From 4fda29c47d77e527c6465e2dd6838e8d180c04f7 Mon Sep 17 00:00:00 2001
From: Pavel Feldman <pavel.feldman@gmail.com>
Date: Wed, 5 Oct 2022 07:56:20 -0800
Subject: [PATCH 001/438] chore: roll to Playwright ToT (#1576)

---
 README.md                            |    4 +-
 playwright/_impl/_browser_context.py |    6 +-
 playwright/_impl/_fetch.py           |   54 +-
 playwright/_impl/_frame.py           |   66 +-
 playwright/_impl/_locator.py         |  198 +++-
 playwright/_impl/_network.py         |    5 +
 playwright/_impl/_page.py            |   52 +
 playwright/_impl/_selectors.py       |    4 +
 playwright/_impl/_str_utils.py       |   27 +-
 playwright/async_api/_generated.py   | 1344 ++++++++++++++++++++++++--
 playwright/sync_api/_generated.py    | 1324 +++++++++++++++++++++++--
 setup.py                             |    2 +-
 tests/sync/test_locator_get_by.py    |  106 ++
 13 files changed, 2970 insertions(+), 222 deletions(-)
 create mode 100644 tests/sync/test_locator_get_by.py

diff --git a/README.md b/README.md
index f0303e4f5..1afe5adfe 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 -->106.0.5249.30<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->107.0.5304.18<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->104.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->105.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 59eeece99..38f375f4d 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -450,8 +450,7 @@ def _on_request_failed(
         page: Optional[Page],
     ) -> None:
         request._failure_text = failure_text
-        if request._timing:
-            request._timing["responseEnd"] = response_end_timing
+        request._set_response_end_timing(response_end_timing)
         self.emit(BrowserContext.Events.RequestFailed, request)
         if page:
             page.emit(Page.Events.RequestFailed, request)
@@ -463,8 +462,7 @@ def _on_request_finished(
         response_end_timing: float,
         page: Optional[Page],
     ) -> None:
-        if request._timing:
-            request._timing["responseEnd"] = response_end_timing
+        request._set_response_end_timing(response_end_timing)
         self.emit(BrowserContext.Events.RequestFinished, request)
         if page:
             page.emit(Page.Events.RequestFinished, request)
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index d78ab64f2..c4428a37e 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -48,6 +48,12 @@
     from playwright._impl._playwright import Playwright
 
 
+FormType = Dict[str, Union[bool, float, str]]
+DataType = Union[Any, bytes, str]
+MultipartType = Dict[str, Union[bytes, bool, float, str, FilePayload]]
+ParamsType = Dict[str, Union[bool, float, str]]
+
+
 class APIRequest:
     def __init__(self, playwright: "Playwright") -> None:
         self.playwright = playwright
@@ -94,11 +100,11 @@ async def dispose(self) -> None:
     async def delete(
         self,
         url: str,
-        params: Dict[str, Union[bool, float, str]] = None,
+        params: ParamsType = None,
         headers: Headers = None,
-        data: Union[Any, bytes, str] = None,
-        form: Dict[str, Union[bool, float, str]] = None,
-        multipart: Dict[str, Union[bytes, bool, float, str, FilePayload]] = None,
+        data: DataType = None,
+        form: FormType = None,
+        multipart: MultipartType = None,
         timeout: float = None,
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
@@ -121,8 +127,11 @@ async def delete(
     async def head(
         self,
         url: str,
-        params: Dict[str, Union[bool, float, str]] = None,
+        params: ParamsType = None,
         headers: Headers = None,
+        data: DataType = None,
+        form: FormType = None,
+        multipart: MultipartType = None,
         timeout: float = None,
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
@@ -133,6 +142,9 @@ async def head(
             method="HEAD",
             params=params,
             headers=headers,
+            data=data,
+            form=form,
+            multipart=multipart,
             timeout=timeout,
             failOnStatusCode=failOnStatusCode,
             ignoreHTTPSErrors=ignoreHTTPSErrors,
@@ -142,8 +154,11 @@ async def head(
     async def get(
         self,
         url: str,
-        params: Dict[str, Union[bool, float, str]] = None,
+        params: ParamsType = None,
         headers: Headers = None,
+        data: DataType = None,
+        form: FormType = None,
+        multipart: MultipartType = None,
         timeout: float = None,
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
@@ -154,6 +169,9 @@ async def get(
             method="GET",
             params=params,
             headers=headers,
+            data=data,
+            form=form,
+            multipart=multipart,
             timeout=timeout,
             failOnStatusCode=failOnStatusCode,
             ignoreHTTPSErrors=ignoreHTTPSErrors,
@@ -163,10 +181,10 @@ async def get(
     async def patch(
         self,
         url: str,
-        params: Dict[str, Union[bool, float, str]] = None,
+        params: ParamsType = None,
         headers: Headers = None,
-        data: Union[Any, bytes, str] = None,
-        form: Dict[str, Union[bool, float, str]] = None,
+        data: DataType = None,
+        form: FormType = None,
         multipart: Dict[str, Union[bytes, bool, float, str, FilePayload]] = None,
         timeout: float = None,
         failOnStatusCode: bool = None,
@@ -190,10 +208,10 @@ async def patch(
     async def put(
         self,
         url: str,
-        params: Dict[str, Union[bool, float, str]] = None,
+        params: ParamsType = None,
         headers: Headers = None,
-        data: Union[Any, bytes, str] = None,
-        form: Dict[str, Union[bool, float, str]] = None,
+        data: DataType = None,
+        form: FormType = None,
         multipart: Dict[str, Union[bytes, bool, float, str, FilePayload]] = None,
         timeout: float = None,
         failOnStatusCode: bool = None,
@@ -217,10 +235,10 @@ async def put(
     async def post(
         self,
         url: str,
-        params: Dict[str, Union[bool, float, str]] = None,
+        params: ParamsType = None,
         headers: Headers = None,
-        data: Union[Any, bytes, str] = None,
-        form: Dict[str, Union[bool, float, str]] = None,
+        data: DataType = None,
+        form: FormType = None,
         multipart: Dict[str, Union[bytes, bool, float, str, FilePayload]] = None,
         timeout: float = None,
         failOnStatusCode: bool = None,
@@ -244,11 +262,11 @@ async def post(
     async def fetch(
         self,
         urlOrRequest: Union[str, network.Request],
-        params: Dict[str, Union[bool, float, str]] = None,
+        params: ParamsType = None,
         method: str = None,
         headers: Headers = None,
-        data: Union[Any, bytes, str] = None,
-        form: Dict[str, Union[bool, float, str]] = None,
+        data: DataType = None,
+        form: FormType = None,
         multipart: Dict[str, Union[bytes, bool, float, str, FilePayload]] = None,
         timeout: float = None,
         failOnStatusCode: bool = None,
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 0f09aa422..3a77a00ad 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -45,7 +45,17 @@
     parse_result,
     serialize_argument,
 )
-from playwright._impl._locator import FrameLocator, Locator
+from playwright._impl._locator import (
+    FrameLocator,
+    Locator,
+    get_by_alt_text_selector,
+    get_by_label_selector,
+    get_by_placeholder_selector,
+    get_by_role_selector,
+    get_by_test_id_selector,
+    get_by_text_selector,
+    get_by_title_selector,
+)
 from playwright._impl._network import Response
 from playwright._impl._set_input_files_helpers import convert_input_files
 from playwright._impl._wait_helper import WaitHelper
@@ -520,6 +530,60 @@ def locator(
     ) -> Locator:
         return Locator(self, selector, has_text=has_text, has=has)
 
+    def get_by_alt_text(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_alt_text_selector(text, exact=exact))
+
+    def get_by_label(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_label_selector(text, exact=exact))
+
+    def get_by_placeholder(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_placeholder_selector(text, exact=exact))
+
+    def get_by_role(
+        self,
+        role: str,
+        checked: bool = None,
+        disabled: bool = None,
+        expanded: bool = None,
+        includeHidden: bool = None,
+        level: int = None,
+        name: Union[str, Pattern[str]] = None,
+        pressed: bool = None,
+        selected: bool = None,
+    ) -> "Locator":
+        return self.locator(
+            get_by_role_selector(
+                role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=includeHidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, testId: str) -> "Locator":
+        return self.locator(get_by_test_id_selector(testId))
+
+    def get_by_text(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_text_selector(text, exact=exact))
+
+    def get_by_title(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_title_selector(text, exact=exact))
+
     def frame_locator(self, selector: str) -> FrameLocator:
         return FrameLocator(self, selector)
 
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 18a385a17..e2d206b62 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -24,6 +24,7 @@
     List,
     Optional,
     Pattern,
+    Tuple,
     TypeVar,
     Union,
 )
@@ -44,7 +45,12 @@
     monotonic_time,
 )
 from playwright._impl._js_handle import Serializable, parse_value, serialize_argument
-from playwright._impl._str_utils import escape_regex_flags, escape_with_quotes
+from playwright._impl._str_utils import (
+    escape_for_attribute_selector,
+    escape_for_text_selector,
+    escape_regex_flags,
+    escape_with_quotes,
+)
 
 if sys.version_info >= (3, 8):  # pragma: no cover
     from typing import Literal
@@ -209,6 +215,60 @@ def locator(
             has=has,
         )
 
+    def get_by_alt_text(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_alt_text_selector(text, exact=exact))
+
+    def get_by_label(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_label_selector(text, exact=exact))
+
+    def get_by_placeholder(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_placeholder_selector(text, exact=exact))
+
+    def get_by_role(
+        self,
+        role: str,
+        checked: bool = None,
+        disabled: bool = None,
+        expanded: bool = None,
+        includeHidden: bool = None,
+        level: int = None,
+        name: Union[str, Pattern[str]] = None,
+        pressed: bool = None,
+        selected: bool = None,
+    ) -> "Locator":
+        return self.locator(
+            get_by_role_selector(
+                role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=includeHidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, testId: str) -> "Locator":
+        return self.locator(get_by_test_id_selector(testId))
+
+    def get_by_text(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_text_selector(text, exact=exact))
+
+    def get_by_title(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_title_selector(text, exact=exact))
+
     def frame_locator(self, selector: str) -> "FrameLocator":
         return FrameLocator(self._frame, self._selector + " >> " + selector)
 
@@ -590,6 +650,60 @@ def locator(
             has=has,
         )
 
+    def get_by_alt_text(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_alt_text_selector(text, exact=exact))
+
+    def get_by_label(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_label_selector(text, exact=exact))
+
+    def get_by_placeholder(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_placeholder_selector(text, exact=exact))
+
+    def get_by_role(
+        self,
+        role: str,
+        checked: bool = None,
+        disabled: bool = None,
+        expanded: bool = None,
+        includeHidden: bool = None,
+        level: int = None,
+        name: Union[str, Pattern[str]] = None,
+        pressed: bool = None,
+        selected: bool = None,
+    ) -> "Locator":
+        return self.locator(
+            get_by_role_selector(
+                role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=includeHidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, testId: str) -> "Locator":
+        return self.locator(get_by_test_id_selector(testId))
+
+    def get_by_text(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_text_selector(text, exact=exact))
+
+    def get_by_title(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self.locator(get_by_title_selector(text, exact=exact))
+
     def frame_locator(self, selector: str) -> "FrameLocator":
         return FrameLocator(
             self._frame, f"{self._frame_selector} >> control=enter-frame >> {selector}"
@@ -608,3 +722,85 @@ def nth(self, index: int) -> "FrameLocator":
 
     def __repr__(self) -> str:
         return f"<FrameLocator frame={self._frame!r} selector={self._frame_selector!r}>"
+
+
+test_id_attribute_name: str = "data-testid"
+
+
+def set_test_id_attribute_name(attribute_name: str) -> None:
+    global test_id_attribute_name
+    test_id_attribute_name = attribute_name
+
+
+def get_by_test_id_selector(test_id: str) -> str:
+    return get_by_attribute_text_selector(test_id_attribute_name, test_id, exact=True)
+
+
+def get_by_attribute_text_selector(
+    attr_name: str, text: Union[str, Pattern[str]], exact: bool = None
+) -> str:
+    if isinstance(text, Pattern):
+        return f"attr=[{attr_name}=/{text.pattern}/{escape_regex_flags(text)}]"
+    suffix = "s" if exact else "i"
+    return f"attr=[{attr_name}={escape_for_attribute_selector(text)}{suffix}]"
+
+
+def get_by_label_selector(text: Union[str, Pattern[str]], exact: bool = None) -> str:
+    return get_by_text_selector(text, exact=exact) + " >> control=resolve-label"
+
+
+def get_by_alt_text_selector(text: Union[str, Pattern[str]], exact: bool = None) -> str:
+    return get_by_attribute_text_selector("alt", text, exact=exact)
+
+
+def get_by_title_selector(text: Union[str, Pattern[str]], exact: bool = None) -> str:
+    return get_by_attribute_text_selector("title", text, exact=exact)
+
+
+def get_by_placeholder_selector(
+    text: Union[str, Pattern[str]], exact: bool = None
+) -> str:
+    return get_by_attribute_text_selector("placeholder", text, exact=exact)
+
+
+def get_by_text_selector(text: Union[str, Pattern[str]], exact: bool = None) -> str:
+    return "text=" + escape_for_text_selector(text, exact=exact)
+
+
+def get_by_role_selector(
+    role: str,
+    checked: bool = None,
+    disabled: bool = None,
+    expanded: bool = None,
+    includeHidden: bool = None,
+    level: int = None,
+    name: Union[str, Pattern[str]] = None,
+    pressed: bool = None,
+    selected: bool = None,
+) -> str:
+    props: List[Tuple[str, str]] = []
+    if checked is not None:
+        props.append(("checked", str(checked)))
+    if disabled is not None:
+        props.append(("disabled", str(disabled)))
+    if selected is not None:
+        props.append(("selected", str(selected)))
+    if expanded is not None:
+        props.append(("expanded", str(expanded)))
+    if includeHidden is not None:
+        props.append(("include-hiddenen", str(includeHidden)))
+    if level is not None:
+        props.append(("level", str(level)))
+    if name is not None:
+        props.append(
+            (
+                "name",
+                f"/{name.pattern}/{escape_regex_flags(name)}"
+                if isinstance(name, Pattern)
+                else escape_for_attribute_selector(name),
+            )
+        )
+    if pressed is not None:
+        props.append(("pressed", str(pressed)))
+    props_str = "".join([f"[{t[0]}={t[1]}]" for t in props])
+    return f"role={role}{props_str}"
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 1ea51e465..f89626b6e 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -181,6 +181,11 @@ def failure(self) -> Optional[str]:
     def timing(self) -> ResourceTiming:
         return self._timing
 
+    def _set_response_end_timing(self, response_end_timing: float) -> None:
+        self._timing["responseEnd"] = response_end_timing
+        if self._timing["responseStart"] == -1:
+            self._timing["responseStart"] = response_end_timing
+
     @property
     def headers(self) -> Headers:
         override = self._fallback_overrides.get("headers")
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 9e05c3f1c..118ffb91e 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -735,6 +735,58 @@ def locator(
     ) -> "Locator":
         return self._main_frame.locator(selector, has_text=has_text, has=has)
 
+    def get_by_alt_text(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self._main_frame.get_by_alt_text(text, exact=exact)
+
+    def get_by_label(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self._main_frame.get_by_label(text, exact=exact)
+
+    def get_by_placeholder(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self._main_frame.get_by_placeholder(text, exact=exact)
+
+    def get_by_role(
+        self,
+        role: str,
+        checked: bool = None,
+        disabled: bool = None,
+        expanded: bool = None,
+        includeHidden: bool = None,
+        level: int = None,
+        name: Union[str, Pattern[str]] = None,
+        pressed: bool = None,
+        selected: bool = None,
+    ) -> "Locator":
+        return self._main_frame.get_by_role(
+            role,
+            checked=checked,
+            disabled=disabled,
+            expanded=expanded,
+            includeHidden=includeHidden,
+            level=level,
+            name=name,
+            pressed=pressed,
+            selected=selected,
+        )
+
+    def get_by_test_id(self, testId: str) -> "Locator":
+        return self._main_frame.get_by_test_id(testId)
+
+    def get_by_text(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self._main_frame.get_by_text(text, exact=exact)
+
+    def get_by_title(
+        self, text: Union[str, Pattern[str]], exact: bool = None
+    ) -> "Locator":
+        return self._main_frame.get_by_title(text, exact=exact)
+
     def frame_locator(self, selector: str) -> "FrameLocator":
         return self.main_frame.frame_locator(selector)
 
diff --git a/playwright/_impl/_selectors.py b/playwright/_impl/_selectors.py
index 03188ea5c..a66484d30 100644
--- a/playwright/_impl/_selectors.py
+++ b/playwright/_impl/_selectors.py
@@ -19,6 +19,7 @@
 from playwright._impl._api_types import Error
 from playwright._impl._connection import ChannelOwner
 from playwright._impl._helper import async_readfile
+from playwright._impl._locator import set_test_id_attribute_name
 
 
 class Selectors:
@@ -46,6 +47,9 @@ async def register(
             await channel._channel.send("register", params)
         self._registrations.append(params)
 
+    def set_test_id_attribute(self, attribute_name: str) -> None:
+        set_test_id_attribute_name(attribute_name)
+
     def _add_channel(self, channel: "SelectorsOwner") -> None:
         self._channels.add(channel)
         for params in self._registrations:
diff --git a/playwright/_impl/_str_utils.py b/playwright/_impl/_str_utils.py
index 22088b81c..8fce2a718 100644
--- a/playwright/_impl/_str_utils.py
+++ b/playwright/_impl/_str_utils.py
@@ -14,7 +14,7 @@
 
 import json
 import re
-from typing import Pattern
+from typing import Pattern, Union
 
 
 def escape_with_quotes(text: str, char: str = "'") -> str:
@@ -45,3 +45,28 @@ def escape_regex_flags(pattern: Pattern) -> str:
         == 0
     ), "Unexpected re.Pattern flag, only MULTILINE, IGNORECASE and DOTALL are supported."
     return flags
+
+
+def escape_for_regex(text: str) -> str:
+    return re.sub(r"[.*+?^>${}()|[\]\\]", "\\$&", text)
+
+
+def escape_for_text_selector(
+    text: Union[str, Pattern[str]], exact: bool = None, case_sensitive: bool = None
+) -> str:
+    if isinstance(text, Pattern):
+        return f"/{text.pattern}/{escape_regex_flags(text)}"
+    if exact:
+        return '"' + text.replace('"', '\\"') + '"'
+    if '"' in text or ">>" in text or text[0] == "/":
+        suffix = "" if case_sensitive else "i"
+        return re.sub(r"\s+", "\\s+", escape_for_regex(text)) + suffix
+    return text
+
+
+def escape_for_attribute_selector(value: str) -> str:
+    # TODO: this should actually be
+    #   cssEscape(value).replace(/\\ /g, ' ')
+    # However, our attribute selectors do not conform to CSS parsing spec,
+    # so we escape them differently.
+    return '"' + value.replace('"', '\\"') + '"'
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 27c16f5fb..d81253425 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -1346,8 +1346,8 @@ async def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -1382,8 +1382,8 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -2611,8 +2611,8 @@ async def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -2659,8 +2659,8 @@ async def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3244,8 +3244,8 @@ async def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3296,8 +3296,8 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3746,8 +3746,8 @@ async def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         strict : Union[bool, None]
@@ -3795,8 +3795,8 @@ async def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -4233,9 +4233,11 @@ def locator(
     ) -> "Locator":
         """Frame.locator
 
-        The method returns an element locator that can be used to perform actions in the frame. Locator is resolved to the
-        element immediately before performing an action, so a series of actions on the same locator can in fact be performed on
-        different DOM elements. That would happen if the DOM structure between those actions has changed.
+        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved to
+        the element immediately before performing an action, so a series of actions on the same locator can in fact be performed
+        on different DOM elements. That would happen if the DOM structure between those actions has changed.
+
+        [Learn more about locators](https://playwright.dev/python/docs/locators).
 
         [Learn more about locators](https://playwright.dev/python/docs/locators).
 
@@ -4264,6 +4266,250 @@ def locator(
             )
         )
 
+    def get_by_alt_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_alt_text
+
+        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+
+        ```html
+        <img alt='Castle'>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_alt_text(text=text, exact=exact))
+
+    def get_by_label(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_label
+
+        Allows locating input elements by the text of the associated label. For example, this method will find the input by
+        label text Password in the following DOM:
+
+        ```html
+        <label for=\"password-input\">Password:</label>
+        <input id=\"password-input\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_label(text=text, exact=exact))
+
+    def get_by_placeholder(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_placeholder
+
+        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+        \"Country\":
+
+        ```html
+        <input placeholder=\"Country\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_placeholder(text=text, exact=exact)
+        )
+
+    def get_by_role(
+        self,
+        role: str,
+        *,
+        checked: typing.Optional[bool] = None,
+        disabled: typing.Optional[bool] = None,
+        expanded: typing.Optional[bool] = None,
+        include_hidden: typing.Optional[bool] = None,
+        level: typing.Optional[int] = None,
+        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        pressed: typing.Optional[bool] = None,
+        selected: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_role
+
+        Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+        [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+        Note that many html elements have an implicitly
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+        Parameters
+        ----------
+        role : str
+            Required aria role.
+        checked : Union[bool, None]
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
+            checked are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
+        disabled : Union[bool, None]
+            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+
+            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+        expanded : Union[bool, None]
+            A boolean attribute that is usually set by `aria-expanded`.
+
+            Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
+        include_hidden : Union[bool, None]
+            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
+
+            Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
+        level : Union[int, None]
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
+            `<h1>-<h6>` elements.
+
+            Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
+        name : Union[Pattern[str], str, None]
+            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+            Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+        pressed : Union[bool, None]
+            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
+        selected : Union[bool, None]
+            A boolean attribute that is usually set by `aria-selected`.
+
+            Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_role(
+                role=role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=include_hidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, test_id: str) -> "Locator":
+        """Frame.get_by_test_id
+
+        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+
+        Parameters
+        ----------
+        test_id : str
+            Id to locate the element by.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_test_id(testId=test_id))
+
+    def get_by_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_text
+
+        Allows locating elements that contain given text.
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_text(text=text, exact=exact))
+
+    def get_by_title(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_title
+
+        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+
+        ```html
+        <button title='Place the order'>Order Now</button>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_title(text=text, exact=exact))
+
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Frame.frame_locator
 
@@ -4272,7 +4518,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         id=\"my-frame\">`:
 
         ```py
-        locator = frame.frame_locator(\"#my-iframe\").locator(\"text=Submit\")
+        locator = frame.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
         await locator.click()
         ```
 
@@ -5056,8 +5302,8 @@ async def main():
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
@@ -5199,7 +5445,10 @@ def locator(
     ) -> "Locator":
         """FrameLocator.locator
 
-        The method finds an element matching the specified selector in the FrameLocator's subtree.
+        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter options,
+        similar to `locator.filter()` method.
+
+        [Learn more about locators](https://playwright.dev/python/docs/locators).
 
         Parameters
         ----------
@@ -5226,6 +5475,250 @@ def locator(
             )
         )
 
+    def get_by_alt_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_alt_text
+
+        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+
+        ```html
+        <img alt='Castle'>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_alt_text(text=text, exact=exact))
+
+    def get_by_label(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_label
+
+        Allows locating input elements by the text of the associated label. For example, this method will find the input by
+        label text Password in the following DOM:
+
+        ```html
+        <label for=\"password-input\">Password:</label>
+        <input id=\"password-input\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_label(text=text, exact=exact))
+
+    def get_by_placeholder(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_placeholder
+
+        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+        \"Country\":
+
+        ```html
+        <input placeholder=\"Country\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_placeholder(text=text, exact=exact)
+        )
+
+    def get_by_role(
+        self,
+        role: str,
+        *,
+        checked: typing.Optional[bool] = None,
+        disabled: typing.Optional[bool] = None,
+        expanded: typing.Optional[bool] = None,
+        include_hidden: typing.Optional[bool] = None,
+        level: typing.Optional[int] = None,
+        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        pressed: typing.Optional[bool] = None,
+        selected: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_role
+
+        Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+        [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+        Note that many html elements have an implicitly
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+        Parameters
+        ----------
+        role : str
+            Required aria role.
+        checked : Union[bool, None]
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
+            checked are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
+        disabled : Union[bool, None]
+            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+
+            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+        expanded : Union[bool, None]
+            A boolean attribute that is usually set by `aria-expanded`.
+
+            Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
+        include_hidden : Union[bool, None]
+            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
+
+            Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
+        level : Union[int, None]
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
+            `<h1>-<h6>` elements.
+
+            Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
+        name : Union[Pattern[str], str, None]
+            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+            Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+        pressed : Union[bool, None]
+            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
+        selected : Union[bool, None]
+            A boolean attribute that is usually set by `aria-selected`.
+
+            Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_role(
+                role=role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=include_hidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, test_id: str) -> "Locator":
+        """FrameLocator.get_by_test_id
+
+        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+
+        Parameters
+        ----------
+        test_id : str
+            Id to locate the element by.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_test_id(testId=test_id))
+
+    def get_by_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_text
+
+        Allows locating elements that contain given text.
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_text(text=text, exact=exact))
+
+    def get_by_title(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_title
+
+        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+
+        ```html
+        <button title='Place the order'>Order Now</button>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_title(text=text, exact=exact))
+
     def frame_locator(self, selector: str) -> "FrameLocator":
         """FrameLocator.frame_locator
 
@@ -5310,8 +5803,8 @@ async def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -5342,8 +5835,8 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -5436,6 +5929,21 @@ async def main():
             )
         )
 
+    def set_test_id_attribute(self, attribute_name: str) -> None:
+        """Selectors.set_test_id_attribute
+
+        Defines custom attribute name to be used in `page.get_by_test_id()`. `data-testid` is used by default.
+
+        Parameters
+        ----------
+        attribute_name : str
+            Test id attribute name.
+        """
+
+        return mapping.from_maybe_impl(
+            self._impl_obj.set_test_id_attribute(attribute_name=attribute_name)
+        )
+
 
 mapping.register(SelectorsImpl, Selectors)
 
@@ -6900,8 +7408,8 @@ async def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -6952,8 +7460,8 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -7002,8 +7510,8 @@ async def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         strict : Union[bool, None]
@@ -7049,8 +7557,8 @@ async def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -7461,13 +7969,13 @@ async def wait_for_load_state(
         when this method is called. If current document has already reached the required state, resolves immediately.
 
         ```py
-        await page.click(\"button\") # click triggers navigation.
+        await page.get_by_role(\"button\").click() # click triggers navigation.
         await page.wait_for_load_state() # the promise resolves after \"load\" event.
         ```
 
         ```py
         async with page.expect_popup() as page_info:
-            await page.click(\"button\") # click triggers a popup.
+            await page.get_by_role(\"button\").click() # click triggers a popup.
         popup = await page_info.value
          # Following resolves after \"domcontentloaded\" event.
         await popup.wait_for_load_state(\"domcontentloaded\")
@@ -8346,58 +8854,300 @@ async def fill(
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
 
-        return mapping.from_maybe_impl(
-            await self._impl_obj.fill(
-                selector=selector,
-                value=value,
-                timeout=timeout,
-                noWaitAfter=no_wait_after,
-                strict=strict,
-                force=force,
-            )
-        )
+        return mapping.from_maybe_impl(
+            await self._impl_obj.fill(
+                selector=selector,
+                value=value,
+                timeout=timeout,
+                noWaitAfter=no_wait_after,
+                strict=strict,
+                force=force,
+            )
+        )
+
+    def locator(
+        self,
+        selector: str,
+        *,
+        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None
+    ) -> "Locator":
+        """Page.locator
+
+        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved to
+        the element immediately before performing an action, so a series of actions on the same locator can in fact be performed
+        on different DOM elements. That would happen if the DOM structure between those actions has changed.
+
+        [Learn more about locators](https://playwright.dev/python/docs/locators).
+
+        Parameters
+        ----------
+        selector : str
+            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+        has_text : Union[Pattern[str], str, None]
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
+            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            `<article><div>Playwright</div></article>`.
+        has : Union[Locator, None]
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
+            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.locator(
+                selector=selector, has_text=has_text, has=has._impl_obj if has else None
+            )
+        )
+
+    def get_by_alt_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Page.get_by_alt_text
+
+        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+
+        ```html
+        <img alt='Castle'>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_alt_text(text=text, exact=exact))
+
+    def get_by_label(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Page.get_by_label
+
+        Allows locating input elements by the text of the associated label. For example, this method will find the input by
+        label text Password in the following DOM:
+
+        ```html
+        <label for=\"password-input\">Password:</label>
+        <input id=\"password-input\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_label(text=text, exact=exact))
+
+    def get_by_placeholder(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Page.get_by_placeholder
+
+        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+        \"Country\":
+
+        ```html
+        <input placeholder=\"Country\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_placeholder(text=text, exact=exact)
+        )
+
+    def get_by_role(
+        self,
+        role: str,
+        *,
+        checked: typing.Optional[bool] = None,
+        disabled: typing.Optional[bool] = None,
+        expanded: typing.Optional[bool] = None,
+        include_hidden: typing.Optional[bool] = None,
+        level: typing.Optional[int] = None,
+        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        pressed: typing.Optional[bool] = None,
+        selected: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Page.get_by_role
+
+        Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+        [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+        Note that many html elements have an implicitly
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+        Parameters
+        ----------
+        role : str
+            Required aria role.
+        checked : Union[bool, None]
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
+            checked are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
+        disabled : Union[bool, None]
+            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+
+            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+        expanded : Union[bool, None]
+            A boolean attribute that is usually set by `aria-expanded`.
+
+            Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
+        include_hidden : Union[bool, None]
+            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
+
+            Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
+        level : Union[int, None]
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
+            `<h1>-<h6>` elements.
+
+            Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
+        name : Union[Pattern[str], str, None]
+            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+            Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+        pressed : Union[bool, None]
+            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
+        selected : Union[bool, None]
+            A boolean attribute that is usually set by `aria-selected`.
+
+            Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_role(
+                role=role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=include_hidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, test_id: str) -> "Locator":
+        """Page.get_by_test_id
+
+        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+
+        Parameters
+        ----------
+        test_id : str
+            Id to locate the element by.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_test_id(testId=test_id))
 
-    def locator(
+    def get_by_text(
         self,
-        selector: str,
+        text: typing.Union[str, typing.Pattern[str]],
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        exact: typing.Optional[bool] = None
     ) -> "Locator":
-        """Page.locator
+        """Page.get_by_text
 
-        The method returns an element locator that can be used to perform actions on the page. Locator is resolved to the
-        element immediately before performing an action, so a series of actions on the same locator can in fact be performed on
-        different DOM elements. That would happen if the DOM structure between those actions has changed.
+        Allows locating elements that contain given text.
 
-        [Learn more about locators](https://playwright.dev/python/docs/locators).
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_text(text=text, exact=exact))
 
-        Shortcut for main frame's `frame.locator()`.
+    def get_by_title(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Page.get_by_title
+
+        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+
+        ```html
+        <button title='Place the order'>Order Now</button>
+        ```
 
         Parameters
         ----------
-        selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
-        has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
-            `<article><div>Playwright</div></article>`.
-        has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
-
-            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
 
         Returns
         -------
         Locator
         """
 
-        return mapping.from_impl(
-            self._impl_obj.locator(
-                selector=selector, has_text=has_text, has=has._impl_obj if has else None
-            )
-        )
+        return mapping.from_impl(self._impl_obj.get_by_title(text=text, exact=exact))
 
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Page.frame_locator
@@ -8407,7 +9157,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         id=\"my-frame\">`:
 
         ```py
-        locator = page.frame_locator(\"#my-iframe\").locator(\"text=Submit\")
+        locator = page.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
         await locator.click()
         ```
 
@@ -8674,6 +9424,20 @@ async def drag_and_drop(
     ) -> None:
         """Page.drag_and_drop
 
+        This method drags the source element to the target element. It will first move to the source element, perform a
+        `mousedown`, then move to the target element and perform a `mouseup`.
+
+        ```py
+        await page.drag_and_drop(\"#source\", \"#target\")
+        # or specify exact positions relative to the top-left corners of the elements:
+        await page.drag_and_drop(
+          \"#source\",
+          \"#target\",
+          source_position={\"x\": 34, \"y\": 7},
+          target_position={\"x\": 10, \"y\": 20}
+        )
+        ```
+
         Parameters
         ----------
         source : str
@@ -9227,8 +9991,8 @@ async def main():
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
@@ -9406,7 +10170,7 @@ def expect_event(
 
         ```py
         async with page.expect_event(\"framenavigated\") as event_info:
-            await page.click(\"button\")
+            await page.get_by_role(\"button\")
         frame = await event_info.value
         ```
 
@@ -10475,7 +11239,7 @@ async def run(playwright):
             <button onclick=\"onClick()\">Click me</button>
             <div></div>
             \"\"\")
-            await page.locator(\"button\").click()
+            await page.get_by_role(\"button\").click()
 
         async def main():
             async with async_playwright() as playwright:
@@ -10553,7 +11317,7 @@ async def run(playwright):
                 <button onclick=\"onClick()\">Click me</button>
                 <div></div>
             \"\"\")
-            await page.locator(\"button\").click()
+            await page.get_by_role(\"button\").click()
 
         async def main():
             async with async_playwright() as playwright:
@@ -10738,7 +11502,7 @@ def expect_event(
 
         ```py
         async with context.expect_event(\"page\") as event_info:
-            await page.locator(\"button\").click()
+            await page.get_by_role(\"button\").click()
         page = await event_info.value
         ```
 
@@ -11161,7 +11925,7 @@ async def new_context(
             security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persistet as separate files and all of these files are archived along with the HAR file.
+            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
             Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
@@ -11356,7 +12120,7 @@ async def new_page(
             security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persistet as separate files and all of these files are archived along with the HAR file.
+            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
             Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
@@ -11856,7 +12620,7 @@ async def launch_persistent_context(
             security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persistet as separate files and all of these files are archived along with the HAR file.
+            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
             Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
@@ -12197,7 +12961,7 @@ async def start_chunk(self, *, title: typing.Optional[str] = None) -> None:
         await page.goto(\"https://playwright.dev\")
 
         await context.tracing.start_chunk()
-        await page.locator(\"text=Get Started\").click()
+        await page.get_by_text(\"Get Started\").click()
         # Everything between start_chunk and stop_chunk will be recorded in the trace.
         await context.tracing.stop_chunk(path = \"trace1.zip\")
 
@@ -12596,8 +13360,8 @@ async def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
@@ -12636,8 +13400,8 @@ async def evaluate_all(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -12676,8 +13440,8 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
@@ -12745,9 +13509,11 @@ def locator(
     ) -> "Locator":
         """Locator.locator
 
-        The method finds an element matching the specified selector in the `Locator`'s subtree. It also accepts filter options,
+        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter options,
         similar to `locator.filter()` method.
 
+        [Learn more about locators](https://playwright.dev/python/docs/locators).
+
         Parameters
         ----------
         selector : str
@@ -12773,6 +13539,250 @@ def locator(
             )
         )
 
+    def get_by_alt_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_alt_text
+
+        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+
+        ```html
+        <img alt='Castle'>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_alt_text(text=text, exact=exact))
+
+    def get_by_label(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_label
+
+        Allows locating input elements by the text of the associated label. For example, this method will find the input by
+        label text Password in the following DOM:
+
+        ```html
+        <label for=\"password-input\">Password:</label>
+        <input id=\"password-input\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_label(text=text, exact=exact))
+
+    def get_by_placeholder(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_placeholder
+
+        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+        \"Country\":
+
+        ```html
+        <input placeholder=\"Country\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_placeholder(text=text, exact=exact)
+        )
+
+    def get_by_role(
+        self,
+        role: str,
+        *,
+        checked: typing.Optional[bool] = None,
+        disabled: typing.Optional[bool] = None,
+        expanded: typing.Optional[bool] = None,
+        include_hidden: typing.Optional[bool] = None,
+        level: typing.Optional[int] = None,
+        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        pressed: typing.Optional[bool] = None,
+        selected: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_role
+
+        Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+        [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+        Note that many html elements have an implicitly
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+        Parameters
+        ----------
+        role : str
+            Required aria role.
+        checked : Union[bool, None]
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
+            checked are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
+        disabled : Union[bool, None]
+            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+
+            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+        expanded : Union[bool, None]
+            A boolean attribute that is usually set by `aria-expanded`.
+
+            Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
+        include_hidden : Union[bool, None]
+            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
+
+            Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
+        level : Union[int, None]
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
+            `<h1>-<h6>` elements.
+
+            Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
+        name : Union[Pattern[str], str, None]
+            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+            Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+        pressed : Union[bool, None]
+            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
+        selected : Union[bool, None]
+            A boolean attribute that is usually set by `aria-selected`.
+
+            Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_role(
+                role=role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=include_hidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, test_id: str) -> "Locator":
+        """Locator.get_by_test_id
+
+        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+
+        Parameters
+        ----------
+        test_id : str
+            Id to locate the element by.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_test_id(testId=test_id))
+
+    def get_by_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_text
+
+        Allows locating elements that contain given text.
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_text(text=text, exact=exact))
+
+    def get_by_title(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_title
+
+        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+
+        ```html
+        <button title='Place the order'>Order Now</button>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_title(text=text, exact=exact))
+
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Locator.frame_locator
 
@@ -12780,7 +13790,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         that iframe:
 
         ```py
-        locator = page.frame_locator(\"iframe\").locator(\"text=Submit\")
+        locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
         await locator.click()
         ```
 
@@ -12861,7 +13871,7 @@ def filter(
         # ...
         await row_locator
             .filter(has_text=\"text in column 1\")
-            .filter(has=page.locator(\"tr\", has_text=\"column 2 button\"))
+            .filter(has=page.get_by_role(\"button\", name=\"column 2 button\"))
             .screenshot()
         ```
 
@@ -12925,6 +13935,22 @@ async def drag_to(
     ) -> None:
         """Locator.drag_to
 
+        This method drags the locator to another target locator or target position. It will first move to the source element,
+        perform a `mousedown`, then move to the target element or position and perform a `mouseup`.
+
+        ```py
+        source = page.locator(\"#source\")
+        target = page.locator(\"#target\")
+
+        await source.drag_to(target)
+        # or specify exact positions relative to the top-left corners of the elements:
+        await source.drag_to(
+          target,
+          source_position={\"x\": 34, \"y\": 7},
+          target_position={\"x\": 10, \"y\": 20}
+        )
+        ```
+
         Parameters
         ----------
         target : Locator
@@ -13604,8 +14630,8 @@ async def type(
         An example of typing into a text field and then submitting the form:
 
         ```py
-        element = page.locator(\"input\")
-        await element.type(\"some text\")
+        element = page.get_by_label(\"Password\")
+        await element.type(\"my password\")
         await element.press(\"Enter\")
         ```
 
@@ -14035,6 +15061,11 @@ async def head(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = 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]]
+        ] = None,
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
@@ -14054,6 +15085,19 @@ async def head(
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
+        data : Union[Any, bytes, str, None]
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
+            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
+            be set to `application/octet-stream` if not explicitly set.
+        form : Union[Dict[str, Union[bool, float, str]], None]
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
+            this request body. If this parameter is specified `content-type` header will be set to
+            `application/x-www-form-urlencoded` unless explicitly provided.
+        multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
+            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
+            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
+            or as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -14074,6 +15118,9 @@ async def head(
                 url=url,
                 params=mapping.to_impl(params),
                 headers=mapping.to_impl(headers),
+                data=mapping.to_impl(data),
+                form=mapping.to_impl(form),
+                multipart=mapping.to_impl(multipart),
                 timeout=timeout,
                 failOnStatusCode=fail_on_status_code,
                 ignoreHTTPSErrors=ignore_https_errors,
@@ -14089,6 +15136,11 @@ async def get(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = 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]]
+        ] = None,
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
@@ -14100,6 +15152,16 @@ async def get(
         method will populate request cookies from the context and update context cookies from the response. The method will
         automatically follow redirects.
 
+        Request parameters can be configured with `params` option, they will be serialized into the URL search parameters:
+
+        ```python
+        query_params = {
+          \"isbn\": \"1234\",
+          \"page\": \"23\"
+        }
+        api_request_context.get(\"https://example.com/api/getText\", params=query_params)
+        ```
+
         Parameters
         ----------
         url : str
@@ -14108,6 +15170,19 @@ async def get(
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
+        data : Union[Any, bytes, str, None]
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
+            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
+            be set to `application/octet-stream` if not explicitly set.
+        form : Union[Dict[str, Union[bool, float, str]], None]
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
+            this request body. If this parameter is specified `content-type` header will be set to
+            `application/x-www-form-urlencoded` unless explicitly provided.
+        multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
+            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
+            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
+            or as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -14128,6 +15203,9 @@ async def get(
                 url=url,
                 params=mapping.to_impl(params),
                 headers=mapping.to_impl(headers),
+                data=mapping.to_impl(data),
+                form=mapping.to_impl(form),
+                multipart=mapping.to_impl(multipart),
                 timeout=timeout,
                 failOnStatusCode=fail_on_status_code,
                 ignoreHTTPSErrors=ignore_https_errors,
@@ -14309,6 +15387,42 @@ async def post(
         The method will populate request cookies from the context and update context cookies from the response. The method will
         automatically follow redirects.
 
+        JSON objects can be passed directly to the request:
+
+        ```python
+        data = {
+            \"title\": \"Book Title\",
+            \"body\": \"John Doe\",
+        }
+        api_request_context.post(\"https://example.com/api/createBook\", data=data)
+        ```
+
+        To send form data to the server use `form` option. Its value will be encoded into the request body with
+        `application/x-www-form-urlencoded` encoding (see below how to use `multipart/form-data` form encoding to send files):
+
+        ```python
+        formData = {
+            \"title\": \"Book Title\",
+            \"body\": \"John Doe\",
+        }
+        api_request_context.post(\"https://example.com/api/findBook\", form=formData)
+        ```
+
+        The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
+        encoding. You can achieve that with Playwright API like this:
+
+        ```python
+        api_request_context.post(
+          \"https://example.com/api/uploadScrip'\",
+          multipart={
+            \"fileField\": {
+              \"name\": \"f.js\",
+              \"mimeType\": \"text/javascript\",
+              \"buffer\": b\"console.log(2022);\",
+            },
+          })
+        ```
+
         Parameters
         ----------
         url : str
@@ -14384,6 +15498,32 @@ async def fetch(
         Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and update
         context cookies from the response. The method will automatically follow redirects.
 
+        JSON objects can be passed directly to the request:
+
+        ```python
+        data = {
+            \"title\": \"Book Title\",
+            \"body\": \"John Doe\",
+        }
+        api_request_context.fetch(\"https://example.com/api/createBook\", method=\"post\", data=data)
+        ```
+
+        The common way to send file(s) in the body of a request is to encode it as form fields with `multipart/form-data`
+        encoding. You can achieve that with Playwright API like this:
+
+        ```python
+        api_request_context.fetch(
+          \"https://example.com/api/uploadScrip'\",
+          method=\"post\",
+          multipart={
+            \"fileField\": {
+              \"name\": \"f.js\",
+              \"mimeType\": \"text/javascript\",
+              \"buffer\": b\"console.log(2022);\",
+            },
+          })
+        ```
+
         Parameters
         ----------
         url_or_request : Union[Request, str]
@@ -14982,7 +16122,7 @@ async def to_have_css(
         ```py
         from playwright.async_api import expect
 
-        locator = page.locator(\"button\")
+        locator = page.get_by_role(\"button\")
         await expect(locator).to_have_css(\"display\", \"flex\")
         ```
 
@@ -15042,7 +16182,7 @@ async def to_have_id(
         ```py
         from playwright.async_api import expect
 
-        locator = page.locator(\"input\")
+        locator = page.get_by_role(\"textbox\")
         await expect(locator).to_have_id(\"lastname\")
         ```
 
@@ -15396,7 +16536,7 @@ async def to_be_checked(
         ```py
         from playwright.async_api import expect
 
-        locator = page.locator(\".subscribe\")
+        locator = page.get_by_label(\"Subscribe to newsletter\")
         await expect(locator).to_be_checked()
         ```
 
@@ -15487,7 +16627,7 @@ async def to_be_editable(
         ```py
         from playwright.async_api import expect
 
-        locator = page.locator(\".input\")
+        locator = page.get_by_role(\"textbox\")
         await expect(locator).to_be_editable()
         ```
 
@@ -15663,8 +16803,8 @@ async def to_be_visible(
     ) -> None:
         """LocatorAssertions.to_be_visible
 
-        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/api/actionability#visible) and [visible](https://playwright.dev/python/docs/api/actionability#visible) DOM
-        node.
+        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/api/actionability#attached) and [visible](https://playwright.dev/python/docs/api/actionability#visible)
+        DOM node.
 
         ```py
         from playwright.async_api import expect
@@ -15715,7 +16855,7 @@ async def to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None
         ```py
         from playwright.async_api import expect
 
-        locator = page.locator('input')
+        locator = page.get_by_role(\"textbox\")
         await expect(locator).to_be_focused()
         ```
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 2c9f54ff7..b1a55548b 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -1342,8 +1342,8 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -1378,8 +1378,8 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -2641,8 +2641,8 @@ def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -2691,8 +2691,8 @@ def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3292,8 +3292,8 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3344,8 +3344,8 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3809,8 +3809,8 @@ def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         strict : Union[bool, None]
@@ -3860,8 +3860,8 @@ def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -4314,9 +4314,11 @@ def locator(
     ) -> "Locator":
         """Frame.locator
 
-        The method returns an element locator that can be used to perform actions in the frame. Locator is resolved to the
-        element immediately before performing an action, so a series of actions on the same locator can in fact be performed on
-        different DOM elements. That would happen if the DOM structure between those actions has changed.
+        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved to
+        the element immediately before performing an action, so a series of actions on the same locator can in fact be performed
+        on different DOM elements. That would happen if the DOM structure between those actions has changed.
+
+        [Learn more about locators](https://playwright.dev/python/docs/locators).
 
         [Learn more about locators](https://playwright.dev/python/docs/locators).
 
@@ -4345,6 +4347,250 @@ def locator(
             )
         )
 
+    def get_by_alt_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_alt_text
+
+        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+
+        ```html
+        <img alt='Castle'>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_alt_text(text=text, exact=exact))
+
+    def get_by_label(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_label
+
+        Allows locating input elements by the text of the associated label. For example, this method will find the input by
+        label text Password in the following DOM:
+
+        ```html
+        <label for=\"password-input\">Password:</label>
+        <input id=\"password-input\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_label(text=text, exact=exact))
+
+    def get_by_placeholder(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_placeholder
+
+        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+        \"Country\":
+
+        ```html
+        <input placeholder=\"Country\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_placeholder(text=text, exact=exact)
+        )
+
+    def get_by_role(
+        self,
+        role: str,
+        *,
+        checked: typing.Optional[bool] = None,
+        disabled: typing.Optional[bool] = None,
+        expanded: typing.Optional[bool] = None,
+        include_hidden: typing.Optional[bool] = None,
+        level: typing.Optional[int] = None,
+        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        pressed: typing.Optional[bool] = None,
+        selected: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_role
+
+        Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+        [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+        Note that many html elements have an implicitly
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+        Parameters
+        ----------
+        role : str
+            Required aria role.
+        checked : Union[bool, None]
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
+            checked are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
+        disabled : Union[bool, None]
+            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+
+            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+        expanded : Union[bool, None]
+            A boolean attribute that is usually set by `aria-expanded`.
+
+            Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
+        include_hidden : Union[bool, None]
+            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
+
+            Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
+        level : Union[int, None]
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
+            `<h1>-<h6>` elements.
+
+            Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
+        name : Union[Pattern[str], str, None]
+            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+            Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+        pressed : Union[bool, None]
+            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
+        selected : Union[bool, None]
+            A boolean attribute that is usually set by `aria-selected`.
+
+            Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_role(
+                role=role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=include_hidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, test_id: str) -> "Locator":
+        """Frame.get_by_test_id
+
+        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+
+        Parameters
+        ----------
+        test_id : str
+            Id to locate the element by.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_test_id(testId=test_id))
+
+    def get_by_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_text
+
+        Allows locating elements that contain given text.
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_text(text=text, exact=exact))
+
+    def get_by_title(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Frame.get_by_title
+
+        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+
+        ```html
+        <button title='Place the order'>Order Now</button>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_title(text=text, exact=exact))
+
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Frame.frame_locator
 
@@ -4353,7 +4599,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         id=\"my-frame\">`:
 
         ```py
-        locator = frame.frame_locator(\"#my-iframe\").locator(\"text=Submit\")
+        locator = frame.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
         locator.click()
         ```
 
@@ -5160,8 +5406,8 @@ def run(playwright):
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
@@ -5307,7 +5553,10 @@ def locator(
     ) -> "Locator":
         """FrameLocator.locator
 
-        The method finds an element matching the specified selector in the FrameLocator's subtree.
+        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter options,
+        similar to `locator.filter()` method.
+
+        [Learn more about locators](https://playwright.dev/python/docs/locators).
 
         Parameters
         ----------
@@ -5334,6 +5583,250 @@ def locator(
             )
         )
 
+    def get_by_alt_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_alt_text
+
+        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+
+        ```html
+        <img alt='Castle'>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_alt_text(text=text, exact=exact))
+
+    def get_by_label(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_label
+
+        Allows locating input elements by the text of the associated label. For example, this method will find the input by
+        label text Password in the following DOM:
+
+        ```html
+        <label for=\"password-input\">Password:</label>
+        <input id=\"password-input\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_label(text=text, exact=exact))
+
+    def get_by_placeholder(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_placeholder
+
+        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+        \"Country\":
+
+        ```html
+        <input placeholder=\"Country\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_placeholder(text=text, exact=exact)
+        )
+
+    def get_by_role(
+        self,
+        role: str,
+        *,
+        checked: typing.Optional[bool] = None,
+        disabled: typing.Optional[bool] = None,
+        expanded: typing.Optional[bool] = None,
+        include_hidden: typing.Optional[bool] = None,
+        level: typing.Optional[int] = None,
+        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        pressed: typing.Optional[bool] = None,
+        selected: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_role
+
+        Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+        [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+        Note that many html elements have an implicitly
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+        Parameters
+        ----------
+        role : str
+            Required aria role.
+        checked : Union[bool, None]
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
+            checked are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
+        disabled : Union[bool, None]
+            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+
+            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+        expanded : Union[bool, None]
+            A boolean attribute that is usually set by `aria-expanded`.
+
+            Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
+        include_hidden : Union[bool, None]
+            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
+
+            Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
+        level : Union[int, None]
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
+            `<h1>-<h6>` elements.
+
+            Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
+        name : Union[Pattern[str], str, None]
+            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+            Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+        pressed : Union[bool, None]
+            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
+        selected : Union[bool, None]
+            A boolean attribute that is usually set by `aria-selected`.
+
+            Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_role(
+                role=role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=include_hidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, test_id: str) -> "Locator":
+        """FrameLocator.get_by_test_id
+
+        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+
+        Parameters
+        ----------
+        test_id : str
+            Id to locate the element by.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_test_id(testId=test_id))
+
+    def get_by_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_text
+
+        Allows locating elements that contain given text.
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_text(text=text, exact=exact))
+
+    def get_by_title(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """FrameLocator.get_by_title
+
+        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+
+        ```html
+        <button title='Place the order'>Order Now</button>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_title(text=text, exact=exact))
+
     def frame_locator(self, selector: str) -> "FrameLocator":
         """FrameLocator.frame_locator
 
@@ -5414,8 +5907,8 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -5446,8 +5939,8 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -5540,6 +6033,21 @@ def run(playwright):
             )
         )
 
+    def set_test_id_attribute(self, attribute_name: str) -> None:
+        """Selectors.set_test_id_attribute
+
+        Defines custom attribute name to be used in `page.get_by_test_id()`. `data-testid` is used by default.
+
+        Parameters
+        ----------
+        attribute_name : str
+            Test id attribute name.
+        """
+
+        return mapping.from_maybe_impl(
+            self._impl_obj.set_test_id_attribute(attribute_name=attribute_name)
+        )
+
 
 mapping.register(SelectorsImpl, Selectors)
 
@@ -6913,8 +7421,8 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -6965,8 +7473,8 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -7017,8 +7525,8 @@ def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         strict : Union[bool, None]
@@ -7066,8 +7574,8 @@ def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -7486,13 +7994,13 @@ def wait_for_load_state(
         when this method is called. If current document has already reached the required state, resolves immediately.
 
         ```py
-        page.click(\"button\") # click triggers navigation.
+        page.get_by_role(\"button\").click() # click triggers navigation.
         page.wait_for_load_state() # the promise resolves after \"load\" event.
         ```
 
         ```py
         with page.expect_popup() as page_info:
-            page.click(\"button\") # click triggers a popup.
+            page.get_by_role(\"button\").click() # click triggers a popup.
         popup = page_info.value
          # Following resolves after \"domcontentloaded\" event.
         popup.wait_for_load_state(\"domcontentloaded\")
@@ -8405,47 +8913,289 @@ def fill(
             )
         )
 
-    def locator(
+    def locator(
+        self,
+        selector: str,
+        *,
+        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None
+    ) -> "Locator":
+        """Page.locator
+
+        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved to
+        the element immediately before performing an action, so a series of actions on the same locator can in fact be performed
+        on different DOM elements. That would happen if the DOM structure between those actions has changed.
+
+        [Learn more about locators](https://playwright.dev/python/docs/locators).
+
+        Parameters
+        ----------
+        selector : str
+            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+        has_text : Union[Pattern[str], str, None]
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
+            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            `<article><div>Playwright</div></article>`.
+        has : Union[Locator, None]
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
+            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.locator(
+                selector=selector, has_text=has_text, has=has._impl_obj if has else None
+            )
+        )
+
+    def get_by_alt_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Page.get_by_alt_text
+
+        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+
+        ```html
+        <img alt='Castle'>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_alt_text(text=text, exact=exact))
+
+    def get_by_label(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Page.get_by_label
+
+        Allows locating input elements by the text of the associated label. For example, this method will find the input by
+        label text Password in the following DOM:
+
+        ```html
+        <label for=\"password-input\">Password:</label>
+        <input id=\"password-input\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_label(text=text, exact=exact))
+
+    def get_by_placeholder(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Page.get_by_placeholder
+
+        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+        \"Country\":
+
+        ```html
+        <input placeholder=\"Country\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_placeholder(text=text, exact=exact)
+        )
+
+    def get_by_role(
+        self,
+        role: str,
+        *,
+        checked: typing.Optional[bool] = None,
+        disabled: typing.Optional[bool] = None,
+        expanded: typing.Optional[bool] = None,
+        include_hidden: typing.Optional[bool] = None,
+        level: typing.Optional[int] = None,
+        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        pressed: typing.Optional[bool] = None,
+        selected: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Page.get_by_role
+
+        Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+        [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+        Note that many html elements have an implicitly
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+        Parameters
+        ----------
+        role : str
+            Required aria role.
+        checked : Union[bool, None]
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
+            checked are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
+        disabled : Union[bool, None]
+            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+
+            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+        expanded : Union[bool, None]
+            A boolean attribute that is usually set by `aria-expanded`.
+
+            Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
+        include_hidden : Union[bool, None]
+            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
+
+            Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
+        level : Union[int, None]
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
+            `<h1>-<h6>` elements.
+
+            Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
+        name : Union[Pattern[str], str, None]
+            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+            Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+        pressed : Union[bool, None]
+            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
+        selected : Union[bool, None]
+            A boolean attribute that is usually set by `aria-selected`.
+
+            Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_role(
+                role=role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=include_hidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, test_id: str) -> "Locator":
+        """Page.get_by_test_id
+
+        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+
+        Parameters
+        ----------
+        test_id : str
+            Id to locate the element by.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_test_id(testId=test_id))
+
+    def get_by_text(
         self,
-        selector: str,
+        text: typing.Union[str, typing.Pattern[str]],
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        exact: typing.Optional[bool] = None
     ) -> "Locator":
-        """Page.locator
+        """Page.get_by_text
 
-        The method returns an element locator that can be used to perform actions on the page. Locator is resolved to the
-        element immediately before performing an action, so a series of actions on the same locator can in fact be performed on
-        different DOM elements. That would happen if the DOM structure between those actions has changed.
+        Allows locating elements that contain given text.
 
-        [Learn more about locators](https://playwright.dev/python/docs/locators).
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_text(text=text, exact=exact))
+
+    def get_by_title(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Page.get_by_title
 
-        Shortcut for main frame's `frame.locator()`.
+        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+
+        ```html
+        <button title='Place the order'>Order Now</button>
+        ```
 
         Parameters
         ----------
-        selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
-        has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
-            `<article><div>Playwright</div></article>`.
-        has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
-
-            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
 
         Returns
         -------
         Locator
         """
 
-        return mapping.from_impl(
-            self._impl_obj.locator(
-                selector=selector, has_text=has_text, has=has._impl_obj if has else None
-            )
-        )
+        return mapping.from_impl(self._impl_obj.get_by_title(text=text, exact=exact))
 
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Page.frame_locator
@@ -8455,7 +9205,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         id=\"my-frame\">`:
 
         ```py
-        locator = page.frame_locator(\"#my-iframe\").locator(\"text=Submit\")
+        locator = page.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
         locator.click()
         ```
 
@@ -8732,6 +9482,20 @@ def drag_and_drop(
     ) -> None:
         """Page.drag_and_drop
 
+        This method drags the source element to the target element. It will first move to the source element, perform a
+        `mousedown`, then move to the target element and perform a `mouseup`.
+
+        ```py
+        page.drag_and_drop(\"#source\", \"#target\")
+        # or specify exact positions relative to the top-left corners of the elements:
+        page.drag_and_drop(
+          \"#source\",
+          \"#target\",
+          source_position={\"x\": 34, \"y\": 7},
+          target_position={\"x\": 10, \"y\": 20}
+        )
+        ```
+
         Parameters
         ----------
         source : str
@@ -9298,8 +10062,8 @@ def run(playwright):
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
@@ -9481,7 +10245,7 @@ def expect_event(
 
         ```py
         with page.expect_event(\"framenavigated\") as event_info:
-            page.click(\"button\")
+            page.get_by_role(\"button\")
         frame = event_info.value
         ```
 
@@ -10505,7 +11269,7 @@ def run(playwright):
             <button onclick=\"onClick()\">Click me</button>
             <div></div>
             \"\"\")
-            page.locator(\"button\").click()
+            page.get_by_role(\"button\").click()
 
         with sync_playwright() as playwright:
             run(playwright)
@@ -10582,7 +11346,7 @@ def run(playwright):
                 <button onclick=\"onClick()\">Click me</button>
                 <div></div>
             \"\"\")
-            page.locator(\"button\").click()
+            page.get_by_role(\"button\").click()
 
         with sync_playwright() as playwright:
             run(playwright)
@@ -10774,7 +11538,7 @@ def expect_event(
 
         ```py
         with context.expect_event(\"page\") as event_info:
-            page.locator(\"button\").click()
+            page.get_by_role(\"button\").click()
         page = event_info.value
         ```
 
@@ -11197,7 +11961,7 @@ def new_context(
             security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persistet as separate files and all of these files are archived along with the HAR file.
+            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
             Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
@@ -11394,7 +12158,7 @@ def new_page(
             security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persistet as separate files and all of these files are archived along with the HAR file.
+            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
             Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
@@ -11900,7 +12664,7 @@ def launch_persistent_context(
             security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persistet as separate files and all of these files are archived along with the HAR file.
+            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
             Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
@@ -12246,7 +13010,7 @@ def start_chunk(self, *, title: typing.Optional[str] = None) -> None:
         page.goto(\"https://playwright.dev\")
 
         context.tracing.start_chunk()
-        page.locator(\"text=Get Started\").click()
+        page.get_by_text(\"Get Started\").click()
         # Everything between start_chunk and stop_chunk will be recorded in the trace.
         context.tracing.stop_chunk(path = \"trace1.zip\")
 
@@ -12655,8 +13419,8 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
@@ -12697,8 +13461,8 @@ def evaluate_all(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -12739,8 +13503,8 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted
-            as a function. Otherwise, evaluated as an expression.
+            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
@@ -12812,9 +13576,11 @@ def locator(
     ) -> "Locator":
         """Locator.locator
 
-        The method finds an element matching the specified selector in the `Locator`'s subtree. It also accepts filter options,
+        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter options,
         similar to `locator.filter()` method.
 
+        [Learn more about locators](https://playwright.dev/python/docs/locators).
+
         Parameters
         ----------
         selector : str
@@ -12840,6 +13606,250 @@ def locator(
             )
         )
 
+    def get_by_alt_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_alt_text
+
+        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+
+        ```html
+        <img alt='Castle'>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_alt_text(text=text, exact=exact))
+
+    def get_by_label(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_label
+
+        Allows locating input elements by the text of the associated label. For example, this method will find the input by
+        label text Password in the following DOM:
+
+        ```html
+        <label for=\"password-input\">Password:</label>
+        <input id=\"password-input\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_label(text=text, exact=exact))
+
+    def get_by_placeholder(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_placeholder
+
+        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
+        \"Country\":
+
+        ```html
+        <input placeholder=\"Country\">
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_placeholder(text=text, exact=exact)
+        )
+
+    def get_by_role(
+        self,
+        role: str,
+        *,
+        checked: typing.Optional[bool] = None,
+        disabled: typing.Optional[bool] = None,
+        expanded: typing.Optional[bool] = None,
+        include_hidden: typing.Optional[bool] = None,
+        level: typing.Optional[int] = None,
+        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        pressed: typing.Optional[bool] = None,
+        selected: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_role
+
+        Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
+        [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
+        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+
+        Note that many html elements have an implicitly
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
+        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
+        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+
+        Parameters
+        ----------
+        role : str
+            Required aria role.
+        checked : Union[bool, None]
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
+            checked are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
+        disabled : Union[bool, None]
+            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+
+            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+        expanded : Union[bool, None]
+            A boolean attribute that is usually set by `aria-expanded`.
+
+            Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
+        include_hidden : Union[bool, None]
+            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
+
+            Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
+        level : Union[int, None]
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
+            `<h1>-<h6>` elements.
+
+            Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
+        name : Union[Pattern[str], str, None]
+            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+            Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+        pressed : Union[bool, None]
+            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+
+            Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
+        selected : Union[bool, None]
+            A boolean attribute that is usually set by `aria-selected`.
+
+            Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(
+            self._impl_obj.get_by_role(
+                role=role,
+                checked=checked,
+                disabled=disabled,
+                expanded=expanded,
+                includeHidden=include_hidden,
+                level=level,
+                name=name,
+                pressed=pressed,
+                selected=selected,
+            )
+        )
+
+    def get_by_test_id(self, test_id: str) -> "Locator":
+        """Locator.get_by_test_id
+
+        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
+        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+
+        Parameters
+        ----------
+        test_id : str
+            Id to locate the element by.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_test_id(testId=test_id))
+
+    def get_by_text(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_text
+
+        Allows locating elements that contain given text.
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_text(text=text, exact=exact))
+
+    def get_by_title(
+        self,
+        text: typing.Union[str, typing.Pattern[str]],
+        *,
+        exact: typing.Optional[bool] = None
+    ) -> "Locator":
+        """Locator.get_by_title
+
+        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+
+        ```html
+        <button title='Place the order'>Order Now</button>
+        ```
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.get_by_title(text=text, exact=exact))
+
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Locator.frame_locator
 
@@ -12847,7 +13857,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         that iframe:
 
         ```py
-        locator = page.frame_locator(\"iframe\").locator(\"text=Submit\")
+        locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
         locator.click()
         ```
 
@@ -12930,7 +13940,7 @@ def filter(
         # ...
         row_locator
             .filter(has_text=\"text in column 1\")
-            .filter(has=page.locator(\"tr\", has_text=\"column 2 button\"))
+            .filter(has=page.get_by_role(\"button\", name=\"column 2 button\"))
             .screenshot()
         ```
 
@@ -12996,6 +14006,22 @@ def drag_to(
     ) -> None:
         """Locator.drag_to
 
+        This method drags the locator to another target locator or target position. It will first move to the source element,
+        perform a `mousedown`, then move to the target element or position and perform a `mouseup`.
+
+        ```py
+        source = page.locator(\"#source\")
+        target = page.locator(\"#target\")
+
+        source.drag_to(target)
+        # or specify exact positions relative to the top-left corners of the elements:
+        source.drag_to(
+          target,
+          source_position={\"x\": 34, \"y\": 7},
+          target_position={\"x\": 10, \"y\": 20}
+        )
+        ```
+
         Parameters
         ----------
         target : Locator
@@ -13703,8 +14729,8 @@ def type(
         An example of typing into a text field and then submitting the form:
 
         ```py
-        element = page.locator(\"input\")
-        element.type(\"some text\")
+        element = page.get_by_label(\"Password\")
+        element.type(\"my password\")
         element.press(\"Enter\")
         ```
 
@@ -14142,6 +15168,11 @@ def head(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = 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]]
+        ] = None,
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
@@ -14161,6 +15192,19 @@ def head(
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
+        data : Union[Any, bytes, str, None]
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
+            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
+            be set to `application/octet-stream` if not explicitly set.
+        form : Union[Dict[str, Union[bool, float, str]], None]
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
+            this request body. If this parameter is specified `content-type` header will be set to
+            `application/x-www-form-urlencoded` unless explicitly provided.
+        multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
+            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
+            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
+            or as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -14182,6 +15226,9 @@ def head(
                     url=url,
                     params=mapping.to_impl(params),
                     headers=mapping.to_impl(headers),
+                    data=mapping.to_impl(data),
+                    form=mapping.to_impl(form),
+                    multipart=mapping.to_impl(multipart),
                     timeout=timeout,
                     failOnStatusCode=fail_on_status_code,
                     ignoreHTTPSErrors=ignore_https_errors,
@@ -14198,6 +15245,11 @@ def get(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = 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]]
+        ] = None,
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
@@ -14209,6 +15261,16 @@ def get(
         method will populate request cookies from the context and update context cookies from the response. The method will
         automatically follow redirects.
 
+        Request parameters can be configured with `params` option, they will be serialized into the URL search parameters:
+
+        ```python
+        query_params = {
+          \"isbn\": \"1234\",
+          \"page\": \"23\"
+        }
+        api_request_context.get(\"https://example.com/api/getText\", params=query_params)
+        ```
+
         Parameters
         ----------
         url : str
@@ -14217,6 +15279,19 @@ def get(
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
+        data : Union[Any, bytes, str, None]
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
+            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
+            be set to `application/octet-stream` if not explicitly set.
+        form : Union[Dict[str, Union[bool, float, str]], None]
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
+            this request body. If this parameter is specified `content-type` header will be set to
+            `application/x-www-form-urlencoded` unless explicitly provided.
+        multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
+            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
+            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
+            or as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -14238,6 +15313,9 @@ def get(
                     url=url,
                     params=mapping.to_impl(params),
                     headers=mapping.to_impl(headers),
+                    data=mapping.to_impl(data),
+                    form=mapping.to_impl(form),
+                    multipart=mapping.to_impl(multipart),
                     timeout=timeout,
                     failOnStatusCode=fail_on_status_code,
                     ignoreHTTPSErrors=ignore_https_errors,
@@ -14424,6 +15502,42 @@ def post(
         The method will populate request cookies from the context and update context cookies from the response. The method will
         automatically follow redirects.
 
+        JSON objects can be passed directly to the request:
+
+        ```python
+        data = {
+            \"title\": \"Book Title\",
+            \"body\": \"John Doe\",
+        }
+        api_request_context.post(\"https://example.com/api/createBook\", data=data)
+        ```
+
+        To send form data to the server use `form` option. Its value will be encoded into the request body with
+        `application/x-www-form-urlencoded` encoding (see below how to use `multipart/form-data` form encoding to send files):
+
+        ```python
+        formData = {
+            \"title\": \"Book Title\",
+            \"body\": \"John Doe\",
+        }
+        api_request_context.post(\"https://example.com/api/findBook\", form=formData)
+        ```
+
+        The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
+        encoding. You can achieve that with Playwright API like this:
+
+        ```python
+        api_request_context.post(
+          \"https://example.com/api/uploadScrip'\",
+          multipart={
+            \"fileField\": {
+              \"name\": \"f.js\",
+              \"mimeType\": \"text/javascript\",
+              \"buffer\": b\"console.log(2022);\",
+            },
+          })
+        ```
+
         Parameters
         ----------
         url : str
@@ -14501,6 +15615,32 @@ def fetch(
         Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and update
         context cookies from the response. The method will automatically follow redirects.
 
+        JSON objects can be passed directly to the request:
+
+        ```python
+        data = {
+            \"title\": \"Book Title\",
+            \"body\": \"John Doe\",
+        }
+        api_request_context.fetch(\"https://example.com/api/createBook\", method=\"post\", data=data)
+        ```
+
+        The common way to send file(s) in the body of a request is to encode it as form fields with `multipart/form-data`
+        encoding. You can achieve that with Playwright API like this:
+
+        ```python
+        api_request_context.fetch(
+          \"https://example.com/api/uploadScrip'\",
+          method=\"post\",
+          multipart={
+            \"fileField\": {
+              \"name\": \"f.js\",
+              \"mimeType\": \"text/javascript\",
+              \"buffer\": b\"console.log(2022);\",
+            },
+          })
+        ```
+
         Parameters
         ----------
         url_or_request : Union[Request, str]
@@ -15123,7 +16263,7 @@ def to_have_css(
         ```py
         from playwright.sync_api import expect
 
-        locator = page.locator(\"button\")
+        locator = page.get_by_role(\"button\")
         expect(locator).to_have_css(\"display\", \"flex\")
         ```
 
@@ -15185,7 +16325,7 @@ def to_have_id(
         ```py
         from playwright.sync_api import expect
 
-        locator = page.locator(\"input\")
+        locator = page.get_by_role(\"textbox\")
         expect(locator).to_have_id(\"lastname\")
         ```
 
@@ -15551,7 +16691,7 @@ def to_be_checked(
         ```py
         from playwright.sync_api import expect
 
-        locator = page.locator(\".subscribe\")
+        locator = page.get_by_label(\"Subscribe to newsletter\")
         expect(locator).to_be_checked()
         ```
 
@@ -15638,7 +16778,7 @@ def to_be_editable(
         ```py
         from playwright.sync_api import expect
 
-        locator = page.locator(\".input\")
+        locator = page.get_by_role(\"textbox\")
         expect(locator).to_be_editable()
         ```
 
@@ -15820,8 +16960,8 @@ def to_be_visible(
     ) -> None:
         """LocatorAssertions.to_be_visible
 
-        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/api/actionability#visible) and [visible](https://playwright.dev/python/docs/api/actionability#visible) DOM
-        node.
+        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/api/actionability#attached) and [visible](https://playwright.dev/python/docs/api/actionability#visible)
+        DOM node.
 
         ```py
         from playwright.sync_api import expect
@@ -15874,7 +17014,7 @@ def to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None:
         ```py
         from playwright.sync_api import expect
 
-        locator = page.locator('input')
+        locator = page.get_by_role(\"textbox\")
         expect(locator).to_be_focused()
         ```
 
diff --git a/setup.py b/setup.py
index 22e1c0c13..ebd8d0e82 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.26.1"
+driver_version = "1.27.0-alpha-1664914898000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/sync/test_locator_get_by.py b/tests/sync/test_locator_get_by.py
new file mode 100644
index 000000000..bc6f6ee05
--- /dev/null
+++ b/tests/sync/test_locator_get_by.py
@@ -0,0 +1,106 @@
+# 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 re
+
+from playwright.sync_api import Page, expect
+
+
+def test_get_by_test_id(page: Page) -> None:
+    page.set_content("<div><div data-testid='Hello'>Hello world</div></div>")
+    expect(page.get_by_test_id("Hello")).to_have_text("Hello world")
+    expect(page.main_frame.get_by_test_id("Hello")).to_have_text("Hello world")
+    expect(page.locator("div").get_by_test_id("Hello")).to_have_text("Hello world")
+
+
+def test_get_by_test_id_escape_id(page: Page) -> None:
+    page.set_content("<div><div data-testid='He\"llo'>Hello world</div></div>")
+    expect(page.get_by_test_id('He"llo')).to_have_text("Hello world")
+
+
+def test_get_by_text(page: Page) -> None:
+    page.set_content("<div>yo</div><div>ya</div><div>\nye  </div>")
+    assert ">\nye  </div>" in page.get_by_text("ye").evaluate("e => e.outerHTML")
+    assert ">\nye  </div>" in page.get_by_text(r"ye").evaluate("e => e.outerHTML")
+
+    page.set_content("<div> ye </div><div>ye</div>")
+    assert "> ye </div>" in page.get_by_text("ye", exact=True).first.evaluate(
+        "e => e.outerHTML"
+    )
+
+    page.set_content("<div>Hello world</div><div>Hello</div>")
+    assert (
+        page.get_by_text("Hello", exact=True).evaluate("e => e.outerHTML")
+        == "<div>Hello</div>"
+    )
+
+
+def test_get_by_label(page: Page) -> None:
+    page.set_content(
+        "<div><label for=target>Name</label><input id=target type=text></div>"
+    )
+    assert page.get_by_text("Name").evaluate("e => e.nodeName") == "LABEL"
+    assert page.get_by_label("Name").evaluate("e => e.nodeName") == "INPUT"
+    assert page.main_frame.get_by_label("Name").evaluate("e => e.nodeName") == "INPUT"
+    assert (
+        page.locator("div").get_by_label("Name").evaluate("e => e.nodeName") == "INPUT"
+    )
+
+
+def test_get_by_placeholder(page: Page) -> None:
+    page.set_content(
+        """<div>
+    <input placeholder="Hello">
+    <input placeholder="Hello World">
+  </div>"""
+    )
+    expect(page.get_by_placeholder("hello")).to_have_count(2)
+    expect(page.get_by_placeholder("Hello", exact=True)).to_have_count(1)
+    expect(page.get_by_placeholder(re.compile(r"wor", re.IGNORECASE))).to_have_count(1)
+
+    # Coverage
+    expect(page.main_frame.get_by_placeholder("hello")).to_have_count(2)
+    expect(page.locator("div").get_by_placeholder("hello")).to_have_count(2)
+
+
+def test_get_by_alt_text(page: Page) -> None:
+    page.set_content(
+        """<div>
+    <input alt="Hello">
+    <input alt="Hello World">
+  </div>"""
+    )
+    expect(page.get_by_alt_text("hello")).to_have_count(2)
+    expect(page.get_by_alt_text("Hello", exact=True)).to_have_count(1)
+    expect(page.get_by_alt_text(re.compile(r"wor", re.IGNORECASE))).to_have_count(1)
+
+    # Coverage
+    expect(page.main_frame.get_by_alt_text("hello")).to_have_count(2)
+    expect(page.locator("div").get_by_alt_text("hello")).to_have_count(2)
+
+
+def test_get_by_title(page: Page) -> None:
+    page.set_content(
+        """<div>
+    <input title="Hello">
+    <input title="Hello World">
+  </div>"""
+    )
+    expect(page.get_by_title("hello")).to_have_count(2)
+    expect(page.get_by_title("Hello", exact=True)).to_have_count(1)
+    expect(page.get_by_title(re.compile(r"wor", re.IGNORECASE))).to_have_count(1)
+
+    # Coverage
+    expect(page.main_frame.get_by_title("hello")).to_have_count(2)
+    expect(page.locator("div").get_by_title("hello")).to_have_count(2)

From d2dad56ef0fe3b9b91731973e2b2d72c0ff97576 Mon Sep 17 00:00:00 2001
From: Pavel Feldman <pavel.feldman@gmail.com>
Date: Thu, 6 Oct 2022 07:16:11 -0800
Subject: [PATCH 002/438] chore: roll Playwright to ToT (#1579)

---
 playwright/_impl/_locator.py      | 28 +++++------
 playwright/_impl/_str_utils.py    | 15 +-----
 setup.py                          |  2 +-
 tests/sync/test_locator_get_by.py | 83 ++++++++++++++++++++++++++++++-
 4 files changed, 97 insertions(+), 31 deletions(-)

diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index e2d206b62..481d9a155 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -49,7 +49,6 @@
     escape_for_attribute_selector,
     escape_for_text_selector,
     escape_regex_flags,
-    escape_with_quotes,
 )
 
 if sys.version_info >= (3, 8):  # pragma: no cover
@@ -79,19 +78,17 @@ def __init__(
         self._dispatcher_fiber = frame._connection._dispatcher_fiber
 
         if has_text:
-            if isinstance(has_text, Pattern):
-                js_regex = f"/{has_text.pattern}/{escape_regex_flags(has_text)}"
-                self._selector += (
-                    f' >> has={json.dumps("text=" + js_regex, ensure_ascii=False)}'
-                )
-            else:
-                escaped = escape_with_quotes(has_text, '"')
-                self._selector += f" >> :scope:has-text({escaped})"
+            text_selector = "text=" + escape_for_text_selector(has_text, exact=False)
+            self._selector += (
+                f" >> internal:has={json.dumps(text_selector, ensure_ascii=False)}"
+            )
 
         if has:
             if has._frame != frame:
                 raise Error('Inner "has" locator must belong to the same frame.')
-            self._selector += " >> has=" + json.dumps(has._selector, ensure_ascii=False)
+            self._selector += " >> internal:has=" + json.dumps(
+                has._selector, ensure_ascii=False
+            )
 
     def __repr__(self) -> str:
         return f"<Locator frame={self._frame!r} selector={self._selector!r}>"
@@ -645,7 +642,7 @@ def locator(
     ) -> Locator:
         return Locator(
             self._frame,
-            f"{self._frame_selector} >> control=enter-frame >> {selector}",
+            f"{self._frame_selector} >> internal:control=enter-frame >> {selector}",
             has_text=has_text,
             has=has,
         )
@@ -706,7 +703,8 @@ def get_by_title(
 
     def frame_locator(self, selector: str) -> "FrameLocator":
         return FrameLocator(
-            self._frame, f"{self._frame_selector} >> control=enter-frame >> {selector}"
+            self._frame,
+            f"{self._frame_selector} >> internal:control=enter-frame >> {selector}",
         )
 
     @property
@@ -740,13 +738,13 @@ def get_by_attribute_text_selector(
     attr_name: str, text: Union[str, Pattern[str]], exact: bool = None
 ) -> str:
     if isinstance(text, Pattern):
-        return f"attr=[{attr_name}=/{text.pattern}/{escape_regex_flags(text)}]"
+        return f"internal:attr=[{attr_name}=/{text.pattern}/{escape_regex_flags(text)}]"
     suffix = "s" if exact else "i"
-    return f"attr=[{attr_name}={escape_for_attribute_selector(text)}{suffix}]"
+    return f"internal:attr=[{attr_name}={escape_for_attribute_selector(text)}{suffix}]"
 
 
 def get_by_label_selector(text: Union[str, Pattern[str]], exact: bool = None) -> str:
-    return get_by_text_selector(text, exact=exact) + " >> control=resolve-label"
+    return "internal:label=" + escape_for_text_selector(text, exact=exact)
 
 
 def get_by_alt_text_selector(text: Union[str, Pattern[str]], exact: bool = None) -> str:
diff --git a/playwright/_impl/_str_utils.py b/playwright/_impl/_str_utils.py
index 8fce2a718..19e8a140b 100644
--- a/playwright/_impl/_str_utils.py
+++ b/playwright/_impl/_str_utils.py
@@ -12,23 +12,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import json
 import re
 from typing import Pattern, Union
 
 
-def escape_with_quotes(text: str, char: str = "'") -> str:
-    stringified = json.dumps(text, ensure_ascii=False)
-    escaped_text = stringified[1:-1].replace('\\"', '"')
-    if char == "'":
-        return char + escaped_text.replace("'", "\\'") + char
-    if char == '"':
-        return char + escaped_text.replace('"', '\\"') + char
-    if char == "`":
-        return char + escaped_text.replace("`", "\\`") + char
-    raise ValueError("Invalid escape char")
-
-
 def escape_regex_flags(pattern: Pattern) -> str:
     flags = ""
     if pattern.flags != 0:
@@ -60,7 +47,7 @@ def escape_for_text_selector(
         return '"' + text.replace('"', '\\"') + '"'
     if '"' in text or ">>" in text or text[0] == "/":
         suffix = "" if case_sensitive else "i"
-        return re.sub(r"\s+", "\\s+", escape_for_regex(text)) + suffix
+        return "/" + re.sub(r"\s+", "\\\\s+", escape_for_regex(text)) + "/" + suffix
     return text
 
 
diff --git a/setup.py b/setup.py
index ebd8d0e82..f2b76ad1e 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.27.0-alpha-1664914898000"
+driver_version = "1.28.0-alpha-oct-6-2022"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/sync/test_locator_get_by.py b/tests/sync/test_locator_get_by.py
index bc6f6ee05..046c6797b 100644
--- a/tests/sync/test_locator_get_by.py
+++ b/tests/sync/test_locator_get_by.py
@@ -30,7 +30,12 @@ def test_get_by_test_id_escape_id(page: Page) -> None:
 
 
 def test_get_by_text(page: Page) -> None:
-    page.set_content("<div>yo</div><div>ya</div><div>\nye  </div>")
+    page.set_content("<div><div>yo</div><div>ya</div><div>\nye  </div></div>")
+
+    expect(page.get_by_text("yo")).to_have_count(1)
+    expect(page.main_frame.get_by_text("yo")).to_have_count(1)
+    expect(page.locator("div").get_by_text("yo")).to_have_count(1)
+
     assert ">\nye  </div>" in page.get_by_text("ye").evaluate("e => e.outerHTML")
     assert ">\nye  </div>" in page.get_by_text(r"ye").evaluate("e => e.outerHTML")
 
@@ -50,6 +55,11 @@ def test_get_by_label(page: Page) -> None:
     page.set_content(
         "<div><label for=target>Name</label><input id=target type=text></div>"
     )
+
+    expect(page.get_by_label("Name")).to_have_count(1)
+    expect(page.main_frame.get_by_label("Name")).to_have_count(1)
+    expect(page.locator("div").get_by_label("Name")).to_have_count(1)
+
     assert page.get_by_text("Name").evaluate("e => e.nodeName") == "LABEL"
     assert page.get_by_label("Name").evaluate("e => e.nodeName") == "INPUT"
     assert page.main_frame.get_by_label("Name").evaluate("e => e.nodeName") == "INPUT"
@@ -58,6 +68,26 @@ def test_get_by_label(page: Page) -> None:
     )
 
 
+def test_get_by_label_with_nested_elements(page: Page) -> None:
+    page.set_content(
+        "<label for=target>Last <span>Name</span></label><input id=target type=text>"
+    )
+
+    expect(page.get_by_label("last name")).to_have_attribute("id", "target")
+    expect(page.get_by_label("st na")).to_have_attribute("id", "target")
+    expect(page.get_by_label("Name")).to_have_attribute("id", "target")
+    expect(page.get_by_label("Last Name", exact=True)).to_have_attribute("id", "target")
+    expect(
+        page.get_by_label(re.compile(r"Last\s+name", re.IGNORECASE))
+    ).to_have_attribute("id", "target")
+
+    expect(page.get_by_label("Last", exact=True)).to_have_count(0)
+    expect(page.get_by_label("last name", exact=True)).to_have_count(0)
+    expect(page.get_by_label("Name", exact=True)).to_have_count(0)
+    expect(page.get_by_label("what?")).to_have_count(0)
+    expect(page.get_by_label(re.compile(r"last name"))).to_have_count(0)
+
+
 def test_get_by_placeholder(page: Page) -> None:
     page.set_content(
         """<div>
@@ -65,6 +95,11 @@ def test_get_by_placeholder(page: Page) -> None:
     <input placeholder="Hello World">
   </div>"""
     )
+
+    expect(page.get_by_placeholder("hello")).to_have_count(2)
+    expect(page.main_frame.get_by_placeholder("hello")).to_have_count(2)
+    expect(page.locator("div").get_by_placeholder("hello")).to_have_count(2)
+
     expect(page.get_by_placeholder("hello")).to_have_count(2)
     expect(page.get_by_placeholder("Hello", exact=True)).to_have_count(1)
     expect(page.get_by_placeholder(re.compile(r"wor", re.IGNORECASE))).to_have_count(1)
@@ -81,6 +116,11 @@ def test_get_by_alt_text(page: Page) -> None:
     <input alt="Hello World">
   </div>"""
     )
+
+    expect(page.get_by_alt_text("hello")).to_have_count(2)
+    expect(page.main_frame.get_by_alt_text("hello")).to_have_count(2)
+    expect(page.locator("div").get_by_alt_text("hello")).to_have_count(2)
+
     expect(page.get_by_alt_text("hello")).to_have_count(2)
     expect(page.get_by_alt_text("Hello", exact=True)).to_have_count(1)
     expect(page.get_by_alt_text(re.compile(r"wor", re.IGNORECASE))).to_have_count(1)
@@ -97,6 +137,11 @@ def test_get_by_title(page: Page) -> None:
     <input title="Hello World">
   </div>"""
     )
+
+    expect(page.get_by_title("hello")).to_have_count(2)
+    expect(page.main_frame.get_by_title("hello")).to_have_count(2)
+    expect(page.locator("div").get_by_title("hello")).to_have_count(2)
+
     expect(page.get_by_title("hello")).to_have_count(2)
     expect(page.get_by_title("Hello", exact=True)).to_have_count(1)
     expect(page.get_by_title(re.compile(r"wor", re.IGNORECASE))).to_have_count(1)
@@ -104,3 +149,39 @@ def test_get_by_title(page: Page) -> None:
     # Coverage
     expect(page.main_frame.get_by_title("hello")).to_have_count(2)
     expect(page.locator("div").get_by_title("hello")).to_have_count(2)
+
+
+def test_get_by_escaping(page: Page) -> None:
+    page.set_content(
+        """<label id=label for=control>Hello
+wo"rld</label><input id=control />"""
+    )
+    page.locator("input").evaluate(
+        """input => {
+    input.setAttribute('placeholder', 'hello\\nwo"rld');
+    input.setAttribute('title', 'hello\\nwo"rld');
+    input.setAttribute('alt', 'hello\\nwo"rld');
+  }"""
+    )
+    expect(page.get_by_text('hello\nwo"rld')).to_have_attribute("id", "label")
+    expect(page.get_by_label('hello\nwo"rld')).to_have_attribute("id", "control")
+    expect(page.get_by_placeholder('hello\nwo"rld')).to_have_attribute("id", "control")
+    expect(page.get_by_alt_text('hello\nwo"rld')).to_have_attribute("id", "control")
+    expect(page.get_by_title('hello\nwo"rld')).to_have_attribute("id", "control")
+
+    page.set_content(
+        """<label id=label for=control>Hello
+world</label><input id=control />"""
+    )
+    page.locator("input").evaluate(
+        """input => {
+    input.setAttribute('placeholder', 'hello\\nworld');
+    input.setAttribute('title', 'hello\\nworld');
+    input.setAttribute('alt', 'hello\\nworld');
+  }"""
+    )
+    expect(page.get_by_text("hello\nworld")).to_have_attribute("id", "label")
+    expect(page.get_by_label("hello\nworld")).to_have_attribute("id", "control")
+    expect(page.get_by_placeholder("hello\nworld")).to_have_attribute("id", "control")
+    expect(page.get_by_alt_text("hello\nworld")).to_have_attribute("id", "control")
+    expect(page.get_by_title("hello\nworld")).to_have_attribute("id", "control")

From bddee135971c55250c8bf22f10d85ba34c0d4612 Mon Sep 17 00:00:00 2001
From: Pavel Feldman <pavel.feldman@gmail.com>
Date: Thu, 6 Oct 2022 13:08:09 -0800
Subject: [PATCH 003/438] chore: move connect to json pipe (#1580)

---
 meta.yaml                               |  1 -
 playwright/_impl/_browser_type.py       | 18 ++++--
 playwright/_impl/_connection.py         | 13 +++-
 playwright/_impl/_json_pipe.py          | 79 +++++++++++++++++++++++++
 playwright/_impl/_transport.py          | 78 ------------------------
 setup.py                                |  1 -
 tests/async/test_browsertype_connect.py |  2 +-
 tests/sync/test_browsertype_connect.py  |  2 +-
 8 files changed, 106 insertions(+), 88 deletions(-)
 create mode 100644 playwright/_impl/_json_pipe.py

diff --git a/meta.yaml b/meta.yaml
index 8f320bd09..8df796e27 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -25,7 +25,6 @@ requirements:
     - python
     - greenlet ==1.1.3
     - pyee ==8.1.0
-    - websockets ==10.1
     - typing_extensions # [py<39]
 test:
   requires:
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 577bf4058..0eca2c6b7 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -42,7 +42,7 @@
     ServiceWorkersPolicy,
     locals_to_params,
 )
-from playwright._impl._transport import WebSocketTransport
+from playwright._impl._json_pipe import JsonPipeTransport
 from playwright._impl._wait_helper import throw_on_timeout
 
 if TYPE_CHECKING:
@@ -188,12 +188,22 @@ async def connect(
     ) -> Browser:
         if timeout is None:
             timeout = 30000
+        if slow_mo is None:
+            slow_mo = 0
 
         headers = {**(headers if headers else {}), "x-playwright-browser": self.name}
-
-        transport = WebSocketTransport(
-            self._connection._loop, ws_endpoint, headers, slow_mo
+        local_utils = self._connection.local_utils
+        pipe_channel = await local_utils._channel.send(
+            "connect",
+            {
+                "wsEndpoint": ws_endpoint,
+                "headers": headers,
+                "slowMo": slow_mo,
+                "timeout": timeout,
+            },
         )
+        transport = JsonPipeTransport(self._connection._loop, pipe_channel)
+
         connection = Connection(
             self._connection._dispatcher_fiber,
             self._connection._object_factory,
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index fd0b6ac7d..0243d85a1 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -316,6 +316,7 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
             self._objects[guid]._dispose()
             return
         object = self._objects[guid]
+        should_replace_guids_with_channels = "jsonPipe@" not in guid
         try:
             if self._is_sync:
                 for listener in object._channel.listeners(method):
@@ -323,9 +324,17 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
                     # and switch to them in order, until they block inside and pass control to each
                     # other and then eventually back to dispatcher as listener functions return.
                     g = greenlet(listener)
-                    g.switch(self._replace_guids_with_channels(params))
+                    if should_replace_guids_with_channels:
+                        g.switch(self._replace_guids_with_channels(params))
+                    else:
+                        g.switch(params)
             else:
-                object._channel.emit(method, self._replace_guids_with_channels(params))
+                if should_replace_guids_with_channels:
+                    object._channel.emit(
+                        method, self._replace_guids_with_channels(params)
+                    )
+                else:
+                    object._channel.emit(method, params)
         except BaseException as exc:
             print("Error occurred in event listener", file=sys.stderr)
             traceback.print_exc()
diff --git a/playwright/_impl/_json_pipe.py b/playwright/_impl/_json_pipe.py
new file mode 100644
index 000000000..a237a63df
--- /dev/null
+++ b/playwright/_impl/_json_pipe.py
@@ -0,0 +1,79 @@
+# 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 typing import Dict, Optional, cast
+
+from pyee import AsyncIOEventEmitter
+
+from playwright._impl._api_types import Error
+from playwright._impl._connection import Channel
+from playwright._impl._helper import ParsedMessagePayload, parse_error
+from playwright._impl._transport import Transport
+
+
+class JsonPipeTransport(AsyncIOEventEmitter, Transport):
+    def __init__(
+        self,
+        loop: asyncio.AbstractEventLoop,
+        pipe_channel: Channel,
+    ) -> None:
+        super().__init__(loop)
+        Transport.__init__(self, loop)
+        self._stop_requested = False
+        self._pipe_channel = pipe_channel
+
+    def request_stop(self) -> None:
+        self._stop_requested = True
+        self._loop.create_task(self._pipe_channel.send("close", {}))
+
+    def dispose(self) -> None:
+        self.on_error_future.cancel()
+        self._stopped_future.cancel()
+
+    async def wait_until_stopped(self) -> None:
+        await self._stopped_future
+
+    async def connect(self) -> None:
+        self._stopped_future: asyncio.Future = asyncio.Future()
+
+        def handle_message(message: Dict) -> None:
+            if not self._stop_requested:
+                self.on_message(cast(ParsedMessagePayload, message))
+
+        def handle_closed(error: Optional[Dict]) -> None:
+            self.emit("close")
+            self.on_error_future.set_exception(
+                parse_error(error["error"])
+                if error
+                else Error("Playwright connection closed")
+            )
+            self._stopped_future.set_result(None)
+
+        self._pipe_channel.on(
+            "message",
+            lambda params: handle_message(params["message"]),
+        )
+        self._pipe_channel.on(
+            "closed",
+            lambda params: handle_closed(params.get("error")),
+        )
+
+    async def run(self) -> None:
+        await self._stopped_future
+
+    def send(self, message: Dict) -> None:
+        if self._stop_requested:
+            raise Error("Playwright connection closed")
+        self._loop.create_task(self._pipe_channel.send("send", {"message": message}))
diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index 03293236b..d0802c17a 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -22,12 +22,6 @@
 from pathlib import Path
 from typing import Callable, Dict, Optional, Union
 
-import websockets
-import websockets.exceptions
-from pyee import AsyncIOEventEmitter
-from websockets.client import connect as websocket_connect
-
-from playwright._impl._api_types import Error
 from playwright._impl._driver import get_driver_env
 from playwright._impl._helper import ParsedMessagePayload
 
@@ -178,75 +172,3 @@ def send(self, message: Dict) -> None:
         self._output.write(
             len(data).to_bytes(4, byteorder="little", signed=False) + data
         )
-
-
-class WebSocketTransport(AsyncIOEventEmitter, Transport):
-    def __init__(
-        self,
-        loop: asyncio.AbstractEventLoop,
-        ws_endpoint: str,
-        headers: Dict[str, str] = None,
-        slow_mo: float = None,
-    ) -> None:
-        super().__init__(loop)
-        Transport.__init__(self, loop)
-
-        self._stopped = False
-        self.ws_endpoint = ws_endpoint
-        self.headers = headers
-        self.slow_mo = slow_mo
-
-    def request_stop(self) -> None:
-        self._stopped = True
-        self.emit("close")
-        self._loop.create_task(self._connection.close())
-
-    def dispose(self) -> None:
-        self.on_error_future.cancel()
-
-    async def wait_until_stopped(self) -> None:
-        await self._connection.wait_closed()
-
-    async def connect(self) -> None:
-        try:
-            self._connection = await websocket_connect(
-                self.ws_endpoint,
-                extra_headers=self.headers,
-                max_size=256 * 1024 * 1024,  # 256Mb
-            )
-        except Exception as exc:
-            self.on_error_future.set_exception(Error(f"websocket.connect: {str(exc)}"))
-            raise exc
-
-    async def run(self) -> None:
-        while not self._stopped:
-            try:
-                message = await self._connection.recv()
-                if self.slow_mo is not None:
-                    await asyncio.sleep(self.slow_mo / 1000)
-                if self._stopped:
-                    self.on_error_future.set_exception(
-                        Error("Playwright connection closed")
-                    )
-                    break
-                obj = self.deserialize_message(message)
-                self.on_message(obj)
-            except (
-                websockets.exceptions.ConnectionClosed,
-                websockets.exceptions.ConnectionClosedError,
-            ):
-                if not self._stopped:
-                    self.emit("close")
-                self.on_error_future.set_exception(
-                    Error("Playwright connection closed")
-                )
-                break
-            except Exception as exc:
-                self.on_error_future.set_exception(exc)
-                break
-
-    def send(self, message: Dict) -> None:
-        if self._stopped or (hasattr(self, "_connection") and self._connection.closed):
-            raise Error("Playwright connection closed")
-        data = self.serialize_message(message)
-        self._loop.create_task(self._connection.send(data))
diff --git a/setup.py b/setup.py
index f2b76ad1e..d2cd10d00 100644
--- a/setup.py
+++ b/setup.py
@@ -211,7 +211,6 @@ def _download_and_extract_local_driver(
     packages=["playwright"],
     include_package_data=True,
     install_requires=[
-        "websockets==10.1",
         "greenlet==1.1.3",
         "pyee==8.1.0",
         "typing-extensions;python_version<='3.8'",
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index f297892f4..33e9184aa 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -213,7 +213,7 @@ async def test_connect_to_closed_server_without_hangs(
     remote_server.kill()
     with pytest.raises(Error) as exc:
         await browser_type.connect(remote_server.ws_endpoint)
-    assert "websocket.connect: " in exc.value.message
+    assert "WebSocket error: " in exc.value.message
 
 
 async def test_should_fulfill_with_global_fetch_result(
diff --git a/tests/sync/test_browsertype_connect.py b/tests/sync/test_browsertype_connect.py
index bb8c5af5c..8d512db31 100644
--- a/tests/sync/test_browsertype_connect.py
+++ b/tests/sync/test_browsertype_connect.py
@@ -192,7 +192,7 @@ def test_connect_to_closed_server_without_hangs(
     remote_server.kill()
     with pytest.raises(Error) as exc:
         browser_type.connect(remote_server.ws_endpoint)
-    assert "websocket.connect: " in exc.value.message
+    assert "WebSocket error: " in exc.value.message
 
 
 def test_browser_type_connect_should_fulfill_with_global_fetch_result(

From be076b7fc83188a3e59e0631fb1021ad4e9d5274 Mon Sep 17 00:00:00 2001
From: Dmitry Gozman <dgozman@gmail.com>
Date: Fri, 7 Oct 2022 10:10:19 -0700
Subject: [PATCH 004/438] test: add get_by_text escaping with multiple space
 sequences (#1582)

Mirrors upstream test. Implementation is already good.
---
 tests/sync/test_locator_get_by.py | 46 +++++++++++++++++++------------
 1 file changed, 28 insertions(+), 18 deletions(-)

diff --git a/tests/sync/test_locator_get_by.py b/tests/sync/test_locator_get_by.py
index 046c6797b..36d2cc4b8 100644
--- a/tests/sync/test_locator_get_by.py
+++ b/tests/sync/test_locator_get_by.py
@@ -153,35 +153,45 @@ def test_get_by_title(page: Page) -> None:
 
 def test_get_by_escaping(page: Page) -> None:
     page.set_content(
-        """<label id=label for=control>Hello
+        """<label id=label for=control>Hello my
 wo"rld</label><input id=control />"""
     )
     page.locator("input").evaluate(
         """input => {
-    input.setAttribute('placeholder', 'hello\\nwo"rld');
-    input.setAttribute('title', 'hello\\nwo"rld');
-    input.setAttribute('alt', 'hello\\nwo"rld');
+    input.setAttribute('placeholder', 'hello my\\nwo"rld');
+    input.setAttribute('title', 'hello my\\nwo"rld');
+    input.setAttribute('alt', 'hello my\\nwo"rld');
   }"""
     )
-    expect(page.get_by_text('hello\nwo"rld')).to_have_attribute("id", "label")
-    expect(page.get_by_label('hello\nwo"rld')).to_have_attribute("id", "control")
-    expect(page.get_by_placeholder('hello\nwo"rld')).to_have_attribute("id", "control")
-    expect(page.get_by_alt_text('hello\nwo"rld')).to_have_attribute("id", "control")
-    expect(page.get_by_title('hello\nwo"rld')).to_have_attribute("id", "control")
+    expect(page.get_by_text('hello my\nwo"rld')).to_have_attribute("id", "label")
+    expect(page.get_by_text('hello     my         wo"rld')).to_have_attribute(
+        "id", "label"
+    )
+    expect(page.get_by_label('hello my\nwo"rld')).to_have_attribute("id", "control")
+    expect(page.get_by_placeholder('hello my\nwo"rld')).to_have_attribute(
+        "id", "control"
+    )
+    expect(page.get_by_alt_text('hello my\nwo"rld')).to_have_attribute("id", "control")
+    expect(page.get_by_title('hello my\nwo"rld')).to_have_attribute("id", "control")
 
     page.set_content(
-        """<label id=label for=control>Hello
+        """<label id=label for=control>Hello my
 world</label><input id=control />"""
     )
     page.locator("input").evaluate(
         """input => {
-    input.setAttribute('placeholder', 'hello\\nworld');
-    input.setAttribute('title', 'hello\\nworld');
-    input.setAttribute('alt', 'hello\\nworld');
+    input.setAttribute('placeholder', 'hello my\\nworld');
+    input.setAttribute('title', 'hello my\\nworld');
+    input.setAttribute('alt', 'hello my\\nworld');
   }"""
     )
-    expect(page.get_by_text("hello\nworld")).to_have_attribute("id", "label")
-    expect(page.get_by_label("hello\nworld")).to_have_attribute("id", "control")
-    expect(page.get_by_placeholder("hello\nworld")).to_have_attribute("id", "control")
-    expect(page.get_by_alt_text("hello\nworld")).to_have_attribute("id", "control")
-    expect(page.get_by_title("hello\nworld")).to_have_attribute("id", "control")
+    expect(page.get_by_text("hello my\nworld")).to_have_attribute("id", "label")
+    expect(page.get_by_text("hello      my       world")).to_have_attribute(
+        "id", "label"
+    )
+    expect(page.get_by_label("hello my\nworld")).to_have_attribute("id", "control")
+    expect(page.get_by_placeholder("hello my\nworld")).to_have_attribute(
+        "id", "control"
+    )
+    expect(page.get_by_alt_text("hello my\nworld")).to_have_attribute("id", "control")
+    expect(page.get_by_title("hello my\nworld")).to_have_attribute("id", "control")

From 66f7f3a302a67a8db22b90f9080a7133dd85052a Mon Sep 17 00:00:00 2001
From: Pavel Feldman <pavel.feldman@gmail.com>
Date: Fri, 7 Oct 2022 14:08:01 -0800
Subject: [PATCH 005/438] chore: roll to Playwright 1.27 (#1581)

---
 playwright/_impl/_api_structures.py |  86 ++++++
 playwright/_impl/_frame.py          |   4 +-
 playwright/_impl/_locator.py        |  10 +-
 playwright/_impl/_page.py           |   3 +-
 playwright/_impl/_str_utils.py      |   9 +-
 playwright/async_api/_generated.py  | 408 ++++++++++++++++++++++++++--
 playwright/sync_api/_generated.py   | 408 ++++++++++++++++++++++++++--
 setup.py                            |   2 +-
 tests/sync/test_locator_get_by.py   |  16 ++
 9 files changed, 875 insertions(+), 71 deletions(-)

diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index cc0eb39e9..44a55cf7f 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -196,3 +196,89 @@ class FrameExpectResult(TypedDict):
     matches: bool
     received: Any
     log: List[str]
+
+
+AriaRole = Literal[
+    "alert",
+    "alertdialog",
+    "application",
+    "article",
+    "banner",
+    "blockquote",
+    "button",
+    "caption",
+    "cell",
+    "checkbox",
+    "code",
+    "columnheader",
+    "combobox",
+    "complementary",
+    "contentinfo",
+    "definition",
+    "deletion",
+    "dialog",
+    "directory",
+    "document",
+    "emphasis",
+    "feed",
+    "figure",
+    "form",
+    "generic",
+    "grid",
+    "gridcell",
+    "group",
+    "heading",
+    "img",
+    "insertion",
+    "link",
+    "list",
+    "listbox",
+    "listitem",
+    "log",
+    "main",
+    "marquee",
+    "math",
+    "menu",
+    "menubar",
+    "menuitem",
+    "menuitemcheckbox",
+    "menuitemradio",
+    "meter",
+    "navigation",
+    "none",
+    "note",
+    "option",
+    "paragraph",
+    "presentation",
+    "progressbar",
+    "radio",
+    "radiogroup",
+    "region",
+    "row",
+    "rowgroup",
+    "rowheader",
+    "scrollbar",
+    "search",
+    "searchbox",
+    "separator",
+    "slider",
+    "spinbutton",
+    "status",
+    "strong",
+    "subscript",
+    "superscript",
+    "switch",
+    "tab",
+    "table",
+    "tablist",
+    "tabpanel",
+    "term",
+    "textbox",
+    "time",
+    "timer",
+    "toolbar",
+    "tooltip",
+    "tree",
+    "treegrid",
+    "treeite",
+]
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 3a77a00ad..a9b4658f3 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -19,7 +19,7 @@
 
 from pyee import EventEmitter
 
-from playwright._impl._api_structures import FilePayload, Position
+from playwright._impl._api_structures import AriaRole, FilePayload, Position
 from playwright._impl._api_types import Error
 from playwright._impl._connection import (
     ChannelOwner,
@@ -547,7 +547,7 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: AriaRole,
         checked: bool = None,
         disabled: bool = None,
         expanded: bool = None,
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 481d9a155..830d68204 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -30,6 +30,7 @@
 )
 
 from playwright._impl._api_structures import (
+    AriaRole,
     FilePayload,
     FloatRect,
     FrameExpectOptions,
@@ -229,7 +230,7 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: AriaRole,
         checked: bool = None,
         disabled: bool = None,
         expanded: bool = None,
@@ -664,7 +665,7 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: AriaRole,
         checked: bool = None,
         disabled: bool = None,
         expanded: bool = None,
@@ -739,8 +740,7 @@ def get_by_attribute_text_selector(
 ) -> str:
     if isinstance(text, Pattern):
         return f"internal:attr=[{attr_name}=/{text.pattern}/{escape_regex_flags(text)}]"
-    suffix = "s" if exact else "i"
-    return f"internal:attr=[{attr_name}={escape_for_attribute_selector(text)}{suffix}]"
+    return f"internal:attr=[{attr_name}={escape_for_attribute_selector(text, exact=exact)}]"
 
 
 def get_by_label_selector(text: Union[str, Pattern[str]], exact: bool = None) -> str:
@@ -766,7 +766,7 @@ def get_by_text_selector(text: Union[str, Pattern[str]], exact: bool = None) ->
 
 
 def get_by_role_selector(
-    role: str,
+    role: AriaRole,
     checked: bool = None,
     disabled: bool = None,
     expanded: bool = None,
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 118ffb91e..914f32537 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -33,6 +33,7 @@
 
 from playwright._impl._accessibility import Accessibility
 from playwright._impl._api_structures import (
+    AriaRole,
     FilePayload,
     FloatRect,
     PdfMargins,
@@ -752,7 +753,7 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: AriaRole,
         checked: bool = None,
         disabled: bool = None,
         expanded: bool = None,
diff --git a/playwright/_impl/_str_utils.py b/playwright/_impl/_str_utils.py
index 19e8a140b..e524df7f7 100644
--- a/playwright/_impl/_str_utils.py
+++ b/playwright/_impl/_str_utils.py
@@ -51,9 +51,6 @@ def escape_for_text_selector(
     return text
 
 
-def escape_for_attribute_selector(value: str) -> str:
-    # TODO: this should actually be
-    #   cssEscape(value).replace(/\\ /g, ' ')
-    # However, our attribute selectors do not conform to CSS parsing spec,
-    # so we escape them differently.
-    return '"' + value.replace('"', '\\"') + '"'
+def escape_for_attribute_selector(value: str, exact: bool = None) -> str:
+    suffix = "" if exact else "i"
+    return '"' + value.replace('"', '\\"') + '"' + suffix
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index d81253425..6dd11cc60 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -4285,7 +4285,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -4315,7 +4316,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -4344,7 +4346,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -4357,7 +4360,90 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeite",
+        ],
         *,
         checked: typing.Optional[bool] = None,
         disabled: typing.Optional[bool] = None,
@@ -4382,7 +4468,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : str
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -4473,7 +4559,8 @@ def get_by_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -4501,7 +4588,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -5494,7 +5582,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -5524,7 +5613,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -5553,7 +5643,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -5566,7 +5657,90 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeite",
+        ],
         *,
         checked: typing.Optional[bool] = None,
         disabled: typing.Optional[bool] = None,
@@ -5591,7 +5765,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : str
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -5682,7 +5856,8 @@ def get_by_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -5710,7 +5885,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -8924,7 +9100,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -8954,7 +9131,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -8983,7 +9161,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -8996,7 +9175,90 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeite",
+        ],
         *,
         checked: typing.Optional[bool] = None,
         disabled: typing.Optional[bool] = None,
@@ -9021,7 +9283,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : str
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -9112,7 +9374,8 @@ def get_by_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -9140,7 +9403,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -13558,7 +13822,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -13588,7 +13853,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -13617,7 +13883,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -13630,7 +13897,90 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeite",
+        ],
         *,
         checked: typing.Optional[bool] = None,
         disabled: typing.Optional[bool] = None,
@@ -13655,7 +14005,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : str
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -13746,7 +14096,8 @@ def get_by_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -13774,7 +14125,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index b1a55548b..4474ad2ef 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -4366,7 +4366,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -4396,7 +4397,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -4425,7 +4427,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -4438,7 +4441,90 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeite",
+        ],
         *,
         checked: typing.Optional[bool] = None,
         disabled: typing.Optional[bool] = None,
@@ -4463,7 +4549,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : str
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -4554,7 +4640,8 @@ def get_by_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -4582,7 +4669,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -5602,7 +5690,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -5632,7 +5721,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -5661,7 +5751,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -5674,7 +5765,90 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeite",
+        ],
         *,
         checked: typing.Optional[bool] = None,
         disabled: typing.Optional[bool] = None,
@@ -5699,7 +5873,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : str
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -5790,7 +5964,8 @@ def get_by_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -5818,7 +5993,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -8972,7 +9148,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -9002,7 +9179,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -9031,7 +9209,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -9044,7 +9223,90 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeite",
+        ],
         *,
         checked: typing.Optional[bool] = None,
         disabled: typing.Optional[bool] = None,
@@ -9069,7 +9331,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : str
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -9160,7 +9422,8 @@ def get_by_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -9188,7 +9451,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -13625,7 +13889,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -13655,7 +13920,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -13684,7 +13950,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -13697,7 +13964,90 @@ def get_by_placeholder(
 
     def get_by_role(
         self,
-        role: str,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeite",
+        ],
         *,
         checked: typing.Optional[bool] = None,
         disabled: typing.Optional[bool] = None,
@@ -13722,7 +14072,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : str
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -13813,7 +14163,8 @@ def get_by_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
@@ -13841,7 +14192,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
+            expression.
 
         Returns
         -------
diff --git a/setup.py b/setup.py
index d2cd10d00..cc08ce2c2 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.28.0-alpha-oct-6-2022"
+driver_version = "1.27.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/sync/test_locator_get_by.py b/tests/sync/test_locator_get_by.py
index 36d2cc4b8..42939672f 100644
--- a/tests/sync/test_locator_get_by.py
+++ b/tests/sync/test_locator_get_by.py
@@ -195,3 +195,19 @@ def test_get_by_escaping(page: Page) -> None:
     )
     expect(page.get_by_alt_text("hello my\nworld")).to_have_attribute("id", "control")
     expect(page.get_by_title("hello my\nworld")).to_have_attribute("id", "control")
+
+
+def test_get_by_role(page: Page) -> None:
+    page.set_content(
+        """
+    <button>Hello</button>
+    <button>Hel"lo</button>
+    <div role="dialog">I am a dialog</div>
+  """
+    )
+    expect(page.get_by_role("button", name="hello")).to_have_count(1)
+    expect(page.get_by_role("button", name='Hel"lo')).to_have_count(1)
+    expect(
+        page.get_by_role("button", name=re.compile(r"he", re.IGNORECASE))
+    ).to_have_count(2)
+    expect(page.get_by_role("dialog")).to_have_count(1)

From a54664af8b7d833560fa46fc484f0794ed91a040 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 10 Oct 2022 23:02:04 +0300
Subject: [PATCH 006/438] fix: wait_for_function with polling interval (#1586)

---
 playwright/_impl/_frame.py            |  4 ++
 tests/async/test_wait_for_function.py | 91 +++++++++++++++++++++++++++
 2 files changed, 95 insertions(+)
 create mode 100644 tests/async/test_wait_for_function.py

diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index a9b4658f3..879af3715 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -746,8 +746,12 @@ async def wait_for_function(
         timeout: float = None,
         polling: Union[float, Literal["raf"]] = None,
     ) -> JSHandle:
+        if isinstance(polling, str) and polling != "raf":
+            raise Error(f"Unknown polling option: {polling}")
         params = locals_to_params(locals())
         params["arg"] = serialize_argument(arg)
+        if polling is not None and polling != "raf":
+            params["pollingInterval"] = polling
         return from_channel(await self._channel.send("waitForFunction", params))
 
     async def title(self) -> str:
diff --git a/tests/async/test_wait_for_function.py b/tests/async/test_wait_for_function.py
new file mode 100644
index 000000000..da480f323
--- /dev/null
+++ b/tests/async/test_wait_for_function.py
@@ -0,0 +1,91 @@
+# 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 datetime import datetime
+
+import pytest
+
+from playwright.async_api import Error, Page
+
+
+async def test_should_timeout(page: Page):
+    start_time = datetime.now()
+    timeout = 42
+    await page.wait_for_timeout(timeout)
+    assert ((datetime.now() - start_time).microseconds * 1000) >= timeout / 2
+
+
+async def test_should_accept_a_string(page: Page):
+    watchdog = page.wait_for_function("window.__FOO === 1")
+    await page.evaluate("window['__FOO'] = 1")
+    await watchdog
+
+
+async def test_should_work_when_resolved_right_before_execution_context_disposal(
+    page: Page,
+):
+    await page.add_init_script("window['__RELOADED'] = true")
+    await page.wait_for_function(
+        """() => {
+            if (!window['__RELOADED'])
+                window.location.reload();
+            return true;
+        }"""
+    )
+
+
+async def test_should_poll_on_interval(page: Page):
+    polling = 100
+    time_delta = await page.wait_for_function(
+        """() => {
+            if (!window['__startTime']) {
+                window['__startTime'] = Date.now();
+                return false;
+            }
+            return Date.now() - window['__startTime'];
+        }""",
+        polling=polling,
+    )
+    assert await time_delta.json_value() >= polling
+
+
+async def test_should_avoid_side_effects_after_timeout(page: Page):
+    counter = 0
+
+    async def on_console(message):
+        nonlocal counter
+        counter += 1
+
+    page.on("console", on_console)
+    with pytest.raises(Error) as exc_info:
+        await page.wait_for_function(
+            """() => {
+            window['counter'] = (window['counter'] || 0) + 1;
+            console.log(window['counter']);
+        }""",
+            polling=1,
+            timeout=1000,
+        )
+
+    saved_counter = counter
+    await page.wait_for_timeout(2000)  # Give it some time to produce more logs.
+
+    assert "Timeout 1000ms exceeded" in exc_info.value.message
+    assert counter == saved_counter
+
+
+async def test_should_throw_on_polling_mutation(page: Page):
+    with pytest.raises(Error) as exc_info:
+        await page.wait_for_function("() => true", polling="mutation")
+    assert "Unknown polling option: mutation" in exc_info.value.message

From 9fc177717d8fe699b0a2b1c6204256b961989635 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 26 Oct 2022 22:16:14 -0700
Subject: [PATCH 007/438] fix: fix impl to api name memory leak (#1604)

---
 playwright/_impl/_impl_to_api_mapping.py |  6 +++++-
 tests/test_reference_count_async.py      | 19 ++++++++++++++++++-
 2 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/playwright/_impl/_impl_to_api_mapping.py b/playwright/_impl/_impl_to_api_mapping.py
index f0af8ab3e..4d57d3a15 100644
--- a/playwright/_impl/_impl_to_api_mapping.py
+++ b/playwright/_impl/_impl_to_api_mapping.py
@@ -38,8 +38,12 @@ def register(self, impl_class: type, api_class: type) -> None:
         self._mapping[impl_class] = api_class
 
     def from_maybe_impl(
-        self, obj: Any, visited: Map[Any, Union[List, Dict]] = Map()
+        self, obj: Any, visited: Optional[Map[Any, Union[List, Dict]]] = None
     ) -> Any:
+        # Python does share default arguments between calls, so we need to
+        # create a new map if it is not provided.
+        if not visited:
+            visited = Map()
         if not obj:
             return obj
         if isinstance(obj, dict):
diff --git a/tests/test_reference_count_async.py b/tests/test_reference_count_async.py
index 4ee81cb65..345be83a5 100644
--- a/tests/test_reference_count_async.py
+++ b/tests/test_reference_count_async.py
@@ -14,6 +14,7 @@
 
 import gc
 from collections import defaultdict
+from typing import Any
 
 import objgraph
 import pytest
@@ -33,7 +34,20 @@ async def test_memory_objects(server: Server, browser_name: str) -> None:
         for _ in range(100):
             await page.evaluate("""async () => alert()""")
 
-        await page.route("**/", lambda route, _: route.fulfill(body="OK"))
+        await page.route("**/*", lambda route, _: route.fulfill(body="OK"))
+
+        def handle_network_response_received(event: Any) -> None:
+            event["__pw__is_last_network_response_received_event"] = True
+
+        if browser_name == "chromium":
+            # https://github.com/microsoft/playwright-python/issues/1602
+            client = await page.context.new_cdp_session(page)
+            await client.send("Network.enable")
+
+            client.on(
+                "Network.responseReceived",
+                handle_network_response_received,
+            )
 
         for _ in range(100):
             response = await page.evaluate("""async () => (await fetch("/")).text()""")
@@ -46,6 +60,9 @@ async def test_memory_objects(server: Server, browser_name: str) -> None:
     pw_objects: defaultdict = defaultdict(int)
     for o in objgraph.by_type("dict"):
         name = o.get("_type")
+        # https://github.com/microsoft/playwright-python/issues/1602
+        if o.get("__pw__is_last_network_response_received_event", False):
+            assert False
         if not name:
             continue
         pw_objects[name] += 1

From 8ecd961bdb532dc658151f1fa2c9ecc9b062182c Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 27 Oct 2022 09:31:54 -0700
Subject: [PATCH 008/438] chore: don't use a function call in default
 initializer (#1606)

---
 playwright/_impl/_impl_to_api_mapping.py | 6 +++++-
 playwright/_impl/_js_handle.py           | 8 ++++++--
 pyproject.toml                           | 1 +
 3 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/playwright/_impl/_impl_to_api_mapping.py b/playwright/_impl/_impl_to_api_mapping.py
index 4d57d3a15..332d9a4d9 100644
--- a/playwright/_impl/_impl_to_api_mapping.py
+++ b/playwright/_impl/_impl_to_api_mapping.py
@@ -87,7 +87,11 @@ def from_impl_list(self, items: List[Any]) -> List[Any]:
     def from_impl_dict(self, map: Dict[str, Any]) -> Dict[str, Any]:
         return {name: self.from_impl(value) for name, value in map.items()}
 
-    def to_impl(self, obj: Any, visited: Map[Any, Union[List, Dict]] = Map()) -> Any:
+    def to_impl(
+        self, obj: Any, visited: Optional[Map[Any, Union[List, Dict]]] = None
+    ) -> Any:
+        if visited is None:
+            visited = Map()
         try:
             if not obj:
                 return obj
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 479dae7d6..7e1513667 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -105,8 +105,10 @@ async def json_value(self) -> Any:
 
 
 def serialize_value(
-    value: Any, handles: List[JSHandle], visitor_info: VisitorInfo = VisitorInfo()
+    value: Any, handles: List[JSHandle], visitor_info: Optional[VisitorInfo] = None
 ) -> Any:
+    if visitor_info is None:
+        visitor_info = VisitorInfo()
     if isinstance(value, JSHandle):
         h = len(handles)
         handles.append(value._channel)
@@ -160,7 +162,9 @@ def serialize_argument(arg: Serializable = None) -> Any:
     return dict(value=value, handles=handles)
 
 
-def parse_value(value: Any, refs: Dict[int, Any] = {}) -> Any:
+def parse_value(value: Any, refs: Optional[Dict[int, Any]] = None) -> Any:
+    if refs is None:
+        refs = {}
     if value is None:
         return None
     if isinstance(value, dict):
diff --git a/pyproject.toml b/pyproject.toml
index b5dd6be80..1c6ec53f1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -36,3 +36,4 @@ ignore = ["tests/async/", "scripts/", "examples/"]
 pythonVersion = "3.7"
 reportMissingImports = false
 reportTypedDictNotRequiredAccess = false
+reportCallInDefaultInitializer = true

From 51e416b9cee7ea2789ddfc2e8bdc8657ef5a2954 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 28 Oct 2022 10:54:00 -0700
Subject: [PATCH 009/438] devops: use official (non RC) Python 3.11 version
 (#1612)

---
 .github/workflows/ci.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 876865996..01eaf6623 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -84,13 +84,13 @@ jobs:
           python-version: '3.10'
           browser: chromium
         - os: windows-latest
-          python-version: '3.11.0-rc.1'
+          python-version: '3.11'
           browser: chromium
         - os: macos-latest
-          python-version: '3.11.0-rc.1'
+          python-version: '3.11'
           browser: chromium
         - os: ubuntu-latest
-          python-version: '3.11.0-rc.1'
+          python-version: '3.11'
           browser: chromium
     runs-on: ${{ matrix.os }}
     steps:

From 690fa21b18c40f11c814e7e18cf9fdff3afa3ebf Mon Sep 17 00:00:00 2001
From: Frazer McLean <frazer@frazermclean.co.uk>
Date: Fri, 28 Oct 2022 20:23:22 +0200
Subject: [PATCH 010/438] chore: use SPDX license expression in project
 metadata (#1611)

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

diff --git a/setup.py b/setup.py
index cc08ce2c2..7298d1531 100644
--- a/setup.py
+++ b/setup.py
@@ -204,6 +204,7 @@ def _download_and_extract_local_driver(
     description="A high-level API to automate web browsers",
     long_description=Path("README.md").read_text(encoding="utf-8"),
     long_description_content_type="text/markdown",
+    license="Apache-2.0",
     url="https://github.com/Microsoft/playwright-python",
     project_urls={
         "Release notes": "https://github.com/microsoft/playwright-python/releases",

From de0f00300b8d5af1302f4f6a98e5d40268aa7e0d Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Sun, 30 Oct 2022 21:23:38 -0700
Subject: [PATCH 011/438] devops: update repo for internal tests

---
 .github/workflows/trigger_internal_tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/trigger_internal_tests.yml b/.github/workflows/trigger_internal_tests.yml
index 66096d497..b4e6c21db 100644
--- a/.github/workflows/trigger_internal_tests.yml
+++ b/.github/workflows/trigger_internal_tests.yml
@@ -16,6 +16,6 @@ jobs:
           -H "Accept: application/vnd.github.v3+json" \
           -H "Authorization: token ${GH_TOKEN}" \
           --data "{\"event_type\": \"playwright_tests_python\", \"client_payload\": {\"ref\": \"${GITHUB_SHA}\"}}" \
-          https://api.github.com/repos/microsoft/playwright-internal/dispatches
+          https://api.github.com/repos/microsoft/playwright-browsers/dispatches
       env:
         GH_TOKEN: ${{ secrets.REPOSITORY_DISPATCH_PERSONAL_ACCESS_TOKEN }}

From 9b2d68289605f3ef37c1872896e0713cdf1f2e13 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 2 Nov 2022 13:18:47 -0700
Subject: [PATCH 012/438] devops: upgrade GitHub Actions (#1623)

---
 .github/workflows/ci.yml                     | 20 ++++++++++----------
 .github/workflows/publish.yml                |  6 +++---
 .github/workflows/publish_canary_docker.yml  |  6 +++---
 .github/workflows/publish_release_docker.yml |  6 +++---
 .github/workflows/test_docker.yml            |  4 ++--
 5 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 01eaf6623..64b87b054 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -21,9 +21,9 @@ jobs:
     name: Lint
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: "3.10"
     - name: Install dependencies & browsers
@@ -34,7 +34,7 @@ jobs:
         python setup.py bdist_wheel
         python -m playwright install --with-deps
     - name: Lint
-      uses: pre-commit/action@v2.0.3
+      run: pre-commit run --show-diff-on-failure --color=always --all-files
     - name: Generate APIs
       run: bash scripts/update_api.sh
     - name: Verify generated API is up to date
@@ -94,9 +94,9 @@ jobs:
           browser: chromium
     runs-on: ${{ matrix.os }}
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies & browsers
@@ -126,7 +126,7 @@ jobs:
     - name: Test Async API
       if: matrix.os == 'ubuntu-latest'
       run: xvfb-run pytest tests/async --browser=${{ matrix.browser }} --timeout 90
-    - uses: actions/upload-artifact@v2
+    - uses: actions/upload-artifact@v3
       if: failure()
       with:
         name: ${{ matrix.browser }}-${{ matrix.os }}-${{ matrix.python-version }}
@@ -150,9 +150,9 @@ jobs:
           browser-channel: msedge
     runs-on: ${{ matrix.os }}
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: "3.10"
     - name: Install dependencies & browsers
@@ -176,7 +176,7 @@ jobs:
     - name: Test Async API
       if: matrix.os == 'ubuntu-latest'
       run: xvfb-run pytest tests/async --browser=chromium --browser-channel=${{ matrix.browser-channel }} --timeout 90
-    - uses: actions/upload-artifact@v2
+    - uses: actions/upload-artifact@v3
       if: failure()
       with:
         name: ${{ matrix.browser-channel }}-${{ matrix.os }}
@@ -190,7 +190,7 @@ jobs:
         os: [ubuntu-20.04, macos-10.15, windows-2019]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
         with:
           fetch-depth: 0
       - name: Get conda
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index a144c237b..2f3ce0a27 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -6,9 +6,9 @@ jobs:
   deploy-pypi:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: 3.9
     - name: Install dependencies
@@ -30,7 +30,7 @@ jobs:
         os: [ubuntu-latest, windows-latest, macos-latest]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
         with:
           fetch-depth: 0
       - name: Get conda
diff --git a/.github/workflows/publish_canary_docker.yml b/.github/workflows/publish_canary_docker.yml
index 0cb39c8c1..e5a962b49 100644
--- a/.github/workflows/publish_canary_docker.yml
+++ b/.github/workflows/publish_canary_docker.yml
@@ -11,9 +11,9 @@ jobs:
     runs-on: ubuntu-20.04
     if: github.repository == 'microsoft/playwright-python'
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: "3.10"
     - name: Install dependencies & browsers
@@ -27,7 +27,7 @@ jobs:
         username: playwright
         password: ${{ secrets.DOCKER_PASSWORD }}
     - name: Set up Docker QEMU for arm64 docker builds
-      uses: docker/setup-qemu-action@v1
+      uses: docker/setup-qemu-action@v2
       with:
         platforms: arm64
     - name: publish docker canary
diff --git a/.github/workflows/publish_release_docker.yml b/.github/workflows/publish_release_docker.yml
index 38f110674..9f255ad7a 100644
--- a/.github/workflows/publish_release_docker.yml
+++ b/.github/workflows/publish_release_docker.yml
@@ -17,9 +17,9 @@ jobs:
     runs-on: ubuntu-20.04
     if: github.repository == 'microsoft/playwright-python'
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: "3.10"
     - uses: azure/docker-login@v1
@@ -28,7 +28,7 @@ jobs:
         username: playwright
         password: ${{ secrets.DOCKER_PASSWORD }}
     - name: Set up Docker QEMU for arm64 docker builds
-      uses: docker/setup-qemu-action@v1
+      uses: docker/setup-qemu-action@v2
       with:
         platforms: arm64
     - name: Install dependencies & browsers
diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index f7a1b2dce..8f4fa8a92 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -27,9 +27,9 @@ jobs:
           - focal
           - jammy
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: "3.10"
     - name: Install dependencies

From f123f8f64babf35800856a60f077579db6968ca7 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 2 Nov 2022 14:23:14 -0700
Subject: [PATCH 013/438] chore: bump linters (pre-commit) (#1624)

---
 .pre-commit-config.yaml                              |  8 ++++----
 .../_impl/__pyinstaller/hook-playwright.async_api.py |  2 +-
 .../_impl/__pyinstaller/hook-playwright.sync_api.py  |  2 +-
 pyproject.toml                                       |  3 +++
 tests/async/test_browsercontext.py                   |  2 +-
 tests/async/test_console.py                          |  2 +-
 tests/async/test_device_descriptors.py               | 12 ++++++------
 tests/async/test_geolocation.py                      |  6 +++---
 tests/async/test_interception.py                     |  2 +-
 tests/async/test_locators.py                         |  4 ++--
 tests/async/test_navigation.py                       | 12 ++++++------
 tests/async/test_page.py                             |  4 ++--
 tests/async/test_popup.py                            |  2 +-
 tests/async/test_wait_for_url.py                     |  4 ++--
 tests/async/test_worker.py                           |  2 +-
 tests/sync/test_browsercontext_request_fallback.py   |  2 +-
 tests/sync/test_console.py                           |  4 ++--
 tests/sync/test_fetch_global.py                      |  4 ++--
 tests/sync/test_locators.py                          |  4 ++--
 tests/sync/test_page_request_fallback.py             |  2 +-
 tests/sync/test_sync.py                              |  2 +-
 tests/sync/test_video.py                             |  1 +
 22 files changed, 45 insertions(+), 41 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 57a4a82e8..e9ed64323 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -15,14 +15,14 @@ repos:
       - id: check-executables-have-shebangs
       - id: check-merge-conflict
   - repo: https://github.com/psf/black
-    rev: 22.6.0
+    rev: 22.10.0
     hooks:
       - id: black
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v0.971
+    rev: v0.982
     hooks:
       - id: mypy
-        additional_dependencies: [types-pyOpenSSL==21.0.3]
+        additional_dependencies: [types-pyOpenSSL==22.1.0.1]
         exclude: examples/
   - repo: https://github.com/pycqa/flake8
     rev: 5.0.4
@@ -40,4 +40,4 @@ repos:
         language: node
         pass_filenames: false
         types: [python]
-        additional_dependencies: ["pyright@1.1.210"]
+        additional_dependencies: ["pyright@1.1.278"]
diff --git a/playwright/_impl/__pyinstaller/hook-playwright.async_api.py b/playwright/_impl/__pyinstaller/hook-playwright.async_api.py
index cfb75c532..0300f0c0d 100644
--- a/playwright/_impl/__pyinstaller/hook-playwright.async_api.py
+++ b/playwright/_impl/__pyinstaller/hook-playwright.async_api.py
@@ -12,6 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from PyInstaller.utils.hooks import collect_data_files
+from PyInstaller.utils.hooks import collect_data_files  # type: ignore
 
 datas = collect_data_files("playwright")
diff --git a/playwright/_impl/__pyinstaller/hook-playwright.sync_api.py b/playwright/_impl/__pyinstaller/hook-playwright.sync_api.py
index cfb75c532..0300f0c0d 100644
--- a/playwright/_impl/__pyinstaller/hook-playwright.sync_api.py
+++ b/playwright/_impl/__pyinstaller/hook-playwright.sync_api.py
@@ -12,6 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from PyInstaller.utils.hooks import collect_data_files
+from PyInstaller.utils.hooks import collect_data_files  # type: ignore
 
 datas = collect_data_files("playwright")
diff --git a/pyproject.toml b/pyproject.toml
index 1c6ec53f1..4fd73ed8c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -37,3 +37,6 @@ pythonVersion = "3.7"
 reportMissingImports = false
 reportTypedDictNotRequiredAccess = false
 reportCallInDefaultInitializer = true
+reportOptionalSubscript = false
+reportUnboundVariable = false
+strictParameterNoneValue = false
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index a21996272..0c98f8551 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -681,7 +681,7 @@ async def test_page_event_should_have_an_opener(context, server):
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     async with context.expect_page() as page_info:
-        await page.goto(server.PREFIX + "/popup/window-open.html"),
+        await page.goto(server.PREFIX + "/popup/window-open.html")
     popup = await page_info.value
     assert popup.url == server.PREFIX + "/popup/popup.html"
     assert await popup.opener() == page
diff --git a/tests/async/test_console.py b/tests/async/test_console.py
index 4345e8e41..82b262633 100644
--- a/tests/async/test_console.py
+++ b/tests/async/test_console.py
@@ -111,7 +111,7 @@ async def test_console_should_trigger_correct_log(page, server):
 async def test_console_should_have_location_for_console_api_calls(page, server):
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_console_message() as message_info:
-        await page.goto(server.PREFIX + "/consolelog.html"),
+        await page.goto(server.PREFIX + "/consolelog.html")
     message = await message_info.value
     assert message.text == "yellow"
     assert message.type == "log"
diff --git a/tests/async/test_device_descriptors.py b/tests/async/test_device_descriptors.py
index bd71679b4..e8ca64625 100644
--- a/tests/async/test_device_descriptors.py
+++ b/tests/async/test_device_descriptors.py
@@ -21,15 +21,15 @@ async def test_should_work(playwright, launch_arguments) -> None:
 
     assert device_descriptor["viewport"]["height"] > 700
     assert device_descriptor["viewport"]["height"] < 800
-    inner_height = await page.evaluate("window.innerHeight")
-    inner_height > 700
-    inner_height < 800
+    inner_height = await page.evaluate("window.screen.availHeight")
+    assert inner_height > 700
+    assert inner_height < 800
 
     assert device_descriptor["viewport"]["width"] > 400
     assert device_descriptor["viewport"]["width"] < 500
-    inner_width = await page.evaluate("window.innerWidth")
-    inner_width > 400
-    inner_width < 500
+    inner_width = await page.evaluate("window.screen.availWidth")
+    assert inner_width > 400
+    assert inner_width < 500
 
     assert device_descriptor["has_touch"]
     assert device_descriptor["is_mobile"]
diff --git a/tests/async/test_geolocation.py b/tests/async/test_geolocation.py
index d05b8e7de..40b166ee2 100644
--- a/tests/async/test_geolocation.py
+++ b/tests/async/test_geolocation.py
@@ -112,9 +112,9 @@ async def test_watch_position_should_be_notified(page, server, context):
         await context.set_geolocation({"latitude": 40, "longitude": 50})
 
     all_messages = "|".join(messages)
-    "latitude=0 lng=10" in all_messages
-    "latitude=20 lng=30" in all_messages
-    "latitude=40 lng=50" in all_messages
+    assert "lat=0 lng=10" in all_messages
+    assert "lat=20 lng=30" in all_messages
+    assert "lat=40 lng=50" in all_messages
 
 
 async def test_should_use_context_options_for_popup(page, context, server):
diff --git a/tests/async/test_interception.py b/tests/async/test_interception.py
index 5c89bb75a..439f68125 100644
--- a/tests/async/test_interception.py
+++ b/tests/async/test_interception.py
@@ -103,7 +103,7 @@ async def test_page_route_should_work_when_POST_is_redirected_with_302(page, ser
     """
     )
     async with page.expect_navigation():
-        await page.eval_on_selector("form", "form => form.submit()"),
+        await page.eval_on_selector("form", "form => form.submit()")
 
 
 # @see https://github.com/GoogleChrome/puppeteer/issues/3973
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index bf4ec8f8d..828f145bb 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -327,7 +327,7 @@ async def test_locators_should_upload_a_file(page: Page, server: Server):
 async def test_locators_should_press(page: Page):
     await page.set_content("<input type='text' />")
     await page.locator("input").press("h")
-    await page.eval_on_selector("input", "input => input.value") == "h"
+    assert await page.eval_on_selector("input", "input => input.value") == "h"
 
 
 async def test_locators_should_scroll_into_view(page: Page, server: Server):
@@ -363,7 +363,7 @@ async def test_locators_should_select_textarea(
 async def test_locators_should_type(page: Page):
     await page.set_content("<input type='text' />")
     await page.locator("input").type("hello")
-    await page.eval_on_selector("input", "input => input.value") == "hello"
+    assert await page.eval_on_selector("input", "input => input.value") == "hello"
 
 
 async def test_locators_should_screenshot(
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index cadd3a4d2..3a921373e 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -464,7 +464,7 @@ async def test_wait_for_nav_should_work_with_clicking_on_anchor_links(page, serv
     await page.goto(server.EMPTY_PAGE)
     await page.set_content('<a href="#foobar">foobar</a>')
     async with page.expect_navigation() as response_info:
-        await page.click("a"),
+        await page.click("a")
     response = await response_info.value
     assert response is None
     assert page.url == server.EMPTY_PAGE + "#foobar"
@@ -477,7 +477,7 @@ async def test_wait_for_nav_should_work_with_clicking_on_links_which_do_not_comm
     await page.set_content(f"<a href='{https_server.EMPTY_PAGE}'>foobar</a>")
     with pytest.raises(Error) as exc_info:
         async with page.expect_navigation():
-            await page.click("a"),
+            await page.click("a")
     expect_ssl_error(exc_info.value.message, browser_name)
 
 
@@ -492,7 +492,7 @@ async def test_wait_for_nav_should_work_with_history_push_state(page, server):
     """
     )
     async with page.expect_navigation() as response_info:
-        await page.click("a"),
+        await page.click("a")
     response = await response_info.value
     assert response is None
     assert page.url == server.PREFIX + "/wow.html"
@@ -509,7 +509,7 @@ async def test_wait_for_nav_should_work_with_history_replace_state(page, server)
     """
     )
     async with page.expect_navigation() as response_info:
-        await page.click("a"),
+        await page.click("a")
     response = await response_info.value
     assert response is None
     assert page.url == server.PREFIX + "/replaced.html"
@@ -531,12 +531,12 @@ async def test_wait_for_nav_should_work_with_dom_history_back_forward(page, serv
     )
     assert page.url == server.PREFIX + "/second.html"
     async with page.expect_navigation() as back_response_info:
-        await page.click("a#back"),
+        await page.click("a#back")
     back_response = await back_response_info.value
     assert back_response is None
     assert page.url == server.PREFIX + "/first.html"
     async with page.expect_navigation() as forward_response_info:
-        await page.click("a#forward"),
+        await page.click("a#forward")
     forward_response = await forward_response_info.value
     assert forward_response is None
     assert page.url == server.PREFIX + "/second.html"
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 3254188c6..71a63b51c 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -174,7 +174,7 @@ async def test_async_stacks_should_work(page, server):
 
 async def test_opener_should_provide_access_to_the_opener_page(page):
     async with page.expect_popup() as popup_info:
-        await page.evaluate("window.open('about:blank')"),
+        await page.evaluate("window.open('about:blank')")
     popup = await popup_info.value
     opener = await popup.opener()
     assert opener == page
@@ -182,7 +182,7 @@ async def test_opener_should_provide_access_to_the_opener_page(page):
 
 async def test_opener_should_return_null_if_parent_page_has_been_closed(page):
     async with page.expect_popup() as popup_info:
-        await page.evaluate("window.open('about:blank')"),
+        await page.evaluate("window.open('about:blank')")
     popup = await popup_info.value
     await page.close()
     opener = await popup.opener()
diff --git a/tests/async/test_popup.py b/tests/async/test_popup.py
index e740ad76e..58804f3ba 100644
--- a/tests/async/test_popup.py
+++ b/tests/async/test_popup.py
@@ -54,7 +54,7 @@ async def handle_request(route: Route) -> None:
 
     await context.route("**/empty.html", handle_request)
     async with context.expect_page():
-        await page.click("a"),
+        await page.click("a")
     assert intercepted == [True]
 
 
diff --git a/tests/async/test_wait_for_url.py b/tests/async/test_wait_for_url.py
index 40d400035..974d795d3 100644
--- a/tests/async/test_wait_for_url.py
+++ b/tests/async/test_wait_for_url.py
@@ -102,11 +102,11 @@ async def test_wait_for_url_should_work_with_dom_history_back_forward(
 
     assert page.url == server.PREFIX + "/second.html"
 
-    await page.click("a#back"),
+    await page.click("a#back")
     await page.wait_for_url("**/first.html")
     assert page.url == server.PREFIX + "/first.html"
 
-    await page.click("a#forward"),
+    await page.click("a#forward")
     await page.wait_for_url("**/second.html")
     assert page.url == server.PREFIX + "/second.html"
 
diff --git a/tests/async/test_worker.py b/tests/async/test_worker.py
index b9adf916d..fb6d62b18 100644
--- a/tests/async/test_worker.py
+++ b/tests/async/test_worker.py
@@ -139,7 +139,7 @@ async def test_workers_should_clear_upon_cross_process_navigation(server, page):
 
 async def test_workers_should_report_network_activity(page, server):
     async with page.expect_worker() as worker_info:
-        await page.goto(server.PREFIX + "/worker/worker.html"),
+        await page.goto(server.PREFIX + "/worker/worker.html")
     worker = await worker_info.value
     url = server.PREFIX + "/one-style.css"
     async with page.expect_request(url) as request_info, page.expect_response(
diff --git a/tests/sync/test_browsercontext_request_fallback.py b/tests/sync/test_browsercontext_request_fallback.py
index 8070edffd..85a7d4be6 100644
--- a/tests/sync/test_browsercontext_request_fallback.py
+++ b/tests/sync/test_browsercontext_request_fallback.py
@@ -290,7 +290,7 @@ def test_should_amend_post_data(
     context.route("**/*", lambda route: route.fallback(post_data="doggo"))
 
     with server.expect_request("/sleep.zzz") as server_request_info:
-        page.evaluate("() => fetch('/sleep.zzz', { method: 'POST', body: 'birdy' })"),
+        page.evaluate("() => fetch('/sleep.zzz', { method: 'POST', body: 'birdy' })")
     server_request = server_request_info.value
     assert post_data == ["doggo"]
     assert server_request.post_body == b"doggo"
diff --git a/tests/sync/test_console.py b/tests/sync/test_console.py
index 5ba9d2e76..73cd9f659 100644
--- a/tests/sync/test_console.py
+++ b/tests/sync/test_console.py
@@ -24,7 +24,7 @@ def test_console_should_work(page: Page, browser_name: str) -> None:
     messages: List[ConsoleMessage] = []
     page.once("console", lambda m: messages.append(m))
     with page.expect_console_message():
-        page.evaluate('() => console.log("hello", 5, {foo: "bar"})'),
+        page.evaluate('() => console.log("hello", 5, {foo: "bar"})')
     assert len(messages) == 1
     message = messages[0]
     if browser_name != "firefox":
@@ -108,7 +108,7 @@ def test_console_should_not_fail_for_window_object(
 def test_console_should_trigger_correct_Log(page: Page, server: Server) -> None:
     page.goto("about:blank")
     with page.expect_console_message() as message:
-        page.evaluate("url => fetch(url).catch(e => {})", server.EMPTY_PAGE),
+        page.evaluate("url => fetch(url).catch(e => {})", server.EMPTY_PAGE)
     assert "Access-Control-Allow-Origin" in message.value.text
     assert message.value.type == "error"
 
diff --git a/tests/sync/test_fetch_global.py b/tests/sync/test_fetch_global.py
index 737c2e801..6cdf9b223 100644
--- a/tests/sync/test_fetch_global.py
+++ b/tests/sync/test_fetch_global.py
@@ -79,7 +79,7 @@ def test_should_propagate_extra_http_headers_with_redirects(
     with server.expect_request("/a/redirect1") as server_req1:
         with server.expect_request("/b/c/redirect2") as server_req2:
             with server.expect_request("/simple.json") as server_req3:
-                request.get(f"{server.PREFIX}/a/redirect1"),
+                request.get(f"{server.PREFIX}/a/redirect1")
     assert server_req1.value.getHeader("my-secret") == "Value"
     assert server_req2.value.getHeader("my-secret") == "Value"
     assert server_req3.value.getHeader("my-secret") == "Value"
@@ -142,7 +142,7 @@ def test_should_use_playwright_as_a_user_agent(
 ) -> None:
     request = playwright.request.new_context()
     with server.expect_request("/empty.html") as server_req:
-        request.get(server.EMPTY_PAGE),
+        request.get(server.EMPTY_PAGE)
     assert str(server_req.value.getHeader("User-Agent")).startswith("Playwright/")
     request.dispose()
 
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index a481ebe7d..6e204336c 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -320,7 +320,7 @@ def test_locators_should_upload_a_file(page: Page, server: Server) -> None:
 def test_locators_should_press(page: Page) -> None:
     page.set_content("<input type='text' />")
     page.locator("input").press("h")
-    page.eval_on_selector("input", "input => input.value") == "h"
+    assert page.eval_on_selector("input", "input => input.value") == "h"
 
 
 def test_locators_should_scroll_into_view(page: Page, server: Server) -> None:
@@ -356,7 +356,7 @@ def test_locators_should_select_textarea(
 def test_locators_should_type(page: Page) -> None:
     page.set_content("<input type='text' />")
     page.locator("input").type("hello")
-    page.eval_on_selector("input", "input => input.value") == "hello"
+    assert page.eval_on_selector("input", "input => input.value") == "hello"
 
 
 def test_locators_should_screenshot(
diff --git a/tests/sync/test_page_request_fallback.py b/tests/sync/test_page_request_fallback.py
index 770dda371..0529ecdc7 100644
--- a/tests/sync/test_page_request_fallback.py
+++ b/tests/sync/test_page_request_fallback.py
@@ -270,7 +270,7 @@ def test_should_amend_post_data(page: Page, server: Server) -> None:
     page.route("**/*", lambda route: route.fallback(post_data="doggo"))
 
     with server.expect_request("/sleep.zzz") as server_request_info:
-        page.evaluate("() => fetch('/sleep.zzz', { method: 'POST', body: 'birdy' })"),
+        page.evaluate("() => fetch('/sleep.zzz', { method: 'POST', body: 'birdy' })")
     server_request = server_request_info.value
     assert post_data == ["doggo"]
     assert server_request.post_body == b"doggo"
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index 134727141..6ab859038 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -190,7 +190,7 @@ def test_sync_network_events(page: Page, server: Server) -> None:
 def test_console_should_work(page: Page, browser_name: str) -> None:
     messages = []
     page.once("console", lambda m: messages.append(m))
-    page.evaluate('() => console.log("hello", 5, {foo: "bar"})'),
+    page.evaluate('() => console.log("hello", 5, {foo: "bar"})')
     assert len(messages) == 1
     message = messages[0]
     if browser_name != "firefox":
diff --git a/tests/sync/test_video.py b/tests/sync/test_video.py
index 7f9467a06..9ef7a93ee 100644
--- a/tests/sync/test_video.py
+++ b/tests/sync/test_video.py
@@ -105,6 +105,7 @@ def test_should_error_if_page_not_closed_before_save_as(
         video = page.video
         assert video
         video.save_as(out_path)
+    assert video
     assert "Page is not yet closed. Close the page prior to calling save_as" in str(err)
     assert not os.path.exists(out_path)
     page.context.close()

From 0ada04ff7bf19a7a08a7507493e9613dddcfd688 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 2 Nov 2022 14:29:54 -0700
Subject: [PATCH 014/438] chore: follow-up to reduce memory footprint (#1625)

---
 playwright/_impl/_js_handle.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 7e1513667..d0b72dcc7 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -13,7 +13,6 @@
 # limitations under the License.
 
 import math
-from dataclasses import dataclass
 from datetime import datetime
 from typing import TYPE_CHECKING, Any, Dict, List, Optional
 from urllib.parse import ParseResult, urlparse, urlunparse
@@ -28,10 +27,13 @@
 Serializable = Any
 
 
-@dataclass
 class VisitorInfo:
-    visited: Map[Any, int] = Map()
-    last_id: int = 0
+    visited: Map[Any, int]
+    last_id: int
+
+    def __init__(self) -> None:
+        self.visited = Map()
+        self.last_id = 0
 
     def visit(self, obj: Any) -> int:
         assert obj not in self.visited

From cb2e94c7828b2a7466acc5a204d1ebc00d404ad0 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 2 Nov 2022 18:15:51 -0700
Subject: [PATCH 015/438] chore: update dev dependencies (#1626)

---
 local-requirements.txt | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index ab9f8289e..6e8e9a618 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,24 +1,24 @@
-auditwheel==5.1.2
+auditwheel==5.2.1
 autobahn==22.7.1
-black==22.6.0
+black==22.10.0
 flake8==5.0.4
 flaky==3.7.0
-mypy==0.971
+mypy==0.982
 objgraph==3.5.0
-Pillow==9.2.0
+Pillow==9.3.0
 pixelmatch==0.3.0
 pre-commit==2.20.0
-pyOpenSSL==22.0.0
-pytest==7.1.2
-pytest-asyncio==0.19.0
-pytest-cov==3.0.0
+pyOpenSSL==22.1.0
+pytest==7.2.0
+pytest-asyncio==0.20.1
+pytest-cov==4.0.0
 pytest-repeat==0.9.1
 pytest-timeout==2.1.0
-pytest-xdist==2.5.0
+pytest-xdist==3.0.2
 requests==2.28.1
 service_identity==21.1.0
-setuptools==60.9.3
+setuptools==65.5.0
 twine==4.0.1
-twisted==22.4.0
-types-pyOpenSSL==22.0.10
+twisted==22.10.0
+types-pyOpenSSL==22.1.0.1
 wheel==0.37.1

From 843d96e2e4db49274e20b591be0beee8a8c2b2a0 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 3 Nov 2022 14:28:26 -0700
Subject: [PATCH 016/438] chore(roll): roll Playwright to
 1.28.0-alpha-nov-2-2022 (#1627)

---
 README.md                                   |   4 +-
 playwright/_impl/_api_structures.py         |   2 +-
 playwright/_impl/_browser.py                |  10 +-
 playwright/_impl/_browser_type.py           |   4 +-
 playwright/_impl/_element_handle.py         |   9 +
 playwright/_impl/_frame.py                  |  42 +-
 playwright/_impl/_helper.py                 |   6 +-
 playwright/_impl/_locator.py                |  28 +-
 playwright/_impl/_page.py                   |  33 +-
 playwright/_impl/_str_utils.py              |   8 +-
 playwright/async_api/_generated.py          | 559 +++++++++++++++----
 playwright/sync_api/_generated.py           | 567 ++++++++++++++++----
 setup.py                                    |   2 +-
 tests/async/test_accessibility.py           |  70 ---
 tests/async/test_assertions.py              |   9 -
 tests/async/test_browsertype_connect_cdp.py |   6 +-
 tests/async/test_element_handle.py          |  10 +
 tests/async/test_fill.py                    |  30 ++
 tests/async/test_locators.py                |  47 ++
 tests/async/test_network.py                 |   2 +-
 tests/async/test_page.py                    |  10 +-
 tests/async/test_popup.py                   |  12 +-
 tests/async/test_selectors_text.py          |  35 ++
 tests/async/test_tracing.py                 |  21 +
 tests/server.py                             |  12 +-
 tests/sync/test_accessibility.py            |  72 ---
 tests/sync/test_assertions.py               |   9 -
 tests/sync/test_browsertype_connect_cdp.py  |   2 +-
 tests/sync/test_element_handle.py           |  10 +
 tests/sync/test_fill.py                     |  55 ++
 tests/sync/test_locators.py                 |  45 ++
 tests/sync/test_network.py                  |   2 +-
 tests/sync/test_page.py                     |   8 +
 tests/sync/test_tracing.py                  |  21 +
 34 files changed, 1355 insertions(+), 407 deletions(-)
 create mode 100644 tests/async/test_selectors_text.py
 create mode 100644 tests/sync/test_fill.py

diff --git a/README.md b/README.md
index 1afe5adfe..2731c3a28 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 -->107.0.5304.18<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->108.0.5359.22<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->105.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->106.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index 44a55cf7f..ddbf3576a 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -280,5 +280,5 @@ class FrameExpectResult(TypedDict):
     "tooltip",
     "tree",
     "treegrid",
-    "treeite",
+    "treeitem",
 ]
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index efe8de296..a59f96cc0 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -122,7 +122,7 @@ async def new_context(
         recordHarContent: HarContentPolicy = None,
     ) -> BrowserContext:
         params = locals_to_params(locals())
-        await normalize_context_params(self._connection._is_sync, params)
+        await prepare_browser_context_params(params)
 
         channel = await self._channel.send("newContext", params)
         context = cast(BrowserContext, from_channel(channel))
@@ -219,7 +219,7 @@ async def stop_tracing(self) -> bytes:
         return base64.b64decode(encoded_binary)
 
 
-async def normalize_context_params(is_sync: bool, params: Dict) -> None:
+async def prepare_browser_context_params(params: Dict) -> None:
     if params.get("noViewport"):
         del params["noViewport"]
         params["noDefaultViewport"] = True
@@ -242,3 +242,9 @@ async def normalize_context_params(is_sync: bool, params: Dict) -> None:
             params["storageState"] = json.loads(
                 (await async_readfile(storageState)).decode()
             )
+    if params.get("colorScheme", None) == "null":
+        params["colorScheme"] = "no-override"
+    if params.get("reducedMotion", None) == "null":
+        params["reducedMotion"] = "no-override"
+    if params.get("forcedColors", None) == "null":
+        params["forcedColors"] = "no-override"
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 0eca2c6b7..aeeab8422 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -24,7 +24,7 @@
     ViewportSize,
 )
 from playwright._impl._api_types import Error
-from playwright._impl._browser import Browser, normalize_context_params
+from playwright._impl._browser import Browser, prepare_browser_context_params
 from playwright._impl._browser_context import BrowserContext
 from playwright._impl._connection import (
     ChannelOwner,
@@ -148,7 +148,7 @@ async def launch_persistent_context(
     ) -> BrowserContext:
         userDataDir = str(Path(userDataDir)) if userDataDir else ""
         params = locals_to_params(locals())
-        await normalize_context_params(self._connection._is_sync, params)
+        await prepare_browser_context_params(params)
         normalize_launch_params(params)
         context = cast(
             BrowserContext,
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 5803413dc..7e20dac1d 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -106,6 +106,7 @@ async def hover(
         modifiers: List[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
+        noWaitAfter: bool = None,
         force: bool = None,
         trial: bool = None,
     ) -> None:
@@ -217,6 +218,14 @@ async def type(
     ) -> None:
         await self._channel.send("type", locals_to_params(locals()))
 
+    async def clear(
+        self,
+        timeout: float = None,
+        noWaitAfter: bool = None,
+        force: bool = None,
+    ) -> None:
+        await self.fill("", **locals_to_params(locals()))
+
     async def press(
         self,
         key: str,
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 879af3715..0f446b6f3 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -249,19 +249,23 @@ async def _wait_for_load_state_impl(
             raise Error(
                 "state: expected one of (load|domcontentloaded|networkidle|commit)"
             )
-        if state in self._load_states:
-            return
         wait_helper = self._setup_navigation_wait_helper("wait_for_load_state", timeout)
 
-        def handle_load_state_event(actual_state: str) -> bool:
-            wait_helper.log(f'"{actual_state}" event fired')
-            return actual_state == state
+        if state in self._load_states:
+            wait_helper.log(f'  not waiting, "{state}" event already fired')
+            # TODO: align with upstream
+            wait_helper._fulfill(None)
+        else:
 
-        wait_helper.wait_for_event(
-            self._event_emitter,
-            "loadstate",
-            handle_load_state_event,
-        )
+            def handle_load_state_event(actual_state: str) -> bool:
+                wait_helper.log(f'"{actual_state}" event fired')
+                return actual_state == state
+
+            wait_helper.wait_for_event(
+                self._event_emitter,
+                "loadstate",
+                handle_load_state_event,
+            )
         await wait_helper.result()
 
     async def frame_element(self) -> ElementHandle:
@@ -618,6 +622,7 @@ async def hover(
         modifiers: List[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
+        noWaitAfter: bool = None,
         force: bool = None,
         strict: bool = None,
         trial: bool = None,
@@ -789,5 +794,22 @@ async def set_checked(
                 trial=trial,
             )
 
+    async def clear(
+        self,
+        selector: str,
+        timeout: float = None,
+        noWaitAfter: bool = None,
+        force: bool = None,
+        strict: bool = None,
+    ) -> None:
+        await self.fill(
+            selector,
+            "",
+            timeout=timeout,
+            noWaitAfter=noWaitAfter,
+            force=force,
+            strict=strict,
+        )
+
     async def _highlight(self, selector: str) -> None:
         await self._channel.send("highlight", {"selector": selector})
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 919b57fe6..43b465c2d 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -60,9 +60,9 @@
     Callable[["Route"], Any], Callable[["Route", "Request"], Any]
 ]
 
-ColorScheme = Literal["dark", "light", "no-preference"]
-ForcedColors = Literal["active", "none"]
-ReducedMotion = Literal["no-preference", "reduce"]
+ColorScheme = Literal["dark", "light", "no-preference", "null"]
+ForcedColors = Literal["active", "none", "null"]
+ReducedMotion = Literal["no-preference", "null", "reduce"]
 DocumentLoadState = Literal["commit", "domcontentloaded", "load", "networkidle"]
 KeyboardModifier = Literal["Alt", "Control", "Meta", "Shift"]
 MouseButton = Literal["left", "middle", "right"]
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 830d68204..f1ef26186 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -79,10 +79,7 @@ def __init__(
         self._dispatcher_fiber = frame._connection._dispatcher_fiber
 
         if has_text:
-            text_selector = "text=" + escape_for_text_selector(has_text, exact=False)
-            self._selector += (
-                f" >> internal:has={json.dumps(text_selector, ensure_ascii=False)}"
-            )
+            self._selector += f" >> internal:has-text={escape_for_text_selector(has_text, exact=False)}"
 
         if has:
             if has._frame != frame:
@@ -200,6 +197,14 @@ async def fill(
         params = locals_to_params(locals())
         return await self._frame.fill(self._selector, strict=True, **params)
 
+    async def clear(
+        self,
+        timeout: float = None,
+        noWaitAfter: bool = None,
+        force: bool = None,
+    ) -> None:
+        await self.fill("", timeout=timeout, noWaitAfter=noWaitAfter, force=force)
+
     def locator(
         self,
         selector: str,
@@ -311,6 +316,16 @@ async def focus(self, timeout: float = None) -> None:
         params = locals_to_params(locals())
         return await self._frame.focus(self._selector, strict=True, **params)
 
+    async def blur(self, timeout: float = None) -> None:
+        await self._frame._channel.send(
+            "blur",
+            {
+                "selector": self._selector,
+                "strict": True,
+                **locals_to_params(locals()),
+            },
+        )
+
     async def count(
         self,
     ) -> int:
@@ -345,6 +360,7 @@ async def hover(
         modifiers: List[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
+        noWaitAfter: bool = None,
         force: bool = None,
         trial: bool = None,
     ) -> None:
@@ -762,7 +778,7 @@ def get_by_placeholder_selector(
 
 
 def get_by_text_selector(text: Union[str, Pattern[str]], exact: bool = None) -> str:
-    return "text=" + escape_for_text_selector(text, exact=exact)
+    return "internal:text=" + escape_for_text_selector(text, exact=exact)
 
 
 def get_by_role_selector(
@@ -801,4 +817,4 @@ def get_by_role_selector(
     if pressed is not None:
         props.append(("pressed", str(pressed)))
     props_str = "".join([f"[{t[0]}={t[1]}]" for t in props])
-    return f"role={role}{props_str}"
+    return f"internal:role={role}{props_str}"
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 914f32537..52c31830f 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -550,7 +550,20 @@ async def emulate_media(
         reducedMotion: ReducedMotion = None,
         forcedColors: ForcedColors = None,
     ) -> None:
-        await self._channel.send("emulateMedia", locals_to_params(locals()))
+        params = locals_to_params(locals())
+        if "colorScheme" in params:
+            params["colorScheme"] = (
+                "no-override" if params["colorScheme"] == "null" else colorScheme
+            )
+        if "reducedMotion" in params:
+            params["reducedMotion"] = (
+                "no-override" if params["reducedMotion"] == "null" else reducedMotion
+            )
+        if "forcedColors" in params:
+            params["forcedColors"] = (
+                "no-override" if params["forcedColors"] == "null" else forcedColors
+            )
+        await self._channel.send("emulateMedia", params)
 
     async def set_viewport_size(self, viewportSize: ViewportSize) -> None:
         self._viewport_size = viewportSize
@@ -728,6 +741,23 @@ async def fill(
     ) -> None:
         return await self._main_frame.fill(**locals_to_params(locals()))
 
+    async def clear(
+        self,
+        selector: str,
+        timeout: float = None,
+        noWaitAfter: bool = None,
+        force: bool = None,
+        strict: bool = None,
+    ) -> None:
+        await self.fill(
+            selector,
+            "",
+            timeout=timeout,
+            noWaitAfter=noWaitAfter,
+            force=force,
+            strict=strict,
+        )
+
     def locator(
         self,
         selector: str,
@@ -822,6 +852,7 @@ async def hover(
         modifiers: List[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
+        noWaitAfter: bool = None,
         force: bool = None,
         strict: bool = None,
         trial: bool = None,
diff --git a/playwright/_impl/_str_utils.py b/playwright/_impl/_str_utils.py
index e524df7f7..45c80184f 100644
--- a/playwright/_impl/_str_utils.py
+++ b/playwright/_impl/_str_utils.py
@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import json
 import re
 from typing import Pattern, Union
 
@@ -43,12 +44,7 @@ def escape_for_text_selector(
 ) -> str:
     if isinstance(text, Pattern):
         return f"/{text.pattern}/{escape_regex_flags(text)}"
-    if exact:
-        return '"' + text.replace('"', '\\"') + '"'
-    if '"' in text or ">>" in text or text[0] == "/":
-        suffix = "" if case_sensitive else "i"
-        return "/" + re.sub(r"\s+", "\\\\s+", escape_for_regex(text)) + "/" + suffix
-    return text
+    return json.dumps(text) + ("s" if exact else "i")
 
 
 def escape_for_attribute_selector(value: str, exact: bool = None) -> str:
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 6dd11cc60..842544448 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -1346,7 +1346,7 @@ async def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -1382,7 +1382,7 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -1423,7 +1423,7 @@ async def get_properties(self) -> typing.Dict[str, "JSHandle"]:
         The method returns a map with **own property names** as keys and JSHandle instances for the property values.
 
         ```py
-        handle = await page.evaluate_handle(\"{window, document}\")
+        handle = await page.evaluate_handle(\"({window, document})\")
         properties = await handle.get_properties()
         window_handle = properties.get(\"window\")
         document_handle = properties.get(\"document\")
@@ -1716,6 +1716,7 @@ async def hover(
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None
     ) -> None:
@@ -1743,6 +1744,10 @@ async def hover(
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         trial : Union[bool, None]
@@ -1755,6 +1760,7 @@ async def hover(
                 modifiers=mapping.to_impl(modifiers),
                 position=position,
                 timeout=timeout,
+                noWaitAfter=no_wait_after,
                 force=force,
                 trial=trial,
             )
@@ -2222,6 +2228,42 @@ async def type(
             )
         )
 
+    async def clear(
+        self,
+        *,
+        timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
+        force: typing.Optional[bool] = None
+    ) -> None:
+        """ElementHandle.clear
+
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
+        `input` event after clearing.
+
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
+        However, if the element is inside the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
+        instead.
+
+        Parameters
+        ----------
+        timeout : Union[float, None]
+            Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
+        force : Union[bool, None]
+            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.clear(
+                timeout=timeout, noWaitAfter=no_wait_after, force=force
+            )
+        )
+
     async def press(
         self,
         key: str,
@@ -2517,7 +2559,7 @@ async def screenshot(
             Defaults to `"hide"`.
         scale : Union["css", "device", None]
             When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenhots of
+            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
             high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
@@ -2611,7 +2653,7 @@ async def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -2659,7 +2701,7 @@ async def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -3244,7 +3286,7 @@ async def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -3296,7 +3338,7 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -3746,7 +3788,7 @@ async def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -3795,7 +3837,7 @@ async def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -4286,7 +4328,7 @@ def get_by_alt_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4304,7 +4346,7 @@ def get_by_label(
         """Frame.get_by_label
 
         Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text Password in the following DOM:
+        label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
@@ -4317,7 +4359,7 @@ def get_by_label(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4347,7 +4389,7 @@ def get_by_placeholder(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4442,7 +4484,7 @@ def get_by_role(
             "tooltip",
             "tree",
             "treegrid",
-            "treeite",
+            "treeitem",
         ],
         *,
         checked: typing.Optional[bool] = None,
@@ -4468,7 +4510,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -4552,7 +4594,39 @@ def get_by_text(
     ) -> "Locator":
         """Frame.get_by_text
 
-        Allows locating elements that contain given text.
+        Allows locating elements that contain given text. Consider the following DOM structure:
+
+        ```html
+        <div>Hello <span>world</span></div>
+        <div>Hello</div>
+        ```
+
+        You can locate by text substring, exact string, or a regular expression:
+
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
+        by the text content.
+
+        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -4560,7 +4634,7 @@ def get_by_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4577,7 +4651,7 @@ def get_by_title(
     ) -> "Locator":
         """Frame.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -4589,7 +4663,7 @@ def get_by_title(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4801,6 +4875,7 @@ async def hover(
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None
@@ -4832,6 +4907,10 @@ async def hover(
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -4848,6 +4927,7 @@ async def hover(
                 modifiers=mapping.to_impl(modifiers),
                 position=position,
                 timeout=timeout,
+                noWaitAfter=no_wait_after,
                 force=force,
                 strict=strict,
                 trial=trial,
@@ -5390,7 +5470,7 @@ async def main():
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -5495,6 +5575,54 @@ async def set_checked(
             )
         )
 
+    async def clear(
+        self,
+        selector: str,
+        *,
+        timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
+        force: typing.Optional[bool] = None,
+        strict: typing.Optional[bool] = None
+    ) -> None:
+        """Frame.clear
+
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
+        element, clears it and triggers an `input` event after clearing.
+
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
+        However, if the element is inside the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
+        instead.
+
+        Parameters
+        ----------
+        selector : str
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
+            [working with selectors](../selectors.md) for more details.
+        timeout : Union[float, None]
+            Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
+        force : Union[bool, None]
+            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
+        strict : Union[bool, None]
+            When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
+            element, the call throws an exception.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.clear(
+                selector=selector,
+                timeout=timeout,
+                noWaitAfter=no_wait_after,
+                force=force,
+                strict=strict,
+            )
+        )
+
 
 mapping.register(FrameImpl, Frame)
 
@@ -5583,7 +5711,7 @@ def get_by_alt_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5601,7 +5729,7 @@ def get_by_label(
         """FrameLocator.get_by_label
 
         Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text Password in the following DOM:
+        label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
@@ -5614,7 +5742,7 @@ def get_by_label(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5644,7 +5772,7 @@ def get_by_placeholder(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5739,7 +5867,7 @@ def get_by_role(
             "tooltip",
             "tree",
             "treegrid",
-            "treeite",
+            "treeitem",
         ],
         *,
         checked: typing.Optional[bool] = None,
@@ -5765,7 +5893,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -5849,7 +5977,39 @@ def get_by_text(
     ) -> "Locator":
         """FrameLocator.get_by_text
 
-        Allows locating elements that contain given text.
+        Allows locating elements that contain given text. Consider the following DOM structure:
+
+        ```html
+        <div>Hello <span>world</span></div>
+        <div>Hello</div>
+        ```
+
+        You can locate by text substring, exact string, or a regular expression:
+
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
+        by the text content.
+
+        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -5857,7 +6017,7 @@ def get_by_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5874,7 +6034,7 @@ def get_by_title(
     ) -> "Locator":
         """FrameLocator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -5886,7 +6046,7 @@ def get_by_title(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5979,7 +6139,7 @@ async def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -6011,7 +6171,7 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -7584,7 +7744,7 @@ async def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -7636,7 +7796,7 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -7686,7 +7846,7 @@ async def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -7733,7 +7893,7 @@ async def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -8340,9 +8500,13 @@ async def emulate_media(
         self,
         *,
         media: typing.Optional[Literal["print", "screen"]] = None,
-        color_scheme: typing.Optional[Literal["dark", "light", "no-preference"]] = None,
-        reduced_motion: typing.Optional[Literal["no-preference", "reduce"]] = None,
-        forced_colors: typing.Optional[Literal["active", "none"]] = None
+        color_scheme: typing.Optional[
+            Literal["dark", "light", "no-preference", "null"]
+        ] = None,
+        reduced_motion: typing.Optional[
+            Literal["no-preference", "null", "reduce"]
+        ] = None,
+        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None
     ) -> None:
         """Page.emulate_media
 
@@ -8383,15 +8547,13 @@ async def emulate_media(
         media : Union["print", "screen", None]
             Changes the CSS media type of the page. The only allowed values are `'screen'`, `'print'` and `null`. Passing `null`
             disables CSS media emulation.
-        color_scheme : Union["dark", "light", "no-preference", None]
+        color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. Passing
-            `null` disables color scheme emulation.
-        reduced_motion : Union["no-preference", "reduce", None]
+            `'Null'` disables color scheme emulation.
+        reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. Passing `null`
             disables reduced motion emulation.
-        forced_colors : Union["active", "none", None]
-            Emulates `'forced-colors'` media feature, supported values are `'active'` and `'none'`. Passing `null` disables forced
-            colors emulation.
+        forced_colors : Union["active", "none", "null", None]
         """
 
         return mapping.from_maybe_impl(
@@ -8613,7 +8775,8 @@ async def route_from_har(
 
             Defaults to abort.
         update : Union[bool, None]
-            If specified, updates the given HAR with the actual network information instead of serving from file.
+            If specified, updates the given HAR with the actual network information instead of serving from file. The file is
+            written to disk when `browser_context.close()` is called.
         """
 
         return mapping.from_maybe_impl(
@@ -8674,7 +8837,7 @@ async def screenshot(
             Defaults to `"hide"`.
         scale : Union["css", "device", None]
             When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenhots of
+            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
             high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
@@ -9041,6 +9204,55 @@ async def fill(
             )
         )
 
+    async def clear(
+        self,
+        selector: str,
+        *,
+        timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
+        force: typing.Optional[bool] = None,
+        strict: typing.Optional[bool] = None
+    ) -> None:
+        """Page.clear
+
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
+        element, clears it and triggers an `input` event after clearing. Note that you can pass an empty string to clear the
+        input field.
+
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
+        However, if the element is inside the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
+        instead.
+
+        Parameters
+        ----------
+        selector : str
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
+            [working with selectors](../selectors.md) for more details.
+        timeout : Union[float, None]
+            Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
+        force : Union[bool, None]
+            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
+        strict : Union[bool, None]
+            When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
+            element, the call throws an exception.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.clear(
+                selector=selector,
+                timeout=timeout,
+                noWaitAfter=no_wait_after,
+                force=force,
+                strict=strict,
+            )
+        )
+
     def locator(
         self,
         selector: str,
@@ -9101,7 +9313,7 @@ def get_by_alt_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9119,7 +9331,7 @@ def get_by_label(
         """Page.get_by_label
 
         Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text Password in the following DOM:
+        label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
@@ -9132,7 +9344,7 @@ def get_by_label(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9162,7 +9374,7 @@ def get_by_placeholder(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9257,7 +9469,7 @@ def get_by_role(
             "tooltip",
             "tree",
             "treegrid",
-            "treeite",
+            "treeitem",
         ],
         *,
         checked: typing.Optional[bool] = None,
@@ -9283,7 +9495,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -9367,7 +9579,39 @@ def get_by_text(
     ) -> "Locator":
         """Page.get_by_text
 
-        Allows locating elements that contain given text.
+        Allows locating elements that contain given text. Consider the following DOM structure:
+
+        ```html
+        <div>Hello <span>world</span></div>
+        <div>Hello</div>
+        ```
+
+        You can locate by text substring, exact string, or a regular expression:
+
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
+        by the text content.
+
+        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -9375,7 +9619,7 @@ def get_by_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9392,7 +9636,7 @@ def get_by_title(
     ) -> "Locator":
         """Page.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -9404,7 +9648,7 @@ def get_by_title(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9618,6 +9862,7 @@ async def hover(
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None
@@ -9651,6 +9896,10 @@ async def hover(
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -9667,6 +9916,7 @@ async def hover(
                 modifiers=mapping.to_impl(modifiers),
                 position=position,
                 timeout=timeout,
+                noWaitAfter=no_wait_after,
                 force=force,
                 strict=strict,
                 trial=trial,
@@ -10255,7 +10505,7 @@ async def main():
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -11743,7 +11993,8 @@ async def route_from_har(
 
             Defaults to abort.
         update : Union[bool, None]
-            If specified, updates the given HAR with the actual network information instead of serving from file.
+            If specified, updates the given HAR with the actual network information instead of serving from file. The file is
+            written to disk when `browser_context.close()` is called.
         """
 
         return mapping.from_maybe_impl(
@@ -12047,9 +12298,13 @@ async def new_context(
         device_scale_factor: typing.Optional[float] = None,
         is_mobile: typing.Optional[bool] = None,
         has_touch: typing.Optional[bool] = None,
-        color_scheme: typing.Optional[Literal["dark", "light", "no-preference"]] = None,
-        reduced_motion: typing.Optional[Literal["no-preference", "reduce"]] = None,
-        forced_colors: typing.Optional[Literal["active", "none"]] = None,
+        color_scheme: typing.Optional[
+            Literal["dark", "light", "no-preference", "null"]
+        ] = None,
+        reduced_motion: typing.Optional[
+            Literal["no-preference", "null", "reduce"]
+        ] = None,
+        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
         default_browser_type: typing.Optional[str] = None,
         proxy: typing.Optional[ProxySettings] = None,
@@ -12132,15 +12387,17 @@ async def new_context(
             in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
-        color_scheme : Union["dark", "light", "no-preference", None]
+        color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'light'`.
-        reduced_motion : Union["no-preference", "reduce", None]
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'light'`.
+        reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'no-preference'`.
-        forced_colors : Union["active", "none", None]
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
+        forced_colors : Union["active", "none", "null", None]
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Defaults to `'none'`.
+            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
@@ -12256,9 +12513,13 @@ async def new_page(
         device_scale_factor: typing.Optional[float] = None,
         is_mobile: typing.Optional[bool] = None,
         has_touch: typing.Optional[bool] = None,
-        color_scheme: typing.Optional[Literal["dark", "light", "no-preference"]] = None,
-        forced_colors: typing.Optional[Literal["active", "none"]] = None,
-        reduced_motion: typing.Optional[Literal["no-preference", "reduce"]] = None,
+        color_scheme: typing.Optional[
+            Literal["dark", "light", "no-preference", "null"]
+        ] = None,
+        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
+        reduced_motion: typing.Optional[
+            Literal["no-preference", "null", "reduce"]
+        ] = None,
         accept_downloads: typing.Optional[bool] = None,
         default_browser_type: typing.Optional[str] = None,
         proxy: typing.Optional[ProxySettings] = None,
@@ -12327,15 +12588,17 @@ async def new_page(
             in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
-        color_scheme : Union["dark", "light", "no-preference", None]
+        color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'light'`.
-        forced_colors : Union["active", "none", None]
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'light'`.
+        forced_colors : Union["active", "none", "null", None]
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Defaults to `'none'`.
-        reduced_motion : Union["no-preference", "reduce", None]
+            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
+        reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'no-preference'`.
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
@@ -12719,9 +12982,13 @@ async def launch_persistent_context(
         device_scale_factor: typing.Optional[float] = None,
         is_mobile: typing.Optional[bool] = None,
         has_touch: typing.Optional[bool] = None,
-        color_scheme: typing.Optional[Literal["dark", "light", "no-preference"]] = None,
-        reduced_motion: typing.Optional[Literal["no-preference", "reduce"]] = None,
-        forced_colors: typing.Optional[Literal["active", "none"]] = None,
+        color_scheme: typing.Optional[
+            Literal["dark", "light", "no-preference", "null"]
+        ] = None,
+        reduced_motion: typing.Optional[
+            Literal["no-preference", "null", "reduce"]
+        ] = None,
+        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
         traces_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         chromium_sandbox: typing.Optional[bool] = None,
@@ -12833,15 +13100,17 @@ async def launch_persistent_context(
             in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
-        color_scheme : Union["dark", "light", "no-preference", None]
+        color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'light'`.
-        reduced_motion : Union["no-preference", "reduce", None]
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'light'`.
+        reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'no-preference'`.
-        forced_colors : Union["active", "none", None]
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
+        forced_colors : Union["active", "none", "null", None]
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Defaults to `'none'`.
+            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         traces_dir : Union[pathlib.Path, str, None]
@@ -13624,7 +13893,7 @@ async def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -13664,7 +13933,7 @@ async def evaluate_all(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -13704,7 +13973,7 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -13764,6 +14033,42 @@ async def fill(
             )
         )
 
+    async def clear(
+        self,
+        *,
+        timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
+        force: typing.Optional[bool] = None
+    ) -> None:
+        """Locator.clear
+
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
+        `input` event after clearing.
+
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
+        However, if the element is inside the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
+        instead.
+
+        Parameters
+        ----------
+        timeout : Union[float, None]
+            Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
+        force : Union[bool, None]
+            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.clear(
+                timeout=timeout, noWaitAfter=no_wait_after, force=force
+            )
+        )
+
     def locator(
         self,
         selector: str,
@@ -13823,7 +14128,7 @@ def get_by_alt_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -13841,7 +14146,7 @@ def get_by_label(
         """Locator.get_by_label
 
         Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text Password in the following DOM:
+        label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
@@ -13854,7 +14159,7 @@ def get_by_label(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -13884,7 +14189,7 @@ def get_by_placeholder(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -13979,7 +14284,7 @@ def get_by_role(
             "tooltip",
             "tree",
             "treegrid",
-            "treeite",
+            "treeitem",
         ],
         *,
         checked: typing.Optional[bool] = None,
@@ -14005,7 +14310,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -14089,7 +14394,39 @@ def get_by_text(
     ) -> "Locator":
         """Locator.get_by_text
 
-        Allows locating elements that contain given text.
+        Allows locating elements that contain given text. Consider the following DOM structure:
+
+        ```html
+        <div>Hello <span>world</span></div>
+        <div>Hello</div>
+        ```
+
+        You can locate by text substring, exact string, or a regular expression:
+
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
+        by the text content.
+
+        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -14097,7 +14434,7 @@ def get_by_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14114,7 +14451,7 @@ def get_by_title(
     ) -> "Locator":
         """Locator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -14126,7 +14463,7 @@ def get_by_title(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14262,6 +14599,20 @@ async def focus(self, *, timeout: typing.Optional[float] = None) -> None:
 
         return mapping.from_maybe_impl(await self._impl_obj.focus(timeout=timeout))
 
+    async def blur(self, *, timeout: typing.Optional[float] = None) -> None:
+        """Locator.blur
+
+        Calls [blur](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/blur) on the element.
+
+        Parameters
+        ----------
+        timeout : Union[float, None]
+            Maximum time in milliseconds, defaults to 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.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.blur(timeout=timeout))
+
     async def count(self) -> int:
         """Locator.count
 
@@ -14371,6 +14722,7 @@ async def hover(
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None
     ) -> None:
@@ -14398,6 +14750,10 @@ async def hover(
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         trial : Union[bool, None]
@@ -14410,6 +14766,7 @@ async def hover(
                 modifiers=mapping.to_impl(modifiers),
                 position=position,
                 timeout=timeout,
+                noWaitAfter=no_wait_after,
                 force=force,
                 trial=trial,
             )
@@ -14688,7 +15045,7 @@ async def screenshot(
             Defaults to `"hide"`.
         scale : Union["css", "device", None]
             When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenhots of
+            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
             high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 4474ad2ef..9fd929303 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -1342,7 +1342,7 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -1378,7 +1378,7 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -1421,7 +1421,7 @@ def get_properties(self) -> typing.Dict[str, "JSHandle"]:
         The method returns a map with **own property names** as keys and JSHandle instances for the property values.
 
         ```py
-        handle = page.evaluate_handle(\"{window, document}\")
+        handle = page.evaluate_handle(\"({window, document})\")
         properties = handle.get_properties()
         window_handle = properties.get(\"window\")
         document_handle = properties.get(\"document\")
@@ -1718,6 +1718,7 @@ def hover(
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None
     ) -> None:
@@ -1745,6 +1746,10 @@ def hover(
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         trial : Union[bool, None]
@@ -1758,6 +1763,7 @@ def hover(
                     modifiers=mapping.to_impl(modifiers),
                     position=position,
                     timeout=timeout,
+                    noWaitAfter=no_wait_after,
                     force=force,
                     trial=trial,
                 )
@@ -2242,6 +2248,44 @@ def type(
             )
         )
 
+    def clear(
+        self,
+        *,
+        timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
+        force: typing.Optional[bool] = None
+    ) -> None:
+        """ElementHandle.clear
+
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
+        `input` event after clearing.
+
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
+        However, if the element is inside the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
+        instead.
+
+        Parameters
+        ----------
+        timeout : Union[float, None]
+            Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
+        force : Union[bool, None]
+            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.clear(
+                    timeout=timeout, noWaitAfter=no_wait_after, force=force
+                )
+            )
+        )
+
     def press(
         self,
         key: str,
@@ -2545,7 +2589,7 @@ def screenshot(
             Defaults to `"hide"`.
         scale : Union["css", "device", None]
             When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenhots of
+            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
             high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
@@ -2641,7 +2685,7 @@ def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -2691,7 +2735,7 @@ def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -3292,7 +3336,7 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -3344,7 +3388,7 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -3809,7 +3853,7 @@ def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -3860,7 +3904,7 @@ def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -4367,7 +4411,7 @@ def get_by_alt_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4385,7 +4429,7 @@ def get_by_label(
         """Frame.get_by_label
 
         Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text Password in the following DOM:
+        label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
@@ -4398,7 +4442,7 @@ def get_by_label(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4428,7 +4472,7 @@ def get_by_placeholder(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4523,7 +4567,7 @@ def get_by_role(
             "tooltip",
             "tree",
             "treegrid",
-            "treeite",
+            "treeitem",
         ],
         *,
         checked: typing.Optional[bool] = None,
@@ -4549,7 +4593,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -4633,7 +4677,39 @@ def get_by_text(
     ) -> "Locator":
         """Frame.get_by_text
 
-        Allows locating elements that contain given text.
+        Allows locating elements that contain given text. Consider the following DOM structure:
+
+        ```html
+        <div>Hello <span>world</span></div>
+        <div>Hello</div>
+        ```
+
+        You can locate by text substring, exact string, or a regular expression:
+
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
+        by the text content.
+
+        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -4641,7 +4717,7 @@ def get_by_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4658,7 +4734,7 @@ def get_by_title(
     ) -> "Locator":
         """Frame.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -4670,7 +4746,7 @@ def get_by_title(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4890,6 +4966,7 @@ def hover(
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None
@@ -4921,6 +4998,10 @@ def hover(
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -4938,6 +5019,7 @@ def hover(
                     modifiers=mapping.to_impl(modifiers),
                     position=position,
                     timeout=timeout,
+                    noWaitAfter=no_wait_after,
                     force=force,
                     strict=strict,
                     trial=trial,
@@ -5494,7 +5576,7 @@ def run(playwright):
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -5603,6 +5685,56 @@ def set_checked(
             )
         )
 
+    def clear(
+        self,
+        selector: str,
+        *,
+        timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
+        force: typing.Optional[bool] = None,
+        strict: typing.Optional[bool] = None
+    ) -> None:
+        """Frame.clear
+
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
+        element, clears it and triggers an `input` event after clearing.
+
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
+        However, if the element is inside the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
+        instead.
+
+        Parameters
+        ----------
+        selector : str
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
+            [working with selectors](../selectors.md) for more details.
+        timeout : Union[float, None]
+            Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
+        force : Union[bool, None]
+            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
+        strict : Union[bool, None]
+            When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
+            element, the call throws an exception.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.clear(
+                    selector=selector,
+                    timeout=timeout,
+                    noWaitAfter=no_wait_after,
+                    force=force,
+                    strict=strict,
+                )
+            )
+        )
+
 
 mapping.register(FrameImpl, Frame)
 
@@ -5691,7 +5823,7 @@ def get_by_alt_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5709,7 +5841,7 @@ def get_by_label(
         """FrameLocator.get_by_label
 
         Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text Password in the following DOM:
+        label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
@@ -5722,7 +5854,7 @@ def get_by_label(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5752,7 +5884,7 @@ def get_by_placeholder(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5847,7 +5979,7 @@ def get_by_role(
             "tooltip",
             "tree",
             "treegrid",
-            "treeite",
+            "treeitem",
         ],
         *,
         checked: typing.Optional[bool] = None,
@@ -5873,7 +6005,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -5957,7 +6089,39 @@ def get_by_text(
     ) -> "Locator":
         """FrameLocator.get_by_text
 
-        Allows locating elements that contain given text.
+        Allows locating elements that contain given text. Consider the following DOM structure:
+
+        ```html
+        <div>Hello <span>world</span></div>
+        <div>Hello</div>
+        ```
+
+        You can locate by text substring, exact string, or a regular expression:
+
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
+        by the text content.
+
+        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -5965,7 +6129,7 @@ def get_by_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5982,7 +6146,7 @@ def get_by_title(
     ) -> "Locator":
         """FrameLocator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -5994,7 +6158,7 @@ def get_by_title(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -6083,7 +6247,7 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -6115,7 +6279,7 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -7597,7 +7761,7 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -7649,7 +7813,7 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -7701,7 +7865,7 @@ def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -7750,7 +7914,7 @@ def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -8371,9 +8535,13 @@ def emulate_media(
         self,
         *,
         media: typing.Optional[Literal["print", "screen"]] = None,
-        color_scheme: typing.Optional[Literal["dark", "light", "no-preference"]] = None,
-        reduced_motion: typing.Optional[Literal["no-preference", "reduce"]] = None,
-        forced_colors: typing.Optional[Literal["active", "none"]] = None
+        color_scheme: typing.Optional[
+            Literal["dark", "light", "no-preference", "null"]
+        ] = None,
+        reduced_motion: typing.Optional[
+            Literal["no-preference", "null", "reduce"]
+        ] = None,
+        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None
     ) -> None:
         """Page.emulate_media
 
@@ -8413,15 +8581,13 @@ def emulate_media(
         media : Union["print", "screen", None]
             Changes the CSS media type of the page. The only allowed values are `'screen'`, `'print'` and `null`. Passing `null`
             disables CSS media emulation.
-        color_scheme : Union["dark", "light", "no-preference", None]
+        color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. Passing
-            `null` disables color scheme emulation.
-        reduced_motion : Union["no-preference", "reduce", None]
+            `'Null'` disables color scheme emulation.
+        reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. Passing `null`
             disables reduced motion emulation.
-        forced_colors : Union["active", "none", None]
-            Emulates `'forced-colors'` media feature, supported values are `'active'` and `'none'`. Passing `null` disables forced
-            colors emulation.
+        forced_colors : Union["active", "none", "null", None]
         """
 
         return mapping.from_maybe_impl(
@@ -8649,7 +8815,8 @@ def route_from_har(
 
             Defaults to abort.
         update : Union[bool, None]
-            If specified, updates the given HAR with the actual network information instead of serving from file.
+            If specified, updates the given HAR with the actual network information instead of serving from file. The file is
+            written to disk when `browser_context.close()` is called.
         """
 
         return mapping.from_maybe_impl(
@@ -8712,7 +8879,7 @@ def screenshot(
             Defaults to `"hide"`.
         scale : Union["css", "device", None]
             When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenhots of
+            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
             high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
@@ -9089,6 +9256,57 @@ def fill(
             )
         )
 
+    def clear(
+        self,
+        selector: str,
+        *,
+        timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
+        force: typing.Optional[bool] = None,
+        strict: typing.Optional[bool] = None
+    ) -> None:
+        """Page.clear
+
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
+        element, clears it and triggers an `input` event after clearing. Note that you can pass an empty string to clear the
+        input field.
+
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
+        However, if the element is inside the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
+        instead.
+
+        Parameters
+        ----------
+        selector : str
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
+            [working with selectors](../selectors.md) for more details.
+        timeout : Union[float, None]
+            Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
+        force : Union[bool, None]
+            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
+        strict : Union[bool, None]
+            When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
+            element, the call throws an exception.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.clear(
+                    selector=selector,
+                    timeout=timeout,
+                    noWaitAfter=no_wait_after,
+                    force=force,
+                    strict=strict,
+                )
+            )
+        )
+
     def locator(
         self,
         selector: str,
@@ -9149,7 +9367,7 @@ def get_by_alt_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9167,7 +9385,7 @@ def get_by_label(
         """Page.get_by_label
 
         Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text Password in the following DOM:
+        label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
@@ -9180,7 +9398,7 @@ def get_by_label(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9210,7 +9428,7 @@ def get_by_placeholder(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9305,7 +9523,7 @@ def get_by_role(
             "tooltip",
             "tree",
             "treegrid",
-            "treeite",
+            "treeitem",
         ],
         *,
         checked: typing.Optional[bool] = None,
@@ -9331,7 +9549,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -9415,7 +9633,39 @@ def get_by_text(
     ) -> "Locator":
         """Page.get_by_text
 
-        Allows locating elements that contain given text.
+        Allows locating elements that contain given text. Consider the following DOM structure:
+
+        ```html
+        <div>Hello <span>world</span></div>
+        <div>Hello</div>
+        ```
+
+        You can locate by text substring, exact string, or a regular expression:
+
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
+        by the text content.
+
+        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -9423,7 +9673,7 @@ def get_by_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9440,7 +9690,7 @@ def get_by_title(
     ) -> "Locator":
         """Page.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -9452,7 +9702,7 @@ def get_by_title(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9674,6 +9924,7 @@ def hover(
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None
@@ -9707,6 +9958,10 @@ def hover(
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -9724,6 +9979,7 @@ def hover(
                     modifiers=mapping.to_impl(modifiers),
                     position=position,
                     timeout=timeout,
+                    noWaitAfter=no_wait_after,
                     force=force,
                     strict=strict,
                     trial=trial,
@@ -10326,7 +10582,7 @@ def run(playwright):
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -11777,7 +12033,8 @@ def route_from_har(
 
             Defaults to abort.
         update : Union[bool, None]
-            If specified, updates the given HAR with the actual network information instead of serving from file.
+            If specified, updates the given HAR with the actual network information instead of serving from file. The file is
+            written to disk when `browser_context.close()` is called.
         """
 
         return mapping.from_maybe_impl(
@@ -12083,9 +12340,13 @@ def new_context(
         device_scale_factor: typing.Optional[float] = None,
         is_mobile: typing.Optional[bool] = None,
         has_touch: typing.Optional[bool] = None,
-        color_scheme: typing.Optional[Literal["dark", "light", "no-preference"]] = None,
-        reduced_motion: typing.Optional[Literal["no-preference", "reduce"]] = None,
-        forced_colors: typing.Optional[Literal["active", "none"]] = None,
+        color_scheme: typing.Optional[
+            Literal["dark", "light", "no-preference", "null"]
+        ] = None,
+        reduced_motion: typing.Optional[
+            Literal["no-preference", "null", "reduce"]
+        ] = None,
+        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
         default_browser_type: typing.Optional[str] = None,
         proxy: typing.Optional[ProxySettings] = None,
@@ -12168,15 +12429,17 @@ def new_context(
             in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
-        color_scheme : Union["dark", "light", "no-preference", None]
+        color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'light'`.
-        reduced_motion : Union["no-preference", "reduce", None]
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'light'`.
+        reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'no-preference'`.
-        forced_colors : Union["active", "none", None]
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
+        forced_colors : Union["active", "none", "null", None]
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Defaults to `'none'`.
+            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
@@ -12294,9 +12557,13 @@ def new_page(
         device_scale_factor: typing.Optional[float] = None,
         is_mobile: typing.Optional[bool] = None,
         has_touch: typing.Optional[bool] = None,
-        color_scheme: typing.Optional[Literal["dark", "light", "no-preference"]] = None,
-        forced_colors: typing.Optional[Literal["active", "none"]] = None,
-        reduced_motion: typing.Optional[Literal["no-preference", "reduce"]] = None,
+        color_scheme: typing.Optional[
+            Literal["dark", "light", "no-preference", "null"]
+        ] = None,
+        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
+        reduced_motion: typing.Optional[
+            Literal["no-preference", "null", "reduce"]
+        ] = None,
         accept_downloads: typing.Optional[bool] = None,
         default_browser_type: typing.Optional[str] = None,
         proxy: typing.Optional[ProxySettings] = None,
@@ -12365,15 +12632,17 @@ def new_page(
             in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
-        color_scheme : Union["dark", "light", "no-preference", None]
+        color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'light'`.
-        forced_colors : Union["active", "none", None]
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'light'`.
+        forced_colors : Union["active", "none", "null", None]
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Defaults to `'none'`.
-        reduced_motion : Union["no-preference", "reduce", None]
+            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
+        reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'no-preference'`.
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
@@ -12763,9 +13032,13 @@ def launch_persistent_context(
         device_scale_factor: typing.Optional[float] = None,
         is_mobile: typing.Optional[bool] = None,
         has_touch: typing.Optional[bool] = None,
-        color_scheme: typing.Optional[Literal["dark", "light", "no-preference"]] = None,
-        reduced_motion: typing.Optional[Literal["no-preference", "reduce"]] = None,
-        forced_colors: typing.Optional[Literal["active", "none"]] = None,
+        color_scheme: typing.Optional[
+            Literal["dark", "light", "no-preference", "null"]
+        ] = None,
+        reduced_motion: typing.Optional[
+            Literal["no-preference", "null", "reduce"]
+        ] = None,
+        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
         traces_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         chromium_sandbox: typing.Optional[bool] = None,
@@ -12877,15 +13150,17 @@ def launch_persistent_context(
             in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
-        color_scheme : Union["dark", "light", "no-preference", None]
+        color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'light'`.
-        reduced_motion : Union["no-preference", "reduce", None]
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'light'`.
+        reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Defaults to `'no-preference'`.
-        forced_colors : Union["active", "none", None]
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
+        forced_colors : Union["active", "none", "null", None]
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Defaults to `'none'`.
+            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         traces_dir : Union[pathlib.Path, str, None]
@@ -13683,7 +13958,7 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -13725,7 +14000,7 @@ def evaluate_all(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -13767,7 +14042,7 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expresion evaluates to a function, the function is
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
             automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
@@ -13831,6 +14106,44 @@ def fill(
             )
         )
 
+    def clear(
+        self,
+        *,
+        timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
+        force: typing.Optional[bool] = None
+    ) -> None:
+        """Locator.clear
+
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
+        `input` event after clearing.
+
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
+        However, if the element is inside the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
+        instead.
+
+        Parameters
+        ----------
+        timeout : Union[float, None]
+            Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
+        force : Union[bool, None]
+            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.clear(
+                    timeout=timeout, noWaitAfter=no_wait_after, force=force
+                )
+            )
+        )
+
     def locator(
         self,
         selector: str,
@@ -13890,7 +14203,7 @@ def get_by_alt_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -13908,7 +14221,7 @@ def get_by_label(
         """Locator.get_by_label
 
         Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text Password in the following DOM:
+        label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
@@ -13921,7 +14234,7 @@ def get_by_label(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -13951,7 +14264,7 @@ def get_by_placeholder(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14046,7 +14359,7 @@ def get_by_role(
             "tooltip",
             "tree",
             "treegrid",
-            "treeite",
+            "treeitem",
         ],
         *,
         checked: typing.Optional[bool] = None,
@@ -14072,7 +14385,7 @@ def get_by_role(
 
         Parameters
         ----------
-        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeite"]
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
             An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
@@ -14156,7 +14469,39 @@ def get_by_text(
     ) -> "Locator":
         """Locator.get_by_text
 
-        Allows locating elements that contain given text.
+        Allows locating elements that contain given text. Consider the following DOM structure:
+
+        ```html
+        <div>Hello <span>world</span></div>
+        <div>Hello</div>
+        ```
+
+        You can locate by text substring, exact string, or a regular expression:
+
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
+        by the text content.
+
+        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -14164,7 +14509,7 @@ def get_by_text(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14181,7 +14526,7 @@ def get_by_title(
     ) -> "Locator":
         """Locator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Submit\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -14193,7 +14538,7 @@ def get_by_title(
             Text to locate the element for.
         exact : Union[bool, None]
             Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression.
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14333,6 +14678,20 @@ def focus(self, *, timeout: typing.Optional[float] = None) -> None:
             self._sync(self._impl_obj.focus(timeout=timeout))
         )
 
+    def blur(self, *, timeout: typing.Optional[float] = None) -> None:
+        """Locator.blur
+
+        Calls [blur](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/blur) on the element.
+
+        Parameters
+        ----------
+        timeout : Union[float, None]
+            Maximum time in milliseconds, defaults to 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.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.blur(timeout=timeout)))
+
     def count(self) -> int:
         """Locator.count
 
@@ -14444,6 +14803,7 @@ def hover(
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None
     ) -> None:
@@ -14471,6 +14831,10 @@ def hover(
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+            inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         trial : Union[bool, None]
@@ -14484,6 +14848,7 @@ def hover(
                     modifiers=mapping.to_impl(modifiers),
                     position=position,
                     timeout=timeout,
+                    noWaitAfter=no_wait_after,
                     force=force,
                     trial=trial,
                 )
@@ -14777,7 +15142,7 @@ def screenshot(
             Defaults to `"hide"`.
         scale : Union["css", "device", None]
             When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenhots of
+            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
             high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
diff --git a/setup.py b/setup.py
index 7298d1531..8cfafb382 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.27.0"
+driver_version = "1.28.0-alpha-1667504282000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_accessibility.py b/tests/async/test_accessibility.py
index 6ffe2c041..623bd5908 100644
--- a/tests/async/test_accessibility.py
+++ b/tests/async/test_accessibility.py
@@ -167,76 +167,6 @@ async def test_accessibility_filtering_children_of_leaf_nodes_should_not_report_
     assert await page.accessibility.snapshot() == golden
 
 
-# WebKit rich text accessibility is iffy
-@pytest.mark.skip_browser("webkit")
-async def test_accessibility_filtering_children_of_leaf_nodes_rich_text_editable_fields_should_have_children(
-    page, is_firefox
-):
-    await page.set_content(
-        """
-    <div contenteditable="true">
-    Edit this image: <img src="fakeimage.png" alt="my fake image">
-    </div>"""
-    )
-    golden = (
-        {
-            "role": "section",
-            "name": "",
-            "children": [
-                {"role": "text leaf", "name": "Edit this image: "},
-                {"role": "text", "name": "my fake image"},
-            ],
-        }
-        if is_firefox
-        else {
-            "role": "generic",
-            "name": "",
-            "value": "Edit this image: ",
-            "children": [
-                {"role": "text", "name": "Edit this image:"},
-                {"role": "img", "name": "my fake image"},
-            ],
-        }
-    )
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot["children"][0] == golden
-
-
-# WebKit rich text accessibility is iffy
-@pytest.mark.skip_browser("webkit")
-async def test_accessibility_filtering_children_of_leaf_nodes_rich_text_editable_fields_with_role_should_have_children(
-    page, is_firefox, browser_channel
-):
-    await page.set_content(
-        """
-        <div contenteditable="true">
-            Edit this image: <img src="fakeimage.png" alt="my fake image">
-        </div>
-    """
-    )
-    if is_firefox:
-        golden = {
-            "role": "section",
-            "name": "",
-            "children": [
-                {"role": "text leaf", "name": "Edit this image: "},
-                {"role": "text", "name": "my fake image"},
-            ],
-        }
-    else:
-        golden = {
-            "role": "generic",
-            "name": "",
-            "value": "Edit this image: ",
-            "children": [
-                {"role": "text", "name": "Edit this image:"},
-                {"role": "img", "name": "my fake image"},
-            ],
-        }
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot["children"][0] == golden
-
-
 # Firefox does not support contenteditable="plaintext-only".
 # WebKit rich text accessibility is iffy
 @pytest.mark.only_browser("chromium")
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 996f02390..561c84105 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -230,15 +230,6 @@ async def test_to_have_js_property_fail_boolean_2(page: Page) -> None:
         await expect(locator).to_have_js_property("foo", True, timeout=500)
 
 
-@pytest.mark.skip("https://github.com/microsoft/playwright/issues/14909")
-async def test_to_have_js_property_pass_undefined(page: Page) -> None:
-    await page.set_content("<div></div>")
-    locator = page.locator("div")
-    await expect(locator).to_have_js_property(
-        "foo", None
-    )  # Python does not have an undefined
-
-
 async def test_to_have_js_property_pass_null(page: Page) -> None:
     await page.set_content("<div></div>")
     await page.eval_on_selector("div", "e => e.foo = null")
diff --git a/tests/async/test_browsertype_connect_cdp.py b/tests/async/test_browsertype_connect_cdp.py
index dbd8bd6d8..ec8caeeea 100644
--- a/tests/async/test_browsertype_connect_cdp.py
+++ b/tests/async/test_browsertype_connect_cdp.py
@@ -30,7 +30,7 @@ async def test_connect_to_an_existing_cdp_session(
     browser_server = await browser_type.launch(
         **launch_arguments, args=[f"--remote-debugging-port={port}"]
     )
-    cdp_browser = await browser_type.connect_over_cdp(f"http://localhost:{port}")
+    cdp_browser = await browser_type.connect_over_cdp(f"http://127.0.0.1:{port}")
     assert len(cdp_browser.contexts) == 1
     await cdp_browser.close()
     await browser_server.close()
@@ -43,7 +43,7 @@ async def test_connect_to_an_existing_cdp_session_twice(
     browser_server = await browser_type.launch(
         **launch_arguments, args=[f"--remote-debugging-port={port}"]
     )
-    endpoint_url = f"http://localhost:{port}"
+    endpoint_url = f"http://127.0.0.1:{port}"
     cdp_browser1 = await browser_type.connect_over_cdp(endpoint_url)
     cdp_browser2 = await browser_type.connect_over_cdp(endpoint_url)
     assert len(cdp_browser1.contexts) == 1
@@ -76,7 +76,7 @@ async def test_conect_over_a_ws_endpoint(
     browser_server = await browser_type.launch(
         **launch_arguments, args=[f"--remote-debugging-port={port}"]
     )
-    ws_endpoint = _ws_endpoint_from_url(f"http://localhost:{port}/json/version/")
+    ws_endpoint = _ws_endpoint_from_url(f"http://127.0.0.1:{port}/json/version/")
 
     cdp_browser1 = await browser_type.connect_over_cdp(ws_endpoint)
     assert len(cdp_browser1.contexts) == 1
diff --git a/tests/async/test_element_handle.py b/tests/async/test_element_handle.py
index d47e6a78c..f900197b4 100644
--- a/tests/async/test_element_handle.py
+++ b/tests/async/test_element_handle.py
@@ -442,6 +442,16 @@ async def test_fill_input_when_Node_is_removed(page, server):
     assert await page.evaluate("result") == "some value"
 
 
+async def test_clear_input(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/textarea.html")
+    handle = await page.query_selector("input")
+    assert handle
+    await handle.fill("some value")
+    assert await page.evaluate("result") == "some value"
+    await handle.clear()
+    assert await page.evaluate("result") == ""
+
+
 async def test_select_textarea(page, server, is_firefox):
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
diff --git a/tests/async/test_fill.py b/tests/async/test_fill.py
index 9e5d252f0..03357e42b 100644
--- a/tests/async/test_fill.py
+++ b/tests/async/test_fill.py
@@ -12,6 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import pytest
+
+from playwright.async_api import Error, Page
+from tests.server import Server
+
 
 async def test_fill_textarea(page, server):
     await page.goto(f"{server.PREFIX}/input/textarea.html")
@@ -23,3 +28,28 @@ async def test_fill_input(page, server):
     await page.goto(f"{server.PREFIX}/input/textarea.html")
     await page.fill("input", "some value")
     assert await page.evaluate("result") == "some value"
+
+
+async def test_should_throw_on_unsupported_inputs_when_clear(
+    page: Page, server: Server
+):
+    await page.goto(f"{server.PREFIX}/input/textarea.html")
+    for type in ["button", "checkbox", "file", "image", "radio", "reset", "submit"]:
+        await page.eval_on_selector(
+            "input", "(input, type) => input.setAttribute('type', type)", type
+        )
+        with pytest.raises(Error) as exc_info:
+            await page.clear("input")
+        assert f'Input of type "{type}" cannot be filled' in exc_info.value.message
+
+
+async def test_it_should_throw_nice_error_without_injected_script_stack_when_element_is_not_an_input_when_clear(
+    page: Page, server: Server
+):
+    await page.goto(server.PREFIX + "/input/textarea.html")
+    with pytest.raises(Error) as exc_info:
+        await page.clear("body")
+    assert (
+        "Element is not an <input>, <textarea> or [contenteditable] element"
+        in exc_info.value.message
+    )
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 828f145bb..af24e10e7 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -275,6 +275,15 @@ async def test_locators_fill_should_work(page: Page, server: Server):
     assert await page.evaluate("result") == "some value"
 
 
+async def test_locators_clear_should_work(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/textarea.html")
+    button = page.locator("input")
+    await button.fill("some value")
+    assert await page.evaluate("result") == "some value"
+    await button.clear()
+    assert await page.evaluate("result") == ""
+
+
 async def test_locators_check_should_work(page: Page):
     await page.set_content("<input id='checkbox' type='checkbox'></input>")
     button = page.locator("input")
@@ -822,3 +831,41 @@ async def test_locators_has_does_not_encode_unicode(page: Page, server: Server):
         with pytest.raises(Error) as exc_info:
             await locator.click(timeout=1_000)
         assert "Драматург" in exc_info.value.message
+
+
+async def test_locators_should_focus_and_blur_a_button(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.PREFIX + "/input/button.html")
+    button = page.locator("button")
+    assert not await button.evaluate("button => document.activeElement === button")
+
+    focused = False
+    blurred = False
+
+    async def focus_event() -> None:
+        nonlocal focused
+        focused = True
+
+    async def blur_event() -> None:
+        nonlocal blurred
+        blurred = True
+
+    await page.expose_function("focusEvent", focus_event)
+    await page.expose_function("blurEvent", blur_event)
+    await button.evaluate(
+        """button => {
+        button.addEventListener('focus', window['focusEvent']);
+        button.addEventListener('blur', window['blurEvent']);
+    }"""
+    )
+
+    await button.focus()
+    assert focused
+    assert not blurred
+    assert await button.evaluate("button => document.activeElement === button")
+
+    await button.blur()
+    assert focused
+    assert blurred
+    assert not await button.evaluate("button => document.activeElement === button")
diff --git a/tests/async/test_network.py b/tests/async/test_network.py
index 5f93f7f82..f118fe384 100644
--- a/tests/async/test_network.py
+++ b/tests/async/test_network.py
@@ -752,7 +752,7 @@ async def test_set_extra_http_headers_should_throw_for_non_string_header_values(
 
 
 async def test_response_server_addr(page: Page, server: Server):
-    response = await page.goto(server.EMPTY_PAGE)
+    response = await page.goto(f"http://127.0.0.1:{server.PORT}")
     server_addr = await response.server_addr()
     assert server_addr
     assert server_addr["port"] == server.PORT
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 71a63b51c..7ac48171b 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -1230,7 +1230,7 @@ async def test_fill_should_not_be_able_to_fill_text_into_the_input_type_number_(
     assert "Cannot type text into input[type=number]" in exc_info.value.message
 
 
-async def test_fill_should_be_able_to_clear(page, server):
+async def test_fill_should_be_able_to_clear_using_fill(page, server):
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.fill("input", "some value")
     assert await page.evaluate("result") == "some value"
@@ -1238,6 +1238,14 @@ async def test_fill_should_be_able_to_clear(page, server):
     assert await page.evaluate("result") == ""
 
 
+async def test_fill_should_be_able_to_clear_using_clear(page, server):
+    await page.goto(server.PREFIX + "/input/textarea.html")
+    await page.fill("input", "some value")
+    assert await page.evaluate("result") == "some value"
+    await page.clear("input")
+    assert await page.evaluate("result") == ""
+
+
 async def test_close_event_should_work_with_window_close(page, server):
     async with page.expect_popup() as popup_info:
         await page.evaluate("window['newPage'] = window.open('about:blank')")
diff --git a/tests/async/test_popup.py b/tests/async/test_popup.py
index 58804f3ba..d1dda1443 100644
--- a/tests/async/test_popup.py
+++ b/tests/async/test_popup.py
@@ -175,8 +175,16 @@ async def test_should_use_viewport_size_from_window_features(browser: Browser, s
     size = None
     async with page.expect_popup() as popup_info:
         size = await page.evaluate(
-            """() => {
-                win = window.open(window.location.href, 'Title', 'toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,width=600,height=300,top=0,left=0')
+            """async () => {
+                const win = window.open(window.location.href, 'Title', 'toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,width=600,height=300,top=0,left=0');
+                await new Promise(resolve => {
+                    const interval = setInterval(() => {
+                    if (win.innerWidth === 600 && win.innerHeight === 300) {
+                        clearInterval(interval);
+                        resolve();
+                    }
+                    }, 10);
+                });
                 return { width: win.innerWidth, height: win.innerHeight }
             }"""
         )
diff --git a/tests/async/test_selectors_text.py b/tests/async/test_selectors_text.py
new file mode 100644
index 000000000..1f09bdebd
--- /dev/null
+++ b/tests/async/test_selectors_text.py
@@ -0,0 +1,35 @@
+import re
+
+from playwright.async_api import Page, expect
+
+
+async def test_has_text_and_internal_text_should_match_full_node_text_in_strict_mode(
+    page: Page,
+) -> None:
+    await page.set_content(
+        """
+        <div id=div1>hello<span>world</span></div>
+        <div id=div2>hello</div>
+    """
+    )
+    await expect(page.get_by_text("helloworld", exact=True)).to_have_id("div1")
+    await expect(page.get_by_text("hello", exact=True)).to_have_id("div2")
+    await expect(page.locator("div", has_text=re.compile("^helloworld$"))).to_have_id(
+        "div1"
+    )
+    await expect(page.locator("div", has_text=re.compile("^hello$"))).to_have_id("div2")
+
+    await page.set_content(
+        """
+        <div id=div1><span id=span1>hello</span>world</div>
+        <div id=div2><span id=span2>hello</span></div>
+    """
+    )
+    await expect(page.get_by_text("helloworld", exact=True)).to_have_id("div1")
+    assert await page.get_by_text("hello", exact=True).evaluate_all(
+        "els => els.map(e => e.id)"
+    ) == ["span1", "span2"]
+    await expect(page.locator("div", has_text=re.compile("^helloworld$"))).to_have_id(
+        "div1"
+    )
+    await expect(page.locator("div", has_text=re.compile("^hello$"))).to_have_id("div2")
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index f20578d46..6dd27c7a1 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -206,6 +206,27 @@ async def test_should_work_with_playwright_context_managers(
     ]
 
 
+async def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
+    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+) -> None:
+    await context.tracing.start(screenshots=True, snapshots=True)
+
+    await page.goto(server.EMPTY_PAGE)
+    await page.wait_for_load_state("load")
+    await page.wait_for_load_state("load")
+
+    trace_file_path = tmpdir / "trace.zip"
+    await context.tracing.stop(path=trace_file_path)
+
+    (_, events) = parse_trace(trace_file_path)
+    assert get_actions(events) == [
+        "Page.goto",
+        "Page.wait_for_load_state",
+        "Page.wait_for_load_state",
+        "Tracing.stop",
+    ]
+
+
 def parse_trace(path: Path) -> Tuple[Dict[str, bytes], List[Any]]:
     resources: Dict[str, bytes] = {}
     with zipfile.ZipFile(path, "r") as zip:
diff --git a/tests/server.py b/tests/server.py
index 75a0631d2..b6f12d87f 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -209,7 +209,11 @@ def handle_redirect(request: http.Request) -> None:
 
 class HTTPServer(Server):
     def listen(self, factory: ClientFactory) -> None:
-        reactor.listenTCP(self.PORT, factory)
+        reactor.listenTCP(self.PORT, factory, interface="127.0.0.1")
+        try:
+            reactor.listenTCP(self.PORT, factory, interface="::1")
+        except Exception:
+            pass
 
 
 class HTTPSServer(Server):
@@ -225,7 +229,11 @@ def listen(self, factory: ClientFactory) -> None:
             ),
         )
         contextFactory = cert.options()
-        reactor.listenSSL(self.PORT, factory, contextFactory)
+        reactor.listenSSL(self.PORT, factory, contextFactory, interface="127.0.0.1")
+        try:
+            reactor.listenSSL(self.PORT, factory, contextFactory, interface="::1")
+        except Exception:
+            pass
 
 
 class WebSocketServerServer(WebSocketServerProtocol):
diff --git a/tests/sync/test_accessibility.py b/tests/sync/test_accessibility.py
index 14b1347bc..d4fdb9dfa 100644
--- a/tests/sync/test_accessibility.py
+++ b/tests/sync/test_accessibility.py
@@ -173,78 +173,6 @@ def test_accessibility_filtering_children_of_leaf_nodes_should_not_report_text_n
     assert page.accessibility.snapshot() == golden
 
 
-# WebKit rich text accessibility is iffy
-@pytest.mark.skip_browser("webkit")
-def test_accessibility_filtering_children_of_leaf_nodes_rich_text_editable_fields_should_have_children(
-    page: Page, is_firefox: bool
-) -> None:
-    page.set_content(
-        """
-    <div contenteditable="true">
-    Edit this image: <img src="fakeimage.png" alt="my fake image">
-    </div>"""
-    )
-    golden = (
-        {
-            "role": "section",
-            "name": "",
-            "children": [
-                {"role": "text leaf", "name": "Edit this image: "},
-                {"role": "text", "name": "my fake image"},
-            ],
-        }
-        if is_firefox
-        else {
-            "role": "generic",
-            "name": "",
-            "value": "Edit this image: ",
-            "children": [
-                {"role": "text", "name": "Edit this image:"},
-                {"role": "img", "name": "my fake image"},
-            ],
-        }
-    )
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == golden
-
-
-# WebKit rich text accessibility is iffy
-@pytest.mark.skip_browser("webkit")
-def test_accessibility_filtering_children_of_leaf_nodes_rich_text_editable_fields_with_role_should_have_children(
-    page: Page, is_firefox: bool
-) -> None:
-    page.set_content(
-        """
-        <div contenteditable="true">
-            Edit this image: <img src="fakeimage.png" alt="my fake image">
-        </div>
-    """
-    )
-    if is_firefox:
-        golden = {
-            "role": "section",
-            "name": "",
-            "children": [
-                {"role": "text leaf", "name": "Edit this image: "},
-                {"role": "text", "name": "my fake image"},
-            ],
-        }
-    else:
-        golden = {
-            "role": "generic",
-            "name": "",
-            "value": "Edit this image: ",
-            "children": [
-                {"role": "text", "name": "Edit this image:"},
-                {"role": "img", "name": "my fake image"},
-            ],
-        }
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == golden
-
-
 # Firefox does not support contenteditable="plaintext-only".
 # WebKit rich text accessibility is iffy
 @pytest.mark.only_browser("chromium")
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 29e1773bd..1f813ff74 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -218,15 +218,6 @@ def test_to_have_js_property_fail_boolean_2(page: Page) -> None:
         expect(locator).to_have_js_property("foo", True, timeout=500)
 
 
-@pytest.mark.skip("https://github.com/microsoft/playwright/issues/14909")
-def test_to_have_js_property_pass_undefined(page: Page) -> None:
-    page.set_content("<div></div>")
-    locator = page.locator("div")
-    expect(locator).to_have_js_property(
-        "foo", None
-    )  # Python does not have an undefined
-
-
 def test_to_have_js_property_pass_null(page: Page) -> None:
     page.set_content("<div></div>")
     page.eval_on_selector("div", "e => e.foo = null")
diff --git a/tests/sync/test_browsertype_connect_cdp.py b/tests/sync/test_browsertype_connect_cdp.py
index d10f10186..27be1ba8f 100644
--- a/tests/sync/test_browsertype_connect_cdp.py
+++ b/tests/sync/test_browsertype_connect_cdp.py
@@ -29,7 +29,7 @@ def test_connect_to_an_existing_cdp_session(
     browser_server = browser_type.launch(
         **launch_arguments, args=[f"--remote-debugging-port={port}"]
     )
-    cdp_browser = browser_type.connect_over_cdp(f"http://localhost:{port}")
+    cdp_browser = browser_type.connect_over_cdp(f"http://127.0.0.1:{port}")
     assert len(cdp_browser.contexts) == 1
     cdp_browser.close()
     browser_server.close()
diff --git a/tests/sync/test_element_handle.py b/tests/sync/test_element_handle.py
index 22e7d626b..b3c110cb9 100644
--- a/tests/sync/test_element_handle.py
+++ b/tests/sync/test_element_handle.py
@@ -421,6 +421,16 @@ def test_fill_input_when_Node_is_removed(page: Page, server: Server) -> None:
     assert page.evaluate("result") == "some value"
 
 
+def test_clear_input(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/textarea.html")
+    handle = page.query_selector("input")
+    assert handle
+    handle.fill("some value")
+    assert page.evaluate("result") == "some value"
+    handle.clear()
+    assert page.evaluate("result") == ""
+
+
 def test_select_textarea(page: Page, server: Server, is_firefox: bool) -> None:
     page.goto(server.PREFIX + "/input/textarea.html")
     textarea = page.query_selector("textarea")
diff --git a/tests/sync/test_fill.py b/tests/sync/test_fill.py
new file mode 100644
index 000000000..86aa3dca7
--- /dev/null
+++ b/tests/sync/test_fill.py
@@ -0,0 +1,55 @@
+# 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 Error, Page
+from tests.server import Server
+
+
+def test_fill_textarea(page: Page, server: Server) -> None:
+    page.goto(f"{server.PREFIX}/input/textarea.html")
+    page.fill("textarea", "some value")
+    assert page.evaluate("result") == "some value"
+
+
+def test_fill_input(page: Page, server: Server) -> None:
+    page.goto(f"{server.PREFIX}/input/textarea.html")
+    page.fill("input", "some value")
+    assert page.evaluate("result") == "some value"
+
+
+def test_should_throw_on_unsupported_inputs_when_clear(
+    page: Page, server: Server
+) -> None:
+    page.goto(f"{server.PREFIX}/input/textarea.html")
+    for type in ["button", "checkbox", "file", "image", "radio", "reset", "submit"]:
+        page.eval_on_selector(
+            "input", "(input, type) => input.setAttribute('type', type)", type
+        )
+        with pytest.raises(Error) as exc_info:
+            page.clear("input")
+        assert f'input of type "{type}" cannot be filled' in exc_info.value.message
+
+
+def test_it_should_throw_nice_error_without_injected_script_stack_when_element_is_not_an_input_when_clear(
+    page: Page, server: Server
+) -> None:
+    page.goto(server.PREFIX + "/input/textarea.html")
+    with pytest.raises(Error) as exc_info:
+        page.clear("body")
+    assert (
+        "Element is not an <input>, <textarea> or [contenteditable] element"
+        in exc_info.value.message
+    )
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 6e204336c..009430954 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -268,6 +268,15 @@ def test_locators_fill_should_work(page: Page, server: Server) -> None:
     assert page.evaluate("result") == "some value"
 
 
+def test_locators_clear_should_work(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/textarea.html")
+    button = page.locator("input")
+    button.fill("some value")
+    assert page.evaluate("result") == "some value"
+    button.clear()
+    assert page.evaluate("result") == ""
+
+
 def test_locators_check_should_work(page: Page) -> None:
     page.set_content("<input id='checkbox' type='checkbox'></input>")
     button = page.locator("input")
@@ -724,3 +733,39 @@ def test_locators_has_does_not_encode_unicode(page: Page, server: Server) -> Non
         with pytest.raises(Error) as exc_info:
             locator.click(timeout=1_000)
         assert "Драматург" in exc_info.value.message
+
+
+def test_locators_should_focus_and_blur_a_button(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/button.html")
+    button = page.locator("button")
+    assert not button.evaluate("button => document.activeElement === button")
+
+    focused = False
+    blurred = False
+
+    async def focus_event() -> None:
+        nonlocal focused
+        focused = True
+
+    async def blur_event() -> None:
+        nonlocal blurred
+        blurred = True
+
+    page.expose_function("focusEvent", focus_event)
+    page.expose_function("blurEvent", blur_event)
+    button.evaluate(
+        """button => {
+        button.addEventListener('focus', window['focusEvent']);
+        button.addEventListener('blur', window['blurEvent']);
+    }"""
+    )
+
+    button.focus()
+    assert focused
+    assert not blurred
+    assert button.evaluate("button => document.activeElement === button")
+
+    button.blur()
+    assert focused
+    assert blurred
+    assert not button.evaluate("button => document.activeElement === button")
diff --git a/tests/sync/test_network.py b/tests/sync/test_network.py
index da4b52424..2ec6d7da9 100644
--- a/tests/sync/test_network.py
+++ b/tests/sync/test_network.py
@@ -19,7 +19,7 @@
 
 
 def test_response_server_addr(page: Page, server: Server) -> None:
-    response = page.goto(server.EMPTY_PAGE)
+    response = page.goto(f"http://127.0.0.1:{server.PORT}")
     assert response
     server_addr = response.server_addr()
     assert server_addr
diff --git a/tests/sync/test_page.py b/tests/sync/test_page.py
index ccb229196..f13a5f56b 100644
--- a/tests/sync/test_page.py
+++ b/tests/sync/test_page.py
@@ -84,3 +84,11 @@ def test_emitted_for_domcontentloaded_and_load(page: Page, server: Server) -> No
             page.goto(server.EMPTY_PAGE)
     assert isinstance(dom_info.value, Page)
     assert isinstance(load_info.value, Page)
+
+
+def test_fill_should_be_able_to_clear_using_clear(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/textarea.html")
+    page.fill("input", "some value")
+    assert page.evaluate("result") == "some value"
+    page.clear("input")
+    assert page.evaluate("result") == ""
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index 94107f1df..b953640c6 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -206,6 +206,27 @@ def test_should_work_with_playwright_context_managers(
     ]
 
 
+def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
+    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+) -> None:
+    context.tracing.start(screenshots=True, snapshots=True)
+
+    page.goto(server.EMPTY_PAGE)
+    page.wait_for_load_state("load")
+    page.wait_for_load_state("load")
+
+    trace_file_path = tmpdir / "trace.zip"
+    context.tracing.stop(path=trace_file_path)
+
+    (_, events) = parse_trace(trace_file_path)
+    assert get_actions(events) == [
+        "Page.goto",
+        "Page.wait_for_load_state",
+        "Page.wait_for_load_state",
+        "Tracing.stop",
+    ]
+
+
 def parse_trace(path: Path) -> Tuple[Dict[str, bytes], List[Any]]:
     resources: Dict[str, bytes] = {}
     with zipfile.ZipFile(path, "r") as zip:

From 982c703c55dfccd7486636d13fced7b97a55ec43 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 8 Nov 2022 14:22:06 -0800
Subject: [PATCH 017/438] chore: various type fixes (#1636)

---
 playwright/_impl/_browser_context.py    | 2 +-
 playwright/_impl/_browser_type.py       | 2 +-
 playwright/_impl/_connection.py         | 2 +-
 playwright/_impl/_js_handle.py          | 6 +++---
 playwright/_impl/_json_pipe.py          | 1 +
 playwright/_impl/_network.py            | 4 +++-
 playwright/_impl/_page.py               | 4 ++--
 playwright/_impl/_playwright.py         | 2 +-
 playwright/sync_api/_context_manager.py | 7 ++++---
 9 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 38f375f4d..2afbab914 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -320,7 +320,7 @@ async def _record_into_har(
         page: Optional[Page] = None,
         url: Union[Pattern[str], str] = None,
     ) -> None:
-        params = {
+        params: Dict[str, Any] = {
             "options": prepare_record_har_options(
                 {
                     "recordHarPath": har,
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index aeeab8422..afe69980d 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -54,7 +54,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        _playwright: "Playwright"
+        self._playwright: "Playwright"
 
     def __repr__(self) -> str:
         return f"<BrowserType name={self.name} executable_path={self.executable_path}>"
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 0243d85a1..dd4d2eac0 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -290,7 +290,7 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
             return
 
         guid = msg["guid"]
-        method = msg.get("method")
+        method = msg["method"]
         params = msg.get("params")
         if method == "__create__":
             assert params
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index d0b72dcc7..51e1ee18a 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -17,7 +17,7 @@
 from typing import TYPE_CHECKING, Any, Dict, List, Optional
 from urllib.parse import ParseResult, urlparse, urlunparse
 
-from playwright._impl._connection import ChannelOwner, from_channel
+from playwright._impl._connection import Channel, ChannelOwner, from_channel
 from playwright._impl._map import Map
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -107,7 +107,7 @@ async def json_value(self) -> Any:
 
 
 def serialize_value(
-    value: Any, handles: List[JSHandle], visitor_info: Optional[VisitorInfo] = None
+    value: Any, handles: List[Channel], visitor_info: Optional[VisitorInfo] = None
 ) -> Any:
     if visitor_info is None:
         visitor_info = VisitorInfo()
@@ -159,7 +159,7 @@ def serialize_value(
 
 
 def serialize_argument(arg: Serializable = None) -> Any:
-    handles: List[JSHandle] = []
+    handles: List[Channel] = []
     value = serialize_value(arg, handles)
     return dict(value=value, handles=handles)
 
diff --git a/playwright/_impl/_json_pipe.py b/playwright/_impl/_json_pipe.py
index a237a63df..311c284e8 100644
--- a/playwright/_impl/_json_pipe.py
+++ b/playwright/_impl/_json_pipe.py
@@ -33,6 +33,7 @@ def __init__(
         Transport.__init__(self, loop)
         self._stop_requested = False
         self._pipe_channel = pipe_channel
+        self._loop: asyncio.AbstractEventLoop
 
     def request_stop(self) -> None:
         self._stop_requested = True
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index f89626b6e..46fadf62c 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -54,6 +54,7 @@
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._fetch import APIResponse
     from playwright._impl._frame import Frame
+    from playwright._impl._page import Page
 
 
 def serialize_headers(headers: Dict[str, str]) -> HeadersArray:
@@ -513,6 +514,7 @@ def __init__(
     ) -> None:
         super().__init__(parent, type, guid, initializer)
         self._is_closed = False
+        self._page = cast("Page", parent)
         self._channel.on(
             "frameSent",
             lambda params: self._on_frame_sent(params["opcode"], params["data"]),
@@ -555,7 +557,7 @@ def expect_event(
             wait_helper.reject_on_event(
                 self, WebSocket.Events.Error, Error("Socket error")
             )
-        wait_helper.reject_on_event(self._parent, "close", Error("Page closed"))
+        wait_helper.reject_on_event(self._page, "close", Error("Page closed"))
         wait_helper.wait_for_event(self, event, predicate)
         return EventContextManagerImpl(wait_helper.result())
 
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 52c31830f..2e4c27c7e 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -133,7 +133,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self._browser_context: BrowserContext = parent
+        self._browser_context = cast("BrowserContext", parent)
         self.accessibility = Accessibility(self._channel)
         self.keyboard = Keyboard(self._channel)
         self.mouse = Mouse(self._channel)
@@ -1268,7 +1268,7 @@ async def call(self, func: Callable) -> None:
             )
 
 
-def trim_url(param: URLMatchRequest) -> Optional[str]:
+def trim_url(param: Union[URLMatchRequest, URLMatchResponse]) -> Optional[str]:
     if isinstance(param, re.Pattern):
         return trim_end(param.pattern)
     if isinstance(param, str):
diff --git a/playwright/_impl/_playwright.py b/playwright/_impl/_playwright.py
index f9fe7617f..746b2e830 100644
--- a/playwright/_impl/_playwright.py
+++ b/playwright/_impl/_playwright.py
@@ -64,7 +64,7 @@ def __getitem__(self, value: str) -> "BrowserType":
             return self.webkit
         raise ValueError("Invalid browser " + value)
 
-    def _set_selectors(self, selectors: SelectorsOwner) -> None:
+    def _set_selectors(self, selectors: Selectors) -> None:
         selectors_owner = from_channel(self._initializer["selectors"])
         self.selectors._remove_channel(selectors_owner)
         self.selectors = selectors
diff --git a/playwright/sync_api/_context_manager.py b/playwright/sync_api/_context_manager.py
index 0fe9b552b..5cae1ea1d 100644
--- a/playwright/sync_api/_context_manager.py
+++ b/playwright/sync_api/_context_manager.py
@@ -14,12 +14,12 @@
 
 import asyncio
 import sys
-from typing import Any, Optional
+from typing import Any, Optional, cast
 
 from greenlet import greenlet
 
 from playwright._impl._api_types import Error
-from playwright._impl._connection import Connection
+from playwright._impl._connection import ChannelOwner, Connection
 from playwright._impl._driver import compute_driver_executable
 from playwright._impl._object_factory import create_remote_object
 from playwright._impl._playwright import Playwright
@@ -77,7 +77,8 @@ def greenlet_main() -> None:
 
         g_self = greenlet.getcurrent()
 
-        def callback_wrapper(playwright_impl: Playwright) -> None:
+        def callback_wrapper(channel_owner: ChannelOwner) -> None:
+            playwright_impl = cast(Playwright, channel_owner)
             self._playwright = SyncPlaywright(playwright_impl)
             g_self.switch()
 

From bb8fce9d8165ad53c3dc41557afd590bc261fc9d Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 8 Nov 2022 14:24:08 -0800
Subject: [PATCH 018/438] chore: bump pyee to 9.0.4 (#1637)

---
 meta.yaml                       | 2 +-
 playwright/_impl/_connection.py | 3 ++-
 playwright/_impl/_json_pipe.py  | 2 +-
 setup.py                        | 2 +-
 4 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/meta.yaml b/meta.yaml
index 8df796e27..dfb8f90e9 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -24,7 +24,7 @@ requirements:
   run:
     - python
     - greenlet ==1.1.3
-    - pyee ==8.1.0
+    - pyee ==9.0.4
     - typing_extensions # [py<39]
 test:
   requires:
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index dd4d2eac0..fd15bc6e4 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -21,7 +21,8 @@
 from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Union, cast
 
 from greenlet import greenlet
-from pyee import AsyncIOEventEmitter, EventEmitter
+from pyee import EventEmitter
+from pyee.asyncio import AsyncIOEventEmitter
 
 import playwright
 from playwright._impl._helper import ParsedMessagePayload, parse_error
diff --git a/playwright/_impl/_json_pipe.py b/playwright/_impl/_json_pipe.py
index 311c284e8..b4452c700 100644
--- a/playwright/_impl/_json_pipe.py
+++ b/playwright/_impl/_json_pipe.py
@@ -15,7 +15,7 @@
 import asyncio
 from typing import Dict, Optional, cast
 
-from pyee import AsyncIOEventEmitter
+from pyee.asyncio import AsyncIOEventEmitter
 
 from playwright._impl._api_types import Error
 from playwright._impl._connection import Channel
diff --git a/setup.py b/setup.py
index 8cfafb382..d90f5c6c6 100644
--- a/setup.py
+++ b/setup.py
@@ -213,7 +213,7 @@ def _download_and_extract_local_driver(
     include_package_data=True,
     install_requires=[
         "greenlet==1.1.3",
-        "pyee==8.1.0",
+        "pyee==9.0.4",
         "typing-extensions;python_version<='3.8'",
     ],
     classifiers=[

From cc5579c0c2eff989bf91c0cf42f773b4a9dfd650 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 14 Nov 2022 11:29:33 -1000
Subject: [PATCH 019/438] chore(roll): roll Playwright to
 1.28.0-alpha-nov-11-2022 (#1642)

---
 README.md                            |   2 +-
 playwright/_impl/_browser_context.py |   8 ++
 playwright/_impl/_connection.py      |  22 ++++
 playwright/_impl/_element_handle.py  |   8 --
 playwright/_impl/_frame.py           |  17 ----
 playwright/_impl/_page.py            |  45 +++------
 playwright/async_api/_generated.py   | 139 +------------------------
 playwright/sync_api/_generated.py    | 145 +--------------------------
 scripts/documentation_provider.py    |   2 -
 setup.py                             |   2 +-
 tests/async/test_element_handle.py   |  10 --
 tests/async/test_fill.py             |  30 ------
 tests/async/test_locators.py         |   2 +-
 tests/async/test_page.py             |   8 --
 tests/async/test_video.py            |   1 +
 tests/sync/test_element_handle.py    |  10 --
 tests/sync/test_fill.py              |  29 +-----
 tests/sync/test_locators.py          |   2 +-
 tests/sync/test_page.py              |   8 --
 tests/sync/test_video.py             |   3 +-
 20 files changed, 57 insertions(+), 436 deletions(-)

diff --git a/README.md b/README.md
index 2731c3a28..93a5011bb 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->108.0.5359.22<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->108.0.5359.29<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->106.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 2afbab914..07c9ae79e 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -163,6 +163,14 @@ def __init__(
         self.once(
             self.Events.Close, lambda context: self._closed_future.set_result(True)
         )
+        self._set_event_to_subscription_mapping(
+            {
+                BrowserContext.Events.Request: "request",
+                BrowserContext.Events.Response: "response",
+                BrowserContext.Events.RequestFinished: "requestFinished",
+                BrowserContext.Events.RequestFailed: "requestFailed",
+            }
+        )
 
     def __repr__(self) -> str:
         return f"<BrowserContext browser={self.browser}>"
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index fd15bc6e4..08652e3e4 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -119,6 +119,8 @@ def __init__(
         if self._parent:
             self._parent._objects[guid] = self
 
+        self._event_to_subscription_mapping: Dict[str, str] = {}
+
     def _dispose(self) -> None:
         # Clean up from parent and connection.
         if self._parent:
@@ -135,6 +137,26 @@ def _adopt(self, child: "ChannelOwner") -> None:
         self._objects[child._guid] = child
         child._parent = self
 
+    def _set_event_to_subscription_mapping(self, mapping: Dict[str, str]) -> None:
+        self._event_to_subscription_mapping = mapping
+
+    def _update_subscription(self, event: str, enabled: bool) -> None:
+        protocol_event = self._event_to_subscription_mapping.get(event)
+        if protocol_event:
+            self._channel.send_no_reply(
+                "updateSubscription", {"event": protocol_event, "enabled": enabled}
+            )
+
+    def _add_event_handler(self, event: str, k: Any, v: Any) -> None:
+        if not self.listeners(event):
+            self._update_subscription(event, True)
+        super()._add_event_handler(event, k, v)
+
+    def remove_listener(self, event: str, f: Any) -> None:
+        super().remove_listener(event, f)
+        if not self.listeners(event):
+            self._update_subscription(event, False)
+
 
 class ProtocolCallback:
     def __init__(self, loop: asyncio.AbstractEventLoop) -> None:
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 7e20dac1d..0cf33a160 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -218,14 +218,6 @@ async def type(
     ) -> None:
         await self._channel.send("type", locals_to_params(locals()))
 
-    async def clear(
-        self,
-        timeout: float = None,
-        noWaitAfter: bool = None,
-        force: bool = None,
-    ) -> None:
-        await self.fill("", **locals_to_params(locals()))
-
     async def press(
         self,
         key: str,
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 0f446b6f3..2ccb8da6c 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -794,22 +794,5 @@ async def set_checked(
                 trial=trial,
             )
 
-    async def clear(
-        self,
-        selector: str,
-        timeout: float = None,
-        noWaitAfter: bool = None,
-        force: bool = None,
-        strict: bool = None,
-    ) -> None:
-        await self.fill(
-            selector,
-            "",
-            timeout=timeout,
-            noWaitAfter=noWaitAfter,
-            force=force,
-            strict=strict,
-        )
-
     async def _highlight(self, selector: str) -> None:
         await self._channel.send("highlight", {"selector": selector})
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 2e4c27c7e..31b058f64 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -221,6 +221,16 @@ def __init__(
             else None,
         )
 
+        self._set_event_to_subscription_mapping(
+            {
+                Page.Events.Request: "request",
+                Page.Events.Response: "response",
+                Page.Events.RequestFinished: "requestFinished",
+                Page.Events.RequestFailed: "requestFailed",
+                Page.Events.FileChooser: "fileChooser",
+            }
+        )
+
     def __repr__(self) -> str:
         return f"<Page url={self.url!r}>"
 
@@ -294,20 +304,6 @@ def _on_video(self, params: Any) -> None:
         artifact = from_channel(params["artifact"])
         cast(Video, self.video)._artifact_ready(artifact)
 
-    def _add_event_handler(self, event: str, k: Any, v: Any) -> None:
-        if event == Page.Events.FileChooser and len(self.listeners(event)) == 0:
-            self._channel.send_no_reply(
-                "setFileChooserInterceptedNoReply", {"intercepted": True}
-            )
-        super()._add_event_handler(event, k, v)
-
-    def remove_listener(self, event: str, f: Any) -> None:
-        super().remove_listener(event, f)
-        if event == Page.Events.FileChooser and len(self.listeners(event)) == 0:
-            self._channel.send_no_reply(
-                "setFileChooserInterceptedNoReply", {"intercepted": False}
-            )
-
     @property
     def context(self) -> "BrowserContext":
         return self._browser_context
@@ -545,12 +541,14 @@ async def go_forward(
 
     async def emulate_media(
         self,
-        media: Literal["print", "screen"] = None,
+        media: Literal["null", "print", "screen"] = None,
         colorScheme: ColorScheme = None,
         reducedMotion: ReducedMotion = None,
         forcedColors: ForcedColors = None,
     ) -> None:
         params = locals_to_params(locals())
+        if "media" in params:
+            params["media"] = "no-override" if params["media"] == "null" else media
         if "colorScheme" in params:
             params["colorScheme"] = (
                 "no-override" if params["colorScheme"] == "null" else colorScheme
@@ -741,23 +739,6 @@ async def fill(
     ) -> None:
         return await self._main_frame.fill(**locals_to_params(locals()))
 
-    async def clear(
-        self,
-        selector: str,
-        timeout: float = None,
-        noWaitAfter: bool = None,
-        force: bool = None,
-        strict: bool = None,
-    ) -> None:
-        await self.fill(
-            selector,
-            "",
-            timeout=timeout,
-            noWaitAfter=noWaitAfter,
-            force=force,
-            strict=strict,
-        )
-
     def locator(
         self,
         selector: str,
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 842544448..99667d85d 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -2228,42 +2228,6 @@ async def type(
             )
         )
 
-    async def clear(
-        self,
-        *,
-        timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
-    ) -> None:
-        """ElementHandle.clear
-
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
-        `input` event after clearing.
-
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
-        instead.
-
-        Parameters
-        ----------
-        timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
-        no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
-        force : Union[bool, None]
-            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
-        """
-
-        return mapping.from_maybe_impl(
-            await self._impl_obj.clear(
-                timeout=timeout, noWaitAfter=no_wait_after, force=force
-            )
-        )
-
     async def press(
         self,
         key: str,
@@ -5575,54 +5539,6 @@ async def set_checked(
             )
         )
 
-    async def clear(
-        self,
-        selector: str,
-        *,
-        timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
-    ) -> None:
-        """Frame.clear
-
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
-        element, clears it and triggers an `input` event after clearing.
-
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
-        instead.
-
-        Parameters
-        ----------
-        selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
-        timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
-        no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
-        force : Union[bool, None]
-            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
-        strict : Union[bool, None]
-            When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
-            element, the call throws an exception.
-        """
-
-        return mapping.from_maybe_impl(
-            await self._impl_obj.clear(
-                selector=selector,
-                timeout=timeout,
-                noWaitAfter=no_wait_after,
-                force=force,
-                strict=strict,
-            )
-        )
-
 
 mapping.register(FrameImpl, Frame)
 
@@ -8499,7 +8415,7 @@ async def go_forward(
     async def emulate_media(
         self,
         *,
-        media: typing.Optional[Literal["print", "screen"]] = None,
+        media: typing.Optional[Literal["null", "print", "screen"]] = None,
         color_scheme: typing.Optional[
             Literal["dark", "light", "no-preference", "null"]
         ] = None,
@@ -8544,8 +8460,8 @@ async def emulate_media(
 
         Parameters
         ----------
-        media : Union["print", "screen", None]
-            Changes the CSS media type of the page. The only allowed values are `'screen'`, `'print'` and `null`. Passing `null`
+        media : Union["null", "print", "screen", None]
+            Changes the CSS media type of the page. The only allowed values are `'Screen'`, `'Print'` and `'Null'`. Passing `'Null'`
             disables CSS media emulation.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. Passing
@@ -9204,55 +9120,6 @@ async def fill(
             )
         )
 
-    async def clear(
-        self,
-        selector: str,
-        *,
-        timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
-    ) -> None:
-        """Page.clear
-
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
-        element, clears it and triggers an `input` event after clearing. Note that you can pass an empty string to clear the
-        input field.
-
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
-        instead.
-
-        Parameters
-        ----------
-        selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
-        timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
-        no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
-        force : Union[bool, None]
-            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
-        strict : Union[bool, None]
-            When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
-            element, the call throws an exception.
-        """
-
-        return mapping.from_maybe_impl(
-            await self._impl_obj.clear(
-                selector=selector,
-                timeout=timeout,
-                noWaitAfter=no_wait_after,
-                force=force,
-                strict=strict,
-            )
-        )
-
     def locator(
         self,
         selector: str,
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 9fd929303..4a8d5bf71 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -2248,44 +2248,6 @@ def type(
             )
         )
 
-    def clear(
-        self,
-        *,
-        timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
-    ) -> None:
-        """ElementHandle.clear
-
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
-        `input` event after clearing.
-
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
-        instead.
-
-        Parameters
-        ----------
-        timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
-        no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
-        force : Union[bool, None]
-            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
-        """
-
-        return mapping.from_maybe_impl(
-            self._sync(
-                self._impl_obj.clear(
-                    timeout=timeout, noWaitAfter=no_wait_after, force=force
-                )
-            )
-        )
-
     def press(
         self,
         key: str,
@@ -5685,56 +5647,6 @@ def set_checked(
             )
         )
 
-    def clear(
-        self,
-        selector: str,
-        *,
-        timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
-    ) -> None:
-        """Frame.clear
-
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
-        element, clears it and triggers an `input` event after clearing.
-
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
-        instead.
-
-        Parameters
-        ----------
-        selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
-        timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
-        no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
-        force : Union[bool, None]
-            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
-        strict : Union[bool, None]
-            When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
-            element, the call throws an exception.
-        """
-
-        return mapping.from_maybe_impl(
-            self._sync(
-                self._impl_obj.clear(
-                    selector=selector,
-                    timeout=timeout,
-                    noWaitAfter=no_wait_after,
-                    force=force,
-                    strict=strict,
-                )
-            )
-        )
-
 
 mapping.register(FrameImpl, Frame)
 
@@ -8534,7 +8446,7 @@ def go_forward(
     def emulate_media(
         self,
         *,
-        media: typing.Optional[Literal["print", "screen"]] = None,
+        media: typing.Optional[Literal["null", "print", "screen"]] = None,
         color_scheme: typing.Optional[
             Literal["dark", "light", "no-preference", "null"]
         ] = None,
@@ -8578,8 +8490,8 @@ def emulate_media(
 
         Parameters
         ----------
-        media : Union["print", "screen", None]
-            Changes the CSS media type of the page. The only allowed values are `'screen'`, `'print'` and `null`. Passing `null`
+        media : Union["null", "print", "screen", None]
+            Changes the CSS media type of the page. The only allowed values are `'Screen'`, `'Print'` and `'Null'`. Passing `'Null'`
             disables CSS media emulation.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. Passing
@@ -9256,57 +9168,6 @@ def fill(
             )
         )
 
-    def clear(
-        self,
-        selector: str,
-        *,
-        timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
-    ) -> None:
-        """Page.clear
-
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
-        element, clears it and triggers an `input` event after clearing. Note that you can pass an empty string to clear the
-        input field.
-
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
-        instead.
-
-        Parameters
-        ----------
-        selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
-        timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
-        no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
-        force : Union[bool, None]
-            Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
-        strict : Union[bool, None]
-            When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
-            element, the call throws an exception.
-        """
-
-        return mapping.from_maybe_impl(
-            self._sync(
-                self._impl_obj.clear(
-                    selector=selector,
-                    timeout=timeout,
-                    noWaitAfter=no_wait_after,
-                    force=force,
-                    strict=strict,
-                )
-            )
-        )
-
     def locator(
         self,
         selector: str,
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 6512965f7..0b3f0dc92 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -122,8 +122,6 @@ def print_entry(
     ) -> None:
         if class_name in ["BindingCall"] or method_name in [
             "pid",
-            "_add_event_handler",
-            "remove_listener",
         ]:
             return
         original_method_name = method_name
diff --git a/setup.py b/setup.py
index d90f5c6c6..5f6d82c91 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.28.0-alpha-1667504282000"
+driver_version = "1.28.0-alpha-nov-11-2022"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_element_handle.py b/tests/async/test_element_handle.py
index f900197b4..d47e6a78c 100644
--- a/tests/async/test_element_handle.py
+++ b/tests/async/test_element_handle.py
@@ -442,16 +442,6 @@ async def test_fill_input_when_Node_is_removed(page, server):
     assert await page.evaluate("result") == "some value"
 
 
-async def test_clear_input(page: Page, server: Server) -> None:
-    await page.goto(server.PREFIX + "/input/textarea.html")
-    handle = await page.query_selector("input")
-    assert handle
-    await handle.fill("some value")
-    assert await page.evaluate("result") == "some value"
-    await handle.clear()
-    assert await page.evaluate("result") == ""
-
-
 async def test_select_textarea(page, server, is_firefox):
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
diff --git a/tests/async/test_fill.py b/tests/async/test_fill.py
index 03357e42b..9e5d252f0 100644
--- a/tests/async/test_fill.py
+++ b/tests/async/test_fill.py
@@ -12,11 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import pytest
-
-from playwright.async_api import Error, Page
-from tests.server import Server
-
 
 async def test_fill_textarea(page, server):
     await page.goto(f"{server.PREFIX}/input/textarea.html")
@@ -28,28 +23,3 @@ async def test_fill_input(page, server):
     await page.goto(f"{server.PREFIX}/input/textarea.html")
     await page.fill("input", "some value")
     assert await page.evaluate("result") == "some value"
-
-
-async def test_should_throw_on_unsupported_inputs_when_clear(
-    page: Page, server: Server
-):
-    await page.goto(f"{server.PREFIX}/input/textarea.html")
-    for type in ["button", "checkbox", "file", "image", "radio", "reset", "submit"]:
-        await page.eval_on_selector(
-            "input", "(input, type) => input.setAttribute('type', type)", type
-        )
-        with pytest.raises(Error) as exc_info:
-            await page.clear("input")
-        assert f'Input of type "{type}" cannot be filled' in exc_info.value.message
-
-
-async def test_it_should_throw_nice_error_without_injected_script_stack_when_element_is_not_an_input_when_clear(
-    page: Page, server: Server
-):
-    await page.goto(server.PREFIX + "/input/textarea.html")
-    with pytest.raises(Error) as exc_info:
-        await page.clear("body")
-    assert (
-        "Element is not an <input>, <textarea> or [contenteditable] element"
-        in exc_info.value.message
-    )
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index af24e10e7..3519d83d2 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -579,7 +579,7 @@ async def test_locator_frame_locator_should_throw_on_ambiguity(
     button = page.locator("body").frame_locator("iframe").locator("button")
     with pytest.raises(
         Error,
-        match='.*strict mode violation: "body >> iframe" resolved to 3 elements.*',
+        match=r'.*strict mode violation: locator\("body"\)\.locator\("iframe"\) resolved to 3 elements.*',
     ):
         await button.wait_for()
 
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 7ac48171b..705c0d76f 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -1238,14 +1238,6 @@ async def test_fill_should_be_able_to_clear_using_fill(page, server):
     assert await page.evaluate("result") == ""
 
 
-async def test_fill_should_be_able_to_clear_using_clear(page, server):
-    await page.goto(server.PREFIX + "/input/textarea.html")
-    await page.fill("input", "some value")
-    assert await page.evaluate("result") == "some value"
-    await page.clear("input")
-    assert await page.evaluate("result") == ""
-
-
 async def test_close_event_should_work_with_window_close(page, server):
     async with page.expect_popup() as popup_info:
         await page.evaluate("window['newPage'] = window.open('about:blank')")
diff --git a/tests/async/test_video.py b/tests/async/test_video.py
index e34a96e02..366707bca 100644
--- a/tests/async/test_video.py
+++ b/tests/async/test_video.py
@@ -56,6 +56,7 @@ async def test_should_not_error_if_page_not_closed_before_save_as(
 ):
     page = await browser.new_page(record_video_dir=tmpdir)
     await page.goto(server.PREFIX + "/grid.html")
+    await page.wait_for_timeout(1000)  # make sure video has some data
     out_path = tmpdir / "some-video.webm"
     saved = page.video.save_as(out_path)
     await page.close()
diff --git a/tests/sync/test_element_handle.py b/tests/sync/test_element_handle.py
index b3c110cb9..22e7d626b 100644
--- a/tests/sync/test_element_handle.py
+++ b/tests/sync/test_element_handle.py
@@ -421,16 +421,6 @@ def test_fill_input_when_Node_is_removed(page: Page, server: Server) -> None:
     assert page.evaluate("result") == "some value"
 
 
-def test_clear_input(page: Page, server: Server) -> None:
-    page.goto(server.PREFIX + "/input/textarea.html")
-    handle = page.query_selector("input")
-    assert handle
-    handle.fill("some value")
-    assert page.evaluate("result") == "some value"
-    handle.clear()
-    assert page.evaluate("result") == ""
-
-
 def test_select_textarea(page: Page, server: Server, is_firefox: bool) -> None:
     page.goto(server.PREFIX + "/input/textarea.html")
     textarea = page.query_selector("textarea")
diff --git a/tests/sync/test_fill.py b/tests/sync/test_fill.py
index 86aa3dca7..e43b9a868 100644
--- a/tests/sync/test_fill.py
+++ b/tests/sync/test_fill.py
@@ -12,9 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import pytest
-
-from playwright.sync_api import Error, Page
+from playwright.sync_api import Page
 from tests.server import Server
 
 
@@ -28,28 +26,3 @@ def test_fill_input(page: Page, server: Server) -> None:
     page.goto(f"{server.PREFIX}/input/textarea.html")
     page.fill("input", "some value")
     assert page.evaluate("result") == "some value"
-
-
-def test_should_throw_on_unsupported_inputs_when_clear(
-    page: Page, server: Server
-) -> None:
-    page.goto(f"{server.PREFIX}/input/textarea.html")
-    for type in ["button", "checkbox", "file", "image", "radio", "reset", "submit"]:
-        page.eval_on_selector(
-            "input", "(input, type) => input.setAttribute('type', type)", type
-        )
-        with pytest.raises(Error) as exc_info:
-            page.clear("input")
-        assert f'input of type "{type}" cannot be filled' in exc_info.value.message
-
-
-def test_it_should_throw_nice_error_without_injected_script_stack_when_element_is_not_an_input_when_clear(
-    page: Page, server: Server
-) -> None:
-    page.goto(server.PREFIX + "/input/textarea.html")
-    with pytest.raises(Error) as exc_info:
-        page.clear("body")
-    assert (
-        "Element is not an <input>, <textarea> or [contenteditable] element"
-        in exc_info.value.message
-    )
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 009430954..b1bff8c67 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -563,7 +563,7 @@ def test_locator_frame_locator_should_throw_on_ambiguity(
     button = page.locator("body").frame_locator("iframe").locator("button")
     with pytest.raises(
         Error,
-        match='.*strict mode violation: "body >> iframe" resolved to 3 elements.*',
+        match=r'.*strict mode violation: locator\("body"\)\.locator\("iframe"\) resolved to 3 elements.*',
     ):
         button.wait_for()
 
diff --git a/tests/sync/test_page.py b/tests/sync/test_page.py
index f13a5f56b..ccb229196 100644
--- a/tests/sync/test_page.py
+++ b/tests/sync/test_page.py
@@ -84,11 +84,3 @@ def test_emitted_for_domcontentloaded_and_load(page: Page, server: Server) -> No
             page.goto(server.EMPTY_PAGE)
     assert isinstance(dom_info.value, Page)
     assert isinstance(load_info.value, Page)
-
-
-def test_fill_should_be_able_to_clear_using_clear(page: Page, server: Server) -> None:
-    page.goto(server.PREFIX + "/input/textarea.html")
-    page.fill("input", "some value")
-    assert page.evaluate("result") == "some value"
-    page.clear("input")
-    assert page.evaluate("result") == ""
diff --git a/tests/sync/test_video.py b/tests/sync/test_video.py
index 9ef7a93ee..ec45c1fad 100644
--- a/tests/sync/test_video.py
+++ b/tests/sync/test_video.py
@@ -100,6 +100,7 @@ def test_should_error_if_page_not_closed_before_save_as(
 ) -> None:
     page = browser.new_page(record_video_dir=tmpdir)
     page.goto(server.PREFIX + "/grid.html")
+    page.wait_for_timeout(1000)  # Give it some time to record.
     out_path = tmpdir / "some-video.webm"
     with pytest.raises(Error) as err:
         video = page.video
@@ -108,7 +109,7 @@ def test_should_error_if_page_not_closed_before_save_as(
     assert video
     assert "Page is not yet closed. Close the page prior to calling save_as" in str(err)
     assert not os.path.exists(out_path)
-    page.context.close()
+    page.close()
 
     video.save_as(out_path)
     assert os.path.exists(out_path)

From ca742b0cc21558a3c32fc205bba651e62bcf38d2 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 14 Nov 2022 15:00:30 -1000
Subject: [PATCH 020/438] chore: hide Window always on Windows (#1648)

---
 playwright/_impl/_transport.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index d0802c17a..9a4127389 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -107,9 +107,8 @@ async def wait_until_stopped(self) -> None:
 
     async def connect(self) -> None:
         self._stopped_future: asyncio.Future = asyncio.Future()
-        # Hide the command-line window on Windows when using Pythonw.exe
         creationflags = 0
-        if sys.platform == "win32" and sys.stdout is None:
+        if sys.platform == "win32":
             creationflags = subprocess.CREATE_NO_WINDOW
 
         try:

From 676b9568754fa7146d657c66cfee579e458528fd Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 15 Nov 2022 15:31:31 -1000
Subject: [PATCH 021/438] chore: roll to 1.28.0-beta-1668538774000 (#1651)

---
 playwright/_impl/_frame.py             |  5 +-
 playwright/_impl/_locator.py           | 25 ++++---
 playwright/_impl/_page.py              |  2 +
 playwright/_impl/_selectors.py         | 10 ++-
 playwright/async_api/_generated.py     | 92 ++++++++++++++++----------
 playwright/sync_api/_generated.py      | 92 ++++++++++++++++----------
 setup.py                               |  2 +-
 tests/async/test_selector_generator.py | 47 +++++++++++++
 tests/async/test_selectors_get_by.py   | 72 ++++++++++++++++++++
 9 files changed, 264 insertions(+), 83 deletions(-)
 create mode 100644 tests/async/test_selector_generator.py
 create mode 100644 tests/async/test_selectors_get_by.py

diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 2ccb8da6c..ca7f4cccb 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -55,6 +55,7 @@
     get_by_test_id_selector,
     get_by_text_selector,
     get_by_title_selector,
+    test_id_attribute_name,
 )
 from playwright._impl._network import Response
 from playwright._impl._set_input_files_helpers import convert_input_files
@@ -560,6 +561,7 @@ def get_by_role(
         name: Union[str, Pattern[str]] = None,
         pressed: bool = None,
         selected: bool = None,
+        exact: bool = None,
     ) -> "Locator":
         return self.locator(
             get_by_role_selector(
@@ -572,11 +574,12 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
     def get_by_test_id(self, testId: str) -> "Locator":
-        return self.locator(get_by_test_id_selector(testId))
+        return self.locator(get_by_test_id_selector(test_id_attribute_name(), testId))
 
     def get_by_text(
         self, text: Union[str, Pattern[str]], exact: bool = None
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index f1ef26186..1597a66f3 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -244,6 +244,7 @@ def get_by_role(
         name: Union[str, Pattern[str]] = None,
         pressed: bool = None,
         selected: bool = None,
+        exact: bool = None,
     ) -> "Locator":
         return self.locator(
             get_by_role_selector(
@@ -256,11 +257,12 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
     def get_by_test_id(self, testId: str) -> "Locator":
-        return self.locator(get_by_test_id_selector(testId))
+        return self.locator(get_by_test_id_selector(test_id_attribute_name(), testId))
 
     def get_by_text(
         self, text: Union[str, Pattern[str]], exact: bool = None
@@ -690,6 +692,7 @@ def get_by_role(
         name: Union[str, Pattern[str]] = None,
         pressed: bool = None,
         selected: bool = None,
+        exact: bool = None,
     ) -> "Locator":
         return self.locator(
             get_by_role_selector(
@@ -702,11 +705,12 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
     def get_by_test_id(self, testId: str) -> "Locator":
-        return self.locator(get_by_test_id_selector(testId))
+        return self.locator(get_by_test_id_selector(test_id_attribute_name(), testId))
 
     def get_by_text(
         self, text: Union[str, Pattern[str]], exact: bool = None
@@ -739,16 +743,20 @@ def __repr__(self) -> str:
         return f"<FrameLocator frame={self._frame!r} selector={self._frame_selector!r}>"
 
 
-test_id_attribute_name: str = "data-testid"
+_test_id_attribute_name: str = "data-testid"
+
+
+def test_id_attribute_name() -> str:
+    return _test_id_attribute_name
 
 
 def set_test_id_attribute_name(attribute_name: str) -> None:
-    global test_id_attribute_name
-    test_id_attribute_name = attribute_name
+    global _test_id_attribute_name
+    _test_id_attribute_name = attribute_name
 
 
-def get_by_test_id_selector(test_id: str) -> str:
-    return get_by_attribute_text_selector(test_id_attribute_name, test_id, exact=True)
+def get_by_test_id_selector(test_id_attribute_name: str, test_id: str) -> str:
+    return f"internal:testid=[{test_id_attribute_name}={escape_for_attribute_selector(test_id, True)}]"
 
 
 def get_by_attribute_text_selector(
@@ -791,6 +799,7 @@ def get_by_role_selector(
     name: Union[str, Pattern[str]] = None,
     pressed: bool = None,
     selected: bool = None,
+    exact: bool = None,
 ) -> str:
     props: List[Tuple[str, str]] = []
     if checked is not None:
@@ -811,7 +820,7 @@ def get_by_role_selector(
                 "name",
                 f"/{name.pattern}/{escape_regex_flags(name)}"
                 if isinstance(name, Pattern)
-                else escape_for_attribute_selector(name),
+                else escape_for_attribute_selector(name, exact),
             )
         )
     if pressed is not None:
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 31b058f64..f2e05acdf 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -773,6 +773,7 @@ def get_by_role(
         name: Union[str, Pattern[str]] = None,
         pressed: bool = None,
         selected: bool = None,
+        exact: bool = None,
     ) -> "Locator":
         return self._main_frame.get_by_role(
             role,
@@ -784,6 +785,7 @@ def get_by_role(
             name=name,
             pressed=pressed,
             selected=selected,
+            exact=exact,
         )
 
     def get_by_test_id(self, testId: str) -> "Locator":
diff --git a/playwright/_impl/_selectors.py b/playwright/_impl/_selectors.py
index a66484d30..409b0921d 100644
--- a/playwright/_impl/_selectors.py
+++ b/playwright/_impl/_selectors.py
@@ -19,7 +19,7 @@
 from playwright._impl._api_types import Error
 from playwright._impl._connection import ChannelOwner
 from playwright._impl._helper import async_readfile
-from playwright._impl._locator import set_test_id_attribute_name
+from playwright._impl._locator import set_test_id_attribute_name, test_id_attribute_name
 
 
 class Selectors:
@@ -49,12 +49,20 @@ async def register(
 
     def set_test_id_attribute(self, attribute_name: str) -> None:
         set_test_id_attribute_name(attribute_name)
+        for channel in self._channels:
+            channel._channel.send_no_reply(
+                "setTestIdAttributeName", {"testIdAttributeName": attribute_name}
+            )
 
     def _add_channel(self, channel: "SelectorsOwner") -> None:
         self._channels.add(channel)
         for params in self._registrations:
             # This should not fail except for connection closure, but just in case we catch.
             channel._channel.send_no_reply("register", params)
+            channel._channel.send_no_reply(
+                "setTestIdAttributeName",
+                {"testIdAttributeName": test_id_attribute_name()},
+            )
 
     def _remove_channel(self, channel: "SelectorsOwner") -> None:
         if channel in self._channels:
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 99667d85d..cc0bb862c 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -4458,7 +4458,8 @@ def get_by_role(
         level: typing.Optional[int] = None,
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
-        selected: typing.Optional[bool] = None
+        selected: typing.Optional[bool] = None,
+        exact: typing.Optional[bool] = None
     ) -> "Locator":
         """Frame.get_by_role
 
@@ -4477,21 +4478,20 @@ def get_by_role(
         role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
-            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
-            checked are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls.
 
             Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
         disabled : Union[bool, None]
-            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+            An attribute that is usually set by `aria-disabled` or `disabled`.
 
             > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
-            A boolean attribute that is usually set by `aria-expanded`.
+            An attribute that is usually set by `aria-expanded`.
 
             Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
         include_hidden : Union[bool, None]
-            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            Option that controls whether hidden elements are matched. By default, only non-hidden elements, as
             [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
@@ -4501,17 +4501,21 @@ def get_by_role(
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
-            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+            Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is
+            case-insensitive and searches for a substring, use `exact` to control this behavior.
 
             Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
         pressed : Union[bool, None]
-            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-pressed`.
 
             Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
         selected : Union[bool, None]
-            A boolean attribute that is usually set by `aria-selected`.
+            An attribute that is usually set by `aria-selected`.
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+        exact : Union[bool, None]
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4529,6 +4533,7 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
@@ -5793,7 +5798,8 @@ def get_by_role(
         level: typing.Optional[int] = None,
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
-        selected: typing.Optional[bool] = None
+        selected: typing.Optional[bool] = None,
+        exact: typing.Optional[bool] = None
     ) -> "Locator":
         """FrameLocator.get_by_role
 
@@ -5812,21 +5818,20 @@ def get_by_role(
         role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
-            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
-            checked are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls.
 
             Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
         disabled : Union[bool, None]
-            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+            An attribute that is usually set by `aria-disabled` or `disabled`.
 
             > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
-            A boolean attribute that is usually set by `aria-expanded`.
+            An attribute that is usually set by `aria-expanded`.
 
             Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
         include_hidden : Union[bool, None]
-            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            Option that controls whether hidden elements are matched. By default, only non-hidden elements, as
             [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
@@ -5836,17 +5841,21 @@ def get_by_role(
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
-            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+            Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is
+            case-insensitive and searches for a substring, use `exact` to control this behavior.
 
             Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
         pressed : Union[bool, None]
-            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-pressed`.
 
             Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
         selected : Union[bool, None]
-            A boolean attribute that is usually set by `aria-selected`.
+            An attribute that is usually set by `aria-selected`.
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+        exact : Union[bool, None]
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5864,6 +5873,7 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
@@ -9346,7 +9356,8 @@ def get_by_role(
         level: typing.Optional[int] = None,
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
-        selected: typing.Optional[bool] = None
+        selected: typing.Optional[bool] = None,
+        exact: typing.Optional[bool] = None
     ) -> "Locator":
         """Page.get_by_role
 
@@ -9365,21 +9376,20 @@ def get_by_role(
         role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
-            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
-            checked are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls.
 
             Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
         disabled : Union[bool, None]
-            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+            An attribute that is usually set by `aria-disabled` or `disabled`.
 
             > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
-            A boolean attribute that is usually set by `aria-expanded`.
+            An attribute that is usually set by `aria-expanded`.
 
             Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
         include_hidden : Union[bool, None]
-            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            Option that controls whether hidden elements are matched. By default, only non-hidden elements, as
             [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
@@ -9389,17 +9399,21 @@ def get_by_role(
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
-            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+            Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is
+            case-insensitive and searches for a substring, use `exact` to control this behavior.
 
             Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
         pressed : Union[bool, None]
-            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-pressed`.
 
             Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
         selected : Union[bool, None]
-            A boolean attribute that is usually set by `aria-selected`.
+            An attribute that is usually set by `aria-selected`.
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+        exact : Union[bool, None]
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9417,6 +9431,7 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
@@ -14161,7 +14176,8 @@ def get_by_role(
         level: typing.Optional[int] = None,
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
-        selected: typing.Optional[bool] = None
+        selected: typing.Optional[bool] = None,
+        exact: typing.Optional[bool] = None
     ) -> "Locator":
         """Locator.get_by_role
 
@@ -14180,21 +14196,20 @@ def get_by_role(
         role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
-            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
-            checked are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls.
 
             Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
         disabled : Union[bool, None]
-            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+            An attribute that is usually set by `aria-disabled` or `disabled`.
 
             > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
-            A boolean attribute that is usually set by `aria-expanded`.
+            An attribute that is usually set by `aria-expanded`.
 
             Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
         include_hidden : Union[bool, None]
-            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            Option that controls whether hidden elements are matched. By default, only non-hidden elements, as
             [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
@@ -14204,17 +14219,21 @@ def get_by_role(
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
-            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+            Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is
+            case-insensitive and searches for a substring, use `exact` to control this behavior.
 
             Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
         pressed : Union[bool, None]
-            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-pressed`.
 
             Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
         selected : Union[bool, None]
-            A boolean attribute that is usually set by `aria-selected`.
+            An attribute that is usually set by `aria-selected`.
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+        exact : Union[bool, None]
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14232,6 +14251,7 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 4a8d5bf71..221f0b4ad 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -4539,7 +4539,8 @@ def get_by_role(
         level: typing.Optional[int] = None,
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
-        selected: typing.Optional[bool] = None
+        selected: typing.Optional[bool] = None,
+        exact: typing.Optional[bool] = None
     ) -> "Locator":
         """Frame.get_by_role
 
@@ -4558,21 +4559,20 @@ def get_by_role(
         role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
-            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
-            checked are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls.
 
             Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
         disabled : Union[bool, None]
-            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+            An attribute that is usually set by `aria-disabled` or `disabled`.
 
             > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
-            A boolean attribute that is usually set by `aria-expanded`.
+            An attribute that is usually set by `aria-expanded`.
 
             Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
         include_hidden : Union[bool, None]
-            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            Option that controls whether hidden elements are matched. By default, only non-hidden elements, as
             [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
@@ -4582,17 +4582,21 @@ def get_by_role(
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
-            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+            Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is
+            case-insensitive and searches for a substring, use `exact` to control this behavior.
 
             Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
         pressed : Union[bool, None]
-            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-pressed`.
 
             Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
         selected : Union[bool, None]
-            A boolean attribute that is usually set by `aria-selected`.
+            An attribute that is usually set by `aria-selected`.
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+        exact : Union[bool, None]
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4610,6 +4614,7 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
@@ -5901,7 +5906,8 @@ def get_by_role(
         level: typing.Optional[int] = None,
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
-        selected: typing.Optional[bool] = None
+        selected: typing.Optional[bool] = None,
+        exact: typing.Optional[bool] = None
     ) -> "Locator":
         """FrameLocator.get_by_role
 
@@ -5920,21 +5926,20 @@ def get_by_role(
         role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
-            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
-            checked are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls.
 
             Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
         disabled : Union[bool, None]
-            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+            An attribute that is usually set by `aria-disabled` or `disabled`.
 
             > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
-            A boolean attribute that is usually set by `aria-expanded`.
+            An attribute that is usually set by `aria-expanded`.
 
             Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
         include_hidden : Union[bool, None]
-            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            Option that controls whether hidden elements are matched. By default, only non-hidden elements, as
             [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
@@ -5944,17 +5949,21 @@ def get_by_role(
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
-            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+            Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is
+            case-insensitive and searches for a substring, use `exact` to control this behavior.
 
             Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
         pressed : Union[bool, None]
-            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-pressed`.
 
             Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
         selected : Union[bool, None]
-            A boolean attribute that is usually set by `aria-selected`.
+            An attribute that is usually set by `aria-selected`.
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+        exact : Union[bool, None]
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5972,6 +5981,7 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
@@ -9394,7 +9404,8 @@ def get_by_role(
         level: typing.Optional[int] = None,
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
-        selected: typing.Optional[bool] = None
+        selected: typing.Optional[bool] = None,
+        exact: typing.Optional[bool] = None
     ) -> "Locator":
         """Page.get_by_role
 
@@ -9413,21 +9424,20 @@ def get_by_role(
         role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
-            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
-            checked are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls.
 
             Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
         disabled : Union[bool, None]
-            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+            An attribute that is usually set by `aria-disabled` or `disabled`.
 
             > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
-            A boolean attribute that is usually set by `aria-expanded`.
+            An attribute that is usually set by `aria-expanded`.
 
             Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
         include_hidden : Union[bool, None]
-            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            Option that controls whether hidden elements are matched. By default, only non-hidden elements, as
             [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
@@ -9437,17 +9447,21 @@ def get_by_role(
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
-            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+            Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is
+            case-insensitive and searches for a substring, use `exact` to control this behavior.
 
             Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
         pressed : Union[bool, None]
-            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-pressed`.
 
             Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
         selected : Union[bool, None]
-            A boolean attribute that is usually set by `aria-selected`.
+            An attribute that is usually set by `aria-selected`.
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+        exact : Union[bool, None]
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9465,6 +9479,7 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
@@ -14230,7 +14245,8 @@ def get_by_role(
         level: typing.Optional[int] = None,
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
-        selected: typing.Optional[bool] = None
+        selected: typing.Optional[bool] = None,
+        exact: typing.Optional[bool] = None
     ) -> "Locator":
         """Locator.get_by_role
 
@@ -14249,21 +14265,20 @@ def get_by_role(
         role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
             Required aria role.
         checked : Union[bool, None]
-            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls. Available values for
-            checked are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-checked` or native `<input type=checkbox>` controls.
 
             Learn more about [`aria-checked`](https://www.w3.org/TR/wai-aria-1.2/#aria-checked).
         disabled : Union[bool, None]
-            A boolean attribute that is usually set by `aria-disabled` or `disabled`.
+            An attribute that is usually set by `aria-disabled` or `disabled`.
 
             > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
-            A boolean attribute that is usually set by `aria-expanded`.
+            An attribute that is usually set by `aria-expanded`.
 
             Learn more about [`aria-expanded`](https://www.w3.org/TR/wai-aria-1.2/#aria-expanded).
         include_hidden : Union[bool, None]
-            A boolean attribute that controls whether hidden elements are matched. By default, only non-hidden elements, as
+            Option that controls whether hidden elements are matched. By default, only non-hidden elements, as
             [defined by ARIA](https://www.w3.org/TR/wai-aria-1.2/#tree_exclusion), are matched by role selector.
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
@@ -14273,17 +14288,21 @@ def get_by_role(
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
-            A string attribute that matches [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+            Option to match the [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). By default, matching is
+            case-insensitive and searches for a substring, use `exact` to control this behavior.
 
             Learn more about [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
         pressed : Union[bool, None]
-            An attribute that is usually set by `aria-pressed`. Available values for pressed are `true`, `false` and `"mixed"`.
+            An attribute that is usually set by `aria-pressed`.
 
             Learn more about [`aria-pressed`](https://www.w3.org/TR/wai-aria-1.2/#aria-pressed).
         selected : Union[bool, None]
-            A boolean attribute that is usually set by `aria-selected`.
+            An attribute that is usually set by `aria-selected`.
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
+        exact : Union[bool, None]
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
+            expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14301,6 +14320,7 @@ def get_by_role(
                 name=name,
                 pressed=pressed,
                 selected=selected,
+                exact=exact,
             )
         )
 
diff --git a/setup.py b/setup.py
index 5f6d82c91..bc06f4691 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.28.0-alpha-nov-11-2022"
+driver_version = "1.28.0-beta-1668538774000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_selector_generator.py b/tests/async/test_selector_generator.py
new file mode 100644
index 000000000..c03e575d3
--- /dev/null
+++ b/tests/async/test_selector_generator.py
@@ -0,0 +1,47 @@
+# 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.async_api import Error, Page, Playwright
+
+
+async def test_should_use_data_test_id_in_strict_errors(
+    page: Page, playwright: Playwright
+) -> None:
+    playwright.selectors.set_test_id_attribute("data-custom-id")
+    await page.set_content(
+        """
+      <div>
+        <div></div>
+        <div>
+          <div></div>
+          <div></div>
+        </div>
+      </div>
+      <div>
+        <div class='foo bar:0' data-custom-id='One'>
+        </div>
+        <div class='foo bar:1' data-custom-id='Two'>
+        </div>
+      </div>
+    """
+    )
+    with pytest.raises(Error) as exc_info:
+        await page.locator(".foo").hover(timeout=200)
+    assert "strict mode violation" in exc_info.value.message
+    assert '<div class="foo bar:0' in exc_info.value.message
+    assert '<div class="foo bar:1' in exc_info.value.message
+    assert 'aka get_by_test_id("One")' in exc_info.value.message
+    assert 'aka get_by_test_id("Two")' in exc_info.value.message
diff --git a/tests/async/test_selectors_get_by.py b/tests/async/test_selectors_get_by.py
new file mode 100644
index 000000000..46a3ef1bc
--- /dev/null
+++ b/tests/async/test_selectors_get_by.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.
+
+from playwright.async_api import Page
+
+
+async def test_get_by_role_escaping(
+    page: Page,
+) -> None:
+    await page.set_content(
+        """
+        <a href="https://playwright.dev">issues 123</a>
+        <a href="https://playwright.dev">he llo 56</a>
+        <button>Click me</button>
+    """
+    )
+    assert await page.get_by_role("button").evaluate_all(
+        "els => els.map(e => e.outerHTML)"
+    ) == [
+        "<button>Click me</button>",
+    ]
+    assert await page.get_by_role("link").evaluate_all(
+        "els => els.map(e => e.outerHTML)"
+    ) == [
+        """<a href="https://playwright.dev">issues 123</a>""",
+        """<a href="https://playwright.dev">he llo 56</a>""",
+    ]
+
+    assert await page.get_by_role("link", name="issues 123").evaluate_all(
+        "els => els.map(e => e.outerHTML)"
+    ) == [
+        """<a href="https://playwright.dev">issues 123</a>""",
+    ]
+    assert await page.get_by_role("link", name="sues").evaluate_all(
+        "els => els.map(e => e.outerHTML)"
+    ) == [
+        """<a href="https://playwright.dev">issues 123</a>""",
+    ]
+    assert await page.get_by_role("link", name="  he    \n  llo ").evaluate_all(
+        "els => els.map(e => e.outerHTML)"
+    ) == [
+        """<a href="https://playwright.dev">he llo 56</a>""",
+    ]
+    assert (
+        await page.get_by_role("button", name="issues").evaluate_all(
+            "els => els.map(e => e.outerHTML)"
+        )
+        == []
+    )
+
+    assert (
+        await page.get_by_role("link", name="sues", exact=True).evaluate_all(
+            "els => els.map(e => e.outerHTML)"
+        )
+        == []
+    )
+    assert await page.get_by_role(
+        "link", name="   he \n llo 56 ", exact=True
+    ).evaluate_all("els => els.map(e => e.outerHTML)") == [
+        """<a href="https://playwright.dev">he llo 56</a>""",
+    ]

From 0767d844becee91fe071612c47aca8256019fa44 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 15 Nov 2022 16:42:30 -1000
Subject: [PATCH 022/438] chore: bump greenlet to v2.0.0 (#1621)

---
 .github/workflows/ci.yml | 5 ++++-
 conda_build_config.yaml  | 1 +
 meta.yaml                | 3 +--
 setup.py                 | 2 +-
 4 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 64b87b054..f55451700 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -92,6 +92,9 @@ jobs:
         - os: ubuntu-latest
           python-version: '3.11'
           browser: chromium
+        - os: windows-latest
+          python-version: '3.11'
+          browser: chromium
     runs-on: ${{ matrix.os }}
     steps:
     - uses: actions/checkout@v3
@@ -187,7 +190,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-20.04, macos-10.15, windows-2019]
+        os: [ubuntu-20.04, macos-11, windows-2019]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v3
diff --git a/conda_build_config.yaml b/conda_build_config.yaml
index 0d84d78b2..80519fa04 100644
--- a/conda_build_config.yaml
+++ b/conda_build_config.yaml
@@ -3,3 +3,4 @@ python:
   - 3.8
   - 3.9
   - "3.10"
+  - "3.11"
diff --git a/meta.yaml b/meta.yaml
index dfb8f90e9..de7cc29d9 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -23,7 +23,7 @@ requirements:
     - setuptools_scm
   run:
     - python
-    - greenlet ==1.1.3
+    - greenlet ==2.0.1
     - pyee ==9.0.4
     - typing_extensions # [py<39]
 test:
@@ -34,7 +34,6 @@ test:
     - playwright.sync_api
     - playwright.async_api
   commands:
-    - pip check
     - playwright --help
 
 about:
diff --git a/setup.py b/setup.py
index bc06f4691..1737097c9 100644
--- a/setup.py
+++ b/setup.py
@@ -212,7 +212,7 @@ def _download_and_extract_local_driver(
     packages=["playwright"],
     include_package_data=True,
     install_requires=[
-        "greenlet==1.1.3",
+        "greenlet==2.0.1",
         "pyee==9.0.4",
         "typing-extensions;python_version<='3.8'",
     ],

From e25107b9b1944ebaf5f9fb4e327587a82daf2ba1 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 16 Nov 2022 11:59:05 -1000
Subject: [PATCH 023/438] chore: roll to v1.28 (#1658)

---
 README.md | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 93a5011bb..e1413a947 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
 | Chromium <!-- GEN:chromium-version -->108.0.5359.29<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| WebKit <!-- GEN:webkit-version -->16.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->106.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
diff --git a/setup.py b/setup.py
index 1737097c9..7f9427da2 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.28.0-beta-1668538774000"
+driver_version = "1.28.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From d87e105effeb0b656b6cfe8945fa207ca6c14a71 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 30 Nov 2022 15:42:39 -0800
Subject: [PATCH 024/438] chore: drop Ubuntu 18 bionic Docker images (#1667)

---
 .github/workflows/test_docker.yml |  2 +-
 utils/docker/Dockerfile.bionic    | 46 -------------------------------
 utils/docker/build.sh             |  2 +-
 utils/docker/publish_docker.sh    | 33 ++++++----------------
 4 files changed, 11 insertions(+), 72 deletions(-)
 delete mode 100644 utils/docker/Dockerfile.bionic

diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index 8f4fa8a92..5a3266197 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -18,7 +18,7 @@ on:
       - release-*
 jobs:
   build:
-    timeout-minutes: 60
+    timeout-minutes: 120
     runs-on: ubuntu-22.04
     strategy:
       fail-fast: false
diff --git a/utils/docker/Dockerfile.bionic b/utils/docker/Dockerfile.bionic
deleted file mode 100644
index a2861cfed..000000000
--- a/utils/docker/Dockerfile.bionic
+++ /dev/null
@@ -1,46 +0,0 @@
-FROM ubuntu:bionic
-
-ARG DEBIAN_FRONTEND=noninteractive
-ARG TZ=America/Los_Angeles
-ARG DOCKER_IMAGE_NAME_TEMPLATE="mcr.microsoft.com/playwright/python:v%version%-bionic"
-
-# === INSTALL Python ===
-
-RUN apt-get update && \
-    # Install Python
-    apt-get install -y python3.8 python3-distutils curl && \
-    update-alternatives --install /usr/bin/python python /usr/bin/python3.8 1 && \
-    curl -sSL https://bootstrap.pypa.io/get-pip.py -o get-pip.py && \
-    python get-pip.py && \
-    rm get-pip.py && \
-    # Feature-parity with node.js base images.
-    apt-get install -y --no-install-recommends git openssh-client gpg && \
-    # clean apt cache
-    rm -rf /var/lib/apt/lists/* && \
-    # Create the pwuser
-    adduser pwuser
-
-# === BAKE BROWSERS INTO IMAGE ===
-
-ENV PLAYWRIGHT_BROWSERS_PATH=/ms-playwright
-
-# 1. Add tip-of-tree Playwright package to install its browsers.
-#    The package should be built beforehand from tip-of-tree Playwright.
-COPY ./dist/*-manylinux*.whl /tmp/
-
-# 2. Bake in browsers & deps.
-#    Browsers will be downloaded in `/ms-playwright`.
-#    Note: make sure to set 777 to the registry so that any user can access
-#    registry.
-RUN mkdir /ms-playwright && \
-    mkdir /ms-playwright-agent && \
-    cd /ms-playwright-agent && \
-    # if its amd64 then install the manylinux1_x86_64 pip package
-    if [ "$(uname -m)" = "x86_64" ]; then pip install /tmp/*manylinux1_x86_64*.whl; fi && \
-    # if its arm64 then install the manylinux1_aarch64 pip package
-    if [ "$(uname -m)" = "aarch64" ]; then pip install /tmp/*manylinux_2_17_aarch64*.whl; fi && \
-    playwright mark-docker-image "${DOCKER_IMAGE_NAME_TEMPLATE}" && \
-    playwright install --with-deps && rm -rf /var/lib/apt/lists/* && \
-    rm /tmp/*.whl && \
-    rm -rf /ms-playwright-agent && \
-    chmod -R 777 /ms-playwright
diff --git a/utils/docker/build.sh b/utils/docker/build.sh
index 65fbafcf4..b28a4807a 100755
--- a/utils/docker/build.sh
+++ b/utils/docker/build.sh
@@ -3,7 +3,7 @@ set -e
 set +x
 
 if [[ ($1 == '--help') || ($1 == '-h') || ($1 == '') || ($2 == '') ]]; then
-  echo "usage: $(basename $0) {--arm64,--amd64} {bionic,focal,jammy} playwright:localbuild-focal"
+  echo "usage: $(basename $0) {--arm64,--amd64} {focal,jammy} playwright:localbuild-focal"
   echo
   echo "Build Playwright docker image and tag it as 'playwright:localbuild-focal'."
   echo "Once image is built, you can run it with"
diff --git a/utils/docker/publish_docker.sh b/utils/docker/publish_docker.sh
index 74f93be9e..fbda708a6 100755
--- a/utils/docker/publish_docker.sh
+++ b/utils/docker/publish_docker.sh
@@ -31,29 +31,22 @@ if [[ -z "${GITHUB_SHA}" ]]; then
   exit 1
 fi
 
-BIONIC_TAGS=(
-  "next-bionic"
-)
-if [[ "$RELEASE_CHANNEL" == "stable" ]]; then
-  BIONIC_TAGS+=("bionic")
-fi
-
 FOCAL_TAGS=(
   "next"
   "sha-${GITHUB_SHA}"
   "next-focal"
 )
-
-JAMMY_TAGS=(
-  "next-jammy"
-)
-
 if [[ "$RELEASE_CHANNEL" == "stable" ]]; then
   FOCAL_TAGS+=("latest")
   FOCAL_TAGS+=("focal")
   FOCAL_TAGS+=("v${PW_VERSION}-focal")
   FOCAL_TAGS+=("v${PW_VERSION}")
+fi
 
+JAMMY_TAGS=(
+  "next-jammy"
+)
+if [[ "$RELEASE_CHANNEL" == "stable" ]]; then
   JAMMY_TAGS+=("jammy")
   JAMMY_TAGS+=("v${PW_VERSION}-jammy")
 fi
@@ -69,14 +62,12 @@ tag_and_push() {
 publish_docker_images_with_arch_suffix() {
   local FLAVOR="$1"
   local TAGS=()
-  if [[ "$FLAVOR" == "bionic" ]]; then
-    TAGS=("${BIONIC_TAGS[@]}")
-  elif [[ "$FLAVOR" == "focal" ]]; then
+  if [[ "$FLAVOR" == "focal" ]]; then
     TAGS=("${FOCAL_TAGS[@]}")
   elif [[ "$FLAVOR" == "jammy" ]]; then
     TAGS=("${JAMMY_TAGS[@]}")
   else
-    echo "ERROR: unknown flavor - $FLAVOR. Must be either 'bionic', 'focal', or 'jammy'"
+    echo "ERROR: unknown flavor - $FLAVOR. Must be either 'focal', or 'jammy'"
     exit 1
   fi
   local ARCH="$2"
@@ -97,14 +88,12 @@ publish_docker_images_with_arch_suffix() {
 publish_docker_manifest () {
   local FLAVOR="$1"
   local TAGS=()
-  if [[ "$FLAVOR" == "bionic" ]]; then
-    TAGS=("${BIONIC_TAGS[@]}")
-  elif [[ "$FLAVOR" == "focal" ]]; then
+  if [[ "$FLAVOR" == "focal" ]]; then
     TAGS=("${FOCAL_TAGS[@]}")
   elif [[ "$FLAVOR" == "jammy" ]]; then
     TAGS=("${JAMMY_TAGS[@]}")
   else
-    echo "ERROR: unknown flavor - $FLAVOR. Must be either 'bionic', 'focal', or 'jammy'"
+    echo "ERROR: unknown flavor - $FLAVOR. Must be either 'focal', or 'jammy'"
     exit 1
   fi
 
@@ -123,10 +112,6 @@ publish_docker_manifest () {
   done
 }
 
-# Bionic
-publish_docker_images_with_arch_suffix bionic amd64
-publish_docker_manifest bionic amd64
-
 # Focal
 publish_docker_images_with_arch_suffix focal amd64
 publish_docker_images_with_arch_suffix focal arm64

From eaf3f155285ef567df10b90bae92a0a68557d47e Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 1 Dec 2022 16:46:12 -0800
Subject: [PATCH 025/438] chore: lint examples and fix to_{have,contain}_text
 with lists (#1675)

---
 .pre-commit-config.yaml                       |    1 -
 README.md                                     |    2 +-
 .../todomvc/{tests => mvctests}/__init__.py   |    0
 .../test_clear_completed_button.py            |    0
 .../{tests => mvctests}/test_counter.py       |    0
 .../{tests => mvctests}/test_editing.py       |    0
 .../todomvc/{tests => mvctests}/test_item.py  |    0
 .../test_mark_all_as_completed.py             |    0
 .../{tests => mvctests}/test_new_todo.py      |    0
 .../{tests => mvctests}/test_persistence.py   |    0
 .../{tests => mvctests}/test_routing.py       |    0
 examples/todomvc/{tests => mvctests}/utils.py |    4 +-
 playwright/_impl/_assertions.py               |   52 +-
 playwright/async_api/_generated.py            | 5609 ++++++++++------
 playwright/sync_api/_generated.py             | 5663 +++++++++++------
 pyproject.toml                                |    1 -
 setup.py                                      |    2 +-
 tests/server.py                               |   12 +-
 tests/sync/test_assertions.py                 |    8 +-
 .../test_browsercontext_request_fallback.py   |   81 +-
 tests/sync/test_page_request_fallback.py      |   82 +-
 21 files changed, 7389 insertions(+), 4128 deletions(-)
 rename examples/todomvc/{tests => mvctests}/__init__.py (100%)
 rename examples/todomvc/{tests => mvctests}/test_clear_completed_button.py (100%)
 rename examples/todomvc/{tests => mvctests}/test_counter.py (100%)
 rename examples/todomvc/{tests => mvctests}/test_editing.py (100%)
 rename examples/todomvc/{tests => mvctests}/test_item.py (100%)
 rename examples/todomvc/{tests => mvctests}/test_mark_all_as_completed.py (100%)
 rename examples/todomvc/{tests => mvctests}/test_new_todo.py (100%)
 rename examples/todomvc/{tests => mvctests}/test_persistence.py (100%)
 rename examples/todomvc/{tests => mvctests}/test_routing.py (100%)
 rename examples/todomvc/{tests => mvctests}/utils.py (87%)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index e9ed64323..6a46b88cc 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -23,7 +23,6 @@ repos:
     hooks:
       - id: mypy
         additional_dependencies: [types-pyOpenSSL==22.1.0.1]
-        exclude: examples/
   - repo: https://github.com/pycqa/flake8
     rev: 5.0.4
     hooks:
diff --git a/README.md b/README.md
index e1413a947..04c25a7b1 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->108.0.5359.29<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->108.0.5359.48<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->106.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/examples/todomvc/tests/__init__.py b/examples/todomvc/mvctests/__init__.py
similarity index 100%
rename from examples/todomvc/tests/__init__.py
rename to examples/todomvc/mvctests/__init__.py
diff --git a/examples/todomvc/tests/test_clear_completed_button.py b/examples/todomvc/mvctests/test_clear_completed_button.py
similarity index 100%
rename from examples/todomvc/tests/test_clear_completed_button.py
rename to examples/todomvc/mvctests/test_clear_completed_button.py
diff --git a/examples/todomvc/tests/test_counter.py b/examples/todomvc/mvctests/test_counter.py
similarity index 100%
rename from examples/todomvc/tests/test_counter.py
rename to examples/todomvc/mvctests/test_counter.py
diff --git a/examples/todomvc/tests/test_editing.py b/examples/todomvc/mvctests/test_editing.py
similarity index 100%
rename from examples/todomvc/tests/test_editing.py
rename to examples/todomvc/mvctests/test_editing.py
diff --git a/examples/todomvc/tests/test_item.py b/examples/todomvc/mvctests/test_item.py
similarity index 100%
rename from examples/todomvc/tests/test_item.py
rename to examples/todomvc/mvctests/test_item.py
diff --git a/examples/todomvc/tests/test_mark_all_as_completed.py b/examples/todomvc/mvctests/test_mark_all_as_completed.py
similarity index 100%
rename from examples/todomvc/tests/test_mark_all_as_completed.py
rename to examples/todomvc/mvctests/test_mark_all_as_completed.py
diff --git a/examples/todomvc/tests/test_new_todo.py b/examples/todomvc/mvctests/test_new_todo.py
similarity index 100%
rename from examples/todomvc/tests/test_new_todo.py
rename to examples/todomvc/mvctests/test_new_todo.py
diff --git a/examples/todomvc/tests/test_persistence.py b/examples/todomvc/mvctests/test_persistence.py
similarity index 100%
rename from examples/todomvc/tests/test_persistence.py
rename to examples/todomvc/mvctests/test_persistence.py
diff --git a/examples/todomvc/tests/test_routing.py b/examples/todomvc/mvctests/test_routing.py
similarity index 100%
rename from examples/todomvc/tests/test_routing.py
rename to examples/todomvc/mvctests/test_routing.py
diff --git a/examples/todomvc/tests/utils.py b/examples/todomvc/mvctests/utils.py
similarity index 87%
rename from examples/todomvc/tests/utils.py
rename to examples/todomvc/mvctests/utils.py
index 635845a4f..ba3d5decb 100644
--- a/examples/todomvc/tests/utils.py
+++ b/examples/todomvc/mvctests/utils.py
@@ -23,4 +23,6 @@ def assert_number_of_todos_in_local_storage(page: Page, expected: int) -> None:
 
 
 def check_todos_in_local_storage(page: Page, title: str) -> None:
-    title in page.evaluate("JSON.parse(localStorage['react-todos']).map(i => i.title)")
+    assert title in page.evaluate(
+        "JSON.parse(localStorage['react-todos']).map(i => i.title)"
+    )
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 3068a313c..2253bdabd 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -120,7 +120,13 @@ def _not(self) -> "LocatorAssertions":
 
     async def to_contain_text(
         self,
-        expected: Union[List[Union[Pattern[str], str]], Pattern[str], str],
+        expected: Union[
+            List[str],
+            List[Pattern[str]],
+            List[Union[Pattern[str], str]],
+            Pattern[str],
+            str,
+        ],
         use_inner_text: bool = None,
         timeout: float = None,
         ignore_case: bool = None,
@@ -163,7 +169,13 @@ async def to_contain_text(
 
     async def not_to_contain_text(
         self,
-        expected: Union[List[Union[Pattern[str], str]], Pattern[str], str],
+        expected: Union[
+            List[str],
+            List[Pattern[str]],
+            List[Union[Pattern[str], str]],
+            Pattern[str],
+            str,
+        ],
         use_inner_text: bool = None,
         timeout: float = None,
         ignore_case: bool = None,
@@ -199,7 +211,13 @@ async def not_to_have_attribute(
 
     async def to_have_class(
         self,
-        expected: Union[List[Union[Pattern[str], str]], Pattern[str], str],
+        expected: Union[
+            List[str],
+            List[Pattern[str]],
+            List[Union[Pattern[str], str]],
+            Pattern[str],
+            str,
+        ],
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
@@ -222,7 +240,13 @@ async def to_have_class(
 
     async def not_to_have_class(
         self,
-        expected: Union[List[Union[Pattern[str], str]], Pattern[str], str],
+        expected: Union[
+            List[str],
+            List[Pattern[str]],
+            List[Union[Pattern[str], str]],
+            Pattern[str],
+            str,
+        ],
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
@@ -346,7 +370,7 @@ async def not_to_have_value(
 
     async def to_have_values(
         self,
-        values: List[Union[Pattern[str], str]],
+        values: Union[List[str], List[Pattern[str]], List[Union[Pattern[str], str]]],
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
@@ -360,7 +384,7 @@ async def to_have_values(
 
     async def not_to_have_values(
         self,
-        values: List[Union[Pattern[str], str]],
+        values: Union[List[str], List[Pattern[str]], List[Union[Pattern[str], str]]],
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
@@ -368,7 +392,13 @@ async def not_to_have_values(
 
     async def to_have_text(
         self,
-        expected: Union[List[Union[Pattern[str], str]], Pattern[str], str],
+        expected: Union[
+            List[str],
+            List[Pattern[str]],
+            List[Union[Pattern[str], str]],
+            Pattern[str],
+            str,
+        ],
         use_inner_text: bool = None,
         timeout: float = None,
         ignore_case: bool = None,
@@ -407,7 +437,13 @@ async def to_have_text(
 
     async def not_to_have_text(
         self,
-        expected: Union[List[Union[Pattern[str], str]], Pattern[str], str],
+        expected: Union[
+            List[str],
+            List[Pattern[str]],
+            List[Union[Pattern[str], str]],
+            Pattern[str],
+            str,
+        ],
         use_inner_text: bool = None,
         timeout: float = None,
         ignore_case: bool = None,
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index cc0bb862c..499701797 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -103,8 +103,8 @@ def resource_type(self) -> str:
         """Request.resource_type
 
         Contains the request's resource type as it was perceived by the rendering engine. ResourceType will be one of the
-        following: `document`, `stylesheet`, `image`, `media`, `font`, `script`, `texttrack`, `xhr`, `fetch`, `eventsource`,
-        `websocket`, `manifest`, `other`.
+        following: `document`, `stylesheet`, `image`, `media`, `font`, `script`, `texttrack`, `xhr`, `fetch`,
+        `eventsource`, `websocket`, `manifest`, `other`.
 
         Returns
         -------
@@ -181,10 +181,12 @@ def redirected_from(self) -> typing.Optional["Request"]:
 
         Request that was redirected by the server to this one, if any.
 
-        When the server responds with a redirect, Playwright creates a new `Request` object. The two requests are connected by
-        `redirectedFrom()` and `redirectedTo()` methods. When multiple server redirects has happened, it is possible to
+        When the server responds with a redirect, Playwright creates a new `Request` object. The two requests are connected
+        by `redirectedFrom()` and `redirectedTo()` methods. When multiple server redirects has happened, it is possible to
         construct the whole redirect chain by repeatedly calling `redirectedFrom()`.
 
+        **Usage**
+
         For example, if the website `http://example.com` redirects to `https://example.com`:
 
         ```py
@@ -192,6 +194,11 @@ def redirected_from(self) -> typing.Optional["Request"]:
         print(response.request.redirected_from.url) # \"http://example.com\"
         ```
 
+        ```py
+        response = page.goto(\"http://example.com\")
+        print(response.request.redirected_from.url) # \"http://example.com\"
+        ```
+
         If the website `https://google.com` has no redirects:
 
         ```py
@@ -199,6 +206,11 @@ def redirected_from(self) -> typing.Optional["Request"]:
         print(response.request.redirected_from) # None
         ```
 
+        ```py
+        response = page.goto(\"https://google.com\")
+        print(response.request.redirected_from) # None
+        ```
+
         Returns
         -------
         Union[Request, None]
@@ -211,6 +223,8 @@ def redirected_to(self) -> typing.Optional["Request"]:
 
         New request issued by the browser if the server responded with redirect.
 
+        **Usage**
+
         This method is the opposite of `request.redirected_from()`:
 
         ```py
@@ -229,6 +243,8 @@ def failure(self) -> typing.Optional[str]:
 
         The method returns `null` unless this request has failed, as reported by `requestfailed` event.
 
+        **Usage**
+
         Example of logging of all the failed requests:
 
         ```py
@@ -245,10 +261,12 @@ def failure(self) -> typing.Optional[str]:
     def timing(self) -> ResourceTiming:
         """Request.timing
 
-        Returns resource timing information for given request. Most of the timing values become available upon the response,
-        `responseEnd` becomes available when request finishes. Find more information at
+        Returns resource timing information for given request. Most of the timing values become available upon the
+        response, `responseEnd` becomes available when request finishes. Find more information at
         [Resource Timing API](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming).
 
+        **Usage**
+
         ```py
         async with page.expect_event(\"requestfinished\") as request_info:
             await page.goto(\"http://example.com\")
@@ -256,6 +274,13 @@ def timing(self) -> ResourceTiming:
         print(request.timing)
         ```
 
+        ```py
+        with page.expect_event(\"requestfinished\") as request_info:
+            page.goto(\"http://example.com\")
+        request = request_info.value
+        print(request.timing)
+        ```
+
         Returns
         -------
         {startTime: float, domainLookupStart: float, domainLookupEnd: float, connectStart: float, secureConnectionStart: float, connectEnd: float, requestStart: float, responseStart: float, responseEnd: float}
@@ -267,8 +292,8 @@ def headers(self) -> typing.Dict[str, str]:
         """Request.headers
 
         An object with the request HTTP headers. The header names are lower-cased. Note that this method does not return
-        security-related headers, including cookie-related ones. You can use `request.all_headers()` for complete list of
-        headers that include `cookie` information.
+        security-related headers, including cookie-related ones. You can use `request.all_headers()` for complete
+        list of headers that include `cookie` information.
 
         Returns
         -------
@@ -327,8 +352,9 @@ async def all_headers(self) -> typing.Dict[str, str]:
     async def headers_array(self) -> typing.List[NameValue]:
         """Request.headers_array
 
-        An array with all the request HTTP headers associated with this request. Unlike `request.all_headers()`, header
-        names are NOT lower-cased. Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
+        An array with all the request HTTP headers associated with this request. Unlike `request.all_headers()`,
+        header names are NOT lower-cased. Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple
+        times.
 
         Returns
         -------
@@ -412,8 +438,8 @@ def headers(self) -> typing.Dict[str, str]:
         """Response.headers
 
         An object with the response HTTP headers. The header names are lower-cased. Note that this method does not return
-        security-related headers, including cookie-related ones. You can use `response.all_headers()` for complete list
-        of headers that include `cookie` information.
+        security-related headers, including cookie-related ones. You can use `response.all_headers()` for complete
+        list of headers that include `cookie` information.
 
         Returns
         -------
@@ -473,8 +499,9 @@ async def all_headers(self) -> typing.Dict[str, str]:
     async def headers_array(self) -> typing.List[NameValue]:
         """Response.headers_array
 
-        An array with all the request HTTP headers associated with this response. Unlike `response.all_headers()`, header
-        names are NOT lower-cased. Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
+        An array with all the request HTTP headers associated with this response. Unlike `response.all_headers()`,
+        header names are NOT lower-cased. Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple
+        times.
 
         Returns
         -------
@@ -486,9 +513,9 @@ async def headers_array(self) -> typing.List[NameValue]:
     async def header_value(self, name: str) -> typing.Optional[str]:
         """Response.header_value
 
-        Returns the value of the header matching the name. The name is case insensitive. If multiple headers have the same name
-        (except `set-cookie`), they are returned as a list separated by `, `. For `set-cookie`, the `\\n` separator is used. If
-        no headers are found, `null` is returned.
+        Returns the value of the header matching the name. The name is case insensitive. If multiple headers have the same
+        name (except `set-cookie`), they are returned as a list separated by `, `. For `set-cookie`, the `\\n` separator is
+        used. If no headers are found, `null` is returned.
 
         Parameters
         ----------
@@ -617,11 +644,11 @@ async def abort(self, error_code: typing.Optional[str] = None) -> None:
             Optional error code. Defaults to `failed`, could be one of the following:
             - `'aborted'` - An operation was aborted (due to user action)
             - `'accessdenied'` - Permission to access a resource, other than the network, was denied
-            - `'addressunreachable'` - The IP address is unreachable. This usually means that there is no route to the specified
-              host or network.
+            - `'addressunreachable'` - The IP address is unreachable. This usually means that there is no route to the
+              specified host or network.
             - `'blockedbyclient'` - The client chose to block the request.
-            - `'blockedbyresponse'` - The request failed because the response was delivered along with requirements which are not
-              met ('X-Frame-Options' and 'Content-Security-Policy' ancestor checks, for instance).
+            - `'blockedbyresponse'` - The request failed because the response was delivered along with requirements which are
+              not met ('X-Frame-Options' and 'Content-Security-Policy' ancestor checks, for instance).
             - `'connectionaborted'` - A connection timed out as a result of not receiving an ACK for data sent.
             - `'connectionclosed'` - A connection was closed (corresponding to a TCP FIN).
             - `'connectionfailed'` - A connection attempt failed.
@@ -649,6 +676,8 @@ async def fulfill(
 
         Fulfills route's request with given response.
 
+        **Usage**
+
         An example of fulfilling all requests with 404 responses:
 
         ```py
@@ -658,12 +687,23 @@ async def fulfill(
             body=\"not found!\"))
         ```
 
+        ```py
+        page.route(\"**/*\", lambda route: route.fulfill(
+            status=404,
+            content_type=\"text/plain\",
+            body=\"not found!\"))
+        ```
+
         An example of serving static file:
 
         ```py
         await page.route(\"**/xhr_endpoint\", lambda route: route.fulfill(path=\"mock_data.json\"))
         ```
 
+        ```py
+        page.route(\"**/xhr_endpoint\", lambda route: route.fulfill(path=\"mock_data.json\"))
+        ```
+
         Parameters
         ----------
         status : Union[int, None]
@@ -673,13 +713,13 @@ async def fulfill(
         body : Union[bytes, str, None]
             Response body.
         path : Union[pathlib.Path, str, None]
-            File path to respond with. The content type will be inferred from file extension. If `path` is a relative path, then it
-            is resolved relative to the current working directory.
+            File path to respond with. The content type will be inferred from file extension. If `path` is a relative path,
+            then it is resolved relative to the current working directory.
         content_type : Union[str, None]
             If set, equals to setting `Content-Type` response header.
         response : Union[APIResponse, None]
-            `APIResponse` to fulfill route's request with. Individual fields of the response (such as headers) can be overridden
-            using fulfill options.
+            `APIResponse` to fulfill route's request with. Individual fields of the response (such as headers) can be
+            overridden using fulfill options.
         """
 
         return mapping.from_maybe_impl(
@@ -703,19 +743,27 @@ async def fallback(
     ) -> None:
         """Route.fallback
 
-        When several routes match the given pattern, they run in the order opposite to their registration. That way the last
-        registered route can always override all the previous ones. In the example below, request will be handled by the
-        bottom-most handler first, then it'll fall back to the previous one and in the end will be aborted by the first
+        When several routes match the given pattern, they run in the order opposite to their registration. That way the
+        last registered route can always override all the previous ones. In the example below, request will be handled by
+        the bottom-most handler first, then it'll fall back to the previous one and in the end will be aborted by the first
         registered route.
 
+        **Usage**
+
         ```py
         await page.route(\"**/*\", lambda route: route.abort())  # Runs last.
         await page.route(\"**/*\", lambda route: route.fallback())  # Runs second.
         await page.route(\"**/*\", lambda route: route.fallback())  # Runs first.
         ```
 
-        Registering multiple routes is useful when you want separate handlers to handle different kinds of requests, for example
-        API calls vs page resources or GET requests vs POST requests as in the example below.
+        ```py
+        page.route(\"**/*\", lambda route: route.abort())  # Runs last.
+        page.route(\"**/*\", lambda route: route.fallback())  # Runs second.
+        page.route(\"**/*\", lambda route: route.fallback())  # Runs first.
+        ```
+
+        Registering multiple routes is useful when you want separate handlers to handle different kinds of requests, for
+        example API calls vs page resources or GET requests vs POST requests as in the example below.
 
         ```py
         # Handle GET requests.
@@ -738,8 +786,29 @@ def handle_post(route):
         await page.route(\"**/*\", handle_post)
         ```
 
-        One can also modify request while falling back to the subsequent handler, that way intermediate route handler can modify
-        url, method, headers and postData of the request.
+        ```py
+        # Handle GET requests.
+        def handle_post(route):
+            if route.request.method != \"GET\":
+                route.fallback()
+                return
+          # Handling GET only.
+          # ...
+
+        # Handle POST requests.
+        def handle_post(route):
+            if route.request.method != \"POST\":
+                route.fallback()
+                return
+          # Handling POST only.
+          # ...
+
+        page.route(\"**/*\", handle_get)
+        page.route(\"**/*\", handle_post)
+        ```
+
+        One can also modify request while falling back to the subsequent handler, that way intermediate route handler can
+        modify url, method, headers and postData of the request.
 
         ```py
         async def handle(route, request):
@@ -754,11 +823,24 @@ async def handle(route, request):
         await page.route(\"**/*\", handle)
         ```
 
+        ```py
+        def handle(route, request):
+            # override headers
+            headers = {
+                **request.headers,
+                \"foo\": \"foo-value\" # set \"foo\" header
+                \"bar\": None # remove \"bar\" header
+            }
+            route.fallback(headers=headers)
+        }
+        page.route(\"**/*\", handle)
+        ```
+
         Parameters
         ----------
         url : Union[str, None]
-            If set changes the request URL. New URL must have same protocol as original one. Changing the URL won't affect the route
-            matching, all the routes are matched using the original request URL.
+            If set changes the request URL. New URL must have same protocol as original one. Changing the URL won't affect the
+            route matching, all the routes are matched using the original request URL.
         method : Union[str, None]
             If set changes the request method (e.g. GET or POST)
         headers : Union[Dict[str, str], None]
@@ -788,6 +870,8 @@ async def continue_(
 
         Continues route's request with optional overrides.
 
+        **Usage**
+
         ```py
         async def handle(route, request):
             # override headers
@@ -801,6 +885,19 @@ async def handle(route, request):
         await page.route(\"**/*\", handle)
         ```
 
+        ```py
+        def handle(route, request):
+            # override headers
+            headers = {
+                **request.headers,
+                \"foo\": \"foo-value\" # set \"foo\" header
+                \"bar\": None # remove \"bar\" header
+            }
+            route.continue_(headers=headers)
+        }
+        page.route(\"**/*\", handle)
+        ```
+
         Parameters
         ----------
         url : Union[str, None]
@@ -952,8 +1049,8 @@ def expect_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()`.
+            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
         -------
@@ -975,11 +1072,11 @@ async def wait_for_event(
     ) -> typing.Any:
         """WebSocket.wait_for_event
 
-        > NOTE: In most cases, you should use `web_socket.expect_event()`.
+        **NOTE** In most cases, you should use `web_socket.expect_event()`.
 
-        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function and
-        waits for `predicate(event)` to return a truthy value. Will throw an error if the socket is closed before the `event` is
-        fired.
+        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function
+        and waits for `predicate(event)` to return a truthy value. Will throw an error if the socket is closed before the
+        `event` is fired.
 
         Parameters
         ----------
@@ -988,8 +1085,8 @@ async def wait_for_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()`.
+            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
         -------
@@ -1024,12 +1121,14 @@ async def down(self, key: str) -> None:
 
         Dispatches a `keydown` event.
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -1038,14 +1137,14 @@ async def down(self, key: str) -> None:
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        If `key` is a modifier key, `Shift`, `Meta`, `Control`, or `Alt`, subsequent key presses will be sent with that modifier
-        active. To release the modifier key, use `keyboard.up()`.
+        If `key` is a modifier key, `Shift`, `Meta`, `Control`, or `Alt`, subsequent key presses will be sent with that
+        modifier active. To release the modifier key, use `keyboard.up()`.
 
         After the key is pressed once, subsequent calls to `keyboard.down()` will have
-        [repeat](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/repeat) set to true. To release the key, use
-        `keyboard.up()`.
+        [repeat](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/repeat) set to true. To release the key,
+        use `keyboard.up()`.
 
-        > NOTE: Modifier keys DO influence `keyboard.down`. Holding down `Shift` will type the text in upper case.
+        **NOTE** Modifier keys DO influence `keyboard.down`. Holding down `Shift` will type the text in upper case.
 
         Parameters
         ----------
@@ -1073,11 +1172,18 @@ async def insert_text(self, text: str) -> None:
 
         Dispatches only `input` event, does not emit the `keydown`, `keyup` or `keypress` events.
 
+        **Usage**
+
         ```py
         await page.keyboard.insert_text(\"嗨\")
         ```
 
-        > NOTE: Modifier keys DO NOT effect `keyboard.insertText`. Holding down `Shift` will not type the text in upper case.
+        ```py
+        page.keyboard.insert_text(\"嗨\")
+        ```
+
+        **NOTE** Modifier keys DO NOT effect `keyboard.insertText`. Holding down `Shift` will not type the text in upper
+        case.
 
         Parameters
         ----------
@@ -1094,13 +1200,21 @@ async def type(self, text: str, *, delay: typing.Optional[float] = None) -> None
 
         To press a special key, like `Control` or `ArrowDown`, use `keyboard.press()`.
 
+        **Usage**
+
         ```py
         await page.keyboard.type(\"Hello\") # types instantly
         await page.keyboard.type(\"World\", delay=100) # types slower, like a user
         ```
 
-        > NOTE: Modifier keys DO NOT effect `keyboard.type`. Holding down `Shift` will not type the text in upper case.
-        > NOTE: For characters that are not on a US keyboard, only an `input` event will be sent.
+        ```py
+        page.keyboard.type(\"Hello\") # types instantly
+        page.keyboard.type(\"World\", delay=100) # types slower, like a user
+        ```
+
+        **NOTE** Modifier keys DO NOT effect `keyboard.type`. Holding down `Shift` will not type the text in upper case.
+
+        **NOTE** For characters that are not on a US keyboard, only an `input` event will be sent.
 
         Parameters
         ----------
@@ -1117,12 +1231,14 @@ async def type(self, text: str, *, delay: typing.Optional[float] = None) -> None
     async def press(self, key: str, *, delay: typing.Optional[float] = None) -> None:
         """Keyboard.press
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -1134,6 +1250,8 @@ async def press(self, key: str, *, delay: typing.Optional[float] = None) -> None
         Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
         modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
+        **Usage**
+
         ```py
         page = await browser.new_page()
         await page.goto(\"https://keycode.info\")
@@ -1146,6 +1264,18 @@ async def press(self, key: str, *, delay: typing.Optional[float] = None) -> None
         await browser.close()
         ```
 
+        ```py
+        page = browser.new_page()
+        page.goto(\"https://keycode.info\")
+        page.keyboard.press(\"a\")
+        page.screenshot(path=\"a.png\")
+        page.keyboard.press(\"ArrowLeft\")
+        page.screenshot(path=\"arrow_left.png\")
+        page.keyboard.press(\"Shift+O\")
+        page.screenshot(path=\"o.png\")
+        browser.close()
+        ```
+
         Shortcut for `keyboard.down()` and `keyboard.up()`.
 
         Parameters
@@ -1287,8 +1417,8 @@ async def wheel(self, delta_x: float, delta_y: float) -> None:
 
         Dispatches a `wheel` event.
 
-        > NOTE: Wheel events may cause scrolling if they are not handled, and this method does not wait for the scrolling to
-        finish before returning.
+        **NOTE** Wheel events may cause scrolling if they are not handled, and this method does not wait for the scrolling
+        to finish before returning.
 
         Parameters
         ----------
@@ -1334,20 +1464,26 @@ async def evaluate(
 
         This method passes this handle as the first argument to `expression`.
 
-        If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its value.
+        If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its
+        value.
 
-        Examples:
+        **Usage**
 
         ```py
         tweet_handle = await page.query_selector(\".tweet .retweets\")
         assert await tweet_handle.evaluate(\"node => node.innerText\") == \"10 retweets\"
         ```
 
+        ```py
+        tweet_handle = page.query_selector(\".tweet .retweets\")
+        assert tweet_handle.evaluate(\"node => node.innerText\") == \"10 retweets\"
+        ```
+
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -1371,19 +1507,19 @@ async def evaluate_handle(
 
         This method passes this handle as the first argument to `expression`.
 
-        The only difference between `jsHandle.evaluate` and `jsHandle.evaluateHandle` is that `jsHandle.evaluateHandle` returns
-        `JSHandle`.
+        The only difference between `jsHandle.evaluate` and `jsHandle.evaluateHandle` is that `jsHandle.evaluateHandle`
+        returns `JSHandle`.
 
-        If the function passed to the `jsHandle.evaluateHandle` returns a [Promise], then `jsHandle.evaluateHandle` would wait
-        for the promise to resolve and return its value.
+        If the function passed to the `jsHandle.evaluateHandle` returns a [Promise], then `jsHandle.evaluateHandle` would
+        wait for the promise to resolve and return its value.
 
         See `page.evaluate_handle()` for more details.
 
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -1422,6 +1558,8 @@ async def get_properties(self) -> typing.Dict[str, "JSHandle"]:
 
         The method returns a map with **own property names** as keys and JSHandle instances for the property values.
 
+        **Usage**
+
         ```py
         handle = await page.evaluate_handle(\"({window, document})\")
         properties = await handle.get_properties()
@@ -1430,6 +1568,14 @@ async def get_properties(self) -> typing.Dict[str, "JSHandle"]:
         await handle.dispose()
         ```
 
+        ```py
+        handle = page.evaluate_handle(\"({window, document})\")
+        properties = handle.get_properties()
+        window_handle = properties.get(\"window\")
+        document_handle = properties.get(\"document\")
+        handle.dispose()
+        ```
+
         Returns
         -------
         Dict[str, JSHandle]
@@ -1462,8 +1608,8 @@ async def json_value(self) -> typing.Any:
 
         Returns a JSON representation of the object. If the object has a `toJSON` function, it **will not be called**.
 
-        > NOTE: The method will return an empty JSON object if the referenced object is not stringifiable. It will throw an
-        error if the object has circular references.
+        **NOTE** The method will return an empty JSON object if the referenced object is not stringifiable. It will throw
+        an error if the object has circular references.
 
         Returns
         -------
@@ -1647,12 +1793,18 @@ async def dispatch_event(
         `click` is dispatched. This is equivalent to calling
         [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
 
+        **Usage**
+
         ```py
         await element_handle.dispatch_event(\"click\")
         ```
 
-        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties
-        and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
+        ```py
+        element_handle.dispatch_event(\"click\")
+        ```
+
+        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
+        properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
@@ -1671,6 +1823,12 @@ async def dispatch_event(
         await element_handle.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
         ```
 
+        ```py
+        # note you can only create data_transfer in chromium and firefox
+        data_transfer = page.evaluate_handle(\"new DataTransfer()\")
+        element_handle.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
+        ```
+
         Parameters
         ----------
         type : str
@@ -1690,8 +1848,8 @@ async def scroll_into_view_if_needed(
     ) -> None:
         """ElementHandle.scroll_into_view_if_needed
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then tries to scroll element into view, unless it is
-        completely visible as defined by
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then tries to scroll element into view, unless
+        it is completely visible as defined by
         [IntersectionObserver](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)'s `ratio`.
 
         Throws when `elementHandle` does not point to an element
@@ -1700,8 +1858,8 @@ async def scroll_into_view_if_needed(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -1730,29 +1888,29 @@ async def hover(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -1791,17 +1949,17 @@ async def click(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -1809,17 +1967,17 @@ async def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -1856,40 +2014,40 @@ async def dblclick(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if the
-           first click of the `dblclick()` triggers a navigation event, this method will throw.
+        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
+           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `elementHandle.dblclick()` dispatches two `click` events and a single `dblclick` event.
+        **NOTE** `elementHandle.dblclick()` dispatches two `click` events and a single `dblclick` event.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -1920,17 +2078,20 @@ async def select_option(
     ) -> typing.List[str]:
         """ElementHandle.select_option
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in the
-        `<select>` element and selects these options.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in
+        the `<select>` element and selects these options.
 
-        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside the
-        `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used instead.
+        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside
+        the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used
+        instead.
 
         Returns the array of option values that have been successfully selected.
 
         Triggers a `change` and `input` event once all the provided options have been selected.
 
+        **Usage**
+
         ```py
         # single selection matching the value
         await handle.select_option(\"blue\")
@@ -1940,27 +2101,36 @@ async def select_option(
         await handle.select_option(value=[\"red\", \"green\", \"blue\"])
         ```
 
+        ```py
+        # single selection matching the value
+        handle.select_option(\"blue\")
+        # single selection matching both the label
+        handle.select_option(label=\"blue\")
+        # multiple selection
+        handle.select_option(value=[\"red\", \"green\", \"blue\"])
+        ```
+
         Parameters
         ----------
         value : Union[List[str], str, None]
-            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         index : Union[List[int], int, None]
             Options to select by index. Optional.
         label : Union[List[str], str, None]
-            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
 
         Returns
         -------
@@ -2001,31 +2171,31 @@ async def tap(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `elementHandle.tap()` requires that the `hasTouch` option of the browser context be set to true.
+        **NOTE** `elementHandle.tap()` requires that the `hasTouch` option of the browser context be set to true.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -2049,11 +2219,11 @@ async def fill(
     ) -> None:
         """ElementHandle.fill
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an `input`
-        event after filling. Note that you can pass an empty string to clear the input field.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an
+        `input` event after filling. Note that you can pass an empty string to clear the input field.
 
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an
+        error. However, if the element is inside the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
@@ -2064,12 +2234,12 @@ async def fill(
         value : str
             Value to set for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -2088,20 +2258,20 @@ async def select_text(
     ) -> None:
         """ElementHandle.select_text
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then focuses the element and selects all its text
-        content.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then focuses the element and selects all its
+        text content.
 
         If the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), focuses and selects text in the
-        control instead.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), focuses and selects text in
+        the control instead.
 
         Parameters
         ----------
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -2114,13 +2284,14 @@ async def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
 
         Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the
+        control.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -2146,24 +2317,24 @@ async def set_input_files(
     ) -> None:
         """ElementHandle.set_input_files
 
-        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
-        are resolved relative to the current working directory. For empty array, clears the selected files.
+        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
+        they are resolved relative to the current working directory. For empty array, clears the selected files.
 
         This method expects `ElementHandle` to point to an
-        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
-        `<label>` element that has an associated
+        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
+        the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
 
         Parameters
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -2190,15 +2361,23 @@ async def type(
     ) -> None:
         """ElementHandle.type
 
-        Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text.
+        Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the
+        text.
 
         To press a special key, like `Control` or `ArrowDown`, use `element_handle.press()`.
 
+        **Usage**
+
         ```py
         await element_handle.type(\"hello\") # types instantly
         await element_handle.type(\"world\", delay=100) # types slower, like a user
         ```
 
+        ```py
+        element_handle.type(\"hello\") # types instantly
+        element_handle.type(\"world\", delay=100) # types slower, like a user
+        ```
+
         An example of typing into a text field and then submitting the form:
 
         ```py
@@ -2207,6 +2386,12 @@ async def type(
         await element_handle.press(\"Enter\")
         ```
 
+        ```py
+        element_handle = page.query_selector(\"input\")
+        element_handle.type(\"some text\")
+        element_handle.press(\"Enter\")
+        ```
+
         Parameters
         ----------
         text : str
@@ -2214,12 +2399,12 @@ async def type(
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -2240,12 +2425,14 @@ async def press(
 
         Focuses the element, and then uses `keyboard.down()` and `keyboard.up()`.
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -2264,12 +2451,12 @@ async def press(
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -2293,35 +2480,35 @@ async def set_checked(
         This method checks or unchecks an element by performing the following steps:
         1. Ensure that element is a checkbox or a radio input. If not, this method throws.
         1. If the element already has the right checked state, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -2347,8 +2534,8 @@ async def check(
         """ElementHandle.check
 
         This method checks the element by performing the following steps:
-        1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already checked,
-           this method returns immediately.
+        1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already
+           checked, this method returns immediately.
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
@@ -2357,26 +2544,26 @@ async def check(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -2411,26 +2598,26 @@ async def uncheck(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -2450,20 +2637,27 @@ async def bounding_box(self) -> typing.Optional[FloatRect]:
         calculated relative to the main frame viewport - which is usually the same as the browser window.
 
         Scrolling affects the returned bounding box, similarly to
-        [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect). That
-        means `x` and/or `y` may be negative.
+        [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
+        That means `x` and/or `y` may be negative.
 
         Elements from child frames return the bounding box relative to the main frame, unlike the
         [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
 
-        Assuming the page is static, it is safe to use bounding box coordinates to perform input. For example, the following
-        snippet should click the center of the element.
+        Assuming the page is static, it is safe to use bounding box coordinates to perform input. For example, the
+        following snippet should click the center of the element.
+
+        **Usage**
 
         ```py
         box = await element_handle.bounding_box()
         await page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
         ```
 
+        ```py
+        box = element_handle.bounding_box()
+        page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
+        ```
+
         Returns
         -------
         Union[{x: float, y: float, width: float, height: float}, None]
@@ -2487,49 +2681,49 @@ async def screenshot(
         """ElementHandle.screenshot
 
         This method captures a screenshot of the page, clipped to the size and position of this particular element. If the
-        element is covered by other elements, it will not be actually visible on the screenshot. If the element is a scrollable
-        container, only the currently scrolled content will be visible on the screenshot.
+        element is covered by other elements, it will not be actually visible on the screenshot. If the element is a
+        scrollable container, only the currently scrolled content will be visible on the screenshot.
 
-        This method waits for the [actionability](https://playwright.dev/python/docs/actionability) checks, then scrolls element into view before taking a
-        screenshot. If the element is detached from DOM, the method throws an error.
+        This method waits for the [actionability](https://playwright.dev/python/docs/actionability) checks, then scrolls element into view before taking
+        a screenshot. If the element is detached from DOM, the method throws an error.
 
         Returns the buffer with the captured screenshot.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
-            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a relative
-            path, then it is resolved relative to the current working directory. If no path is provided, the image won't be saved to
-            the disk.
+            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a
+            relative path, then it is resolved relative to the current working directory. If no path is provided, the image
+            won't be saved to the disk.
         quality : Union[int, None]
             The quality of the image, between 0-100. Not applicable to `png` images.
         omit_background : Union[bool, None]
             Hides default white background and allows capturing screenshots with transparency. Not applicable to `jpeg` images.
             Defaults to `false`.
         animations : Union["allow", "disabled", None]
-            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different treatment
-            depending on their duration:
+            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different
+            treatment depending on their duration:
             - finite animations are fast-forwarded to completion, so they'll fire `transitionend` event.
             - infinite animations are canceled to initial state, and then played over after the screenshot.
 
             Defaults to `"allow"` that leaves animations untouched.
         caret : Union["hide", "initial", None]
-            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be changed.
-            Defaults to `"hide"`.
+            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be
+            changed.  Defaults to `"hide"`.
         scale : Union["css", "device", None]
-            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
-            high-dpi devices will be twice as large or even larger.
+            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this
+            will keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so
+            screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
-            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-            `#FF00FF` that completely covers its bounding box.
+            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
+            box `#FF00FF` that completely covers its bounding box.
 
         Returns
         -------
@@ -2597,14 +2791,14 @@ async def eval_on_selector(
 
         Returns the return value of `expression`.
 
-        The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a first
-        argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the
-        selector, the method throws an error.
+        The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a
+        first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements
+        match the selector, the method throws an error.
 
-        If `expression` returns a [Promise], then `element_handle.eval_on_selector()` would wait for the promise to resolve
-        and return its value.
+        If `expression` returns a [Promise], then `element_handle.eval_on_selector()` would wait for the promise to
+        resolve and return its value.
 
-        Examples:
+        **Usage**
 
         ```py
         tweet_handle = await page.query_selector(\".tweet\")
@@ -2612,13 +2806,19 @@ async def eval_on_selector(
         assert await tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") = \"10\"
         ```
 
+        ```py
+        tweet_handle = page.query_selector(\".tweet\")
+        assert tweet_handle.eval_on_selector(\".like\", \"node => node.innerText\") == \"100\"
+        assert tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") = \"10\"
+        ```
+
         Parameters
         ----------
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -2640,13 +2840,14 @@ async def eval_on_selector_all(
 
         Returns the return value of `expression`.
 
-        The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array of
-        matched elements as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details.
+        The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array
+        of matched elements as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more
+        details.
 
         If `expression` returns a [Promise], then `element_handle.eval_on_selector_all()` would wait for the promise to
         resolve and return its value.
 
-        Examples:
+        **Usage**
 
         ```html
         <div class=\"feed\">
@@ -2660,13 +2861,18 @@ async def eval_on_selector_all(
         assert await feed_handle.eval_on_selector_all(\".tweet\", \"nodes => nodes.map(n => n.innerText)\") == [\"hello!\", \"hi!\"]
         ```
 
+        ```py
+        feed_handle = page.query_selector(\".feed\")
+        assert feed_handle.eval_on_selector_all(\".tweet\", \"nodes => nodes.map(n => n.innerText)\") == [\"hello!\", \"hi!\"]
+        ```
+
         Parameters
         ----------
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -2697,7 +2903,8 @@ async def wait_for_element_state(
         pass. This method throws when the element is detached while waiting, unless waiting for the `\"hidden\"` state.
         - `\"visible\"` Wait until the element is [visible](https://playwright.dev/python/docs/actionability#visible).
         - `\"hidden\"` Wait until the element is [not visible](https://playwright.dev/python/docs/actionability#visible) or
-          [not attached](https://playwright.dev/python/docs/actionability#attached). Note that waiting for hidden does not throw when the element detaches.
+          [not attached](https://playwright.dev/python/docs/actionability#attached). Note that waiting for hidden does not throw when the element
+          detaches.
         - `\"stable\"` Wait until the element is both [visible](https://playwright.dev/python/docs/actionability#visible) and
           [stable](https://playwright.dev/python/docs/actionability#stable).
         - `\"enabled\"` Wait until the element is [enabled](https://playwright.dev/python/docs/actionability#enabled).
@@ -2711,8 +2918,8 @@ async def wait_for_element_state(
         state : Union["disabled", "editable", "enabled", "hidden", "stable", "visible"]
             A state to wait for, see below for more details.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -2734,10 +2941,12 @@ async def wait_for_selector(
         Returns element specified by selector when it satisfies `state` option. Returns `null` if waiting for `hidden` or
         `detached`.
 
-        Wait for the `selector` relative to the element handle to satisfy `state` option (either appear/disappear from dom, or
-        become visible/hidden). If at the moment of calling the method `selector` already satisfies the condition, the method
-        will return immediately. If the selector doesn't satisfy the condition for the `timeout` milliseconds, the function will
-        throw.
+        Wait for the `selector` relative to the element handle to satisfy `state` option (either appear/disappear from dom,
+        or become visible/hidden). If at the moment of calling the method `selector` already satisfies the condition, the
+        method will return immediately. If the selector doesn't satisfy the condition for the `timeout` milliseconds, the
+        function will throw.
+
+        **Usage**
 
         ```py
         await page.set_content(\"<div><span></span></div>\")
@@ -2746,7 +2955,14 @@ async def wait_for_selector(
         span = await div.wait_for_selector(\"span\", state=\"attached\")
         ```
 
-        > NOTE: This method does not work across navigations, use `page.wait_for_selector()` instead.
+        ```py
+        page.set_content(\"<div><span></span></div>\")
+        div = page.query_selector(\"div\")
+        # waiting for the \"span\" selector relative to the div.
+        span = div.wait_for_selector(\"span\", state=\"attached\")
+        ```
+
+        **NOTE** This method does not work across navigations, use `page.wait_for_selector()` instead.
 
         Parameters
         ----------
@@ -2756,13 +2972,13 @@ async def wait_for_selector(
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
             - `'detached'` - wait for element to not be present in DOM.
-            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element without
-              any content or with `display:none` has an empty bounding box and is not considered visible.
-            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.
-              This is opposite to the `'visible'` option.
+            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element
+              without any content or with `display:none` has an empty bounding box and is not considered visible.
+            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or
+              `visibility:hidden`. This is opposite to the `'visible'` option.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -2791,15 +3007,14 @@ async def snapshot(
     ) -> typing.Optional[typing.Dict]:
         """Accessibility.snapshot
 
-        **DEPRECATED** This method is deprecated. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you
-        need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for
-        integration with Axe.
+        Captures the current state of the accessibility tree. The returned object represents the root accessible node of
+        the page.
 
-        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`.
 
-        > 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:
 
@@ -2808,6 +3023,11 @@ async def snapshot(
         print(snapshot)
         ```
 
+        ```py
+        snapshot = page.accessibility.snapshot()
+        print(snapshot)
+        ```
+
         An example of logging the focused node's name:
 
         ```py
@@ -2826,6 +3046,22 @@ def find_focused_node(node):
             print(node[\"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]
@@ -2900,19 +3136,19 @@ async def set_files(
     ) -> None:
         """FileChooser.set_files
 
-        Sets the value of the file input this chooser is associated with. If some of the `filePaths` are relative paths, then
-        they are resolved relative to the current working directory. For empty array, clears the selected files.
+        Sets the value of the file input this chooser is associated with. If some of the `filePaths` are relative paths,
+        then they are resolved relative to the current working directory. For empty array, clears the selected files.
 
         Parameters
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -2946,7 +3182,8 @@ def name(self) -> str:
 
         If the name is empty, returns the id attribute instead.
 
-        > NOTE: This value is calculated once when the frame is created, and will not update if the attribute is changed later.
+        **NOTE** This value is calculated once when the frame is created, and will not update if the attribute is changed
+        later.
 
         Returns
         -------
@@ -3000,8 +3237,8 @@ async def goto(
     ) -> typing.Optional["Response"]:
         """Frame.goto
 
-        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
-        last redirect.
+        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
+        the last redirect.
 
         The method will throw an error if:
         - there's an SSL error (e.g. in case of self-signed certificates).
@@ -3010,13 +3247,14 @@ async def goto(
         - the remote server does not respond or is unreachable.
         - the main resource failed to load.
 
-        The method will not throw an error when any valid HTTP status code is returned by the remote server, including 404 \"Not
-        Found\" and 500 \"Internal Server Error\".  The status code for such responses can be retrieved by calling
+        The method will not throw an error when any valid HTTP status code is returned by the remote server, including 404
+        \"Not Found\" and 500 \"Internal Server Error\".  The status code for such responses can be retrieved by calling
         `response.status()`.
 
-        > NOTE: The method either throws an error or returns a main resource response. The only exceptions are navigation to
-        `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
-        > NOTE: Headless mode doesn't support navigation to a PDF document. See the
+        **NOTE** The method either throws an error or returns a main resource response. The only exceptions are navigation
+        to `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
+
+        **NOTE** Headless mode doesn't support navigation to a PDF document. See the
         [upstream issue](https://bugs.chromium.org/p/chromium/issues/detail?id=761295).
 
         Parameters
@@ -3024,16 +3262,18 @@ async def goto(
         url : str
             URL to navigate frame to. The url should include scheme, e.g. `https://`.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         referer : Union[str, None]
             Referer header value. If provided it will take preference over the referer header value set by
             `page.set_extra_http_headers()`.
@@ -3062,12 +3302,14 @@ def expect_navigation(
     ) -> AsyncEventContextManager["Response"]:
         """Frame.expect_navigation
 
-        Waits for the frame navigation and returns the main resource response. In case of multiple redirects, the navigation
-        will resolve with the response of the last redirect. In case of navigation to a different anchor or navigation due to
-        History API usage, the navigation will resolve with `null`.
+        Waits for the frame navigation and returns the main resource response. In case of multiple redirects, the
+        navigation will resolve with the response of the last redirect. In case of navigation to a different anchor or
+        navigation due to History API usage, the navigation will resolve with `null`.
+
+        **Usage**
 
-        This method waits for the frame to navigate to a new URL. It is useful for when you run code which will indirectly cause
-        the frame to navigate. Consider this example:
+        This method waits for the frame to navigate to a new URL. It is useful for when you run code which will indirectly
+        cause the frame to navigate. Consider this example:
 
         ```py
         async with frame.expect_navigation():
@@ -3075,24 +3317,32 @@ def expect_navigation(
         # Resolves after navigation has finished
         ```
 
-        > NOTE: Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL is
-        considered a navigation.
+        ```py
+        with frame.expect_navigation():
+            frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+        # Resolves after navigation has finished
+        ```
+
+        **NOTE** Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL
+        is considered a 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 the
-            parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to
-            the string.
+            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]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
 
@@ -3120,26 +3370,35 @@ async def wait_for_url(
 
         Waits for the frame to navigate to the given URL.
 
+        **Usage**
+
         ```py
         await frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
         await frame.wait_for_url(\"**/target.html\")
         ```
 
+        ```py
+        frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+        frame.wait_for_url(\"**/target.html\")
+        ```
+
         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 the
-            parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to
-            the string.
+            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]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         """
@@ -3162,14 +3421,22 @@ async def wait_for_load_state(
 
         Waits for the required load state to be reached.
 
-        This returns when the frame reaches a required load state, `load` by default. The navigation must have been committed
-        when this method is called. If current document has already reached the required state, resolves immediately.
+        This returns when the frame reaches a required load state, `load` by default. The navigation must have been
+        committed when this method is called. If current document has already reached the required state, resolves
+        immediately.
+
+        **Usage**
 
         ```py
         await frame.click(\"button\") # click triggers navigation.
         await frame.wait_for_load_state() # the promise resolves after \"load\" event.
         ```
 
+        ```py
+        frame.click(\"button\") # click triggers navigation.
+        frame.wait_for_load_state() # the promise resolves after \"load\" event.
+        ```
+
         Parameters
         ----------
         state : Union["domcontentloaded", "load", "networkidle", None]
@@ -3179,8 +3446,8 @@ async def wait_for_load_state(
             - `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired.
             - `'networkidle'` - wait until there are no network connections for at least `500` ms.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         """
@@ -3194,17 +3461,25 @@ async def frame_element(self) -> "ElementHandle":
 
         Returns the `frame` or `iframe` element handle which corresponds to this frame.
 
-        This is an inverse of `element_handle.content_frame()`. Note that returned handle actually belongs to the parent
-        frame.
+        This is an inverse of `element_handle.content_frame()`. Note that returned handle actually belongs to the
+        parent frame.
 
         This method throws an error if the frame has been detached before `frameElement()` returns.
 
+        **Usage**
+
         ```py
         frame_element = await frame.frame_element()
         content_frame = await frame_element.content_frame()
         assert frame == content_frame
         ```
 
+        ```py
+        frame_element = frame.frame_element()
+        content_frame = frame_element.content_frame()
+        assert frame == content_frame
+        ```
+
         Returns
         -------
         ElementHandle
@@ -3219,18 +3494,25 @@ async def evaluate(
 
         Returns the return value of `expression`.
 
-        If the function passed to the `frame.evaluate()` returns a [Promise], then `frame.evaluate()` would wait
-        for the promise to resolve and return its value.
+        If the function passed to the `frame.evaluate()` returns a [Promise], then `frame.evaluate()` would
+        wait for the promise to resolve and return its value.
 
         If the function passed to the `frame.evaluate()` returns a non-[Serializable] value, then
-        `frame.evaluate()` returns `undefined`. Playwright also supports transferring some additional values that are
-        not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
+        `frame.evaluate()` returns `undefined`. Playwright also supports transferring some additional values that
+        are not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
+
+        **Usage**
 
         ```py
         result = await frame.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
         print(result) # prints \"56\"
         ```
 
+        ```py
+        result = frame.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
+        print(result) # prints \"56\"
+        ```
+
         A string can also be passed in instead of a function.
 
         ```py
@@ -3239,6 +3521,12 @@ async def evaluate(
         print(await frame.evaluate(f\"1 + {x}\")) # prints \"11\"
         ```
 
+        ```py
+        print(frame.evaluate(\"1 + 2\")) # prints \"3\"
+        x = 10
+        print(frame.evaluate(f\"1 + {x}\")) # prints \"11\"
+        ```
+
         `ElementHandle` instances can be passed as an argument to the `frame.evaluate()`:
 
         ```py
@@ -3247,11 +3535,17 @@ async def evaluate(
         await body_handle.dispose()
         ```
 
+        ```py
+        body_handle = frame.evaluate(\"document.body\")
+        html = frame.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
+        body_handle.dispose()
+        ```
+
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3279,17 +3573,28 @@ async def evaluate_handle(
         If the function, passed to the `frame.evaluate_handle()`, returns a [Promise], then
         `frame.evaluate_handle()` would wait for the promise to resolve and return its value.
 
+        **Usage**
+
         ```py
         a_window_handle = await frame.evaluate_handle(\"Promise.resolve(window)\")
         a_window_handle # handle for the window object.
         ```
 
+        ```py
+        a_window_handle = frame.evaluate_handle(\"Promise.resolve(window)\")
+        a_window_handle # handle for the window object.
+        ```
+
         A string can also be passed in instead of a function.
 
         ```py
         a_handle = await page.evaluate_handle(\"document\") # handle for the \"document\"
         ```
 
+        ```py
+        a_handle = page.evaluate_handle(\"document\") # handle for the \"document\"
+        ```
+
         `JSHandle` instances can be passed as an argument to the `frame.evaluate_handle()`:
 
         ```py
@@ -3299,11 +3604,18 @@ async def evaluate_handle(
         await result_handle.dispose()
         ```
 
+        ```py
+        a_handle = page.evaluate_handle(\"document.body\")
+        result_handle = page.evaluate_handle(\"body => body.innerHTML\", a_handle)
+        print(result_handle.json_value())
+        result_handle.dispose()
+        ```
+
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3325,7 +3637,7 @@ async def query_selector(
 
         Returns the ElementHandle pointing to the frame element.
 
-        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
+        **NOTE** The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
 
         The method finds an element matching the specified selector within the frame. See
         [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns `null`.
@@ -3352,7 +3664,7 @@ async def query_selector_all(self, selector: str) -> typing.List["ElementHandle"
 
         Returns the ElementHandles pointing to the frame elements.
 
-        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects instead.
+        **NOTE** The use of `ElementHandle` is discouraged, use `Locator` objects instead.
 
         The method finds all elements matching the specified selector within the frame. See
         [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns empty array.
@@ -3386,12 +3698,14 @@ async def wait_for_selector(
         Returns when element specified by selector satisfies `state` option. Returns `null` if waiting for `hidden` or
         `detached`.
 
-        > NOTE: Playwright automatically waits for element to be ready before performing an action. Using `Locator` objects and
-        web-first assertions make the code wait-for-selector-free.
+        **NOTE** Playwright automatically waits for element to be ready before performing an action. Using `Locator`
+        objects and web-first assertions make the code wait-for-selector-free.
+
+        Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If
+        at the moment of calling the method `selector` already satisfies the condition, the method will return immediately.
+        If the selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
 
-        Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at
-        the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the
-        selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
+        **Usage**
 
         This method works across navigations:
 
@@ -3415,6 +3729,23 @@ async def main():
         asyncio.run(main())
         ```
 
+        ```py
+        from playwright.sync_api import sync_playwright
+
+        def run(playwright):
+            chromium = playwright.chromium
+            browser = chromium.launch()
+            page = browser.new_page()
+            for current_url in [\"https://google.com\", \"https://bbc.com\"]:
+                page.goto(current_url, wait_until=\"domcontentloaded\")
+                element = page.main_frame.wait_for_selector(\"img\")
+                print(\"Loaded image: \" + str(element.get_attribute(\"src\")))
+            browser.close()
+
+        with sync_playwright() as playwright:
+            run(playwright)
+        ```
+
         Parameters
         ----------
         selector : str
@@ -3423,16 +3754,16 @@ async def main():
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
             - `'detached'` - wait for element to not be present in DOM.
-            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element without
-              any content or with `display:none` has an empty bounding box and is not considered visible.
-            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.
-              This is opposite to the `'visible'` option.
+            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element
+              without any content or with `display:none` has an empty bounding box and is not considered visible.
+            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or
+              `visibility:hidden`. This is opposite to the `'visible'` option.
 
         Returns
         -------
@@ -3459,14 +3790,14 @@ async def is_checked(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -3493,14 +3824,14 @@ async def is_disabled(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -3527,14 +3858,14 @@ async def is_editable(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -3561,14 +3892,14 @@ async def is_enabled(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -3590,20 +3921,18 @@ async def is_hidden(
     ) -> bool:
         """Frame.is_hidden
 
-        Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).  `selector` that does not
-        match any elements is considered hidden.
+        Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).  `selector` that
+        does not match any elements is considered hidden.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `frame.is_hidden()` does not wait for the element to become hidden and
-            returns immediately.
 
         Returns
         -------
@@ -3625,20 +3954,18 @@ async def is_visible(
     ) -> bool:
         """Frame.is_visible
 
-        Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible). `selector` that does not match any elements is
-        considered not visible.
+        Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible). `selector` that does not match any elements
+        is considered not visible.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `frame.is_visible()` does not wait for the element to become visible and
-            returns immediately.
 
         Returns
         -------
@@ -3666,12 +3993,18 @@ async def dispatch_event(
         `click` is dispatched. This is equivalent to calling
         [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
 
+        **Usage**
+
         ```py
         await frame.dispatch_event(\"button#submit\", \"click\")
         ```
 
-        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties
-        and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
+        ```py
+        frame.dispatch_event(\"button#submit\", \"click\")
+        ```
+
+        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
+        properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
@@ -3690,11 +4023,17 @@ async def dispatch_event(
         await frame.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
         ```
 
+        ```py
+        # note you can only create data_transfer in chromium and firefox
+        data_transfer = frame.evaluate_handle(\"new DataTransfer()\")
+        frame.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
+        ```
+
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         type : str
             DOM event type: `"click"`, `"dragstart"`, etc.
         event_init : Union[Dict, None]
@@ -3703,8 +4042,8 @@ async def dispatch_event(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -3729,17 +4068,14 @@ async def eval_on_selector(
 
         Returns the return value of `expression`.
 
-        > NOTE: This method does not wait for the element to pass actionability checks and therefore can lead to the flaky
-        tests. Use `locator.evaluate()`, other `Locator` helper methods or web-first assertions instead.
-
         The method finds an element matching the specified selector within the frame and passes it as a first argument to
-        `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, the
-        method throws an error.
+        `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector,
+        the method throws an error.
 
-        If `expression` returns a [Promise], then `frame.eval_on_selector()` would wait for the promise to resolve and
-        return its value.
+        If `expression` returns a [Promise], then `frame.eval_on_selector()` would wait for the promise to resolve
+        and return its value.
 
-        Examples:
+        **Usage**
 
         ```py
         search_value = await frame.eval_on_selector(\"#search\", \"el => el.value\")
@@ -3747,13 +4083,19 @@ async def eval_on_selector(
         html = await frame.eval_on_selector(\".main-container\", \"(e, suffix) => e.outerHTML + suffix\", \"hello\")
         ```
 
+        ```py
+        search_value = frame.eval_on_selector(\"#search\", \"el => el.value\")
+        preload_href = frame.eval_on_selector(\"link[rel=preload]\", \"el => el.href\")
+        html = frame.eval_on_selector(\".main-container\", \"(e, suffix) => e.outerHTML + suffix\", \"hello\")
+        ```
+
         Parameters
         ----------
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         strict : Union[bool, None]
@@ -3781,28 +4123,29 @@ async def eval_on_selector_all(
 
         Returns the return value of `expression`.
 
-        > NOTE: In most cases, `locator.evaluate_all()`, other `Locator` helper methods and web-first assertions do a
-        better job.
+        The method finds all elements matching the specified selector within the frame and passes an array of matched
+        elements as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details.
 
-        The method finds all elements matching the specified selector within the frame and passes an array of matched elements
-        as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details.
-
-        If `expression` returns a [Promise], then `frame.eval_on_selector_all()` would wait for the promise to resolve and
-        return its value.
+        If `expression` returns a [Promise], then `frame.eval_on_selector_all()` would wait for the promise to resolve
+        and return its value.
 
-        Examples:
+        **Usage**
 
         ```py
         divs_counts = await frame.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
         ```
 
+        ```py
+        divs_counts = frame.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
+        ```
+
         Parameters
         ----------
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3845,16 +4188,18 @@ async def set_content(
         html : str
             HTML markup to assign to the page.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         """
 
         return mapping.from_maybe_impl(
@@ -3894,8 +4239,8 @@ async def add_script_tag(
         url : Union[str, None]
             URL of a script to be added.
         path : Union[pathlib.Path, str, None]
-            Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative to the
-            current working directory.
+            Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative
+            to the current working directory.
         content : Union[str, None]
             Raw JavaScript content to be injected into frame.
         type : Union[str, None]
@@ -3967,26 +4312,26 @@ async def click(
 
         This method clicks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -3994,20 +4339,20 @@ async def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4046,48 +4391,48 @@ async def dblclick(
 
         This method double clicks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if the
-           first click of the `dblclick()` triggers a navigation event, this method will throw.
+        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
+           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `frame.dblclick()` dispatches two `click` events and a single `dblclick` event.
+        **NOTE** `frame.dblclick()` dispatches two `click` events and a single `dblclick` event.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4123,43 +4468,43 @@ async def tap(
 
         This method taps an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `frame.tap()` requires that the `hasTouch` option of the browser context be set to true.
+        **NOTE** `frame.tap()` requires that the `hasTouch` option of the browser context be set to true.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4187,12 +4532,12 @@ async def fill(
     ) -> None:
         """Frame.fill
 
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
-        element, fills it and triggers an `input` event after filling. Note that you can pass an empty string to clear the input
-        field.
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks,
+        focuses the element, fills it and triggers an `input` event after filling. Note that you can pass an empty string
+        to clear the input field.
 
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an
+        error. However, if the element is inside the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
@@ -4201,17 +4546,17 @@ async def fill(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4239,9 +4584,9 @@ def locator(
     ) -> "Locator":
         """Frame.locator
 
-        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved to
-        the element immediately before performing an action, so a series of actions on the same locator can in fact be performed
-        on different DOM elements. That would happen if the DOM structure between those actions has changed.
+        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved
+        to the element immediately before performing an action, so a series of actions on the same locator can in fact be
+        performed on different DOM elements. That would happen if the DOM structure between those actions has changed.
 
         [Learn more about locators](https://playwright.dev/python/docs/locators).
 
@@ -4252,12 +4597,12 @@ def locator(
         selector : str
             A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
         has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
+            passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
+            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
@@ -4291,8 +4636,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4322,8 +4667,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4352,8 +4697,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4469,9 +4814,10 @@ def get_by_role(
         accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
 
         Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
-        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
-        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
+        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
+        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
+        default values.
 
         Parameters
         ----------
@@ -4484,7 +4830,7 @@ def get_by_role(
         disabled : Union[bool, None]
             An attribute that is usually set by `aria-disabled` or `disabled`.
 
-            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
@@ -4496,8 +4842,8 @@ def get_by_role(
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
         level : Union[int, None]
-            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
-            `<h1>-<h6>` elements.
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values
+            for `<h1>-<h6>` elements.
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
@@ -4514,8 +4860,8 @@ def get_by_role(
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
         exact : Union[bool, None]
-            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
-            expression. Note that exact match still trims whitespace.
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4589,23 +4935,41 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
-        by the text content.
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
 
-        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
-        one, turns line breaks into spaces and ignores leading and trailing whitespace.
-        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
-        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
 
-        Parameters
-        ----------
-        text : Union[Pattern[str], str]
-            Text to locate the element for.
-        exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
 
-        Returns
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
+        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+
+        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
+        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
+
+        Returns
         -------
         Locator
         """
@@ -4620,7 +4984,8 @@ def get_by_title(
     ) -> "Locator":
         """Frame.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
+        order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -4631,8 +4996,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4644,8 +5009,12 @@ def get_by_title(
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Frame.frame_locator
 
-        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements in
-        that iframe. Following snippet locates element with text \"Submit\" in the iframe with id `my-frame`, like `<iframe
+        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
+        in that iframe.
+
+        **Usage**
+
+        Following snippet locates element with text \"Submit\" in the iframe with id `my-frame`, like `<iframe
         id=\"my-frame\">`:
 
         ```py
@@ -4653,6 +5022,11 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         await locator.click()
         ```
 
+        ```py
+        locator = frame.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
+        locator.click()
+        ```
+
         Parameters
         ----------
         selector : str
@@ -4674,20 +5048,20 @@ async def focus(
     ) -> None:
         """Frame.focus
 
-        This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the method
-        waits until a matching element appears in the DOM.
+        This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the
+        method waits until a matching element appears in the DOM.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -4710,14 +5084,14 @@ async def text_content(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -4744,14 +5118,14 @@ async def inner_text(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -4778,14 +5152,14 @@ async def inner_html(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -4813,16 +5187,16 @@ async def get_attribute(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         name : str
             Attribute name to get the value for.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -4853,41 +5227,41 @@ async def hover(
 
         This method hovers over an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4921,11 +5295,11 @@ async def drag_and_drop(
         Parameters
         ----------
         source : str
-            A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
-        target : str
-            A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will
+            A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will
             be used. See [working with selectors](../selectors.md) for more details.
+        target : str
+            A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first
+            will be used. See [working with selectors](../selectors.md) for more details.
         source_position : Union[{x: float, y: float}, None]
             Clicks on the source 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.
@@ -4935,18 +5309,18 @@ async def drag_and_drop(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4980,17 +5354,20 @@ async def select_option(
     ) -> typing.List[str]:
         """Frame.select_option
 
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until
-        all specified options are present in the `<select>` element and selects these options.
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits
+        until all specified options are present in the `<select>` element and selects these options.
 
-        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside the
-        `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used instead.
+        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside
+        the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used
+        instead.
 
         Returns the array of option values that have been successfully selected.
 
         Triggers a `change` and `input` event once all the provided options have been selected.
 
+        **Usage**
+
         ```py
         # single selection matching the value
         await frame.select_option(\"select#colors\", \"blue\")
@@ -5000,27 +5377,36 @@ async def select_option(
         await frame.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
         ```
 
+        ```py
+        # single selection matching the value
+        frame.select_option(\"select#colors\", \"blue\")
+        # single selection matching both the label
+        frame.select_option(\"select#colors\", label=\"blue\")
+        # multiple selection
+        frame.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
+        ```
+
         Parameters
         ----------
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         value : Union[List[str], str, None]
-            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         index : Union[List[int], int, None]
             Options to select by index. Optional.
         label : Union[List[str], str, None]
-            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5058,19 +5444,20 @@ async def input_value(
         Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
 
         Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the
+        control.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -5100,30 +5487,30 @@ async def set_input_files(
     ) -> None:
         """Frame.set_input_files
 
-        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
-        are resolved relative to the current working directory. For empty array, clears the selected files.
+        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
+        they are resolved relative to the current working directory. For empty array, clears the selected files.
 
         This method expects `selector` to point to an
-        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
-        `<label>` element that has an associated
+        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
+        the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -5148,21 +5535,28 @@ async def type(
     ) -> None:
         """Frame.type
 
-        Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `frame.type` can be used to
-        send fine-grained keyboard events. To fill values in form fields, use `frame.fill()`.
+        Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `frame.type` can be used
+        to send fine-grained keyboard events. To fill values in form fields, use `frame.fill()`.
 
         To press a special key, like `Control` or `ArrowDown`, use `keyboard.press()`.
 
+        **Usage**
+
         ```py
         await frame.type(\"#mytextarea\", \"hello\") # types instantly
         await frame.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
         ```
 
+        ```py
+        frame.type(\"#mytextarea\", \"hello\") # types instantly
+        frame.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
+        ```
+
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         text : str
             A text to type into a focused element.
         delay : Union[float, None]
@@ -5171,12 +5565,12 @@ async def type(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -5202,12 +5596,14 @@ async def press(
     ) -> None:
         """Frame.press
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -5222,8 +5618,8 @@ async def press(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         key : str
             Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
         delay : Union[float, None]
@@ -5232,12 +5628,12 @@ async def press(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -5266,41 +5662,41 @@ async def check(
 
         This method checks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is already
-           checked, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is
+           already checked, this method returns immediately.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5330,41 +5726,41 @@ async def uncheck(
 
         This method checks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is already
-           unchecked, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is
+           already unchecked, this method returns immediately.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5384,8 +5780,8 @@ async def wait_for_timeout(self, timeout: float) -> None:
 
         Waits for the given `timeout` in milliseconds.
 
-        Note that `frame.waitForTimeout()` should only be used for debugging. Tests using the timer in production are going to
-        be flaky. Use signals such as network events, selectors becoming visible and others instead.
+        Note that `frame.waitForTimeout()` should only be used for debugging. Tests using the timer in production are going
+        to be flaky. Use signals such as network events, selectors becoming visible and others instead.
 
         Parameters
         ----------
@@ -5409,6 +5805,8 @@ async def wait_for_function(
 
         Returns when the `expression` returns a truthy value, returns that value.
 
+        **Usage**
+
         The `frame.wait_for_function()` can be used to observe viewport size change:
 
         ```py
@@ -5429,6 +5827,21 @@ async def main():
         asyncio.run(main())
         ```
 
+        ```py
+        from playwright.sync_api import sync_playwright
+
+        def run(playwright):
+            webkit = playwright.webkit
+            browser = webkit.launch()
+            page = browser.new_page()
+            page.evaluate(\"window.x = 0; setTimeout(() => { window.x = 100 }, 1000);\")
+            page.main_frame.wait_for_function(\"() => window.x > 0\")
+            browser.close()
+
+        with sync_playwright() as playwright:
+            run(playwright)
+        ```
+
         To pass an argument to the predicate of `frame.waitForFunction` function:
 
         ```py
@@ -5436,19 +5849,25 @@ async def main():
         await frame.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
         ```
 
+        ```py
+        selector = \".foo\"
+        frame.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
+        ```
+
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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()`.
+            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()`.
         polling : Union["raf", float, None]
-            If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling` is a
-            number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to `raf`.
+            If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling`
+            is a number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to
+            `raf`.
 
         Returns
         -------
@@ -5494,41 +5913,41 @@ async def set_checked(
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
         1. Ensure that matched element is a checkbox or a radio input. If not, this method throws.
         1. If the element already has the right checked state, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5582,8 +6001,8 @@ def locator(
     ) -> "Locator":
         """FrameLocator.locator
 
-        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter options,
-        similar to `locator.filter()` method.
+        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter
+        options, similar to `locator.filter()` method.
 
         [Learn more about locators](https://playwright.dev/python/docs/locators).
 
@@ -5592,12 +6011,12 @@ def locator(
         selector : str
             A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
         has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
+            passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
+            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
@@ -5631,8 +6050,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5662,8 +6081,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5692,8 +6111,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5809,9 +6228,10 @@ def get_by_role(
         accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
 
         Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
-        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
-        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
+        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
+        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
+        default values.
 
         Parameters
         ----------
@@ -5824,7 +6244,7 @@ def get_by_role(
         disabled : Union[bool, None]
             An attribute that is usually set by `aria-disabled` or `disabled`.
 
-            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
@@ -5836,8 +6256,8 @@ def get_by_role(
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
         level : Union[int, None]
-            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
-            `<h1>-<h6>` elements.
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values
+            for `<h1>-<h6>` elements.
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
@@ -5854,8 +6274,8 @@ def get_by_role(
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
         exact : Union[bool, None]
-            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
-            expression. Note that exact match still trims whitespace.
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5929,21 +6349,39 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
-        by the text content.
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
 
-        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
-        one, turns line breaks into spaces and ignores leading and trailing whitespace.
-        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
-        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
+        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+
+        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
+        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5960,7 +6398,8 @@ def get_by_title(
     ) -> "Locator":
         """FrameLocator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
+        order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -5971,8 +6410,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5984,8 +6423,8 @@ def get_by_title(
     def frame_locator(self, selector: str) -> "FrameLocator":
         """FrameLocator.frame_locator
 
-        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements in
-        that iframe.
+        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
+        in that iframe.
 
         Parameters
         ----------
@@ -6026,7 +6465,8 @@ def on(
         f: typing.Callable[["Worker"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is terminated."""
+        Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is
+        terminated."""
         return super().on(event=event, f=f)
 
     def once(
@@ -6035,7 +6475,8 @@ def once(
         f: typing.Callable[["Worker"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is terminated."""
+        Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is
+        terminated."""
         return super().once(event=event, f=f)
 
     @property
@@ -6055,18 +6496,18 @@ async def evaluate(
 
         Returns the return value of `expression`.
 
-        If the function passed to the `worker.evaluate()` returns a [Promise], then `worker.evaluate()` would
-        wait for the promise to resolve and return its value.
+        If the function passed to the `worker.evaluate()` returns a [Promise], then `worker.evaluate()`
+        would wait for the promise to resolve and return its value.
 
         If the function passed to the `worker.evaluate()` returns a non-[Serializable] value, then
-        `worker.evaluate()` returns `undefined`. Playwright also supports transferring some additional values that are
-        not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
+        `worker.evaluate()` returns `undefined`. Playwright also supports transferring some additional values that
+        are not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
 
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -6097,8 +6538,8 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -6128,6 +6569,8 @@ async def register(
     ) -> None:
         """Selectors.register
 
+        **Usage**
+
         An example of registering selector engine that queries elements based on a tag name:
 
         ```py
@@ -6169,6 +6612,41 @@ async def main():
         asyncio.run(main())
         ```
 
+        ```py
+        from playwright.sync_api import sync_playwright
+
+        def run(playwright):
+            tag_selector = \"\"\"
+              {
+                  // Returns the first element matching given selector in the root's subtree.
+                  query(root, selector) {
+                      return root.querySelector(selector);
+                  },
+                  // Returns all elements matching given selector in the root's subtree.
+                  queryAll(root, selector) {
+                      return Array.from(root.querySelectorAll(selector));
+                  }
+              }\"\"\"
+
+            # Register the engine. Selectors will be prefixed with \"tag=\".
+            playwright.selectors.register(\"tag\", tag_selector)
+            browser = playwright.chromium.launch()
+            page = browser.new_page()
+            page.set_content('<div><button>Click me</button></div>')
+
+            # Use the selector prefixed with its name.
+            button = page.locator('tag=button')
+            # Combine it with other selector engines.
+            page.locator('tag=div >> text=\"Click me\"').click()
+            # Can use it in any methods supporting selectors.
+            button_count = page.locator('tag=button').count()
+            print(button_count)
+            browser.close()
+
+        with sync_playwright() as playwright:
+            run(playwright)
+        ```
+
         Parameters
         ----------
         name : str
@@ -6180,9 +6658,9 @@ async def main():
             Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to the current working
             directory.
         content_script : Union[bool, None]
-            Whether to run this selector engine in isolated JavaScript environment. This environment has access to the same DOM, but
-            not any JavaScript objects from the frame's scripts. Defaults to `false`. Note that running as a content script is not
-            guaranteed when this engine is used together with other registered engines.
+            Whether to run this selector engine in isolated JavaScript environment. This environment has access to the same
+            DOM, but not any JavaScript objects from the frame's scripts. Defaults to `false`. Note that running as a content
+            script is not guaranteed when this engine is used together with other registered engines.
         """
 
         return mapping.from_maybe_impl(
@@ -6216,8 +6694,8 @@ def type(self) -> str:
         """ConsoleMessage.type
 
         One of the following values: `'log'`, `'debug'`, `'info'`, `'error'`, `'warning'`, `'dir'`, `'dirxml'`, `'table'`,
-        `'trace'`, `'clear'`, `'startGroup'`, `'startGroupCollapsed'`, `'endGroup'`, `'assert'`, `'profile'`, `'profileEnd'`,
-        `'count'`, `'timeEnd'`.
+        `'trace'`, `'clear'`, `'startGroup'`, `'startGroupCollapsed'`, `'endGroup'`, `'assert'`, `'profile'`,
+        `'profileEnd'`, `'count'`, `'timeEnd'`.
 
         Returns
         -------
@@ -6357,9 +6835,9 @@ def suggested_filename(self) -> str:
         """Download.suggested_filename
 
         Returns suggested filename for this download. It is typically computed by the browser from the
-        [`Content-Disposition`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition) response header
-        or the `download` attribute. See the spec on [whatwg](https://html.spec.whatwg.org/#downloading-resources). Different
-        browsers can use different logic for computing it.
+        [`Content-Disposition`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition) response
+        header or the `download` attribute. See the spec on [whatwg](https://html.spec.whatwg.org/#downloading-resources).
+        Different browsers can use different logic for computing it.
 
         Returns
         -------
@@ -6390,11 +6868,11 @@ async def failure(self) -> typing.Optional[str]:
     async def path(self) -> typing.Optional[pathlib.Path]:
         """Download.path
 
-        Returns path to the downloaded file in case of successful download. The method will wait for the download to finish if
-        necessary. The method throws when connected remotely.
+        Returns path to the downloaded file in case of successful download. The method will wait for the download to finish
+        if necessary. The method throws when connected remotely.
 
-        Note that the download's file name is a random GUID, use `download.suggested_filename()` to get suggested file
-        name.
+        Note that the download's file name is a random GUID, use `download.suggested_filename()` to get suggested
+        file name.
 
         Returns
         -------
@@ -6406,8 +6884,8 @@ async def path(self) -> typing.Optional[pathlib.Path]:
     async def save_as(self, path: typing.Union[str, pathlib.Path]) -> None:
         """Download.save_as
 
-        Copy the download to a user-specified path. It is safe to call this method while the download is still in progress. Will
-        wait for the download to finish if necessary.
+        Copy the download to a user-specified path. It is safe to call this method while the download is still in progress.
+        Will wait for the download to finish if necessary.
 
         Parameters
         ----------
@@ -6434,8 +6912,8 @@ class Video(AsyncBase):
     async def path(self) -> pathlib.Path:
         """Video.path
 
-        Returns the file system path this video will be recorded to. The video is guaranteed to be written to the filesystem
-        upon closing the browser context. This method throws when connected remotely.
+        Returns the file system path this video will be recorded to. The video is guaranteed to be written to the
+        filesystem upon closing the browser context. This method throws when connected remotely.
 
         Returns
         -------
@@ -6447,8 +6925,8 @@ async def path(self) -> pathlib.Path:
     async def save_as(self, path: typing.Union[str, pathlib.Path]) -> None:
         """Video.save_as
 
-        Saves the video to a user-specified path. It is safe to call this method while the video is still in progress, or after
-        the page has closed. This method waits until the page is closed and the video is fully saved.
+        Saves the video to a user-specified path. It is safe to call this method while the video is still in progress, or
+        after the page has closed. This method waits until the page is closed and the video is fully saved.
 
         Parameters
         ----------
@@ -6505,6 +6983,15 @@ async def print_args(msg):
 
         page.on(\"console\", print_args)
         await page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        ```
+
+        ```py
+        def print_args(msg):
+            for arg in msg.args:
+                print(arg.json_value())
+
+        page.on(\"console\", print_args)
+        page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
         ```"""
 
     @typing.overload
@@ -6514,8 +7001,8 @@ def on(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when the page crashes. Browser pages might crash if they try to allocate too much memory. When the page crashes,
-        ongoing and subsequent operations will throw.
+        Emitted when the page crashes. Browser pages might crash if they try to allocate too much memory. When the page
+        crashes, ongoing and subsequent operations will throw.
 
         The most common way to deal with crashes is to catch an exception:
 
@@ -6527,6 +7014,16 @@ def on(
             await page.wait_for_event(\"popup\")
         except Error as e:
             # when the page crashes, exception message contains \"crash\".
+        ```
+
+        ```py
+        try:
+            # crash might happen during a click.
+            page.click(\"button\")
+            # or while waiting for an event.
+            page.wait_for_event(\"popup\")
+        except Error as e:
+            # when the page crashes, exception message contains \"crash\".
         ```"""
 
     @typing.overload
@@ -6538,14 +7035,14 @@ def on(
         """
         Emitted when a JavaScript dialog appears, such as `alert`, `prompt`, `confirm` or `beforeunload`. Listener **must**
         either `dialog.accept()` or `dialog.dismiss()` the dialog - otherwise the page will
-        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog, and
-        actions like click will never finish.
+        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
+        and actions like click will never finish.
 
         ```python
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        > NOTE: When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
+        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
 
     @typing.overload
     def on(
@@ -6554,8 +7051,8 @@ def on(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when the JavaScript [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded)
-        event is dispatched."""
+        Emitted when the JavaScript
+        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched."""
 
     @typing.overload
     def on(
@@ -6564,8 +7061,8 @@ def on(
         f: typing.Callable[["Download"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when attachment download started. User can access basic file operations on downloaded content via the passed
-        `Download` instance."""
+        Emitted when attachment download started. User can access basic file operations on downloaded content via the
+        passed `Download` instance."""
 
     @typing.overload
     def on(
@@ -6634,6 +7131,14 @@ def on(
 
         # Navigate to a page with an exception.
         await page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
+        ```
+
+        ```py
+        # Log all uncaught errors to the terminal
+        page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
+
+        # Navigate to a page with an exception.
+        page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
         ```"""
 
     @typing.overload
@@ -6647,8 +7152,8 @@ def on(
         `browser_context.on('page')`, but only for popups relevant to this page.
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
-        popup with `window.open('http://example.com')`, this event will fire when the network request to \"http://example.com\" is
-        done and its response has started loading in the popup.
+        popup with `window.open('http://example.com')`, this event will fire when the network request to
+        \"http://example.com\" is done and its response has started loading in the popup.
 
         ```py
         async with page.expect_event(\"popup\") as page_info:
@@ -6657,8 +7162,15 @@ def on(
         print(await popup.evaluate(\"location.href\"))
         ```
 
-        > NOTE: Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not need it
-        in most cases)."""
+        ```py
+        with page.expect_event(\"popup\") as page_info:
+            page.evaluate(\"window.open('https://example.com')\")
+        popup = page_info.value
+        print(popup.evaluate(\"location.href\"))
+        ```
+
+        **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
+        need it in most cases)."""
 
     @typing.overload
     def on(
@@ -6667,8 +7179,8 @@ def on(
         f: typing.Callable[["Request"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when a page issues a request. The [request] object is read-only. In order to intercept and mutate requests, see
-        `page.route()` or `browser_context.route()`."""
+        Emitted when a page issues a request. The [request] object is read-only. In order to intercept and mutate requests,
+        see `page.route()` or `browser_context.route()`."""
 
     @typing.overload
     def on(
@@ -6683,9 +7195,9 @@ def on(
         page.on(\"requestfailed\", lambda request: print(request.url + \" \" + request.failure.error_text))
         ```
 
-        > NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will
-        complete with `page.on('request_finished')` event and not with `page.on('request_failed')`. A request will only be
-        considered failed when the client cannot get an HTTP response from the server, e.g. due to network error
+        **NOTE** HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request
+        will complete with `page.on('request_finished')` event and not with `page.on('request_failed')`. A request will
+        only be considered failed when the client cannot get an HTTP response from the server, e.g. due to network error
         net::ERR_FAILED."""
 
     @typing.overload
@@ -6705,8 +7217,8 @@ def on(
         f: typing.Callable[["Response"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of events
-        is `request`, `response` and `requestfinished`."""
+        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of
+        events is `request`, `response` and `requestfinished`."""
 
     @typing.overload
     def on(
@@ -6724,8 +7236,8 @@ def on(
         f: typing.Callable[["Worker"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when a dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is spawned by the
-        page."""
+        Emitted when a dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is spawned
+        by the page."""
 
     def on(
         self,
@@ -6768,6 +7280,15 @@ async def print_args(msg):
 
         page.on(\"console\", print_args)
         await page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        ```
+
+        ```py
+        def print_args(msg):
+            for arg in msg.args:
+                print(arg.json_value())
+
+        page.on(\"console\", print_args)
+        page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
         ```"""
 
     @typing.overload
@@ -6777,8 +7298,8 @@ def once(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when the page crashes. Browser pages might crash if they try to allocate too much memory. When the page crashes,
-        ongoing and subsequent operations will throw.
+        Emitted when the page crashes. Browser pages might crash if they try to allocate too much memory. When the page
+        crashes, ongoing and subsequent operations will throw.
 
         The most common way to deal with crashes is to catch an exception:
 
@@ -6790,6 +7311,16 @@ def once(
             await page.wait_for_event(\"popup\")
         except Error as e:
             # when the page crashes, exception message contains \"crash\".
+        ```
+
+        ```py
+        try:
+            # crash might happen during a click.
+            page.click(\"button\")
+            # or while waiting for an event.
+            page.wait_for_event(\"popup\")
+        except Error as e:
+            # when the page crashes, exception message contains \"crash\".
         ```"""
 
     @typing.overload
@@ -6801,14 +7332,14 @@ def once(
         """
         Emitted when a JavaScript dialog appears, such as `alert`, `prompt`, `confirm` or `beforeunload`. Listener **must**
         either `dialog.accept()` or `dialog.dismiss()` the dialog - otherwise the page will
-        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog, and
-        actions like click will never finish.
+        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
+        and actions like click will never finish.
 
         ```python
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        > NOTE: When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
+        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
 
     @typing.overload
     def once(
@@ -6817,8 +7348,8 @@ def once(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when the JavaScript [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded)
-        event is dispatched."""
+        Emitted when the JavaScript
+        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched."""
 
     @typing.overload
     def once(
@@ -6827,8 +7358,8 @@ def once(
         f: typing.Callable[["Download"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when attachment download started. User can access basic file operations on downloaded content via the passed
-        `Download` instance."""
+        Emitted when attachment download started. User can access basic file operations on downloaded content via the
+        passed `Download` instance."""
 
     @typing.overload
     def once(
@@ -6897,6 +7428,14 @@ def once(
 
         # Navigate to a page with an exception.
         await page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
+        ```
+
+        ```py
+        # Log all uncaught errors to the terminal
+        page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
+
+        # Navigate to a page with an exception.
+        page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
         ```"""
 
     @typing.overload
@@ -6910,8 +7449,8 @@ def once(
         `browser_context.on('page')`, but only for popups relevant to this page.
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
-        popup with `window.open('http://example.com')`, this event will fire when the network request to \"http://example.com\" is
-        done and its response has started loading in the popup.
+        popup with `window.open('http://example.com')`, this event will fire when the network request to
+        \"http://example.com\" is done and its response has started loading in the popup.
 
         ```py
         async with page.expect_event(\"popup\") as page_info:
@@ -6920,8 +7459,15 @@ def once(
         print(await popup.evaluate(\"location.href\"))
         ```
 
-        > NOTE: Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not need it
-        in most cases)."""
+        ```py
+        with page.expect_event(\"popup\") as page_info:
+            page.evaluate(\"window.open('https://example.com')\")
+        popup = page_info.value
+        print(popup.evaluate(\"location.href\"))
+        ```
+
+        **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
+        need it in most cases)."""
 
     @typing.overload
     def once(
@@ -6930,8 +7476,8 @@ def once(
         f: typing.Callable[["Request"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when a page issues a request. The [request] object is read-only. In order to intercept and mutate requests, see
-        `page.route()` or `browser_context.route()`."""
+        Emitted when a page issues a request. The [request] object is read-only. In order to intercept and mutate requests,
+        see `page.route()` or `browser_context.route()`."""
 
     @typing.overload
     def once(
@@ -6946,9 +7492,9 @@ def once(
         page.on(\"requestfailed\", lambda request: print(request.url + \" \" + request.failure.error_text))
         ```
 
-        > NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will
-        complete with `page.on('request_finished')` event and not with `page.on('request_failed')`. A request will only be
-        considered failed when the client cannot get an HTTP response from the server, e.g. due to network error
+        **NOTE** HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request
+        will complete with `page.on('request_finished')` event and not with `page.on('request_failed')`. A request will
+        only be considered failed when the client cannot get an HTTP response from the server, e.g. due to network error
         net::ERR_FAILED."""
 
     @typing.overload
@@ -6968,8 +7514,8 @@ def once(
         f: typing.Callable[["Response"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of events
-        is `request`, `response` and `requestfinished`."""
+        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of
+        events is `request`, `response` and `requestfinished`."""
 
     @typing.overload
     def once(
@@ -6987,8 +7533,8 @@ def once(
         f: typing.Callable[["Worker"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when a dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is spawned by the
-        page."""
+        Emitted when a dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is spawned
+        by the page."""
 
     def once(
         self,
@@ -7001,10 +7547,6 @@ def once(
     def accessibility(self) -> "Accessibility":
         """Page.accessibility
 
-        **DEPRECATED** This property is deprecated. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you
-        need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for
-        integration with Axe.
-
         Returns
         -------
         Accessibility
@@ -7081,8 +7623,6 @@ def frames(self) -> typing.List["Frame"]:
     def url(self) -> str:
         """Page.url
 
-        Shortcut for main frame's `frame.url()`.
-
         Returns
         -------
         str
@@ -7103,10 +7643,10 @@ def viewport_size(self) -> typing.Optional[ViewportSize]:
     def workers(self) -> typing.List["Worker"]:
         """Page.workers
 
-        This method returns all of the dedicated [WebWorkers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API)
-        associated with the page.
+        This method returns all of the dedicated
+        [WebWorkers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) associated with the page.
 
-        > NOTE: This does not contain ServiceWorkers
+        **NOTE** This does not contain ServiceWorkers
 
         Returns
         -------
@@ -7119,7 +7659,8 @@ def request(self) -> "APIRequestContext":
         """Page.request
 
         API testing helper associated with this page. This method returns the same instance as
-        `browser_context.request` on the page's context. See `browser_context.request` for more details.
+        `browser_context.request` on the page's context. See `browser_context.request` for more
+        details.
 
         Returns
         -------
@@ -7163,6 +7704,8 @@ def frame(
 
         Returns frame matching the specified criteria. Either `name` or `url` must be specified.
 
+        **Usage**
+
         ```py
         frame = page.frame(name=\"frame-name\")
         ```
@@ -7199,7 +7742,7 @@ def set_default_navigation_timeout(self, timeout: float) -> None:
         - `page.expect_navigation()`
         - `page.wait_for_url()`
 
-        > NOTE: `page.set_default_navigation_timeout()` takes priority over `page.set_default_timeout()`,
+        **NOTE** `page.set_default_navigation_timeout()` takes priority over `page.set_default_timeout()`,
         `browser_context.set_default_timeout()` and `browser_context.set_default_navigation_timeout()`.
 
         Parameters
@@ -7217,7 +7760,7 @@ def set_default_timeout(self, timeout: float) -> None:
 
         This setting will change the default maximum time for all the methods accepting `timeout` option.
 
-        > NOTE: `page.set_default_navigation_timeout()` takes priority over `page.set_default_timeout()`.
+        **NOTE** `page.set_default_navigation_timeout()` takes priority over `page.set_default_timeout()`.
 
         Parameters
         ----------
@@ -7234,13 +7777,9 @@ async def query_selector(
     ) -> typing.Optional["ElementHandle"]:
         """Page.query_selector
 
-        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
-
         The method finds an element matching the specified selector within the page. If no elements match the selector, the
         return value resolves to `null`. To wait for an element on the page, use `locator.wait_for()`.
 
-        Shortcut for main frame's `frame.query_selector()`.
-
         Parameters
         ----------
         selector : str
@@ -7261,12 +7800,8 @@ async def query_selector(
     async def query_selector_all(self, selector: str) -> typing.List["ElementHandle"]:
         """Page.query_selector_all
 
-        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
-
-        The method finds all elements matching the specified selector within the page. If no elements match the selector, the
-        return value resolves to `[]`.
-
-        Shortcut for main frame's `frame.query_selector_all()`.
+        The method finds all elements matching the specified selector within the page. If no elements match the selector,
+        the return value resolves to `[]`.
 
         Parameters
         ----------
@@ -7297,12 +7832,14 @@ async def wait_for_selector(
         Returns when element specified by selector satisfies `state` option. Returns `null` if waiting for `hidden` or
         `detached`.
 
-        > NOTE: Playwright automatically waits for element to be ready before performing an action. Using `Locator` objects and
-        web-first assertions makes the code wait-for-selector-free.
+        **NOTE** Playwright automatically waits for element to be ready before performing an action. Using `Locator`
+        objects and web-first assertions makes the code wait-for-selector-free.
+
+        Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If
+        at the moment of calling the method `selector` already satisfies the condition, the method will return immediately.
+        If the selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
 
-        Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at
-        the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the
-        selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
+        **Usage**
 
         This method works across navigations:
 
@@ -7326,21 +7863,38 @@ async def main():
         asyncio.run(main())
         ```
 
+        ```py
+        from playwright.sync_api import sync_playwright
+
+        def run(playwright):
+            chromium = playwright.chromium
+            browser = chromium.launch()
+            page = browser.new_page()
+            for current_url in [\"https://google.com\", \"https://bbc.com\"]:
+                page.goto(current_url, wait_until=\"domcontentloaded\")
+                element = page.wait_for_selector(\"img\")
+                print(\"Loaded image: \" + str(element.get_attribute(\"src\")))
+            browser.close()
+
+        with sync_playwright() as playwright:
+            run(playwright)
+        ```
+
         Parameters
         ----------
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
             - `'detached'` - wait for element to not be present in DOM.
-            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element without
-              any content or with `display:none` has an empty bounding box and is not considered visible.
-            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.
-              This is opposite to the `'visible'` option.
+            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element
+              without any content or with `display:none` has an empty bounding box and is not considered visible.
+            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or
+              `visibility:hidden`. This is opposite to the `'visible'` option.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -7370,14 +7924,14 @@ async def is_checked(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -7404,14 +7958,14 @@ async def is_disabled(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -7438,14 +7992,14 @@ async def is_editable(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -7472,14 +8026,14 @@ async def is_enabled(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -7501,20 +8055,18 @@ async def is_hidden(
     ) -> bool:
         """Page.is_hidden
 
-        Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).  `selector` that does not
-        match any elements is considered hidden.
+        Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).  `selector` that
+        does not match any elements is considered hidden.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `page.is_hidden()` does not wait for the element to become hidden and
-            returns immediately.
 
         Returns
         -------
@@ -7536,20 +8088,18 @@ async def is_visible(
     ) -> bool:
         """Page.is_visible
 
-        Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible). `selector` that does not match any elements is
-        considered not visible.
+        Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible). `selector` that does not match any elements
+        is considered not visible.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `page.is_visible()` does not wait for the element to become visible and
-            returns immediately.
 
         Returns
         -------
@@ -7577,12 +8127,18 @@ async def dispatch_event(
         `click` is dispatched. This is equivalent to calling
         [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
 
+        **Usage**
+
         ```py
         await page.dispatch_event(\"button#submit\", \"click\")
         ```
 
-        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties
-        and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
+        ```py
+        page.dispatch_event(\"button#submit\", \"click\")
+        ```
+
+        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
+        properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
@@ -7601,18 +8157,24 @@ async def dispatch_event(
         await page.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
         ```
 
+        ```py
+        # note you can only create data_transfer in chromium and firefox
+        data_transfer = page.evaluate_handle(\"new DataTransfer()\")
+        page.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
+        ```
+
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         type : str
             DOM event type: `"click"`, `"dragstart"`, etc.
         event_init : Union[Dict, None]
             Optional event-specific initialization properties.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -7635,12 +8197,14 @@ async def evaluate(
 
         Returns the value of the `expression` invocation.
 
-        If the function passed to the `page.evaluate()` returns a [Promise], then `page.evaluate()` would wait
-        for the promise to resolve and return its value.
+        If the function passed to the `page.evaluate()` returns a [Promise], then `page.evaluate()` would
+        wait for the promise to resolve and return its value.
 
         If the function passed to the `page.evaluate()` returns a non-[Serializable] value, then
-        `page.evaluate()` resolves to `undefined`. Playwright also supports transferring some additional values that are
-        not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
+        `page.evaluate()` resolves to `undefined`. Playwright also supports transferring some additional values
+        that are not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
+
+        **Usage**
 
         Passing argument to `expression`:
 
@@ -7649,6 +8213,11 @@ async def evaluate(
         print(result) # prints \"56\"
         ```
 
+        ```py
+        result = page.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
+        print(result) # prints \"56\"
+        ```
+
         A string can also be passed in instead of a function:
 
         ```py
@@ -7657,6 +8226,12 @@ async def evaluate(
         print(await page.evaluate(f\"1 + {x}\")) # prints \"11\"
         ```
 
+        ```py
+        print(page.evaluate(\"1 + 2\")) # prints \"3\"
+        x = 10
+        print(page.evaluate(f\"1 + {x}\")) # prints \"11\"
+        ```
+
         `ElementHandle` instances can be passed as an argument to the `page.evaluate()`:
 
         ```py
@@ -7665,13 +8240,17 @@ async def evaluate(
         await body_handle.dispose()
         ```
 
-        Shortcut for main frame's `frame.evaluate()`.
+        ```py
+        body_handle = page.evaluate(\"document.body\")
+        html = page.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
+        body_handle.dispose()
+        ```
 
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -7696,20 +8275,31 @@ async def evaluate_handle(
         The only difference between `page.evaluate()` and `page.evaluate_handle()` is that
         `page.evaluate_handle()` returns `JSHandle`.
 
-        If the function passed to the `page.evaluate_handle()` returns a [Promise], then `page.evaluate_handle()`
-        would wait for the promise to resolve and return its value.
+        If the function passed to the `page.evaluate_handle()` returns a [Promise], then
+        `page.evaluate_handle()` would wait for the promise to resolve and return its value.
+
+        **Usage**
 
         ```py
         a_window_handle = await page.evaluate_handle(\"Promise.resolve(window)\")
         a_window_handle # handle for the window object.
         ```
 
+        ```py
+        a_window_handle = page.evaluate_handle(\"Promise.resolve(window)\")
+        a_window_handle # handle for the window object.
+        ```
+
         A string can also be passed in instead of a function:
 
         ```py
         a_handle = await page.evaluate_handle(\"document\") # handle for the \"document\"
         ```
 
+        ```py
+        a_handle = page.evaluate_handle(\"document\") # handle for the \"document\"
+        ```
+
         `JSHandle` instances can be passed as an argument to the `page.evaluate_handle()`:
 
         ```py
@@ -7719,11 +8309,18 @@ async def evaluate_handle(
         await result_handle.dispose()
         ```
 
+        ```py
+        a_handle = page.evaluate_handle(\"document.body\")
+        result_handle = page.evaluate_handle(\"body => body.innerHTML\", a_handle)
+        print(result_handle.json_value())
+        result_handle.dispose()
+        ```
+
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -7748,16 +8345,13 @@ async def eval_on_selector(
     ) -> typing.Any:
         """Page.eval_on_selector
 
-        > NOTE: This method does not wait for the element to pass actionability checks and therefore can lead to the flaky
-        tests. Use `locator.evaluate()`, other `Locator` helper methods or web-first assertions instead.
-
         The method finds an element matching the specified selector within the page and passes it as a first argument to
         `expression`. If no elements match the selector, the method throws an error. Returns the value of `expression`.
 
         If `expression` returns a [Promise], then `page.eval_on_selector()` would wait for the promise to resolve and
         return its value.
 
-        Examples:
+        **Usage**
 
         ```py
         search_value = await page.eval_on_selector(\"#search\", \"el => el.value\")
@@ -7765,15 +8359,19 @@ async def eval_on_selector(
         html = await page.eval_on_selector(\".main-container\", \"(e, suffix) => e.outer_html + suffix\", \"hello\")
         ```
 
-        Shortcut for main frame's `frame.eval_on_selector()`.
+        ```py
+        search_value = page.eval_on_selector(\"#search\", \"el => el.value\")
+        preload_href = page.eval_on_selector(\"link[rel=preload]\", \"el => el.href\")
+        html = page.eval_on_selector(\".main-container\", \"(e, suffix) => e.outer_html + suffix\", \"hello\")
+        ```
 
         Parameters
         ----------
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         strict : Union[bool, None]
@@ -7799,28 +8397,29 @@ async def eval_on_selector_all(
     ) -> typing.Any:
         """Page.eval_on_selector_all
 
-        > NOTE: In most cases, `locator.evaluate_all()`, other `Locator` helper methods and web-first assertions do a
-        better job.
-
-        The method finds all elements matching the specified selector within the page and passes an array of matched elements as
-        a first argument to `expression`. Returns the result of `expression` invocation.
+        The method finds all elements matching the specified selector within the page and passes an array of matched
+        elements as a first argument to `expression`. Returns the result of `expression` invocation.
 
-        If `expression` returns a [Promise], then `page.eval_on_selector_all()` would wait for the promise to resolve and
-        return its value.
+        If `expression` returns a [Promise], then `page.eval_on_selector_all()` would wait for the promise to resolve
+        and return its value.
 
-        Examples:
+        **Usage**
 
         ```py
         div_counts = await page.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
         ```
 
+        ```py
+        div_counts = page.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
+        ```
+
         Parameters
         ----------
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -7848,15 +8447,13 @@ async def add_script_tag(
         Adds a `<script>` tag into the page with the desired url or content. Returns the added tag when the script's onload
         fires or when the script content was injected into frame.
 
-        Shortcut for main frame's `frame.add_script_tag()`.
-
         Parameters
         ----------
         url : Union[str, None]
             URL of a script to be added.
         path : Union[pathlib.Path, str, None]
-            Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative to the
-            current working directory.
+            Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative
+            to the current working directory.
         content : Union[str, None]
             Raw JavaScript content to be injected into frame.
         type : Union[str, None]
@@ -7886,8 +8483,6 @@ async def add_style_tag(
         Adds a `<link rel=\"stylesheet\">` tag into the page with the desired url or a `<style type=\"text/css\">` tag with the
         content. Returns the added tag when the stylesheet's onload fires or when the CSS content was injected into frame.
 
-        Shortcut for main frame's `frame.add_style_tag()`.
-
         Parameters
         ----------
         url : Union[str, None]
@@ -7910,14 +8505,16 @@ async def add_style_tag(
     async def expose_function(self, name: str, callback: typing.Callable) -> None:
         """Page.expose_function
 
-        The method adds a function called `name` on the `window` object of every frame in the page. When called, the function
-        executes `callback` and returns a [Promise] which resolves to the return value of `callback`.
+        The method adds a function called `name` on the `window` object of every frame in the page. When called, the
+        function executes `callback` and returns a [Promise] which resolves to the return value of `callback`.
 
         If the `callback` returns a [Promise], it will be awaited.
 
         See `browser_context.expose_function()` for context-wide exposed function.
 
-        > NOTE: Functions installed via `page.expose_function()` survive navigations.
+        **NOTE** Functions installed via `page.expose_function()` survive navigations.
+
+        **Usage**
 
         An example of adding a `sha256` function to the page:
 
@@ -7953,6 +8550,35 @@ async def main():
         asyncio.run(main())
         ```
 
+        ```py
+        import hashlib
+        from playwright.sync_api import sync_playwright
+
+        def sha256(text):
+            m = hashlib.sha256()
+            m.update(bytes(text, \"utf8\"))
+            return m.hexdigest()
+
+        def run(playwright):
+            webkit = playwright.webkit
+            browser = webkit.launch(headless=False)
+            page = browser.new_page()
+            page.expose_function(\"sha256\", sha256)
+            page.set_content(\"\"\"
+                <script>
+                  async function onClick() {
+                    document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
+                  }
+                </script>
+                <button onclick=\"onClick()\">Click me</button>
+                <div></div>
+            \"\"\")
+            page.click(\"button\")
+
+        with sync_playwright() as playwright:
+            run(playwright)
+        ```
+
         Parameters
         ----------
         name : str
@@ -7976,16 +8602,18 @@ async def expose_binding(
     ) -> None:
         """Page.expose_binding
 
-        The method adds a function called `name` on the `window` object of every frame in this page. When called, the function
-        executes `callback` and returns a [Promise] which resolves to the return value of `callback`. If the `callback` returns
-        a [Promise], it will be awaited.
+        The method adds a function called `name` on the `window` object of every frame in this page. When called, the
+        function executes `callback` and returns a [Promise] which resolves to the return value of `callback`. If the
+        `callback` returns a [Promise], it will be awaited.
 
-        The first argument of the `callback` function contains information about the caller: `{ browserContext: BrowserContext,
-        page: Page, frame: Frame }`.
+        The first argument of the `callback` function contains information about the caller: `{ browserContext:
+        BrowserContext, page: Page, frame: Frame }`.
 
         See `browser_context.expose_binding()` for the context-wide version.
 
-        > NOTE: Functions installed via `page.expose_binding()` survive navigations.
+        **NOTE** Functions installed via `page.expose_binding()` survive navigations.
+
+        **Usage**
 
         An example of exposing page URL to all frames in a page:
 
@@ -8016,6 +8644,30 @@ async def main():
         asyncio.run(main())
         ```
 
+        ```py
+        from playwright.sync_api import sync_playwright
+
+        def run(playwright):
+            webkit = playwright.webkit
+            browser = webkit.launch(headless=false)
+            context = browser.new_context()
+            page = context.new_page()
+            page.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
+            page.set_content(\"\"\"
+            <script>
+              async function onClick() {
+                document.querySelector('div').textContent = await window.pageURL();
+              }
+            </script>
+            <button onclick=\"onClick()\">Click me</button>
+            <div></div>
+            \"\"\")
+            page.click(\"button\")
+
+        with sync_playwright() as playwright:
+            run(playwright)
+        ```
+
         An example of passing an element handle:
 
         ```py
@@ -8032,6 +8684,20 @@ async def print(source, element):
         \"\"\")
         ```
 
+        ```py
+        def print(source, element):
+            print(element.text_content())
+
+        page.expose_binding(\"clicked\", print, handle=true)
+        page.set_content(\"\"\"
+          <script>
+            document.addEventListener('click', event => window.clicked(event.target));
+          </script>
+          <div>Click me</div>
+          <div>Or click me</div>
+        \"\"\")
+        ```
+
         Parameters
         ----------
         name : str
@@ -8054,7 +8720,7 @@ async def set_extra_http_headers(self, headers: typing.Dict[str, str]) -> None:
 
         The extra HTTP headers will be sent with every request the page initiates.
 
-        > NOTE: `page.set_extra_http_headers()` does not guarantee the order of headers in the outgoing requests.
+        **NOTE** `page.set_extra_http_headers()` does not guarantee the order of headers in the outgoing requests.
 
         Parameters
         ----------
@@ -8096,16 +8762,18 @@ async def set_content(
         html : str
             HTML markup to assign to the page.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         """
 
         return mapping.from_maybe_impl(
@@ -8136,34 +8804,35 @@ async def goto(
         - the remote server does not respond or is unreachable.
         - the main resource failed to load.
 
-        The method will not throw an error when any valid HTTP status code is returned by the remote server, including 404 \"Not
-        Found\" and 500 \"Internal Server Error\".  The status code for such responses can be retrieved by calling
+        The method will not throw an error when any valid HTTP status code is returned by the remote server, including 404
+        \"Not Found\" and 500 \"Internal Server Error\".  The status code for such responses can be retrieved by calling
         `response.status()`.
 
-        > NOTE: The method either throws an error or returns a main resource response. The only exceptions are navigation to
-        `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
-        > NOTE: Headless mode doesn't support navigation to a PDF document. See the
-        [upstream issue](https://bugs.chromium.org/p/chromium/issues/detail?id=761295).
+        **NOTE** The method either throws an error or returns a main resource response. The only exceptions are navigation
+        to `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
 
-        Shortcut for main frame's `frame.goto()`
+        **NOTE** Headless mode doesn't support navigation to a PDF document. See the
+        [upstream issue](https://bugs.chromium.org/p/chromium/issues/detail?id=761295).
 
         Parameters
         ----------
         url : str
-            URL to navigate page to. The url should include scheme, e.g. `https://`. When a `baseURL` via the context options was
-            provided and the passed URL is a path, it gets merged via the
+            URL to navigate page to. The url should include scheme, e.g. `https://`. 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.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         referer : Union[str, None]
             Referer header value. If provided it will take preference over the referer header value set by
             `page.set_extra_http_headers()`.
@@ -8189,22 +8858,25 @@ async def reload(
     ) -> typing.Optional["Response"]:
         """Page.reload
 
-        This method reloads the current page, in the same way as if the user had triggered a browser refresh. Returns the main
-        resource response. In case of multiple redirects, the navigation will resolve with the response of the last redirect.
+        This method reloads the current page, in the same way as if the user had triggered a browser refresh. Returns the
+        main resource response. In case of multiple redirects, the navigation will resolve with the response of the last
+        redirect.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
 
         Returns
         -------
@@ -8227,14 +8899,22 @@ async def wait_for_load_state(
 
         Returns when the required load state has been reached.
 
-        This resolves when the page reaches a required load state, `load` by default. The navigation must have been committed
-        when this method is called. If current document has already reached the required state, resolves immediately.
+        This resolves when the page reaches a required load state, `load` by default. The navigation must have been
+        committed when this method is called. If current document has already reached the required state, resolves
+        immediately.
+
+        **Usage**
 
         ```py
         await page.get_by_role(\"button\").click() # click triggers navigation.
         await page.wait_for_load_state() # the promise resolves after \"load\" event.
         ```
 
+        ```py
+        page.get_by_role(\"button\").click() # click triggers navigation.
+        page.wait_for_load_state() # the promise resolves after \"load\" event.
+        ```
+
         ```py
         async with page.expect_popup() as page_info:
             await page.get_by_role(\"button\").click() # click triggers a popup.
@@ -8244,7 +8924,14 @@ async def wait_for_load_state(
         print(await popup.title()) # popup is ready to use.
         ```
 
-        Shortcut for main frame's `frame.wait_for_load_state()`.
+        ```py
+        with page.expect_popup() as page_info:
+            page.get_by_role(\"button\").click() # click triggers a popup.
+        popup = page_info.value
+         # Following resolves after \"domcontentloaded\" event.
+        popup.wait_for_load_state(\"domcontentloaded\")
+        print(popup.title()) # popup is ready to use.
+        ```
 
         Parameters
         ----------
@@ -8255,8 +8942,8 @@ async def wait_for_load_state(
             - `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired.
             - `'networkidle'` - wait until there are no network connections for at least `500` ms.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         """
@@ -8278,28 +8965,35 @@ async def wait_for_url(
 
         Waits for the main frame to navigate to the given URL.
 
+        **Usage**
+
         ```py
         await page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
         await page.wait_for_url(\"**/target.html\")
         ```
 
-        Shortcut for main frame's `frame.wait_for_url()`.
+        ```py
+        page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+        page.wait_for_url(\"**/target.html\")
+        ```
 
         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 the
-            parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to
-            the string.
+            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]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         """
@@ -8319,11 +9013,11 @@ async def wait_for_event(
     ) -> typing.Any:
         """Page.wait_for_event
 
-        > NOTE: In most cases, you should use `page.expect_event()`.
+        **NOTE** In most cases, you should use `page.expect_event()`.
 
-        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function and
-        waits for `predicate(event)` to return a truthy value. Will throw an error if the page is closed before the `event` is
-        fired.
+        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function
+        and waits for `predicate(event)` to return a truthy value. Will throw an error if the page is closed before the
+        `event` is fired.
 
         Parameters
         ----------
@@ -8332,8 +9026,8 @@ async def wait_for_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()`.
+            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
         -------
@@ -8356,24 +9050,26 @@ async def go_back(
     ) -> typing.Optional["Response"]:
         """Page.go_back
 
-        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
-        last redirect. If can not go back, returns `null`.
+        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
+        the last redirect. If can not go back, returns `null`.
 
         Navigate to the previous page in history.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
 
         Returns
         -------
@@ -8394,24 +9090,26 @@ async def go_forward(
     ) -> typing.Optional["Response"]:
         """Page.go_forward
 
-        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
-        last redirect. If can not go forward, returns `null`.
+        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
+        the last redirect. If can not go forward, returns `null`.
 
         Navigate to the next page in history.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
 
         Returns
         -------
@@ -8439,6 +9137,8 @@ async def emulate_media(
         This method changes the `CSS media type` through the `media` argument, and/or the `'prefers-colors-scheme'` media
         feature, using the `colorScheme` argument.
 
+        **Usage**
+
         ```py
         await page.evaluate(\"matchMedia('screen').matches\")
         # → True
@@ -8458,6 +9158,25 @@ async def emulate_media(
         # → False
         ```
 
+        ```py
+        page.evaluate(\"matchMedia('screen').matches\")
+        # → True
+        page.evaluate(\"matchMedia('print').matches\")
+        # → False
+
+        page.emulate_media(media=\"print\")
+        page.evaluate(\"matchMedia('screen').matches\")
+        # → False
+        page.evaluate(\"matchMedia('print').matches\")
+        # → True
+
+        page.emulate_media()
+        page.evaluate(\"matchMedia('screen').matches\")
+        # → True
+        page.evaluate(\"matchMedia('print').matches\")
+        # → False
+        ```
+
         ```py
         await page.emulate_media(color_scheme=\"dark\")
         await page.evaluate(\"matchMedia('(prefers-color-scheme: dark)').matches\")
@@ -8468,17 +9187,26 @@ async def emulate_media(
         # → False
         ```
 
+        ```py
+        page.emulate_media(color_scheme=\"dark\")
+        page.evaluate(\"matchMedia('(prefers-color-scheme: dark)').matches\")
+        # → True
+        page.evaluate(\"matchMedia('(prefers-color-scheme: light)').matches\")
+        # → False
+        page.evaluate(\"matchMedia('(prefers-color-scheme: no-preference)').matches\")
+        ```
+
         Parameters
         ----------
         media : Union["null", "print", "screen", None]
-            Changes the CSS media type of the page. The only allowed values are `'Screen'`, `'Print'` and `'Null'`. Passing `'Null'`
-            disables CSS media emulation.
+            Changes the CSS media type of the page. The only allowed values are `'Screen'`, `'Print'` and `'Null'`. Passing
+            `'Null'` disables CSS media emulation.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
-            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. Passing
-            `'Null'` disables color scheme emulation.
+            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`.
+            Passing `'Null'` disables color scheme emulation.
         reduced_motion : Union["no-preference", "null", "reduce", None]
-            Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. Passing `null`
-            disables reduced motion emulation.
+            Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. Passing
+            `null` disables reduced motion emulation.
         forced_colors : Union["active", "none", "null", None]
         """
 
@@ -8498,9 +9226,11 @@ async def set_viewport_size(self, viewport_size: ViewportSize) -> None:
         `browser.new_context()` allows to set viewport size (and more) for all pages in the context at once.
 
         `page.set_viewport_size()` will resize the page. A lot of websites don't expect phones to change size, so you
-        should set the viewport size before navigating to the page. `page.set_viewport_size()` will also reset `screen`
-        size, use `browser.new_context()` with `screen` and `viewport` parameters if you need better control of these
-        properties.
+        should set the viewport size before navigating to the page. `page.set_viewport_size()` will also reset
+        `screen` size, use `browser.new_context()` with `screen` and `viewport` parameters if you need better
+        control of these properties.
+
+        **Usage**
 
         ```py
         page = await browser.new_page()
@@ -8508,6 +9238,12 @@ async def set_viewport_size(self, viewport_size: ViewportSize) -> None:
         await page.goto(\"https://example.com\")
         ```
 
+        ```py
+        page = browser.new_page()
+        page.set_viewport_size({\"width\": 640, \"height\": 480})
+        page.goto(\"https://example.com\")
+        ```
+
         Parameters
         ----------
         viewport_size : {width: int, height: int}
@@ -8535,11 +9271,13 @@ async def add_init_script(
 
         Adds a script which would be evaluated in one of the following scenarios:
         - Whenever the page is navigated.
-        - Whenever the child frame is attached or navigated. In this case, the script is evaluated in the context of the newly
-          attached frame.
+        - Whenever the child frame is attached or navigated. In this case, the script is evaluated in the context of the
+          newly attached frame.
+
+        The script is evaluated after the document was created but before any of its scripts were run. This is useful to
+        amend the JavaScript environment, e.g. to seed `Math.random`.
 
-        The script is evaluated after the document was created but before any of its scripts were run. This is useful to amend
-        the JavaScript environment, e.g. to seed `Math.random`.
+        **Usage**
 
         An example of overriding `Math.random` before the page loads:
 
@@ -8548,7 +9286,12 @@ async def add_init_script(
         await page.add_init_script(path=\"./preload.js\")
         ```
 
-        > NOTE: The order of evaluation of multiple scripts installed via `browser_context.add_init_script()` and
+        ```py
+        # in your playwright script, assuming the preload.js file is in same directory
+        page.add_init_script(path=\"./preload.js\")
+        ```
+
+        **NOTE** The order of evaluation of multiple scripts installed via `browser_context.add_init_script()` and
         `page.add_init_script()` is not defined.
 
         Parameters
@@ -8578,12 +9321,16 @@ async def route(
 
         Routing provides the capability to modify network requests that are made by a page.
 
-        Once routing is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or aborted.
+        Once routing is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or
+        aborted.
 
-        > NOTE: The handler will only be called for the first url if the response is a redirect.
-        > NOTE: `page.route()` will not intercept requests intercepted by Service Worker. See
-        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
-        request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        **NOTE** The handler will only be called for the first url if the response is a redirect.
+
+        **NOTE** `page.route()` will not intercept requests intercepted by Service Worker. See
+        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
+        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+
+        **Usage**
 
         An example of a naive handler that aborts all image requests:
 
@@ -8594,6 +9341,13 @@ async def route(
         await browser.close()
         ```
 
+        ```py
+        page = browser.new_page()
+        page.route(\"**/*.{png,jpg,jpeg}\", lambda route: route.abort())
+        page.goto(\"https://example.com\")
+        browser.close()
+        ```
+
         or the same snippet using a regex pattern instead:
 
         ```py
@@ -8603,8 +9357,15 @@ async def route(
         await browser.close()
         ```
 
-        It is possible to examine the request to decide the route action. For example, mocking all requests that contain some
-        post data, and leaving all other requests as is:
+        ```py
+        page = browser.new_page()
+        page.route(re.compile(r\"(\\.png$)|(\\.jpg$)\"), lambda route: route.abort())
+        page.goto(\"https://example.com\")
+        browser.close()
+        ```
+
+        It is possible to examine the request to decide the route action. For example, mocking all requests that contain
+        some post data, and leaving all other requests as is:
 
         ```py
         def handle_route(route):
@@ -8615,12 +9376,21 @@ def handle_route(route):
         await page.route(\"/api/**\", handle_route)
         ```
 
+        ```py
+        def handle_route(route):
+          if (\"my-string\" in route.request.post_data)
+            route.fulfill(body=\"mocked-data\")
+          else
+            route.continue_()
+        page.route(\"/api/**\", handle_route)
+        ```
+
         Page routes take precedence over browser context routes (set up with `browser_context.route()`) when request
         matches both handlers.
 
         To remove a route with its handler you can use `page.unroute()`.
 
-        > NOTE: Enabling routing disables http cache.
+        **NOTE** Enabling routing disables http cache.
 
         Parameters
         ----------
@@ -8654,7 +9424,8 @@ async def unroute(
     ) -> None:
         """Page.unroute
 
-        Removes a route created with `page.route()`. When `handler` is not specified, removes all routes for the `url`.
+        Removes a route created with `page.route()`. When `handler` is not specified, removes all routes for the
+        `url`.
 
         Parameters
         ----------
@@ -8684,8 +9455,8 @@ async def route_from_har(
         [Replaying from HAR](https://playwright.dev/python/docs/network#replaying-from-har).
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
-        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
-        request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
+        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
 
         Parameters
         ----------
@@ -8693,8 +9464,8 @@ async def route_from_har(
             Path to a [HAR](http://www.softwareishard.com/blog/har-12-spec) file with prerecorded network data. If `path` is a
             relative path, then it is resolved relative to the current working directory.
         url : Union[Pattern[str], str, None]
-            A glob pattern, regular expression or predicate to match the request URL. Only requests with URL matching the pattern
-            will be served from the HAR file. If not specified, all requests are served from the HAR file.
+            A glob pattern, regular expression or predicate to match the request URL. Only requests with URL matching the
+            pattern will be served from the HAR file. If not specified, all requests are served from the HAR file.
         not_found : Union["abort", "fallback", None]
             - If set to 'abort' any request not found in the HAR file will be aborted.
             - If set to 'fallback' missing requests will be sent to the network.
@@ -8733,14 +9504,14 @@ async def screenshot(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
-            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a relative
-            path, then it is resolved relative to the current working directory. If no path is provided, the image won't be saved to
-            the disk.
+            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a
+            relative path, then it is resolved relative to the current working directory. If no path is provided, the image
+            won't be saved to the disk.
         quality : Union[int, None]
             The quality of the image, between 0-100. Not applicable to `png` images.
         omit_background : Union[bool, None]
@@ -8752,24 +9523,24 @@ async def screenshot(
         clip : Union[{x: float, y: float, width: float, height: float}, None]
             An object which specifies clipping of the resulting image. Should have the following fields:
         animations : Union["allow", "disabled", None]
-            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different treatment
-            depending on their duration:
+            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different
+            treatment depending on their duration:
             - finite animations are fast-forwarded to completion, so they'll fire `transitionend` event.
             - infinite animations are canceled to initial state, and then played over after the screenshot.
 
             Defaults to `"allow"` that leaves animations untouched.
         caret : Union["hide", "initial", None]
-            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be changed.
-            Defaults to `"hide"`.
+            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be
+            changed.  Defaults to `"hide"`.
         scale : Union["css", "device", None]
-            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
-            high-dpi devices will be twice as large or even larger.
+            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this
+            will keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so
+            screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
-            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-            `#FF00FF` that completely covers its bounding box.
+            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
+            box `#FF00FF` that completely covers its bounding box.
 
         Returns
         -------
@@ -8795,7 +9566,7 @@ async def screenshot(
     async def title(self) -> str:
         """Page.title
 
-        Returns the page's title. Shortcut for main frame's `frame.title()`.
+        Returns the page's title.
 
         Returns
         -------
@@ -8812,8 +9583,8 @@ async def close(self, *, run_before_unload: typing.Optional[bool] = None) -> Non
 
         By default, `page.close()` **does not** run `beforeunload` handlers.
 
-        > NOTE: if `runBeforeUnload` is passed as true, a `beforeunload` dialog might be summoned and should be handled manually
-        via `page.on('dialog')` event.
+        **NOTE** if `runBeforeUnload` is passed as true, a `beforeunload` dialog might be summoned and should be handled
+        manually via `page.on('dialog')` event.
 
         Parameters
         ----------
@@ -8859,28 +9630,26 @@ async def click(
 
         This method clicks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        Shortcut for main frame's `frame.click()`.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -8888,17 +9657,17 @@ async def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8940,50 +9709,48 @@ async def dblclick(
 
         This method double clicks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if the
-           first click of the `dblclick()` triggers a navigation event, this method will throw.
-
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
+           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
-        > NOTE: `page.dblclick()` dispatches two `click` events and a single `dblclick` event.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        Shortcut for main frame's `frame.dblclick()`.
+        **NOTE** `page.dblclick()` dispatches two `click` events and a single `dblclick` event.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -9019,45 +9786,43 @@ async def tap(
 
         This method taps an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        > NOTE: `page.tap()` requires that the `hasTouch` option of the browser context be set to true.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        Shortcut for main frame's `frame.tap()`.
+        **NOTE** `page.tap()` requires that the `hasTouch` option of the browser context be set to true.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -9085,33 +9850,31 @@ async def fill(
     ) -> None:
         """Page.fill
 
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
-        element, fills it and triggers an `input` event after filling. Note that you can pass an empty string to clear the input
-        field.
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks,
+        focuses the element, fills it and triggers an `input` event after filling. Note that you can pass an empty string
+        to clear the input field.
 
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an
+        error. However, if the element is inside the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
         To send fine-grained keyboard events, use `page.type()`.
 
-        Shortcut for main frame's `frame.fill()`.
-
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9139,9 +9902,9 @@ def locator(
     ) -> "Locator":
         """Page.locator
 
-        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved to
-        the element immediately before performing an action, so a series of actions on the same locator can in fact be performed
-        on different DOM elements. That would happen if the DOM structure between those actions has changed.
+        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved
+        to the element immediately before performing an action, so a series of actions on the same locator can in fact be
+        performed on different DOM elements. That would happen if the DOM structure between those actions has changed.
 
         [Learn more about locators](https://playwright.dev/python/docs/locators).
 
@@ -9150,12 +9913,12 @@ def locator(
         selector : str
             A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
         has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
+            passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
+            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
@@ -9189,8 +9952,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9220,8 +9983,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9250,8 +10013,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9367,9 +10130,10 @@ def get_by_role(
         accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
 
         Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
-        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
-        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
+        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
+        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
+        default values.
 
         Parameters
         ----------
@@ -9382,7 +10146,7 @@ def get_by_role(
         disabled : Union[bool, None]
             An attribute that is usually set by `aria-disabled` or `disabled`.
 
-            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
@@ -9394,8 +10158,8 @@ def get_by_role(
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
         level : Union[int, None]
-            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
-            `<h1>-<h6>` elements.
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values
+            for `<h1>-<h6>` elements.
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
@@ -9412,8 +10176,8 @@ def get_by_role(
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
         exact : Union[bool, None]
-            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
-            expression. Note that exact match still trims whitespace.
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9487,21 +10251,39 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
-        by the text content.
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
 
-        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
-        one, turns line breaks into spaces and ignores leading and trailing whitespace.
-        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
-        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
+        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+
+        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
+        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9518,7 +10300,8 @@ def get_by_title(
     ) -> "Locator":
         """Page.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
+        order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -9529,8 +10312,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9542,8 +10325,12 @@ def get_by_title(
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Page.frame_locator
 
-        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements in
-        that iframe. Following snippet locates element with text \"Submit\" in the iframe with id `my-frame`, like `<iframe
+        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
+        in that iframe.
+
+        **Usage**
+
+        Following snippet locates element with text \"Submit\" in the iframe with id `my-frame`, like `<iframe
         id=\"my-frame\">`:
 
         ```py
@@ -9551,6 +10338,11 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         await locator.click()
         ```
 
+        ```py
+        locator = page.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
+        locator.click()
+        ```
+
         Parameters
         ----------
         selector : str
@@ -9572,22 +10364,20 @@ async def focus(
     ) -> None:
         """Page.focus
 
-        This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the method
-        waits until a matching element appears in the DOM.
-
-        Shortcut for main frame's `frame.focus()`.
+        This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the
+        method waits until a matching element appears in the DOM.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -9610,14 +10400,14 @@ async def text_content(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -9644,14 +10434,14 @@ async def inner_text(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -9678,14 +10468,14 @@ async def inner_html(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -9713,16 +10503,16 @@ async def get_attribute(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         name : str
             Attribute name to get the value for.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -9753,43 +10543,41 @@ async def hover(
 
         This method hovers over an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        Shortcut for main frame's `frame.hover()`.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -9823,6 +10611,8 @@ async def drag_and_drop(
         This method drags the source element to the target element. It will first move to the source element, perform a
         `mousedown`, then move to the target element and perform a `mouseup`.
 
+        **Usage**
+
         ```py
         await page.drag_and_drop(\"#source\", \"#target\")
         # or specify exact positions relative to the top-left corners of the elements:
@@ -9834,14 +10624,25 @@ async def drag_and_drop(
         )
         ```
 
+        ```py
+        page.drag_and_drop(\"#source\", \"#target\")
+        # or specify exact positions relative to the top-left corners of the elements:
+        page.drag_and_drop(
+          \"#source\",
+          \"#target\",
+          source_position={\"x\": 34, \"y\": 7},
+          target_position={\"x\": 10, \"y\": 20}
+        )
+        ```
+
         Parameters
         ----------
         source : str
-            A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
-        target : str
-            A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will
+            A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will
             be used. See [working with selectors](../selectors.md) for more details.
+        target : str
+            A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first
+            will be used. See [working with selectors](../selectors.md) for more details.
         source_position : Union[{x: float, y: float}, None]
             Clicks on the source 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.
@@ -9851,18 +10652,18 @@ async def drag_and_drop(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -9896,17 +10697,20 @@ async def select_option(
     ) -> typing.List[str]:
         """Page.select_option
 
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until
-        all specified options are present in the `<select>` element and selects these options.
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits
+        until all specified options are present in the `<select>` element and selects these options.
 
-        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside the
-        `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used instead.
+        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside
+        the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used
+        instead.
 
         Returns the array of option values that have been successfully selected.
 
         Triggers a `change` and `input` event once all the provided options have been selected.
 
+        **Usage**
+
         ```py
         # single selection matching the value
         await page.select_option(\"select#colors\", \"blue\")
@@ -9916,30 +10720,37 @@ async def select_option(
         await page.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
         ```
 
-        Shortcut for main frame's `frame.select_option()`.
+        ```py
+        # single selection matching the value
+        page.select_option(\"select#colors\", \"blue\")
+        # single selection matching both the label
+        page.select_option(\"select#colors\", label=\"blue\")
+        # multiple selection
+        page.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
+        ```
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         value : Union[List[str], str, None]
-            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         index : Union[List[int], int, None]
             Options to select by index. Optional.
         label : Union[List[str], str, None]
-            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -9977,19 +10788,20 @@ async def input_value(
         Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
 
         Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the
+        control.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -10019,30 +10831,30 @@ async def set_input_files(
     ) -> None:
         """Page.set_input_files
 
-        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
-        are resolved relative to the current working directory. For empty array, clears the selected files.
+        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
+        they are resolved relative to the current working directory. For empty array, clears the selected files.
 
         This method expects `selector` to point to an
-        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
-        `<label>` element that has an associated
+        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
+        the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -10067,34 +10879,39 @@ async def type(
     ) -> None:
         """Page.type
 
-        Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `page.type` can be used to send
-        fine-grained keyboard events. To fill values in form fields, use `page.fill()`.
+        Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `page.type` can be used to
+        send fine-grained keyboard events. To fill values in form fields, use `page.fill()`.
 
         To press a special key, like `Control` or `ArrowDown`, use `keyboard.press()`.
 
+        **Usage**
+
         ```py
         await page.type(\"#mytextarea\", \"hello\") # types instantly
         await page.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
         ```
 
-        Shortcut for main frame's `frame.type()`.
+        ```py
+        page.type(\"#mytextarea\", \"hello\") # types instantly
+        page.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
+        ```
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         text : str
             A text to type into a focused element.
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10125,12 +10942,14 @@ async def press(
 
         Focuses the element, and then uses `keyboard.down()` and `keyboard.up()`.
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -10142,6 +10961,8 @@ async def press(
         Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
         modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
+        **Usage**
+
         ```py
         page = await browser.new_page()
         await page.goto(\"https://keycode.info\")
@@ -10154,22 +10975,34 @@ async def press(
         await browser.close()
         ```
 
+        ```py
+        page = browser.new_page()
+        page.goto(\"https://keycode.info\")
+        page.press(\"body\", \"A\")
+        page.screenshot(path=\"a.png\")
+        page.press(\"body\", \"ArrowLeft\")
+        page.screenshot(path=\"arrow_left.png\")
+        page.press(\"body\", \"Shift+O\")
+        page.screenshot(path=\"o.png\")
+        browser.close()
+        ```
+
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         key : str
             Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10201,43 +11034,41 @@ async def check(
 
         This method checks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is already
-           checked, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is
+           already checked, this method returns immediately.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        Shortcut for main frame's `frame.check()`.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -10267,43 +11098,41 @@ async def uncheck(
 
         This method unchecks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is already
-           unchecked, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is
+           already unchecked, this method returns immediately.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        Shortcut for main frame's `frame.uncheck()`.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -10323,15 +11152,20 @@ async def wait_for_timeout(self, timeout: float) -> None:
 
         Waits for the given `timeout` in milliseconds.
 
-        Note that `page.waitForTimeout()` should only be used for debugging. Tests using the timer in production are going to be
-        flaky. Use signals such as network events, selectors becoming visible and others instead.
+        Note that `page.waitForTimeout()` should only be used for debugging. Tests using the timer in production are going
+        to be flaky. Use signals such as network events, selectors becoming visible and others instead.
+
+        **Usage**
 
         ```py
         # wait for 1 second
         await page.wait_for_timeout(1000)
         ```
 
-        Shortcut for main frame's `frame.wait_for_timeout()`.
+        ```py
+        # wait for 1 second
+        page.wait_for_timeout(1000)
+        ```
 
         Parameters
         ----------
@@ -10355,6 +11189,8 @@ async def wait_for_function(
 
         Returns when the `expression` returns a truthy value. It resolves to a JSHandle of the truthy value.
 
+        **Usage**
+
         The `page.wait_for_function()` can be used to observe viewport size change:
 
         ```py
@@ -10375,6 +11211,21 @@ async def main():
         asyncio.run(main())
         ```
 
+        ```py
+        from playwright.sync_api import sync_playwright
+
+        def run(playwright):
+            webkit = playwright.webkit
+            browser = webkit.launch()
+            page = browser.new_page()
+            page.evaluate(\"window.x = 0; setTimeout(() => { window.x = 100 }, 1000);\")
+            page.wait_for_function(\"() => window.x > 0\")
+            browser.close()
+
+        with sync_playwright() as playwright:
+            run(playwright)
+        ```
+
         To pass an argument to the predicate of `page.wait_for_function()` function:
 
         ```py
@@ -10382,21 +11233,25 @@ async def main():
         await page.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
         ```
 
-        Shortcut for main frame's `frame.wait_for_function()`.
+        ```py
+        selector = \".foo\"
+        page.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
+        ```
 
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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()`.
+            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()`.
         polling : Union["raf", float, None]
-            If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling` is a
-            number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to `raf`.
+            If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling`
+            is a number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to
+            `raf`.
 
         Returns
         -------
@@ -10415,13 +11270,13 @@ async def main():
     async def pause(self) -> None:
         """Page.pause
 
-        Pauses script execution. Playwright will stop executing the script and wait for the user to either press 'Resume' button
-        in the page overlay or to call `playwright.resume()` in the DevTools console.
+        Pauses script execution. Playwright will stop executing the script and wait for the user to either press 'Resume'
+        button in the page overlay or to call `playwright.resume()` in the DevTools console.
 
-        User can inspect selectors or perform manual steps while paused. Resume will continue running the original script from
-        the place it was paused.
+        User can inspect selectors or perform manual steps while paused. Resume will continue running the original script
+        from the place it was paused.
 
-        > NOTE: This method requires Playwright to be started in a headed mode, with a falsy `headless` value in the
+        **NOTE** This method requires Playwright to be started in a headed mode, with a falsy `headless` value in the
         `browser_type.launch()`.
         """
 
@@ -10448,14 +11303,16 @@ async def pdf(
 
         Returns the PDF buffer.
 
-        > NOTE: Generating a pdf is currently only supported in Chromium headless.
+        **NOTE** Generating a pdf is currently only supported in Chromium headless.
 
         `page.pdf()` generates a pdf of the page with `print` css media. To generate a pdf with `screen` media, call
         `page.emulate_media()` before calling `page.pdf()`:
 
-        > NOTE: By default, `page.pdf()` generates a pdf with modified colors for printing. Use the
-        [`-webkit-print-color-adjust`](https://developer.mozilla.org/en-US/docs/Web/CSS/-webkit-print-color-adjust) property to
-        force rendering of exact colors.
+        **NOTE** By default, `page.pdf()` generates a pdf with modified colors for printing. Use the
+        [`-webkit-print-color-adjust`](https://developer.mozilla.org/en-US/docs/Web/CSS/-webkit-print-color-adjust)
+        property to force rendering of exact colors.
+
+        **Usage**
 
         ```py
         # generates a pdf with \"screen\" media type.
@@ -10463,7 +11320,14 @@ async def pdf(
         await page.pdf(path=\"page.pdf\")
         ```
 
-        The `width`, `height`, and `margin` options accept values labeled with units. Unlabeled values are treated as pixels.
+        ```py
+        # generates a pdf with \"screen\" media type.
+        page.emulate_media(media=\"screen\")
+        page.pdf(path=\"page.pdf\")
+        ```
+
+        The `width`, `height`, and `margin` options accept values labeled with units. Unlabeled values are treated as
+        pixels.
 
         A few examples:
         - `page.pdf({width: 100})` - prints with width set to 100 pixels
@@ -10489,8 +11353,8 @@ async def pdf(
         - `A5`: 5.83in x 8.27in
         - `A6`: 4.13in x 5.83in
 
-        > NOTE: `headerTemplate` and `footerTemplate` markup have the following limitations: > 1. Script tags inside templates
-        are not evaluated. > 2. Page styles are not visible inside templates.
+        **NOTE** `headerTemplate` and `footerTemplate` markup have the following limitations: > 1. Script tags inside
+        templates are not evaluated. > 2. Page styles are not visible inside templates.
 
         Parameters
         ----------
@@ -10499,8 +11363,8 @@ async def pdf(
         display_header_footer : Union[bool, None]
             Display header and footer. Defaults to `false`.
         header_template : Union[str, None]
-            HTML template for the print header. Should be valid HTML markup with following classes used to inject printing values
-            into them:
+            HTML template for the print header. Should be valid HTML markup with following classes used to inject printing
+            values into them:
             - `'date'` formatted print date
             - `'title'` document title
             - `'url'` document location
@@ -10564,12 +11428,20 @@ def 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
         ```
 
+        ```py
+        with page.expect_event(\"framenavigated\") as event_info:
+            page.get_by_role(\"button\")
+        frame = event_info.value
+        ```
+
         Parameters
         ----------
         event : str
@@ -10577,8 +11449,8 @@ def expect_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()`.
+            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
         -------
@@ -10600,16 +11472,16 @@ def expect_console_message(
         """Page.expect_console_message
 
         Performs action and waits for a `ConsoleMessage` to be logged by in the page. If predicate is provided, it passes
-        `ConsoleMessage` value into the `predicate` function and waits for `predicate(message)` to return a truthy value. Will
-        throw an error if the page is closed before the `page.on('console')` event is fired.
+        `ConsoleMessage` value into the `predicate` function and waits for `predicate(message)` to return a truthy value.
+        Will throw an error if the page is closed before the `page.on('console')` event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[ConsoleMessage], bool], None]
             Receives the `ConsoleMessage` object 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()`.
+            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
         -------
@@ -10631,16 +11503,16 @@ def expect_download(
         """Page.expect_download
 
         Performs action and waits for a new `Download`. If predicate is provided, it passes `Download` value into the
-        `predicate` function and waits for `predicate(download)` to return a truthy value. Will throw an error if the page is
-        closed before the download event is fired.
+        `predicate` function and waits for `predicate(download)` to return a truthy value. Will throw an error if the page
+        is closed before the download event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[Download], bool], None]
             Receives the `Download` object 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()`.
+            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
         -------
@@ -10661,17 +11533,17 @@ def expect_file_chooser(
     ) -> AsyncEventContextManager["FileChooser"]:
         """Page.expect_file_chooser
 
-        Performs action and waits for a new `FileChooser` to be created. If predicate is provided, it passes `FileChooser` value
-        into the `predicate` function and waits for `predicate(fileChooser)` to return a truthy value. Will throw an error if
-        the page is closed before the file chooser is opened.
+        Performs action and waits for a new `FileChooser` to be created. If predicate is provided, it passes `FileChooser`
+        value into the `predicate` function and waits for `predicate(fileChooser)` to return a truthy value. Will throw an
+        error if the page is closed before the file chooser is opened.
 
         Parameters
         ----------
         predicate : Union[Callable[[FileChooser], bool], None]
             Receives the `FileChooser` object 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()`.
+            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
         -------
@@ -10701,9 +11573,11 @@ def expect_navigation(
         navigation will resolve with the response of the last redirect. In case of navigation to a different anchor or
         navigation due to History API usage, the navigation will resolve with `null`.
 
-        This resolves when the page navigates to a new URL or reloads. It is useful for when you run code which will indirectly
-        cause the page to navigate. e.g. The click target has an `onclick` handler that triggers navigation from a `setTimeout`.
-        Consider this example:
+        **Usage**
+
+        This resolves when the page navigates to a new URL or reloads. It is useful for when you run code which will
+        indirectly cause the page to navigate. e.g. The click target has an `onclick` handler that triggers navigation from
+        a `setTimeout`. Consider this example:
 
         ```py
         async with page.expect_navigation():
@@ -10711,26 +11585,32 @@ def expect_navigation(
         # Resolves after navigation has finished
         ```
 
-        > NOTE: Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL is
-        considered a navigation.
+        ```py
+        with page.expect_navigation():
+            page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+        # Resolves after navigation has finished
+        ```
 
-        Shortcut for main frame's `frame.expect_navigation()`.
+        **NOTE** Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL
+        is considered a 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 the
-            parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to
-            the string.
+            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]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
 
@@ -10753,17 +11633,17 @@ def expect_popup(
     ) -> AsyncEventContextManager["Page"]:
         """Page.expect_popup
 
-        Performs action and waits for a popup `Page`. If predicate is provided, it passes [Popup] value into the `predicate`
-        function and waits for `predicate(page)` to return a truthy value. Will throw an error if the page is closed before the
-        popup event is fired.
+        Performs action and waits for a popup `Page`. If predicate is provided, it passes [Popup] value into the
+        `predicate` function and waits for `predicate(page)` to return a truthy value. Will throw an error if the page is
+        closed before the popup event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[Page], bool], None]
             Receives the `Page` object 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()`.
+            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
         -------
@@ -10786,8 +11666,10 @@ def expect_request(
     ) -> AsyncEventContextManager["Request"]:
         """Page.expect_request
 
-        Waits for the matching request and returns it. See [waiting for event](https://playwright.dev/python/docs/events#waiting-for-event) for more details
-        about events.
+        Waits for the matching request and returns it. See [waiting for event](https://playwright.dev/python/docs/events#waiting-for-event) for more
+        details about events.
+
+        **Usage**
 
         ```py
         async with page.expect_request(\"http://example.com/resource\") as first:
@@ -10800,15 +11682,26 @@ def expect_request(
         second_request = await second.value
         ```
 
+        ```py
+        with page.expect_request(\"http://example.com/resource\") as first:
+            page.click('button')
+        first_request = first.value
+
+        # or with a lambda
+        with page.expect_request(lambda request: request.url == \"http://example.com\" and request.method == \"get\") as second:
+            page.click('img')
+        second_request = second.value
+        ```
+
         Parameters
         ----------
         url_or_predicate : Union[Callable[[Request], 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
+            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.
         timeout : Union[float, None]
-            Maximum wait time in milliseconds, defaults to 30 seconds, pass `0` to disable the timeout. The default value can be
-            changed by using the `page.set_default_timeout()` method.
+            Maximum wait time in milliseconds, defaults to 30 seconds, pass `0` to disable the timeout. The default value can
+            be changed by using the `page.set_default_timeout()` method.
 
         Returns
         -------
@@ -10829,17 +11722,17 @@ def expect_request_finished(
     ) -> AsyncEventContextManager["Request"]:
         """Page.expect_request_finished
 
-        Performs action and waits for a `Request` to finish loading. If predicate is provided, it passes `Request` value into
-        the `predicate` function and waits for `predicate(request)` to return a truthy value. Will throw an error if the page is
-        closed before the `page.on('request_finished')` event is fired.
+        Performs action and waits for a `Request` to finish loading. If predicate is provided, it passes `Request` value
+        into the `predicate` function and waits for `predicate(request)` to return a truthy value. Will throw an error if
+        the page is closed before the `page.on('request_finished')` event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[Request], bool], None]
             Receives the `Request` object 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()`.
+            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
         -------
@@ -10862,7 +11755,10 @@ def expect_response(
     ) -> AsyncEventContextManager["Response"]:
         """Page.expect_response
 
-        Returns the matched response. See [waiting for event](https://playwright.dev/python/docs/events#waiting-for-event) for more details about events.
+        Returns the matched response. See [waiting for event](https://playwright.dev/python/docs/events#waiting-for-event) for more details about
+        events.
+
+        **Usage**
 
         ```py
         async with page.expect_response(\"https://example.com/resource\") as response_info:
@@ -10877,6 +11773,19 @@ def expect_response(
         return response.ok
         ```
 
+        ```py
+        with page.expect_response(\"https://example.com/resource\") as response_info:
+            page.click(\"input\")
+        response = response_info.value
+        return response.ok
+
+        # or with a lambda
+        with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200) as response_info:
+            page.click(\"input\")
+        response = response_info.value
+        return response.ok
+        ```
+
         Parameters
         ----------
         url_or_predicate : Union[Callable[[Response], bool], Pattern[str], str]
@@ -10884,8 +11793,8 @@ def expect_response(
             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.
         timeout : Union[float, None]
-            Maximum wait time in milliseconds, defaults to 30 seconds, pass `0` to disable the timeout. The default value can be
-            changed by using the `browser_context.set_default_timeout()` or `page.set_default_timeout()` methods.
+            Maximum wait time in milliseconds, defaults to 30 seconds, pass `0` to disable the timeout. The default value can
+            be changed by using the `browser_context.set_default_timeout()` or `page.set_default_timeout()` methods.
 
         Returns
         -------
@@ -10907,16 +11816,16 @@ def expect_websocket(
         """Page.expect_websocket
 
         Performs action and waits for a new `WebSocket`. If predicate is provided, it passes `WebSocket` value into the
-        `predicate` function and waits for `predicate(webSocket)` to return a truthy value. Will throw an error if the page is
-        closed before the WebSocket event is fired.
+        `predicate` function and waits for `predicate(webSocket)` to return a truthy value. Will throw an error if the page
+        is closed before the WebSocket event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[WebSocket], bool], None]
             Receives the `WebSocket` object 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()`.
+            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
         -------
@@ -10937,17 +11846,17 @@ def expect_worker(
     ) -> AsyncEventContextManager["Worker"]:
         """Page.expect_worker
 
-        Performs action and waits for a new `Worker`. If predicate is provided, it passes `Worker` value into the `predicate`
-        function and waits for `predicate(worker)` to return a truthy value. Will throw an error if the page is closed before
-        the worker event is fired.
+        Performs action and waits for a new `Worker`. If predicate is provided, it passes `Worker` value into the
+        `predicate` function and waits for `predicate(worker)` to return a truthy value. Will throw an error if the page is
+        closed before the worker event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[Worker], bool], None]
             Receives the `Worker` object 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()`.
+            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
         -------
@@ -10978,43 +11887,41 @@ async def set_checked(
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
         1. Ensure that matched element is a checkbox or a radio input. If not, this method throws.
         1. If the element already has the right checked state, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        Shortcut for main frame's `frame.set_checked()`.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -11042,12 +11949,16 @@ def on(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        > NOTE: Only works with Chromium browser's persistent context.
+        **NOTE** Only works with Chromium browser's persistent context.
 
         Emitted when new background page is created in the context.
 
         ```py
         background_page = await context.wait_for_event(\"backgroundpage\")
+        ```
+
+        ```py
+        background_page = context.wait_for_event(\"backgroundpage\")
         ```"""
 
     @typing.overload
@@ -11071,12 +11982,13 @@ def on(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event will
-        also fire for popup pages. See also `page.on('popup')` to receive events about popups relevant to a specific page.
+        The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event
+        will also fire for popup pages. See also `page.on('popup')` to receive events about popups relevant to a
+        specific page.
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
-        popup with `window.open('http://example.com')`, this event will fire when the network request to \"http://example.com\" is
-        done and its response has started loading in the popup.
+        popup with `window.open('http://example.com')`, this event will fire when the network request to
+        \"http://example.com\" is done and its response has started loading in the popup.
 
         ```py
         async with context.expect_page() as page_info:
@@ -11085,8 +11997,15 @@ def on(
         print(await page.evaluate(\"location.href\"))
         ```
 
-        > NOTE: Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not need it
-        in most cases)."""
+        ```py
+        with context.expect_page() as page_info:
+            page.locator(\"a[target=_blank]\").click(),
+        page = page_info.value
+        print(page.evaluate(\"location.href\"))
+        ```
+
+        **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
+        need it in most cases)."""
 
     @typing.overload
     def on(
@@ -11095,8 +12014,8 @@ def on(
         f: typing.Callable[["Request"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To only
-        listen for requests from a particular page, use `page.on('request')`.
+        Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To
+        only listen for requests from a particular page, use `page.on('request')`.
 
         In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`."""
 
@@ -11107,11 +12026,12 @@ def on(
         f: typing.Callable[["Request"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when a request fails, for example by timing out. To only listen for failed requests from a particular page, use
-        `page.on('request_failed')`.
+        Emitted when a request fails, for example by timing out. To only listen for failed requests from a particular page,
+        use `page.on('request_failed')`.
 
-        > NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will
-        complete with `browser_context.on('request_finished')` event and not with `browser_context.on('request_failed')`."""
+        **NOTE** HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request
+        will complete with `browser_context.on('request_finished')` event and not with
+        `browser_context.on('request_failed')`."""
 
     @typing.overload
     def on(
@@ -11121,8 +12041,8 @@ def on(
     ) -> None:
         """
         Emitted when a request finishes successfully after downloading the response body. For a successful response, the
-        sequence of events is `request`, `response` and `requestfinished`. To listen for successful requests from a particular
-        page, use `page.on('request_finished')`."""
+        sequence of events is `request`, `response` and `requestfinished`. To listen for successful requests from a
+        particular page, use `page.on('request_finished')`."""
 
     @typing.overload
     def on(
@@ -11131,8 +12051,8 @@ def on(
         f: typing.Callable[["Response"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of events
-        is `request`, `response` and `requestfinished`. To listen for response events from a particular page, use
+        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of
+        events is `request`, `response` and `requestfinished`. To listen for response events from a particular page, use
         `page.on('response')`."""
 
     @typing.overload
@@ -11142,7 +12062,7 @@ def on(
         f: typing.Callable[["Worker"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        > NOTE: Service workers are only supported on Chromium-based browsers.
+        **NOTE** Service workers are only supported on Chromium-based browsers.
 
         Emitted when new service worker is created in the context."""
 
@@ -11160,12 +12080,16 @@ def once(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        > NOTE: Only works with Chromium browser's persistent context.
+        **NOTE** Only works with Chromium browser's persistent context.
 
         Emitted when new background page is created in the context.
 
         ```py
         background_page = await context.wait_for_event(\"backgroundpage\")
+        ```
+
+        ```py
+        background_page = context.wait_for_event(\"backgroundpage\")
         ```"""
 
     @typing.overload
@@ -11189,12 +12113,13 @@ def once(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event will
-        also fire for popup pages. See also `page.on('popup')` to receive events about popups relevant to a specific page.
+        The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event
+        will also fire for popup pages. See also `page.on('popup')` to receive events about popups relevant to a
+        specific page.
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
-        popup with `window.open('http://example.com')`, this event will fire when the network request to \"http://example.com\" is
-        done and its response has started loading in the popup.
+        popup with `window.open('http://example.com')`, this event will fire when the network request to
+        \"http://example.com\" is done and its response has started loading in the popup.
 
         ```py
         async with context.expect_page() as page_info:
@@ -11203,8 +12128,15 @@ def once(
         print(await page.evaluate(\"location.href\"))
         ```
 
-        > NOTE: Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not need it
-        in most cases)."""
+        ```py
+        with context.expect_page() as page_info:
+            page.locator(\"a[target=_blank]\").click(),
+        page = page_info.value
+        print(page.evaluate(\"location.href\"))
+        ```
+
+        **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
+        need it in most cases)."""
 
     @typing.overload
     def once(
@@ -11213,8 +12145,8 @@ def once(
         f: typing.Callable[["Request"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To only
-        listen for requests from a particular page, use `page.on('request')`.
+        Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To
+        only listen for requests from a particular page, use `page.on('request')`.
 
         In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`."""
 
@@ -11225,11 +12157,12 @@ def once(
         f: typing.Callable[["Request"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when a request fails, for example by timing out. To only listen for failed requests from a particular page, use
-        `page.on('request_failed')`.
+        Emitted when a request fails, for example by timing out. To only listen for failed requests from a particular page,
+        use `page.on('request_failed')`.
 
-        > NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will
-        complete with `browser_context.on('request_finished')` event and not with `browser_context.on('request_failed')`."""
+        **NOTE** HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request
+        will complete with `browser_context.on('request_finished')` event and not with
+        `browser_context.on('request_failed')`."""
 
     @typing.overload
     def once(
@@ -11239,8 +12172,8 @@ def once(
     ) -> None:
         """
         Emitted when a request finishes successfully after downloading the response body. For a successful response, the
-        sequence of events is `request`, `response` and `requestfinished`. To listen for successful requests from a particular
-        page, use `page.on('request_finished')`."""
+        sequence of events is `request`, `response` and `requestfinished`. To listen for successful requests from a
+        particular page, use `page.on('request_finished')`."""
 
     @typing.overload
     def once(
@@ -11249,8 +12182,8 @@ def once(
         f: typing.Callable[["Response"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of events
-        is `request`, `response` and `requestfinished`. To listen for response events from a particular page, use
+        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of
+        events is `request`, `response` and `requestfinished`. To listen for response events from a particular page, use
         `page.on('response')`."""
 
     @typing.overload
@@ -11260,7 +12193,7 @@ def once(
         f: typing.Callable[["Worker"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        > NOTE: Service workers are only supported on Chromium-based browsers.
+        **NOTE** Service workers are only supported on Chromium-based browsers.
 
         Emitted when new service worker is created in the context."""
 
@@ -11299,7 +12232,7 @@ def browser(self) -> typing.Optional["Browser"]:
     def background_pages(self) -> typing.List["Page"]:
         """BrowserContext.background_pages
 
-        > NOTE: Background pages are only supported on Chromium-based browsers.
+        **NOTE** Background pages are only supported on Chromium-based browsers.
 
         All existing background pages in the context.
 
@@ -11313,7 +12246,7 @@ def background_pages(self) -> typing.List["Page"]:
     def service_workers(self) -> typing.List["Worker"]:
         """BrowserContext.service_workers
 
-        > NOTE: Service workers are only supported on Chromium-based browsers.
+        **NOTE** Service workers are only supported on Chromium-based browsers.
 
         All existing service workers in the context.
 
@@ -11356,7 +12289,7 @@ def set_default_navigation_timeout(self, timeout: float) -> None:
         - `page.set_content()`
         - `page.expect_navigation()`
 
-        > NOTE: `page.set_default_navigation_timeout()` and `page.set_default_timeout()` take priority over
+        **NOTE** `page.set_default_navigation_timeout()` and `page.set_default_timeout()` take priority over
         `browser_context.set_default_navigation_timeout()`.
 
         Parameters
@@ -11374,8 +12307,9 @@ def set_default_timeout(self, timeout: float) -> None:
 
         This setting will change the default maximum time for all the methods accepting `timeout` option.
 
-        > NOTE: `page.set_default_navigation_timeout()`, `page.set_default_timeout()` and
-        `browser_context.set_default_navigation_timeout()` take priority over `browser_context.set_default_timeout()`.
+        **NOTE** `page.set_default_navigation_timeout()`, `page.set_default_timeout()` and
+        `browser_context.set_default_navigation_timeout()` take priority over
+        `browser_context.set_default_timeout()`.
 
         Parameters
         ----------
@@ -11404,8 +12338,8 @@ async def cookies(
     ) -> typing.List[Cookie]:
         """BrowserContext.cookies
 
-        If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those URLs
-        are returned.
+        If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those
+        URLs are returned.
 
         Parameters
         ----------
@@ -11424,13 +12358,19 @@ async def cookies(
     async def add_cookies(self, cookies: typing.List[SetCookieParam]) -> None:
         """BrowserContext.add_cookies
 
-        Adds cookies into this browser context. All pages within this context will have these cookies installed. Cookies can be
-        obtained via `browser_context.cookies()`.
+        Adds cookies into this browser context. All pages within this context will have these cookies installed. Cookies
+        can be obtained via `browser_context.cookies()`.
+
+        **Usage**
 
         ```py
         await browser_context.add_cookies([cookie_object1, cookie_object2])
         ```
 
+        ```py
+        browser_context.add_cookies([cookie_object1, cookie_object2])
+        ```
+
         Parameters
         ----------
         cookies : List[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
@@ -11490,12 +12430,21 @@ async def clear_permissions(self) -> None:
 
         Clears all permission overrides for the browser context.
 
+        **Usage**
+
         ```py
         context = await browser.new_context()
         await context.grant_permissions([\"clipboard-read\"])
         # do stuff ..
         context.clear_permissions()
         ```
+
+        ```py
+        context = browser.new_context()
+        context.grant_permissions([\"clipboard-read\"])
+        # do stuff ..
+        context.clear_permissions()
+        ```
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.clear_permissions())
@@ -11507,12 +12456,18 @@ async def set_geolocation(
 
         Sets the context's geolocation. Passing `null` or `undefined` emulates position unavailable.
 
+        **Usage**
+
         ```py
         await browser_context.set_geolocation({\"latitude\": 59.95, \"longitude\": 30.31667})
         ```
 
-        > NOTE: Consider using `browser_context.grant_permissions()` to grant permissions for the browser context pages to
-        read its geolocation.
+        ```py
+        browser_context.set_geolocation({\"latitude\": 59.95, \"longitude\": 30.31667})
+        ```
+
+        **NOTE** Consider using `browser_context.grant_permissions()` to grant permissions for the browser context
+        pages to read its geolocation.
 
         Parameters
         ----------
@@ -11526,11 +12481,12 @@ async def set_geolocation(
     async def set_extra_http_headers(self, headers: typing.Dict[str, str]) -> None:
         """BrowserContext.set_extra_http_headers
 
-        The extra HTTP headers will be sent with every request initiated by any page in the context. These headers are merged
-        with page-specific extra HTTP headers set with `page.set_extra_http_headers()`. If page overrides a particular
-        header, page-specific header value will be used instead of the browser context header value.
+        The extra HTTP headers will be sent with every request initiated by any page in the context. These headers are
+        merged with page-specific extra HTTP headers set with `page.set_extra_http_headers()`. If page overrides a
+        particular header, page-specific header value will be used instead of the browser context header value.
 
-        > NOTE: `browser_context.set_extra_http_headers()` does not guarantee the order of headers in the outgoing requests.
+        **NOTE** `browser_context.set_extra_http_headers()` does not guarantee the order of headers in the outgoing
+        requests.
 
         Parameters
         ----------
@@ -11570,8 +12526,10 @@ async def add_init_script(
         - Whenever a child frame is attached or navigated in any page in the browser context. In this case, the script is
           evaluated in the context of the newly attached frame.
 
-        The script is evaluated after the document was created but before any of its scripts were run. This is useful to amend
-        the JavaScript environment, e.g. to seed `Math.random`.
+        The script is evaluated after the document was created but before any of its scripts were run. This is useful to
+        amend the JavaScript environment, e.g. to seed `Math.random`.
+
+        **Usage**
 
         An example of overriding `Math.random` before the page loads:
 
@@ -11580,7 +12538,12 @@ async def add_init_script(
         await browser_context.add_init_script(path=\"preload.js\")
         ```
 
-        > NOTE: The order of evaluation of multiple scripts installed via `browser_context.add_init_script()` and
+        ```py
+        # in your playwright script, assuming the preload.js file is in same directory.
+        browser_context.add_init_script(path=\"preload.js\")
+        ```
+
+        **NOTE** The order of evaluation of multiple scripts installed via `browser_context.add_init_script()` and
         `page.add_init_script()` is not defined.
 
         Parameters
@@ -11606,14 +12569,16 @@ async def expose_binding(
         """BrowserContext.expose_binding
 
         The method adds a function called `name` on the `window` object of every frame in every page in the context. When
-        called, the function executes `callback` and returns a [Promise] which resolves to the return value of `callback`. If
-        the `callback` returns a [Promise], it will be awaited.
+        called, the function executes `callback` and returns a [Promise] which resolves to the return value of `callback`.
+        If the `callback` returns a [Promise], it will be awaited.
 
-        The first argument of the `callback` function contains information about the caller: `{ browserContext: BrowserContext,
-        page: Page, frame: Frame }`.
+        The first argument of the `callback` function contains information about the caller: `{ browserContext:
+        BrowserContext, page: Page, frame: Frame }`.
 
         See `page.expose_binding()` for page-only version.
 
+        **Usage**
+
         An example of exposing page URL to all frames in all pages in the context:
 
         ```py
@@ -11643,6 +12608,30 @@ async def main():
         asyncio.run(main())
         ```
 
+        ```py
+        from playwright.sync_api import sync_playwright
+
+        def run(playwright):
+            webkit = playwright.webkit
+            browser = webkit.launch(headless=false)
+            context = browser.new_context()
+            context.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
+            page = context.new_page()
+            page.set_content(\"\"\"
+            <script>
+              async function onClick() {
+                document.querySelector('div').textContent = await window.pageURL();
+              }
+            </script>
+            <button onclick=\"onClick()\">Click me</button>
+            <div></div>
+            \"\"\")
+            page.get_by_role(\"button\").click()
+
+        with sync_playwright() as playwright:
+            run(playwright)
+        ```
+
         An example of passing an element handle:
 
         ```py
@@ -11659,6 +12648,20 @@ async def print(source, element):
         \"\"\")
         ```
 
+        ```py
+        def print(source, element):
+            print(element.text_content())
+
+        context.expose_binding(\"clicked\", print, handle=true)
+        page.set_content(\"\"\"
+          <script>
+            document.addEventListener('click', event => window.clicked(event.target));
+          </script>
+          <div>Click me</div>
+          <div>Or click me</div>
+        \"\"\")
+        ```
+
         Parameters
         ----------
         name : str
@@ -11686,6 +12689,8 @@ async def expose_function(self, name: str, callback: typing.Callable) -> None:
 
         See `page.expose_function()` for page-only version.
 
+        **Usage**
+
         An example of adding a `sha256` function to all pages in the context:
 
         ```py
@@ -11721,6 +12726,36 @@ async def main():
         asyncio.run(main())
         ```
 
+        ```py
+        import hashlib
+        from playwright.sync_api import sync_playwright
+
+        def sha256(text):
+            m = hashlib.sha256()
+            m.update(bytes(text, \"utf8\"))
+            return m.hexdigest()
+
+        def run(playwright):
+            webkit = playwright.webkit
+            browser = webkit.launch(headless=False)
+            context = browser.new_context()
+            context.expose_function(\"sha256\", sha256)
+            page = context.new_page()
+            page.set_content(\"\"\"
+                <script>
+                  async function onClick() {
+                    document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
+                  }
+                </script>
+                <button onclick=\"onClick()\">Click me</button>
+                <div></div>
+            \"\"\")
+            page.get_by_role(\"button\").click()
+
+        with sync_playwright() as playwright:
+            run(playwright)
+        ```
+
         Parameters
         ----------
         name : str
@@ -11747,12 +12782,14 @@ async def route(
     ) -> None:
         """BrowserContext.route
 
-        Routing provides the capability to modify network requests that are made by any page in the browser context. Once route
-        is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or aborted.
+        Routing provides the capability to modify network requests that are made by any page in the browser context. Once
+        route is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or aborted.
+
+        **NOTE** `browser_context.route()` will not intercept requests intercepted by Service Worker. See
+        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
+        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
 
-        > NOTE: `browser_context.route()` will not intercept requests intercepted by Service Worker. See
-        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
-        request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        **Usage**
 
         An example of a naive handler that aborts all image requests:
 
@@ -11764,6 +12801,14 @@ async def route(
         await browser.close()
         ```
 
+        ```py
+        context = browser.new_context()
+        page = context.new_page()
+        context.route(\"**/*.{png,jpg,jpeg}\", lambda route: route.abort())
+        page.goto(\"https://example.com\")
+        browser.close()
+        ```
+
         or the same snippet using a regex pattern instead:
 
         ```py
@@ -11775,8 +12820,18 @@ async def route(
         await browser.close()
         ```
 
-        It is possible to examine the request to decide the route action. For example, mocking all requests that contain some
-        post data, and leaving all other requests as is:
+        ```py
+        context = browser.new_context()
+        page = context.new_page()
+        context.route(re.compile(r\"(\\.png$)|(\\.jpg$)\"), lambda route: route.abort())
+        page = await context.new_page()
+        page = context.new_page()
+        page.goto(\"https://example.com\")
+        browser.close()
+        ```
+
+        It is possible to examine the request to decide the route action. For example, mocking all requests that contain
+        some post data, and leaving all other requests as is:
 
         ```py
         def handle_route(route):
@@ -11787,12 +12842,21 @@ def handle_route(route):
         await context.route(\"/api/**\", handle_route)
         ```
 
-        Page routes (set up with `page.route()`) take precedence over browser context routes when request matches both
-        handlers.
+        ```py
+        def handle_route(route):
+          if (\"my-string\" in route.request.post_data)
+            route.fulfill(body=\"mocked-data\")
+          else
+            route.continue_()
+        context.route(\"/api/**\", handle_route)
+        ```
+
+        Page routes (set up with `page.route()`) take precedence over browser context routes when request matches
+        both handlers.
 
         To remove a route with its handler you can use `browser_context.unroute()`.
 
-        > NOTE: Enabling routing disables http cache.
+        **NOTE** Enabling routing disables http cache.
 
         Parameters
         ----------
@@ -11826,8 +12890,8 @@ async def unroute(
     ) -> None:
         """BrowserContext.unroute
 
-        Removes a route created with `browser_context.route()`. When `handler` is not specified, removes all routes for
-        the `url`.
+        Removes a route created with `browser_context.route()`. When `handler` is not specified, removes all routes
+        for the `url`.
 
         Parameters
         ----------
@@ -11858,8 +12922,8 @@ async def route_from_har(
         [Replaying from HAR](https://playwright.dev/python/docs/network#replaying-from-har).
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
-        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
-        request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
+        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
 
         Parameters
         ----------
@@ -11867,8 +12931,8 @@ async def route_from_har(
             Path to a [HAR](http://www.softwareishard.com/blog/har-12-spec) file with prerecorded network data. If `path` is a
             relative path, then it is resolved relative to the current working directory.
         url : Union[Pattern[str], str, None]
-            A glob pattern, regular expression or predicate to match the request URL. Only requests with URL matching the pattern
-            will be served from the HAR file. If not specified, all requests are served from the HAR file.
+            A glob pattern, regular expression or predicate to match the request URL. Only requests with URL matching the
+            pattern will be served from the HAR file. If not specified, all requests are served from the HAR file.
         not_found : Union["abort", "fallback", None]
             - If set to 'abort' any request not found in the HAR file will be aborted.
             - If set to 'fallback' falls through to the next route handler in the handler chain.
@@ -11897,12 +12961,20 @@ def 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 context closes before the event is fired. Returns the event data value.
 
+        **Usage**
+
         ```py
         async with context.expect_event(\"page\") as event_info:
             await page.get_by_role(\"button\").click()
         page = await event_info.value
         ```
 
+        ```py
+        with context.expect_event(\"page\") as event_info:
+            page.get_by_role(\"button\").click()
+        page = event_info.value
+        ```
+
         Parameters
         ----------
         event : str
@@ -11910,8 +12982,8 @@ def expect_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()`.
+            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
         -------
@@ -11929,7 +13001,7 @@ async def close(self) -> None:
 
         Closes the browser context. All the pages that belong to the browser context will be closed.
 
-        > NOTE: The default browser context cannot be closed.
+        **NOTE** The default browser context cannot be closed.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.close())
@@ -11963,11 +13035,11 @@ async def wait_for_event(
     ) -> typing.Any:
         """BrowserContext.wait_for_event
 
-        > NOTE: In most cases, you should use `browser_context.expect_event()`.
+        **NOTE** In most cases, you should use `browser_context.expect_event()`.
 
-        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function and
-        waits for `predicate(event)` to return a truthy value. Will throw an error if the browser context is closed before the
-        `event` is fired.
+        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function
+        and waits for `predicate(event)` to return a truthy value. Will throw an error if the browser context is closed
+        before the `event` is fired.
 
         Parameters
         ----------
@@ -11976,8 +13048,8 @@ async def wait_for_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()`.
+            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
         -------
@@ -11999,16 +13071,16 @@ def expect_page(
         """BrowserContext.expect_page
 
         Performs action and waits for a new `Page` to be created in the context. If predicate is provided, it passes `Page`
-        value into the `predicate` function and waits for `predicate(event)` to return a truthy value. Will throw an error if
-        the context closes before new `Page` is created.
+        value into the `predicate` function and waits for `predicate(event)` to return a truthy value. Will throw an error
+        if the context closes before new `Page` is created.
 
         Parameters
         ----------
         predicate : Union[Callable[[Page], bool], None]
             Receives the `Page` object 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()`.
+            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
         -------
@@ -12026,15 +13098,15 @@ async def new_cdp_session(
     ) -> "CDPSession":
         """BrowserContext.new_cdp_session
 
-        > NOTE: CDP sessions are only supported on Chromium-based browsers.
+        **NOTE** CDP sessions are only supported on Chromium-based browsers.
 
         Returns the newly created session.
 
         Parameters
         ----------
         page : Union[Frame, Page]
-            Target to create new session for. For backwards-compatibility, this parameter is named `page`, but it can be a `Page` or
-            `Frame` type.
+            Target to create new session for. For backwards-compatibility, this parameter is named `page`, but it can be a
+            `Page` or `Frame` type.
 
         Returns
         -------
@@ -12072,8 +13144,8 @@ async def send(
     async def detach(self) -> None:
         """CDPSession.detach
 
-        Detaches the CDPSession from the target. Once detached, the CDPSession object won't emit any events and can't be used to
-        send messages.
+        Detaches the CDPSession from the target. Once detached, the CDPSession object won't emit any events and can't be
+        used to send messages.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.detach())
@@ -12089,7 +13161,8 @@ def on(
         f: typing.Callable[["Browser"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when Browser gets disconnected from the browser application. This might happen because of one of the following:
+        Emitted when Browser gets disconnected from the browser application. This might happen because of one of the
+        following:
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
         return super().on(event=event, f=f)
@@ -12100,7 +13173,8 @@ def once(
         f: typing.Callable[["Browser"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when Browser gets disconnected from the browser application. This might happen because of one of the following:
+        Emitted when Browser gets disconnected from the browser application. This might happen because of one of the
+        following:
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
         return super().once(event=event, f=f)
@@ -12111,6 +13185,8 @@ def contexts(self) -> typing.List["BrowserContext"]:
 
         Returns an array of all open browser contexts. In a newly created browser, this will return zero browser contexts.
 
+        **Usage**
+
         ```py
         browser = await pw.webkit.launch()
         print(len(browser.contexts())) # prints `0`
@@ -12118,6 +13194,13 @@ def contexts(self) -> typing.List["BrowserContext"]:
         print(len(browser.contexts())) # prints `1`
         ```
 
+        ```py
+        browser = pw.webkit.launch()
+        print(len(browser.contexts())) # prints `0`
+        context = browser.new_context()
+        print(len(browser.contexts())) # prints `1`
+        ```
+
         Returns
         -------
         List[BrowserContext]
@@ -12210,10 +13293,12 @@ async def new_context(
 
         Creates a new browser context. It won't share cookies/cache with other browser contexts.
 
-        > NOTE: If directly using this method to create `BrowserContext`s, it is best practice to explicitly close the returned
-        context via `browser_context.close()` when your code is done with the `BrowserContext`, and before calling
-        `browser.close()`. This will ensure the `context` is closed gracefully and any artifacts—like HARs and
-        videos—are fully flushed and saved.
+        **NOTE** If directly using this method to create `BrowserContext`s, it is best practice to explicitly close the
+        returned context via `browser_context.close()` when your code is done with the `BrowserContext`, and before
+        calling `browser.close()`. This will ensure the `context` is closed gracefully and any artifacts—like HARs
+        and videos—are fully flushed and saved.
+
+        **Usage**
 
         ```py
         browser = await playwright.firefox.launch() # or \"chromium\" or \"webkit\".
@@ -12228,13 +13313,27 @@ async def new_context(
         await browser.close()
         ```
 
+        ```py
+        browser = playwright.firefox.launch() # or \"chromium\" or \"webkit\".
+        # create a new incognito browser context.
+        context = browser.new_context()
+        # create a new page in a pristine context.
+        page = context.new_page()
+        page.goto(\"https://example.com\")
+
+        # gracefully close up everything
+        context.close()
+        browser.close()
+        ```
+
         Parameters
         ----------
         viewport : Union[{width: int, height: int}, None]
-            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed viewport.
+            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
+            viewport.
         screen : Union[{width: int, height: int}, None]
-            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the `viewport`
-            is set.
+            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
+            `viewport` is set.
         no_viewport : Union[bool, None]
             Does not enforce fixed viewport, allows resizing window in the headed mode.
         ignore_https_errors : Union[bool, None]
@@ -12246,16 +13345,16 @@ async def new_context(
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
-            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `Accept-Language`
-            request header value as well as number and date formatting rules.
+            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
+            `Accept-Language` request header value as well as number and date formatting rules.
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
-            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for more
-            details.
+            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
+            more details.
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
@@ -12265,8 +13364,8 @@ async def new_context(
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not supported
-            in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
+            supported in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
@@ -12278,58 +13377,61 @@ async def new_context(
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'no-preference'`.
         forced_colors : Union["active", "none", "null", None]
-            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
+            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'none'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings to use with this context.
 
-            > NOTE: For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If all
-            contexts override the proxy, global proxy will be never used and can be any string, for example `launch({ proxy: {
-            server: 'http://per-context' } })`.
+            **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
+            all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
+            proxy: { server: 'http://per-context' } })`.
         record_har_path : Union[pathlib.Path, str, None]
-            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file on the
-            filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()` for the HAR to
-            be saved.
+            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
+            on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
+            for the HAR to be saved.
         record_har_omit_content : Union[bool, None]
             Optional setting to control whether to omit request content from the HAR. Defaults to `false`.
         record_video_dir : Union[pathlib.Path, str, None]
-            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make sure
-            to call `browser_context.close()` for videos to be saved.
+            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make
+            sure to call `browser_context.close()` for videos to be saved.
         record_video_size : Union[{width: int, height: int}, None]
             Dimensions of the recorded videos. If not specified the size will be equal to `viewport` scaled down to fit into
-            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page will
-            be scaled down if necessary to fit the specified size.
+            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
+            will be scaled down if necessary to fit the specified size.
         storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
-            Populates context with given storage state. This option can be used to initialize context with logged-in information
-            obtained via `browser_context.storage_state()`. Either a path to the file with saved storage, or an object with
-            the following fields:
+            Populates context with given storage state. This option can be used to initialize context with logged-in
+            information obtained via `browser_context.storage_state()`. Either a path to the file with saved storage, or
+            an object with the following fields:
         base_url : Union[str, None]
-            When using `page.goto()`, `page.route()`, `page.wait_for_url()`, `page.expect_request()`,
-            or `page.expect_response()` it takes the base URL in consideration by using the
-            [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the corresponding URL.
-            Examples:
+            When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
+            `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
+            using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
+            corresponding URL. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
-            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in `http://localhost:3000/foo/bar.html`
+            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
+              `http://localhost:3000/foo/bar.html`
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
-            that imply single target DOM element will throw when more than one element matches the selector. See `Locator` to learn
-            more about the strict mode.
+            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. See
+            `Locator` to learn more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
-            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be registered.
+            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
+              registered.
             - `'block'`: Playwright will block all registration of Service Workers.
         record_har_url_filter : Union[Pattern[str], str, None]
         record_har_mode : Union["full", "minimal", None]
-            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page, cookies,
-            security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
+            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
-            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
-            Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
+            `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
+            HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
         -------
@@ -12425,17 +13527,18 @@ async def new_page(
 
         Creates a new page in a new browser context. Closing this page will close the context as well.
 
-        This is a convenience API that should only be used for the single-page scenarios and short snippets. Production code and
-        testing frameworks should explicitly create `browser.new_context()` followed by the
+        This is a convenience API that should only be used for the single-page scenarios and short snippets. Production
+        code and testing frameworks should explicitly create `browser.new_context()` followed by the
         `browser_context.new_page()` to control their exact life times.
 
         Parameters
         ----------
         viewport : Union[{width: int, height: int}, None]
-            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed viewport.
+            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
+            viewport.
         screen : Union[{width: int, height: int}, None]
-            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the `viewport`
-            is set.
+            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
+            `viewport` is set.
         no_viewport : Union[bool, None]
             Does not enforce fixed viewport, allows resizing window in the headed mode.
         ignore_https_errors : Union[bool, None]
@@ -12447,16 +13550,16 @@ async def new_page(
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
-            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `Accept-Language`
-            request header value as well as number and date formatting rules.
+            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
+            `Accept-Language` request header value as well as number and date formatting rules.
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
-            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for more
-            details.
+            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
+            more details.
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
@@ -12466,8 +13569,8 @@ async def new_page(
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not supported
-            in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
+            supported in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
@@ -12475,8 +13578,9 @@ async def new_page(
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'light'`.
         forced_colors : Union["active", "none", "null", None]
-            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
+            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'none'`.
         reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -12486,51 +13590,53 @@ async def new_page(
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings to use with this context.
 
-            > NOTE: For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If all
-            contexts override the proxy, global proxy will be never used and can be any string, for example `launch({ proxy: {
-            server: 'http://per-context' } })`.
+            **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
+            all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
+            proxy: { server: 'http://per-context' } })`.
         record_har_path : Union[pathlib.Path, str, None]
-            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file on the
-            filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()` for the HAR to
-            be saved.
+            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
+            on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
+            for the HAR to be saved.
         record_har_omit_content : Union[bool, None]
             Optional setting to control whether to omit request content from the HAR. Defaults to `false`.
         record_video_dir : Union[pathlib.Path, str, None]
-            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make sure
-            to call `browser_context.close()` for videos to be saved.
+            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make
+            sure to call `browser_context.close()` for videos to be saved.
         record_video_size : Union[{width: int, height: int}, None]
             Dimensions of the recorded videos. If not specified the size will be equal to `viewport` scaled down to fit into
-            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page will
-            be scaled down if necessary to fit the specified size.
+            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
+            will be scaled down if necessary to fit the specified size.
         storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
-            Populates context with given storage state. This option can be used to initialize context with logged-in information
-            obtained via `browser_context.storage_state()`. Either a path to the file with saved storage, or an object with
-            the following fields:
+            Populates context with given storage state. This option can be used to initialize context with logged-in
+            information obtained via `browser_context.storage_state()`. Either a path to the file with saved storage, or
+            an object with the following fields:
         base_url : Union[str, None]
-            When using `page.goto()`, `page.route()`, `page.wait_for_url()`, `page.expect_request()`,
-            or `page.expect_response()` it takes the base URL in consideration by using the
-            [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the corresponding URL.
-            Examples:
+            When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
+            `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
+            using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
+            corresponding URL. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
-            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in `http://localhost:3000/foo/bar.html`
+            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
+              `http://localhost:3000/foo/bar.html`
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
-            that imply single target DOM element will throw when more than one element matches the selector. See `Locator` to learn
-            more about the strict mode.
+            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. See
+            `Locator` to learn more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
-            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be registered.
+            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
+              registered.
             - `'block'`: Playwright will block all registration of Service Workers.
         record_har_url_filter : Union[Pattern[str], str, None]
         record_har_mode : Union["full", "minimal", None]
-            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page, cookies,
-            security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
+            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
-            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
-            Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
+            `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
+            HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
         -------
@@ -12579,14 +13685,14 @@ async def new_page(
     async def close(self) -> None:
         """Browser.close
 
-        In case this browser is obtained using `browser_type.launch()`, closes the browser and all of its pages (if any
-        were opened).
+        In case this browser is obtained using `browser_type.launch()`, closes the browser and all of its pages (if
+        any were opened).
 
-        In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from the
-        browser server.
+        In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from
+        the browser server.
 
-        > NOTE: This is similar to force quitting the browser. Therefore, you should call `browser_context.close()` on
-        any `BrowserContext`'s you explicitly created earlier with `browser.new_context()` **before** calling
+        **NOTE** This is similar to force quitting the browser. Therefore, you should call `browser_context.close()`
+        on any `BrowserContext`'s you explicitly created earlier with `browser.new_context()` **before** calling
         `browser.close()`.
 
         The `Browser` object itself is considered to be disposed and cannot be used anymore.
@@ -12597,7 +13703,7 @@ async def close(self) -> None:
     async def new_browser_cdp_session(self) -> "CDPSession":
         """Browser.new_browser_cdp_session
 
-        > NOTE: CDP Sessions are only supported on Chromium-based browsers.
+        **NOTE** CDP Sessions are only supported on Chromium-based browsers.
 
         Returns the newly created browser session.
 
@@ -12618,19 +13724,28 @@ async def start_tracing(
     ) -> None:
         """Browser.start_tracing
 
-        > NOTE: This API controls [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool)
-        which is a low-level chromium-specific debugging tool. API to control [Playwright Tracing](https://playwright.dev/python/docs/trace-viewer) could be
-        found [here](https://playwright.dev/python/docs/api/class-tracing).
+        **NOTE** This API controls
+        [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool) which is a low-level
+        chromium-specific debugging tool. API to control [Playwright Tracing](https://playwright.dev/python/docs/trace-viewer) could be found
+        [here](https://playwright.dev/python/docs/api/class-tracing).
 
         You can use `browser.start_tracing()` and `browser.stop_tracing()` to create a trace file that can be
         opened in Chrome DevTools performance panel.
 
+        **Usage**
+
         ```py
         await browser.start_tracing(page, path=\"trace.json\")
         await page.goto(\"https://www.google.com\")
         await browser.stop_tracing()
         ```
 
+        ```py
+        browser.start_tracing(page, path=\"trace.json\")
+        page.goto(\"https://www.google.com\")
+        browser.stop_tracing()
+        ```
+
         Parameters
         ----------
         page : Union[Page, None]
@@ -12655,9 +13770,10 @@ async def start_tracing(
     async def stop_tracing(self) -> bytes:
         """Browser.stop_tracing
 
-        > NOTE: This API controls [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool)
-        which is a low-level chromium-specific debugging tool. API to control [Playwright Tracing](https://playwright.dev/python/docs/trace-viewer) could be
-        found [here](https://playwright.dev/python/docs/api/class-tracing).
+        **NOTE** This API controls
+        [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool) which is a low-level
+        chromium-specific debugging tool. API to control [Playwright Tracing](https://playwright.dev/python/docs/trace-viewer) could be found
+        [here](https://playwright.dev/python/docs/api/class-tracing).
 
         Returns the buffer with trace data.
 
@@ -12726,6 +13842,8 @@ async def launch(
 
         Returns the browser instance.
 
+        **Usage**
+
         You can use `ignoreDefaultArgs` to filter out `--mute-audio` from default arguments:
 
         ```py
@@ -12734,18 +13852,24 @@ async def launch(
         )
         ```
 
-        > **Chromium-only** Playwright can also be used to control the Google Chrome or Microsoft Edge browsers, but it works
-        best with the version of Chromium it is bundled with. There is no guarantee it will work with any other version. Use
-        `executablePath` option with extreme caution.
+        ```py
+        browser = playwright.chromium.launch( # or \"firefox\" or \"webkit\".
+            ignore_default_args=[\"--mute-audio\"]
+        )
+        ```
+
+        > **Chromium-only** Playwright can also be used to control the Google Chrome or Microsoft Edge browsers, but it
+        works best with the version of Chromium it is bundled with. There is no guarantee it will work with any other
+        version. Use `executablePath` option with extreme caution.
         >
         > If Google Chrome (rather than Chromium) is preferred, a
         [Chrome Canary](https://www.google.com/chrome/browser/canary.html) or
         [Dev Channel](https://www.chromium.org/getting-involved/dev-channel) build is suggested.
         >
-        > Stock browsers like Google Chrome and Microsoft Edge are suitable for tests that require proprietary media codecs for
-        video playback. See
-        [this article](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for other
-        differences between Chromium and Chrome.
+        > Stock browsers like Google Chrome and Microsoft Edge are suitable for tests that require proprietary media codecs
+        for video playback. See
+        [this article](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for
+        other differences between Chromium and Chrome.
         [This article](https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md)
         describes some differences for Linux users.
 
@@ -12753,11 +13877,11 @@ async def launch(
         ----------
         executable_path : Union[pathlib.Path, str, None]
             Path to a browser executable to run instead of the bundled one. If `executablePath` is a relative path, then it is
-            resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium, Firefox
-            or WebKit, use at your own risk.
+            resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
+            Firefox or WebKit, use at your own risk.
         channel : Union[str, None]
-            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge",
-            "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
+            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
+            "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
             [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
         args : Union[List[str], None]
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
@@ -12772,8 +13896,8 @@ async def launch(
         handle_sighup : Union[bool, None]
             Close the browser process on SIGHUP. Defaults to `true`.
         timeout : Union[float, None]
-            Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0` to
-            disable timeout.
+            Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0`
+            to disable timeout.
         env : Union[Dict[str, Union[bool, float, str]], None]
             Specify environment variables that will be visible to the browser. Defaults to `process.env`.
         headless : Union[bool, None]
@@ -12782,16 +13906,17 @@ async def launch(
             [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). 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`.
+            **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`.
         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]
-            If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is
-            deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in
-            is closed.
+            If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and
+            is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were
+            created in is closed.
         slow_mo : Union[float, None]
-            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
+            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going
+            on.
         traces_dir : Union[pathlib.Path, str, None]
             If specified, traces are saved into this directory.
         chromium_sandbox : Union[bool, None]
@@ -12899,17 +14024,17 @@ async def launch_persistent_context(
         user_data_dir : Union[pathlib.Path, str]
             Path to a User Data Directory, which stores browser session data like cookies and local storage. More details for
             [Chromium](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md#introduction) and
-            [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile). Note that Chromium's user
-            data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty string to use
-            a temporary directory instead.
+            [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile). Note that Chromium's
+            user data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty
+            string to use a temporary directory instead.
         channel : Union[str, None]
-            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge",
-            "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
+            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
+            "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
             [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
         executable_path : Union[pathlib.Path, str, None]
             Path to a browser executable to run instead of the bundled one. If `executablePath` is a relative path, then it is
-            resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium, Firefox
-            or WebKit, use at your own risk.
+            resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
+            Firefox or WebKit, use at your own risk.
         args : Union[List[str], None]
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
             [here](http://peter.sh/experiments/chromium-command-line-switches/).
@@ -12923,8 +14048,8 @@ async def launch_persistent_context(
         handle_sighup : Union[bool, None]
             Close the browser process on SIGHUP. Defaults to `true`.
         timeout : Union[float, None]
-            Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0` to
-            disable timeout.
+            Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0`
+            to disable timeout.
         env : Union[Dict[str, Union[bool, float, str]], None]
             Specify environment variables that will be visible to the browser. Defaults to `process.env`.
         headless : Union[bool, None]
@@ -12933,21 +14058,23 @@ async def launch_persistent_context(
             [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). 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`.
+            **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`.
         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]
-            If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is
-            deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in
-            is closed.
+            If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and
+            is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were
+            created in is closed.
         slow_mo : Union[float, None]
-            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
+            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going
+            on.
         viewport : Union[{width: int, height: int}, None]
-            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed viewport.
+            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
+            viewport.
         screen : Union[{width: int, height: int}, None]
-            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the `viewport`
-            is set.
+            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
+            `viewport` is set.
         no_viewport : Union[bool, None]
             Does not enforce fixed viewport, allows resizing window in the headed mode.
         ignore_https_errors : Union[bool, None]
@@ -12959,16 +14086,16 @@ async def launch_persistent_context(
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
-            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `Accept-Language`
-            request header value as well as number and date formatting rules.
+            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
+            `Accept-Language` request header value as well as number and date formatting rules.
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
-            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for more
-            details.
+            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
+            more details.
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
@@ -12978,8 +14105,8 @@ async def launch_persistent_context(
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not supported
-            in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
+            supported in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
@@ -12991,8 +14118,9 @@ async def launch_persistent_context(
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'no-preference'`.
         forced_colors : Union["active", "none", "null", None]
-            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
+            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'none'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         traces_dir : Union[pathlib.Path, str, None]
@@ -13000,43 +14128,45 @@ async def launch_persistent_context(
         chromium_sandbox : Union[bool, None]
             Enable Chromium sandboxing. Defaults to `false`.
         record_har_path : Union[pathlib.Path, str, None]
-            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file on the
-            filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()` for the HAR to
-            be saved.
+            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
+            on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
+            for the HAR to be saved.
         record_har_omit_content : Union[bool, None]
             Optional setting to control whether to omit request content from the HAR. Defaults to `false`.
         record_video_dir : Union[pathlib.Path, str, None]
-            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make sure
-            to call `browser_context.close()` for videos to be saved.
+            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make
+            sure to call `browser_context.close()` for videos to be saved.
         record_video_size : Union[{width: int, height: int}, None]
             Dimensions of the recorded videos. If not specified the size will be equal to `viewport` scaled down to fit into
-            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page will
-            be scaled down if necessary to fit the specified size.
+            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
+            will be scaled down if necessary to fit the specified size.
         base_url : Union[str, None]
-            When using `page.goto()`, `page.route()`, `page.wait_for_url()`, `page.expect_request()`,
-            or `page.expect_response()` it takes the base URL in consideration by using the
-            [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the corresponding URL.
-            Examples:
+            When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
+            `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
+            using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
+            corresponding URL. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
-            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in `http://localhost:3000/foo/bar.html`
+            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
+              `http://localhost:3000/foo/bar.html`
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
-            that imply single target DOM element will throw when more than one element matches the selector. See `Locator` to learn
-            more about the strict mode.
+            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. See
+            `Locator` to learn more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
-            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be registered.
+            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
+              registered.
             - `'block'`: Playwright will block all registration of Service Workers.
         record_har_url_filter : Union[Pattern[str], str, None]
         record_har_mode : Union["full", "minimal", None]
-            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page, cookies,
-            security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
+            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
-            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
-            Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
+            `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
+            HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
         -------
@@ -13110,7 +14240,9 @@ async def connect_over_cdp(
 
         The default browser context is accessible via `browser.contexts()`.
 
-        > NOTE: Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
+        **NOTE** Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
+
+        **Usage**
 
         ```py
         browser = await playwright.chromium.connect_over_cdp(\"http://localhost:9222\")
@@ -13118,17 +14250,23 @@ async def connect_over_cdp(
         page = default_context.pages[0]
         ```
 
+        ```py
+        browser = playwright.chromium.connect_over_cdp(\"http://localhost:9222\")
+        default_context = browser.contexts[0]
+        page = default_context.pages[0]
+        ```
+
         Parameters
         ----------
         endpoint_url : str
             A CDP websocket endpoint or http url to connect to. For example `http://localhost:9222/` or
             `ws://127.0.0.1:9222/devtools/browser/387adf4c-243f-4051-a181-46798f4a46f4`.
         timeout : Union[float, None]
-            Maximum time in milliseconds to wait for the connection to be established. Defaults to `30000` (30 seconds). Pass `0` to
-            disable timeout.
+            Maximum time in milliseconds to wait for the connection to be established. Defaults to `30000` (30 seconds). Pass
+            `0` to disable timeout.
         slow_mo : Union[float, None]
-            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
-            Defaults to 0.
+            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going
+            on. Defaults to 0.
         headers : Union[Dict[str, str], None]
             Additional HTTP headers to be sent with connect request. Optional.
 
@@ -13167,8 +14305,8 @@ async def connect(
         timeout : Union[float, None]
             Maximum time in milliseconds to wait for the connection to be established. Defaults to `0` (no timeout).
         slow_mo : Union[float, None]
-            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
-            Defaults to 0.
+            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going
+            on. Defaults to 0.
         headers : Union[Dict[str, str], None]
             Additional HTTP headers to be sent with web socket connect request. Optional.
 
@@ -13217,6 +14355,23 @@ async def main():
         asyncio.run(main())
         ```
 
+        ```py
+        from playwright.sync_api import sync_playwright
+
+        def run(playwright):
+            webkit = playwright.webkit
+            iphone = playwright.devices[\"iPhone 6\"]
+            browser = webkit.launch()
+            context = browser.new_context(**iphone)
+            page = context.new_page()
+            page.goto(\"http://example.com\")
+            # other actions...
+            browser.close()
+
+        with sync_playwright() as playwright:
+            run(playwright)
+        ```
+
         Returns
         -------
         Dict
@@ -13291,8 +14446,8 @@ def __getitem__(self, value: str) -> "BrowserType":
     def stop(self) -> None:
         """Playwright.stop
 
-        Terminates this instance of Playwright in case it was created bypassing the Python context manager. This is useful in
-        REPL applications.
+        Terminates this instance of Playwright in case it was created bypassing the Python context manager. This is useful
+        in REPL applications.
 
         ```py
         >>> from playwright.sync_api import sync_playwright
@@ -13329,6 +14484,8 @@ async def start(
 
         Start tracing.
 
+        **Usage**
+
         ```py
         await context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
         page = await context.new_page()
@@ -13336,11 +14493,18 @@ async def start(
         await context.tracing.stop(path = \"trace.zip\")
         ```
 
+        ```py
+        context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        page = context.new_page()
+        page.goto(\"https://playwright.dev\")
+        context.tracing.stop(path = \"trace.zip\")
+        ```
+
         Parameters
         ----------
         name : Union[str, None]
-            If specified, the trace is going to be saved into the file with the given name inside the `tracesDir` folder specified
-            in `browser_type.launch()`.
+            If specified, the trace is going to be saved into the file with the given name inside the `tracesDir` folder
+            specified in `browser_type.launch()`.
         title : Union[str, None]
             Trace name to be shown in the Trace Viewer.
         snapshots : Union[bool, None]
@@ -13370,6 +14534,8 @@ async def start_chunk(self, *, title: typing.Optional[str] = None) -> None:
         `tracing.start()` once, and then create multiple trace chunks with `tracing.start_chunk()` and
         `tracing.stop_chunk()`.
 
+        **Usage**
+
         ```py
         await context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
         page = await context.new_page()
@@ -13386,6 +14552,22 @@ async def start_chunk(self, *, title: typing.Optional[str] = None) -> None:
         await context.tracing.stop_chunk(path = \"trace2.zip\")
         ```
 
+        ```py
+        context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        page = context.new_page()
+        page.goto(\"https://playwright.dev\")
+
+        context.tracing.start_chunk()
+        page.get_by_text(\"Get Started\").click()
+        # Everything between start_chunk and stop_chunk will be recorded in the trace.
+        context.tracing.stop_chunk(path = \"trace1.zip\")
+
+        context.tracing.start_chunk()
+        page.goto(\"http://example.com\")
+        # Save a second trace file with different actions.
+        context.tracing.stop_chunk(path = \"trace2.zip\")
+        ```
+
         Parameters
         ----------
         title : Union[str, None]
@@ -13474,25 +14656,32 @@ async def bounding_box(
         calculated relative to the main frame viewport - which is usually the same as the browser window.
 
         Scrolling affects the returned bounding box, similarly to
-        [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect). That
-        means `x` and/or `y` may be negative.
+        [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
+        That means `x` and/or `y` may be negative.
 
         Elements from child frames return the bounding box relative to the main frame, unlike the
         [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
 
-        Assuming the page is static, it is safe to use bounding box coordinates to perform input. For example, the following
-        snippet should click the center of the element.
+        Assuming the page is static, it is safe to use bounding box coordinates to perform input. For example, the
+        following snippet should click the center of the element.
+
+        **Usage**
 
         ```py
         box = await element.bounding_box()
         await page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
         ```
 
+        ```py
+        box = element.bounding_box()
+        page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -13515,8 +14704,8 @@ async def check(
         """Locator.check
 
         This method checks the element by performing the following steps:
-        1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already checked,
-           this method returns immediately.
+        1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already
+           checked, this method returns immediately.
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
@@ -13525,26 +14714,26 @@ async def check(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -13582,17 +14771,17 @@ async def click(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -13600,17 +14789,17 @@ async def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -13647,40 +14836,40 @@ async def dblclick(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if the
-           first click of the `dblclick()` triggers a navigation event, this method will throw.
+        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
+           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `element.dblclick()` dispatches two `click` events and a single `dblclick` event.
+        **NOTE** `element.dblclick()` dispatches two `click` events and a single `dblclick` event.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -13709,12 +14898,18 @@ async def dispatch_event(
         `click` is dispatched. This is equivalent to calling
         [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
 
+        **Usage**
+
         ```py
         await element.dispatch_event(\"click\")
         ```
 
-        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties
-        and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
+        ```py
+        element.dispatch_event(\"click\")
+        ```
+
+        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
+        properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
@@ -13733,6 +14928,12 @@ async def dispatch_event(
         await element.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
         ```
 
+        ```py
+        # note you can only create data_transfer in chromium and firefox
+        data_transfer = page.evaluate_handle(\"new DataTransfer()\")
+        element.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
+        ```
+
         Parameters
         ----------
         type : str
@@ -13740,8 +14941,8 @@ async def dispatch_event(
         event_init : Union[Dict, None]
             Optional event-specific initialization properties.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -13763,25 +14964,31 @@ async def evaluate(
 
         This method passes this handle as the first argument to `expression`.
 
-        If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its value.
+        If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its
+        value.
 
-        Examples:
+        **Usage**
 
         ```py
         tweets = page.locator(\".tweet .retweets\")
         assert await tweets.evaluate(\"node => node.innerText\") == \"10 retweets\"
         ```
 
+        ```py
+        tweets = page.locator(\".tweet .retweets\")
+        assert tweets.evaluate(\"node => node.innerText\") == \"10 retweets\"
+        ```
+
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -13799,24 +15006,29 @@ async def evaluate_all(
     ) -> typing.Any:
         """Locator.evaluate_all
 
-        The method finds all elements matching the specified locator and passes an array of matched elements as a first argument
-        to `expression`. Returns the result of `expression` invocation.
+        The method finds all elements matching the specified locator and passes an array of matched elements as a first
+        argument to `expression`. Returns the result of `expression` invocation.
 
         If `expression` returns a [Promise], then `locator.evaluate_all()` would wait for the promise to resolve and
         return its value.
 
-        Examples:
+        **Usage**
+
+        ```py
+        elements = page.locator(\"div\")
+        div_counts = await elements.evaluate_all(\"(divs, min) => divs.length >= min\", 10)
+        ```
 
         ```py
         elements = page.locator(\"div\")
-        div_counts = await elements(\"(divs, min) => divs.length >= min\", 10)
+        div_counts = elements.evaluate_all(\"(divs, min) => divs.length >= min\", 10)
         ```
 
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -13855,13 +15067,13 @@ async def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -13884,11 +15096,11 @@ async def fill(
     ) -> None:
         """Locator.fill
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an `input`
-        event after filling. Note that you can pass an empty string to clear the input field.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an
+        `input` event after filling. Note that you can pass an empty string to clear the input field.
 
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an
+        error. However, if the element is inside the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
@@ -13899,12 +15111,12 @@ async def fill(
         value : str
             Value to set for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -13927,20 +15139,20 @@ async def clear(
         This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
         `input` event after clearing.
 
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an
+        error. However, if the element is inside the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
         instead.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -13960,8 +15172,8 @@ def locator(
     ) -> "Locator":
         """Locator.locator
 
-        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter options,
-        similar to `locator.filter()` method.
+        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter
+        options, similar to `locator.filter()` method.
 
         [Learn more about locators](https://playwright.dev/python/docs/locators).
 
@@ -13970,12 +15182,12 @@ def locator(
         selector : str
             A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
         has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
+            passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
+            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
@@ -14009,8 +15221,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14040,8 +15252,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14070,8 +15282,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14187,9 +15399,10 @@ def get_by_role(
         accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
 
         Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
-        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
-        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
+        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
+        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
+        default values.
 
         Parameters
         ----------
@@ -14202,7 +15415,7 @@ def get_by_role(
         disabled : Union[bool, None]
             An attribute that is usually set by `aria-disabled` or `disabled`.
 
-            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
@@ -14214,8 +15427,8 @@ def get_by_role(
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
         level : Union[int, None]
-            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
-            `<h1>-<h6>` elements.
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values
+            for `<h1>-<h6>` elements.
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
@@ -14232,8 +15445,8 @@ def get_by_role(
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
         exact : Union[bool, None]
-            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
-            expression. Note that exact match still trims whitespace.
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14307,21 +15520,39 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
-        by the text content.
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
 
-        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
-        one, turns line breaks into spaces and ignores leading and trailing whitespace.
-        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
-        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
+        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+
+        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
+        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14338,7 +15569,8 @@ def get_by_title(
     ) -> "Locator":
         """Locator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
+        order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -14349,8 +15581,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14362,14 +15594,21 @@ def get_by_title(
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Locator.frame_locator
 
-        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements in
-        that iframe:
+        **Usage**
+
+        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
+        in that iframe:
 
         ```py
         locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
         await locator.click()
         ```
 
+        ```py
+        locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
+        locator.click()
+        ```
+
         Parameters
         ----------
         selector : str
@@ -14387,14 +15626,14 @@ async def element_handle(
     ) -> "ElementHandle":
         """Locator.element_handle
 
-        Resolves given locator to the first matching DOM element. If no elements matching the query are visible, waits for them
-        up to a given timeout. If multiple elements match the selector, throws.
+        Resolves given locator to the first matching DOM element. If no elements matching the query are visible, waits for
+        them up to a given timeout. If multiple elements match the selector, throws.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14439,8 +15678,10 @@ def filter(
     ) -> "Locator":
         """Locator.filter
 
-        This method narrows existing locator according to the options, for example filters by text. It can be chained to filter
-        multiple times.
+        This method narrows existing locator according to the options, for example filters by text. It can be chained to
+        filter multiple times.
+
+        **Usage**
 
         ```py
         row_locator = page.locator(\"tr\")
@@ -14451,15 +15692,24 @@ def filter(
             .screenshot()
         ```
 
+        ```py
+        row_locator = page.locator(\"tr\")
+        # ...
+        row_locator
+            .filter(has_text=\"text in column 1\")
+            .filter(has=page.get_by_role(\"button\", name=\"column 2 button\"))
+            .screenshot()
+        ```
+
         Parameters
         ----------
         has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
+            passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
+            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
@@ -14480,8 +15730,8 @@ async def focus(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.focus(timeout=timeout))
@@ -14494,8 +15744,8 @@ async def blur(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.blur(timeout=timeout))
@@ -14525,8 +15775,10 @@ async def drag_to(
     ) -> None:
         """Locator.drag_to
 
-        This method drags the locator to another target locator or target position. It will first move to the source element,
-        perform a `mousedown`, then move to the target element or position and perform a `mouseup`.
+        This method drags the locator to another target locator or target position. It will first move to the source
+        element, perform a `mousedown`, then move to the target element or position and perform a `mouseup`.
+
+        **Usage**
 
         ```py
         source = page.locator(\"#source\")
@@ -14541,6 +15793,19 @@ async def drag_to(
         )
         ```
 
+        ```py
+        source = page.locator(\"#source\")
+        target = page.locator(\"#target\")
+
+        source.drag_to(target)
+        # or specify exact positions relative to the top-left corners of the elements:
+        source.drag_to(
+          target,
+          source_position={\"x\": 34, \"y\": 7},
+          target_position={\"x\": 10, \"y\": 20}
+        )
+        ```
+
         Parameters
         ----------
         target : Locator
@@ -14548,15 +15813,15 @@ async def drag_to(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         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.
+            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.
         source_position : Union[{x: float, y: float}, None]
             Clicks on the source 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.
@@ -14589,8 +15854,8 @@ async def get_attribute(
         name : str
             Attribute name to get the value for.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14623,29 +15888,29 @@ async def hover(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -14667,8 +15932,8 @@ async def inner_html(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14685,8 +15950,8 @@ async def inner_text(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14701,13 +15966,14 @@ async def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
 
         Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the
+        control.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14726,8 +15992,8 @@ async def is_checked(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14744,8 +16010,8 @@ async def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14764,8 +16030,8 @@ async def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14784,8 +16050,8 @@ async def is_enabled(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14802,8 +16068,6 @@ async def is_hidden(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `locator.is_hidden()` does not wait for the element to become hidden and
-            returns immediately.
 
         Returns
         -------
@@ -14820,8 +16084,6 @@ async def is_visible(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `locator.is_visible()` does not wait for the element to become visible and
-            returns immediately.
 
         Returns
         -------
@@ -14842,12 +16104,14 @@ async def press(
 
         Focuses the element, and then uses `keyboard.down()` and `keyboard.up()`.
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -14866,12 +16130,12 @@ async def press(
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -14895,50 +16159,50 @@ async def screenshot(
     ) -> bytes:
         """Locator.screenshot
 
-        This method captures a screenshot of the page, clipped to the size and position of a particular element matching the
-        locator. If the element is covered by other elements, it will not be actually visible on the screenshot. If the element
-        is a scrollable container, only the currently scrolled content will be visible on the screenshot.
+        This method captures a screenshot of the page, clipped to the size and position of a particular element matching
+        the locator. If the element is covered by other elements, it will not be actually visible on the screenshot. If the
+        element is a scrollable container, only the currently scrolled content will be visible on the screenshot.
 
-        This method waits for the [actionability](https://playwright.dev/python/docs/actionability) checks, then scrolls element into view before taking a
-        screenshot. If the element is detached from DOM, the method throws an error.
+        This method waits for the [actionability](https://playwright.dev/python/docs/actionability) checks, then scrolls element into view before taking
+        a screenshot. If the element is detached from DOM, the method throws an error.
 
         Returns the buffer with the captured screenshot.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
-            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a relative
-            path, then it is resolved relative to the current working directory. If no path is provided, the image won't be saved to
-            the disk.
+            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a
+            relative path, then it is resolved relative to the current working directory. If no path is provided, the image
+            won't be saved to the disk.
         quality : Union[int, None]
             The quality of the image, between 0-100. Not applicable to `png` images.
         omit_background : Union[bool, None]
             Hides default white background and allows capturing screenshots with transparency. Not applicable to `jpeg` images.
             Defaults to `false`.
         animations : Union["allow", "disabled", None]
-            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different treatment
-            depending on their duration:
+            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different
+            treatment depending on their duration:
             - finite animations are fast-forwarded to completion, so they'll fire `transitionend` event.
             - infinite animations are canceled to initial state, and then played over after the screenshot.
 
             Defaults to `"allow"` that leaves animations untouched.
         caret : Union["hide", "initial", None]
-            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be changed.
-            Defaults to `"hide"`.
+            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be
+            changed.  Defaults to `"hide"`.
         scale : Union["css", "device", None]
-            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
-            high-dpi devices will be twice as large or even larger.
+            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this
+            will keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so
+            screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
-            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-            `#FF00FF` that completely covers its bounding box.
+            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
+            box `#FF00FF` that completely covers its bounding box.
 
         Returns
         -------
@@ -14964,15 +16228,15 @@ async def scroll_into_view_if_needed(
     ) -> None:
         """Locator.scroll_into_view_if_needed
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then tries to scroll element into view, unless it is
-        completely visible as defined by
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then tries to scroll element into view, unless
+        it is completely visible as defined by
         [IntersectionObserver](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)'s `ratio`.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -14994,17 +16258,20 @@ async def select_option(
     ) -> typing.List[str]:
         """Locator.select_option
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in the
-        `<select>` element and selects these options.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in
+        the `<select>` element and selects these options.
 
-        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside the
-        `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used instead.
+        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside
+        the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used
+        instead.
 
         Returns the array of option values that have been successfully selected.
 
         Triggers a `change` and `input` event once all the provided options have been selected.
 
+        **Usage**
+
         ```py
         # single selection matching the value
         await element.select_option(\"blue\")
@@ -15014,25 +16281,34 @@ async def select_option(
         await element.select_option(value=[\"red\", \"green\", \"blue\"])
         ```
 
+        ```py
+        # single selection matching the value
+        element.select_option(\"blue\")
+        # single selection matching both the label
+        element.select_option(label=\"blue\")
+        # multiple selection
+        element.select_option(value=[\"red\", \"green\", \"blue\"])
+        ```
+
         Parameters
         ----------
         value : Union[List[str], str, None]
-            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         index : Union[List[int], int, None]
             Options to select by index. Optional.
         label : Union[List[str], str, None]
-            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
 
@@ -15061,20 +16337,20 @@ async def select_text(
     ) -> None:
         """Locator.select_text
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then focuses the element and selects all its text
-        content.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then focuses the element and selects all its
+        text content.
 
         If the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), focuses and selects text in the
-        control instead.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), focuses and selects text in
+        the control instead.
 
         Parameters
         ----------
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -15096,24 +16372,24 @@ async def set_input_files(
     ) -> None:
         """Locator.set_input_files
 
-        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
-        are resolved relative to the current working directory. For empty array, clears the selected files.
+        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
+        they are resolved relative to the current working directory. For empty array, clears the selected files.
 
         This method expects `Locator` to point to an
-        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
-        `<label>` element that has an associated
+        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
+        the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
 
         Parameters
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -15144,31 +16420,31 @@ async def tap(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `element.tap()` requires that the `hasTouch` option of the browser context be set to true.
+        **NOTE** `element.tap()` requires that the `hasTouch` option of the browser context be set to true.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15192,8 +16468,8 @@ async def text_content(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -15214,15 +16490,23 @@ async def type(
     ) -> None:
         """Locator.type
 
-        Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text.
+        Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the
+        text.
 
         To press a special key, like `Control` or `ArrowDown`, use `locator.press()`.
 
+        **Usage**
+
         ```py
         await element.type(\"hello\") # types instantly
         await element.type(\"world\", delay=100) # types slower, like a user
         ```
 
+        ```py
+        element.type(\"hello\") # types instantly
+        element.type(\"world\", delay=100) # types slower, like a user
+        ```
+
         An example of typing into a text field and then submitting the form:
 
         ```py
@@ -15231,6 +16515,12 @@ async def type(
         await element.press(\"Enter\")
         ```
 
+        ```py
+        element = page.get_by_label(\"Password\")
+        element.type(\"my password\")
+        element.press(\"Enter\")
+        ```
+
         Parameters
         ----------
         text : str
@@ -15238,12 +16528,12 @@ async def type(
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -15274,26 +16564,26 @@ async def uncheck(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15342,27 +16632,34 @@ async def wait_for(
 
         Returns when element specified by locator satisfies the `state` option.
 
-        If target element already satisfies the condition, the method returns immediately. Otherwise, waits for up to `timeout`
-        milliseconds until the condition is met.
+        If target element already satisfies the condition, the method returns immediately. Otherwise, waits for up to
+        `timeout` milliseconds until the condition is met.
+
+        **Usage**
 
         ```py
         order_sent = page.locator(\"#order-sent\")
         await order_sent.wait_for()
         ```
 
+        ```py
+        order_sent = page.locator(\"#order-sent\")
+        order_sent.wait_for()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
             - `'detached'` - wait for element to not be present in DOM.
-            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element without
-              any content or with `display:none` has an empty bounding box and is not considered visible.
-            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.
-              This is opposite to the `'visible'` option.
+            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element
+              without any content or with `display:none` has an empty bounding box and is not considered visible.
+            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or
+              `visibility:hidden`. This is opposite to the `'visible'` option.
         """
 
         return mapping.from_maybe_impl(
@@ -15384,35 +16681,35 @@ async def set_checked(
         This method checks or unchecks an element by performing the following steps:
         1. Ensure that matched element is a checkbox or a radio input. If not, this method throws.
         1. If the element already has the right checked state, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15504,8 +16801,8 @@ def headers(self) -> typing.Dict[str, str]:
     def headers_array(self) -> typing.List[NameValue]:
         """APIResponse.headers_array
 
-        An array with all the request HTTP headers associated with this response. Header names are not lower-cased. Headers with
-        multiple entries, such as `Set-Cookie`, appear in the array multiple times.
+        An array with all the request HTTP headers associated with this response. Header names are not lower-cased. Headers
+        with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
 
         Returns
         -------
@@ -15567,8 +16864,8 @@ class APIRequestContext(AsyncBase):
     async def dispose(self) -> None:
         """APIRequestContext.dispose
 
-        All responses returned by `a_pi_request_context.get()` and similar methods are stored in the memory, so that you
-        can later call `a_pi_response.body()`. This method discards all stored responses, and makes
+        All responses returned by `a_pi_request_context.get()` and similar methods are stored in the memory, so that
+        you can later call `a_pi_response.body()`. This method discards all stored responses, and makes
         `a_pi_response.body()` throw \"Response disposed\" error.
         """
 
@@ -15595,8 +16892,8 @@ async def delete(
         """APIRequestContext.delete
 
         Sends HTTP(S) [DELETE](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/DELETE) request and returns its
-        response. The method will populate request cookies from the context and update context cookies from the response. The
-        method will automatically follow redirects.
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
 
         Parameters
         ----------
@@ -15607,22 +16904,24 @@ async def delete(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -15669,9 +16968,9 @@ async def head(
     ) -> "APIResponse":
         """APIRequestContext.head
 
-        Sends HTTP(S) [HEAD](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/HEAD) request and returns its response.
-        The method will populate request cookies from the context and update context cookies from the response. The method will
-        automatically follow redirects.
+        Sends HTTP(S) [HEAD](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/HEAD) request and returns its
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
 
         Parameters
         ----------
@@ -15682,22 +16981,24 @@ async def head(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -15744,9 +17045,11 @@ async def get(
     ) -> "APIResponse":
         """APIRequestContext.get
 
-        Sends HTTP(S) [GET](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/GET) request and returns its response. The
-        method will populate request cookies from the context and update context cookies from the response. The method will
-        automatically follow redirects.
+        Sends HTTP(S) [GET](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/GET) request and returns its
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
+
+        **Usage**
 
         Request parameters can be configured with `params` option, they will be serialized into the URL search parameters:
 
@@ -15767,22 +17070,24 @@ async def get(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -15829,9 +17134,9 @@ async def patch(
     ) -> "APIResponse":
         """APIRequestContext.patch
 
-        Sends HTTP(S) [PATCH](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PATCH) request and returns its response.
-        The method will populate request cookies from the context and update context cookies from the response. The method will
-        automatically follow redirects.
+        Sends HTTP(S) [PATCH](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PATCH) request and returns its
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
 
         Parameters
         ----------
@@ -15842,22 +17147,24 @@ async def patch(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -15904,9 +17211,9 @@ async def put(
     ) -> "APIResponse":
         """APIRequestContext.put
 
-        Sends HTTP(S) [PUT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT) request and returns its response. The
-        method will populate request cookies from the context and update context cookies from the response. The method will
-        automatically follow redirects.
+        Sends HTTP(S) [PUT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT) request and returns its
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
 
         Parameters
         ----------
@@ -15917,22 +17224,24 @@ async def put(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -15979,9 +17288,11 @@ async def post(
     ) -> "APIResponse":
         """APIRequestContext.post
 
-        Sends HTTP(S) [POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST) request and returns its response.
-        The method will populate request cookies from the context and update context cookies from the response. The method will
-        automatically follow redirects.
+        Sends HTTP(S) [POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST) request and returns its
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
+
+        **Usage**
 
         JSON objects can be passed directly to the request:
 
@@ -15994,7 +17305,8 @@ async def post(
         ```
 
         To send form data to the server use `form` option. Its value will be encoded into the request body with
-        `application/x-www-form-urlencoded` encoding (see below how to use `multipart/form-data` form encoding to send files):
+        `application/x-www-form-urlencoded` encoding (see below how to use `multipart/form-data` form encoding to send
+        files):
 
         ```python
         formData = {
@@ -16028,22 +17340,24 @@ async def post(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -16091,10 +17405,11 @@ async def fetch(
     ) -> "APIResponse":
         """APIRequestContext.fetch
 
-        Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and update
-        context cookies from the response. The method will automatically follow redirects.
+        Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and
+        update context cookies from the response. The method will automatically follow redirects. JSON objects can be
+        passed directly to the request.
 
-        JSON objects can be passed directly to the request:
+        **Usage**
 
         ```python
         data = {
@@ -16132,22 +17447,24 @@ async def fetch(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -16180,8 +17497,8 @@ async def storage_state(
     ) -> StorageState:
         """APIRequestContext.storage_state
 
-        Returns storage state for this request context, contains current cookies and local storage snapshot if it was passed to
-        the constructor.
+        Returns storage state for this request context, contains current cookies and local storage snapshot if it was
+        passed to the constructor.
 
         Parameters
         ----------
@@ -16241,12 +17558,13 @@ async def new_context(
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         timeout : Union[float, None]
-            Maximum time in milliseconds to wait for the response. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
+            Maximum time in milliseconds to wait for the response. Defaults to `30000` (30 seconds). Pass `0` to disable
+            timeout.
         storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
-            Populates context with given storage state. This option can be used to initialize context with logged-in information
-            obtained via `browser_context.storage_state()` or `a_pi_request_context.storage_state()`. Either a path to the
-            file with saved storage, or the value returned by one of `browser_context.storage_state()` or
-            `a_pi_request_context.storage_state()` methods.
+            Populates context with given storage state. This option can be used to initialize context with logged-in
+            information obtained via `browser_context.storage_state()` or `a_pi_request_context.storage_state()`.
+            Either a path to the file with saved storage, or the value returned by one of
+            `browser_context.storage_state()` or `a_pi_request_context.storage_state()` methods.
 
         Returns
         -------
@@ -16281,6 +17599,8 @@ async def to_have_title(
 
         Ensures the page has the given title.
 
+        **Usage**
+
         ```py
         import re
         from playwright.async_api import expect
@@ -16289,6 +17609,14 @@ async def to_have_title(
         await expect(page).to_have_title(re.compile(r\".*checkout\"))
         ```
 
+        ```py
+        import re
+        from playwright.sync_api import expect
+
+        # ...
+        expect(page).to_have_title(re.compile(r\".*checkout\"))
+        ```
+
         Parameters
         ----------
         title_or_reg_exp : Union[Pattern[str], str]
@@ -16339,6 +17667,8 @@ async def to_have_url(
 
         Ensures the page is navigated to the given URL.
 
+        **Usage**
+
         ```py
         import re
         from playwright.async_api import expect
@@ -16347,6 +17677,14 @@ async def to_have_url(
         await expect(page).to_have_url(re.compile(\".*checkout\"))
         ```
 
+        ```py
+        import re
+        from playwright.sync_api import expect
+
+        # ...
+        expect(page).to_have_url(re.compile(\".*checkout\"))
+        ```
+
         Parameters
         ----------
         url_or_reg_exp : Union[Pattern[str], str]
@@ -16395,6 +17733,8 @@ class LocatorAssertions(AsyncBase):
     async def to_contain_text(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -16406,8 +17746,10 @@ async def to_contain_text(
     ) -> None:
         """LocatorAssertions.to_contain_text
 
-        Ensures the `Locator` points to an element that contains the given text. You can use regular expressions for the value
-        as well.
+        Ensures the `Locator` points to an element that contains the given text. You can use regular expressions for the
+        value as well.
+
+        **Usage**
 
         ```py
         import re
@@ -16418,6 +17760,15 @@ async def to_contain_text(
         await expect(locator).to_contain_text(re.compile(r\"\\d messages\"))
         ```
 
+        ```py
+        import re
+        from playwright.sync_api import expect
+
+        locator = page.locator('.title')
+        expect(locator).to_contain_text(\"substring\")
+        expect(locator).to_contain_text(re.compile(r\"\\d messages\"))
+        ```
+
         If you pass an array as an expected value, the expectations are:
         1. Locator resolves to a list of elements.
         1. Elements from a **subset** of this list contain text from the expected array, respectively.
@@ -16452,9 +17803,25 @@ async def to_contain_text(
         await expect(page.locator(\"ul\")).to_contain_text([\"Text 3\"])
         ```
 
+        ```py
+        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\"])
+
+        # ✖ Wrong order
+        expect(page.locator(\"ul > li\")).to_contain_text([\"Text 3\", \"Text 2\"])
+
+        # ✖ No item contains this text
+        expect(page.locator(\"ul > li\")).to_contain_text([\"Some 33\"])
+
+        # ✖ Locator points to the outer list element, not to the list items
+        expect(page.locator(\"ul\")).to_contain_text([\"Text 3\"])
+        ```
+
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -16478,6 +17845,8 @@ async def to_contain_text(
     async def not_to_contain_text(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -16493,7 +17862,7 @@ async def not_to_contain_text(
 
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -16525,6 +17894,8 @@ async def to_have_attribute(
 
         Ensures the `Locator` points to an element with given attribute.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
@@ -16532,6 +17903,13 @@ async def to_have_attribute(
         await expect(locator).to_have_attribute(\"type\", \"text\")
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"input\")
+        expect(locator).to_have_attribute(\"type\", \"text\")
+        ```
+
         Parameters
         ----------
         name : str
@@ -16580,6 +17958,8 @@ async def not_to_have_attribute(
     async def to_have_class(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -16592,6 +17972,8 @@ async def to_have_class(
         Ensures the `Locator` points to an element with given CSS classes. This needs to be a full match or using a relaxed
         regular expression.
 
+        **Usage**
+
         ```html
         <div class='selected row' id='component'></div>
         ```
@@ -16604,6 +17986,14 @@ async def to_have_class(
         await expect(locator).to_have_class(\"selected row\")
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"#component\")
+        expect(locator).to_have_class(re.compile(r\"selected\"))
+        expect(locator).to_have_class(\"selected row\")
+        ```
+
         Note that if array is passed as an expected value, entire lists of elements can be asserted:
 
         ```py
@@ -16613,9 +18003,16 @@ async def to_have_class(
         await expect(locator).to_have_class([\"component\", \"component selected\", \"component\"])
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"list > .component\")
+        expect(locator).to_have_class([\"component\", \"component selected\", \"component\"])
+        ```
+
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
             Time to retry the assertion for.
@@ -16631,6 +18028,8 @@ async def to_have_class(
     async def not_to_have_class(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -16644,7 +18043,7 @@ async def not_to_have_class(
 
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
             Time to retry the assertion for.
@@ -16664,6 +18063,8 @@ async def to_have_count(
 
         Ensures the `Locator` resolves to an exact number of DOM nodes.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
@@ -16671,6 +18072,13 @@ async def to_have_count(
         await expect(locator).to_have_count(3)
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"list > .component\")
+        expect(locator).to_have_count(3)
+        ```
+
         Parameters
         ----------
         count : int
@@ -16715,6 +18123,8 @@ async def to_have_css(
 
         Ensures the `Locator` resolves to an element with the given computed CSS style.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
@@ -16722,6 +18132,13 @@ async def to_have_css(
         await expect(locator).to_have_css(\"display\", \"flex\")
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.get_by_role(\"button\")
+        expect(locator).to_have_css(\"display\", \"flex\")
+        ```
+
         Parameters
         ----------
         name : str
@@ -16775,6 +18192,8 @@ async def to_have_id(
 
         Ensures the `Locator` points to an element with the given DOM Node ID.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
@@ -16782,6 +18201,13 @@ async def to_have_id(
         await expect(locator).to_have_id(\"lastname\")
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.get_by_role(\"textbox\")
+        expect(locator).to_have_id(\"lastname\")
+        ```
+
         Parameters
         ----------
         id : Union[Pattern[str], str]
@@ -16823,8 +18249,10 @@ async def to_have_js_property(
     ) -> None:
         """LocatorAssertions.to_have_js_property
 
-        Ensures the `Locator` points to an element with given JavaScript property. Note that this property can be of a primitive
-        type as well as a plain serializable JavaScript object.
+        Ensures the `Locator` points to an element with given JavaScript property. Note that this property can be of a
+        primitive type as well as a plain serializable JavaScript object.
+
+        **Usage**
 
         ```py
         from playwright.async_api import expect
@@ -16833,6 +18261,13 @@ async def to_have_js_property(
         await expect(locator).to_have_js_property(\"loaded\", True)
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator(\".component\")
+        expect(locator).to_have_js_property(\"loaded\", True)
+        ```
+
         Parameters
         ----------
         name : str
@@ -16882,8 +18317,10 @@ async def to_have_value(
     ) -> None:
         """LocatorAssertions.to_have_value
 
-        Ensures the `Locator` points to an element with the given input value. You can use regular expressions for the value as
-        well.
+        Ensures the `Locator` points to an element with the given input value. You can use regular expressions for the
+        value as well.
+
+        **Usage**
 
         ```py
         import re
@@ -16893,6 +18330,14 @@ async def to_have_value(
         await expect(locator).to_have_value(re.compile(r\"[0-9]\"))
         ```
 
+        ```py
+        import re
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"input[type=number]\")
+        expect(locator).to_have_value(re.compile(r\"[0-9]\"))
+        ```
+
         Parameters
         ----------
         value : Union[Pattern[str], str]
@@ -16931,14 +18376,20 @@ async def not_to_have_value(
 
     async def to_have_values(
         self,
-        values: typing.List[typing.Union[typing.Pattern[str], str]],
+        values: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
+            typing.List[typing.Union[typing.Pattern[str], str]],
+        ],
         *,
         timeout: typing.Optional[float] = None
     ) -> None:
         """LocatorAssertions.to_have_values
 
-        Ensures the `Locator` points to multi-select/combobox (i.e. a `select` with the `multiple` attribute) and the specified
-        values are selected.
+        Ensures the `Locator` points to multi-select/combobox (i.e. a `select` with the `multiple` attribute) and the
+        specified values are selected.
+
+        **Usage**
 
         For example, given the following element:
 
@@ -16959,9 +18410,18 @@ async def to_have_values(
         await expect(locator).to_have_values([re.compile(r\"R\"), re.compile(r\"G\")])
         ```
 
+        ```py
+        import re
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"id=favorite-colors\")
+        locator.select_option([\"R\", \"G\"])
+        expect(locator).to_have_values([re.compile(r\"R\"), re.compile(r\"G\")])
+        ```
+
         Parameters
         ----------
-        values : List[Union[Pattern[str], str]]
+        values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
             Expected options currently selected.
         timeout : Union[float, None]
             Time to retry the assertion for.
@@ -16976,7 +18436,11 @@ async def to_have_values(
 
     async def not_to_have_values(
         self,
-        values: typing.List[typing.Union[typing.Pattern[str], str]],
+        values: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
+            typing.List[typing.Union[typing.Pattern[str], str]],
+        ],
         *,
         timeout: typing.Optional[float] = None
     ) -> None:
@@ -16986,7 +18450,7 @@ async def not_to_have_values(
 
         Parameters
         ----------
-        values : List[Union[Pattern[str], str]]
+        values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
             Expected options currently selected.
         timeout : Union[float, None]
             Time to retry the assertion for.
@@ -17002,6 +18466,8 @@ async def not_to_have_values(
     async def to_have_text(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -17013,7 +18479,10 @@ async def to_have_text(
     ) -> None:
         """LocatorAssertions.to_have_text
 
-        Ensures the `Locator` points to an element with the given text. You can use regular expressions for the value as well.
+        Ensures the `Locator` points to an element with the given text. You can use regular expressions for the value as
+        well.
+
+        **Usage**
 
         ```py
         import re
@@ -17024,6 +18493,15 @@ async def to_have_text(
         await expect(locator).to_have_text(re.compile(r\"Welcome, .*\"))
         ```
 
+        ```py
+        import re
+        from playwright.sync_api import expect
+
+        locator = page.locator(\".title\")
+        expect(locator).to_have_text(re.compile(r\"Welcome, Test User\"))
+        expect(locator).to_have_text(re.compile(r\"Welcome, .*\"))
+        ```
+
         If you pass an array as an expected value, the expectations are:
         1. Locator resolves to a list of elements.
         1. The number of elements equals the number of expected values in the array.
@@ -17057,9 +18535,25 @@ async def to_have_text(
         await expect(page.locator(\"ul\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        # ✓ Has the right items in the right order
+        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
+
+        # ✖ Wrong order
+        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 3\", \"Text 2\", \"Text 1\"])
+
+        # ✖ Last item does not match
+        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text\"])
+
+        # ✖ Locator points to the outer list element, not to the list items
+        await expect(page.locator(\"ul\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
+        ```
+
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -17083,6 +18577,8 @@ async def to_have_text(
     async def not_to_have_text(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -17098,7 +18594,7 @@ async def not_to_have_text(
 
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -17129,6 +18625,8 @@ async def to_be_checked(
 
         Ensures the `Locator` points to a checked input.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
@@ -17136,6 +18634,13 @@ async def to_be_checked(
         await expect(locator).to_be_checked()
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.get_by_label(\"Subscribe to newsletter\")
+        expect(locator).to_be_checked()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17169,11 +18674,14 @@ async def not_to_be_checked(
     async def to_be_disabled(self, *, timeout: typing.Optional[float] = None) -> None:
         """LocatorAssertions.to_be_disabled
 
-        Ensures the `Locator` points to a disabled element. Element is disabled if it has \"disabled\" attribute or is disabled
-        via ['aria-disabled'](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled). Note
+        Ensures the `Locator` points to a disabled element. Element is disabled if it has \"disabled\" attribute or is
+        disabled via
+        ['aria-disabled'](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled). Note
         that only native control elements such as HTML `button`, `input`, `select`, `textarea`, `option`, `optgroup` can be
         disabled by setting \"disabled\" attribute. \"disabled\" attribute on other elements is ignored by the browser.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
@@ -17181,6 +18689,13 @@ async def to_be_disabled(self, *, timeout: typing.Optional[float] = None) -> Non
         await expect(locator).to_be_disabled()
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"button.submit\")
+        expect(locator).to_be_disabled()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17220,6 +18735,8 @@ async def to_be_editable(
 
         Ensures the `Locator` points to an editable element.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
@@ -17227,6 +18744,13 @@ async def to_be_editable(
         await expect(locator).to_be_editable()
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.get_by_role(\"textbox\")
+        expect(locator).to_be_editable()
+        ```
+
         Parameters
         ----------
         editable : Union[bool, None]
@@ -17266,6 +18790,8 @@ async def to_be_empty(self, *, timeout: typing.Optional[float] = None) -> None:
 
         Ensures the `Locator` points to an empty editable element or to a DOM node that has no text.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
@@ -17273,6 +18799,13 @@ async def to_be_empty(self, *, timeout: typing.Optional[float] = None) -> None:
         await expect(locator).to_be_empty()
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"div.warning\")
+        expect(locator).to_be_empty()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17310,6 +18843,8 @@ async def to_be_enabled(
 
         Ensures the `Locator` points to an enabled element.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
@@ -17317,6 +18852,13 @@ async def to_be_enabled(
         await expect(locator).to_be_enabled()
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"button.submit\")
+        expect(locator).to_be_enabled()
+        ```
+
         Parameters
         ----------
         enabled : Union[bool, None]
@@ -17355,7 +18897,9 @@ async def to_be_hidden(self, *, timeout: typing.Optional[float] = None) -> None:
         """LocatorAssertions.to_be_hidden
 
         Ensures that `Locator` either does not resolve to any DOM node, or resolves to a
-        [non-visible](https://playwright.dev/python/docs/api/actionability#visible) one.
+        [non-visible](https://playwright.dev/python/docs/actionability#visible) one.
+
+        **Usage**
 
         ```py
         from playwright.async_api import expect
@@ -17364,6 +18908,13 @@ async def to_be_hidden(self, *, timeout: typing.Optional[float] = None) -> None:
         await expect(locator).to_be_hidden()
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator('.my-element')
+        expect(locator).to_be_hidden()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17399,8 +18950,10 @@ async def to_be_visible(
     ) -> None:
         """LocatorAssertions.to_be_visible
 
-        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/api/actionability#attached) and [visible](https://playwright.dev/python/docs/api/actionability#visible)
-        DOM node.
+        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/actionability#attached) and
+        [visible](https://playwright.dev/python/docs/actionability#visible) DOM node.
+
+        **Usage**
 
         ```py
         from playwright.async_api import expect
@@ -17409,6 +18962,13 @@ async def to_be_visible(
         await expect(locator).to_be_visible()
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator('.my-element')
+        expect(locator).to_be_visible()
+        ```
+
         Parameters
         ----------
         visible : Union[bool, None]
@@ -17448,6 +19008,8 @@ async def to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None
 
         Ensures the `Locator` points to a focused DOM node.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
@@ -17455,6 +19017,13 @@ async def to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None
         await expect(locator).to_be_focused()
         ```
 
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.get_by_role(\"textbox\")
+        expect(locator).to_be_focused()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17494,12 +19063,22 @@ async def to_be_ok(self) -> None:
 
         Ensures the response status code is within `200..299` range.
 
+        **Usage**
+
         ```py
         from playwright.async_api import expect
 
         # ...
         await expect(response).to_be_ok()
         ```
+
+        ```py
+        import re
+        from playwright.sync_api import expect
+
+        # ...
+        expect(response).to_be_ok()
+        ```
         """
         __tracebackhide__ = True
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 221f0b4ad..cb0955615 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -103,8 +103,8 @@ def resource_type(self) -> str:
         """Request.resource_type
 
         Contains the request's resource type as it was perceived by the rendering engine. ResourceType will be one of the
-        following: `document`, `stylesheet`, `image`, `media`, `font`, `script`, `texttrack`, `xhr`, `fetch`, `eventsource`,
-        `websocket`, `manifest`, `other`.
+        following: `document`, `stylesheet`, `image`, `media`, `font`, `script`, `texttrack`, `xhr`, `fetch`,
+        `eventsource`, `websocket`, `manifest`, `other`.
 
         Returns
         -------
@@ -181,12 +181,19 @@ def redirected_from(self) -> typing.Optional["Request"]:
 
         Request that was redirected by the server to this one, if any.
 
-        When the server responds with a redirect, Playwright creates a new `Request` object. The two requests are connected by
-        `redirectedFrom()` and `redirectedTo()` methods. When multiple server redirects has happened, it is possible to
+        When the server responds with a redirect, Playwright creates a new `Request` object. The two requests are connected
+        by `redirectedFrom()` and `redirectedTo()` methods. When multiple server redirects has happened, it is possible to
         construct the whole redirect chain by repeatedly calling `redirectedFrom()`.
 
+        **Usage**
+
         For example, if the website `http://example.com` redirects to `https://example.com`:
 
+        ```py
+        response = await page.goto(\"http://example.com\")
+        print(response.request.redirected_from.url) # \"http://example.com\"
+        ```
+
         ```py
         response = page.goto(\"http://example.com\")
         print(response.request.redirected_from.url) # \"http://example.com\"
@@ -194,6 +201,11 @@ def redirected_from(self) -> typing.Optional["Request"]:
 
         If the website `https://google.com` has no redirects:
 
+        ```py
+        response = await page.goto(\"https://google.com\")
+        print(response.request.redirected_from) # None
+        ```
+
         ```py
         response = page.goto(\"https://google.com\")
         print(response.request.redirected_from) # None
@@ -211,6 +223,8 @@ def redirected_to(self) -> typing.Optional["Request"]:
 
         New request issued by the browser if the server responded with redirect.
 
+        **Usage**
+
         This method is the opposite of `request.redirected_from()`:
 
         ```py
@@ -229,6 +243,8 @@ def failure(self) -> typing.Optional[str]:
 
         The method returns `null` unless this request has failed, as reported by `requestfailed` event.
 
+        **Usage**
+
         Example of logging of all the failed requests:
 
         ```py
@@ -245,10 +261,19 @@ def failure(self) -> typing.Optional[str]:
     def timing(self) -> ResourceTiming:
         """Request.timing
 
-        Returns resource timing information for given request. Most of the timing values become available upon the response,
-        `responseEnd` becomes available when request finishes. Find more information at
+        Returns resource timing information for given request. Most of the timing values become available upon the
+        response, `responseEnd` becomes available when request finishes. Find more information at
         [Resource Timing API](https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming).
 
+        **Usage**
+
+        ```py
+        async with page.expect_event(\"requestfinished\") as request_info:
+            await page.goto(\"http://example.com\")
+        request = await request_info.value
+        print(request.timing)
+        ```
+
         ```py
         with page.expect_event(\"requestfinished\") as request_info:
             page.goto(\"http://example.com\")
@@ -267,8 +292,8 @@ def headers(self) -> typing.Dict[str, str]:
         """Request.headers
 
         An object with the request HTTP headers. The header names are lower-cased. Note that this method does not return
-        security-related headers, including cookie-related ones. You can use `request.all_headers()` for complete list of
-        headers that include `cookie` information.
+        security-related headers, including cookie-related ones. You can use `request.all_headers()` for complete
+        list of headers that include `cookie` information.
 
         Returns
         -------
@@ -327,8 +352,9 @@ def all_headers(self) -> typing.Dict[str, str]:
     def headers_array(self) -> typing.List[NameValue]:
         """Request.headers_array
 
-        An array with all the request HTTP headers associated with this request. Unlike `request.all_headers()`, header
-        names are NOT lower-cased. Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
+        An array with all the request HTTP headers associated with this request. Unlike `request.all_headers()`,
+        header names are NOT lower-cased. Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple
+        times.
 
         Returns
         -------
@@ -414,8 +440,8 @@ def headers(self) -> typing.Dict[str, str]:
         """Response.headers
 
         An object with the response HTTP headers. The header names are lower-cased. Note that this method does not return
-        security-related headers, including cookie-related ones. You can use `response.all_headers()` for complete list
-        of headers that include `cookie` information.
+        security-related headers, including cookie-related ones. You can use `response.all_headers()` for complete
+        list of headers that include `cookie` information.
 
         Returns
         -------
@@ -475,8 +501,9 @@ def all_headers(self) -> typing.Dict[str, str]:
     def headers_array(self) -> typing.List[NameValue]:
         """Response.headers_array
 
-        An array with all the request HTTP headers associated with this response. Unlike `response.all_headers()`, header
-        names are NOT lower-cased. Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
+        An array with all the request HTTP headers associated with this response. Unlike `response.all_headers()`,
+        header names are NOT lower-cased. Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple
+        times.
 
         Returns
         -------
@@ -488,9 +515,9 @@ def headers_array(self) -> typing.List[NameValue]:
     def header_value(self, name: str) -> typing.Optional[str]:
         """Response.header_value
 
-        Returns the value of the header matching the name. The name is case insensitive. If multiple headers have the same name
-        (except `set-cookie`), they are returned as a list separated by `, `. For `set-cookie`, the `\\n` separator is used. If
-        no headers are found, `null` is returned.
+        Returns the value of the header matching the name. The name is case insensitive. If multiple headers have the same
+        name (except `set-cookie`), they are returned as a list separated by `, `. For `set-cookie`, the `\\n` separator is
+        used. If no headers are found, `null` is returned.
 
         Parameters
         ----------
@@ -623,11 +650,11 @@ def abort(self, error_code: typing.Optional[str] = None) -> None:
             Optional error code. Defaults to `failed`, could be one of the following:
             - `'aborted'` - An operation was aborted (due to user action)
             - `'accessdenied'` - Permission to access a resource, other than the network, was denied
-            - `'addressunreachable'` - The IP address is unreachable. This usually means that there is no route to the specified
-              host or network.
+            - `'addressunreachable'` - The IP address is unreachable. This usually means that there is no route to the
+              specified host or network.
             - `'blockedbyclient'` - The client chose to block the request.
-            - `'blockedbyresponse'` - The request failed because the response was delivered along with requirements which are not
-              met ('X-Frame-Options' and 'Content-Security-Policy' ancestor checks, for instance).
+            - `'blockedbyresponse'` - The request failed because the response was delivered along with requirements which are
+              not met ('X-Frame-Options' and 'Content-Security-Policy' ancestor checks, for instance).
             - `'connectionaborted'` - A connection timed out as a result of not receiving an ACK for data sent.
             - `'connectionclosed'` - A connection was closed (corresponding to a TCP FIN).
             - `'connectionfailed'` - A connection attempt failed.
@@ -657,8 +684,17 @@ def fulfill(
 
         Fulfills route's request with given response.
 
+        **Usage**
+
         An example of fulfilling all requests with 404 responses:
 
+        ```py
+        await page.route(\"**/*\", lambda route: route.fulfill(
+            status=404,
+            content_type=\"text/plain\",
+            body=\"not found!\"))
+        ```
+
         ```py
         page.route(\"**/*\", lambda route: route.fulfill(
             status=404,
@@ -668,6 +704,10 @@ def fulfill(
 
         An example of serving static file:
 
+        ```py
+        await page.route(\"**/xhr_endpoint\", lambda route: route.fulfill(path=\"mock_data.json\"))
+        ```
+
         ```py
         page.route(\"**/xhr_endpoint\", lambda route: route.fulfill(path=\"mock_data.json\"))
         ```
@@ -681,13 +721,13 @@ def fulfill(
         body : Union[bytes, str, None]
             Response body.
         path : Union[pathlib.Path, str, None]
-            File path to respond with. The content type will be inferred from file extension. If `path` is a relative path, then it
-            is resolved relative to the current working directory.
+            File path to respond with. The content type will be inferred from file extension. If `path` is a relative path,
+            then it is resolved relative to the current working directory.
         content_type : Union[str, None]
             If set, equals to setting `Content-Type` response header.
         response : Union[APIResponse, None]
-            `APIResponse` to fulfill route's request with. Individual fields of the response (such as headers) can be overridden
-            using fulfill options.
+            `APIResponse` to fulfill route's request with. Individual fields of the response (such as headers) can be
+            overridden using fulfill options.
         """
 
         return mapping.from_maybe_impl(
@@ -713,19 +753,48 @@ def fallback(
     ) -> None:
         """Route.fallback
 
-        When several routes match the given pattern, they run in the order opposite to their registration. That way the last
-        registered route can always override all the previous ones. In the example below, request will be handled by the
-        bottom-most handler first, then it'll fall back to the previous one and in the end will be aborted by the first
+        When several routes match the given pattern, they run in the order opposite to their registration. That way the
+        last registered route can always override all the previous ones. In the example below, request will be handled by
+        the bottom-most handler first, then it'll fall back to the previous one and in the end will be aborted by the first
         registered route.
 
+        **Usage**
+
+        ```py
+        await page.route(\"**/*\", lambda route: route.abort())  # Runs last.
+        await page.route(\"**/*\", lambda route: route.fallback())  # Runs second.
+        await page.route(\"**/*\", lambda route: route.fallback())  # Runs first.
+        ```
+
         ```py
         page.route(\"**/*\", lambda route: route.abort())  # Runs last.
         page.route(\"**/*\", lambda route: route.fallback())  # Runs second.
         page.route(\"**/*\", lambda route: route.fallback())  # Runs first.
         ```
 
-        Registering multiple routes is useful when you want separate handlers to handle different kinds of requests, for example
-        API calls vs page resources or GET requests vs POST requests as in the example below.
+        Registering multiple routes is useful when you want separate handlers to handle different kinds of requests, for
+        example API calls vs page resources or GET requests vs POST requests as in the example below.
+
+        ```py
+        # Handle GET requests.
+        def handle_post(route):
+            if route.request.method != \"GET\":
+                route.fallback()
+                return
+          # Handling GET only.
+          # ...
+
+        # Handle POST requests.
+        def handle_post(route):
+            if route.request.method != \"POST\":
+                route.fallback()
+                return
+          # Handling POST only.
+          # ...
+
+        await page.route(\"**/*\", handle_get)
+        await page.route(\"**/*\", handle_post)
+        ```
 
         ```py
         # Handle GET requests.
@@ -748,8 +817,21 @@ def handle_post(route):
         page.route(\"**/*\", handle_post)
         ```
 
-        One can also modify request while falling back to the subsequent handler, that way intermediate route handler can modify
-        url, method, headers and postData of the request.
+        One can also modify request while falling back to the subsequent handler, that way intermediate route handler can
+        modify url, method, headers and postData of the request.
+
+        ```py
+        async def handle(route, request):
+            # override headers
+            headers = {
+                **request.headers,
+                \"foo\": \"foo-value\" # set \"foo\" header
+                \"bar\": None # remove \"bar\" header
+            }
+            await route.fallback(headers=headers)
+        }
+        await page.route(\"**/*\", handle)
+        ```
 
         ```py
         def handle(route, request):
@@ -767,8 +849,8 @@ def handle(route, request):
         Parameters
         ----------
         url : Union[str, None]
-            If set changes the request URL. New URL must have same protocol as original one. Changing the URL won't affect the route
-            matching, all the routes are matched using the original request URL.
+            If set changes the request URL. New URL must have same protocol as original one. Changing the URL won't affect the
+            route matching, all the routes are matched using the original request URL.
         method : Union[str, None]
             If set changes the request method (e.g. GET or POST)
         headers : Union[Dict[str, str], None]
@@ -800,6 +882,21 @@ def continue_(
 
         Continues route's request with optional overrides.
 
+        **Usage**
+
+        ```py
+        async def handle(route, request):
+            # override headers
+            headers = {
+                **request.headers,
+                \"foo\": \"foo-value\" # set \"foo\" header
+                \"bar\": None # remove \"bar\" header
+            }
+            await route.continue_(headers=headers)
+        }
+        await page.route(\"**/*\", handle)
+        ```
+
         ```py
         def handle(route, request):
             # override headers
@@ -938,8 +1035,8 @@ def expect_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()`.
+            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
         -------
@@ -961,11 +1058,11 @@ def wait_for_event(
     ) -> typing.Any:
         """WebSocket.wait_for_event
 
-        > NOTE: In most cases, you should use `web_socket.expect_event()`.
+        **NOTE** In most cases, you should use `web_socket.expect_event()`.
 
-        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function and
-        waits for `predicate(event)` to return a truthy value. Will throw an error if the socket is closed before the `event` is
-        fired.
+        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function
+        and waits for `predicate(event)` to return a truthy value. Will throw an error if the socket is closed before the
+        `event` is fired.
 
         Parameters
         ----------
@@ -974,8 +1071,8 @@ def wait_for_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()`.
+            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
         -------
@@ -1014,12 +1111,14 @@ def down(self, key: str) -> None:
 
         Dispatches a `keydown` event.
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -1028,14 +1127,14 @@ def down(self, key: str) -> None:
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        If `key` is a modifier key, `Shift`, `Meta`, `Control`, or `Alt`, subsequent key presses will be sent with that modifier
-        active. To release the modifier key, use `keyboard.up()`.
+        If `key` is a modifier key, `Shift`, `Meta`, `Control`, or `Alt`, subsequent key presses will be sent with that
+        modifier active. To release the modifier key, use `keyboard.up()`.
 
         After the key is pressed once, subsequent calls to `keyboard.down()` will have
-        [repeat](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/repeat) set to true. To release the key, use
-        `keyboard.up()`.
+        [repeat](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/repeat) set to true. To release the key,
+        use `keyboard.up()`.
 
-        > NOTE: Modifier keys DO influence `keyboard.down`. Holding down `Shift` will type the text in upper case.
+        **NOTE** Modifier keys DO influence `keyboard.down`. Holding down `Shift` will type the text in upper case.
 
         Parameters
         ----------
@@ -1063,11 +1162,18 @@ def insert_text(self, text: str) -> None:
 
         Dispatches only `input` event, does not emit the `keydown`, `keyup` or `keypress` events.
 
+        **Usage**
+
+        ```py
+        await page.keyboard.insert_text(\"嗨\")
+        ```
+
         ```py
         page.keyboard.insert_text(\"嗨\")
         ```
 
-        > NOTE: Modifier keys DO NOT effect `keyboard.insertText`. Holding down `Shift` will not type the text in upper case.
+        **NOTE** Modifier keys DO NOT effect `keyboard.insertText`. Holding down `Shift` will not type the text in upper
+        case.
 
         Parameters
         ----------
@@ -1086,13 +1192,21 @@ def type(self, text: str, *, delay: typing.Optional[float] = None) -> None:
 
         To press a special key, like `Control` or `ArrowDown`, use `keyboard.press()`.
 
+        **Usage**
+
+        ```py
+        await page.keyboard.type(\"Hello\") # types instantly
+        await page.keyboard.type(\"World\", delay=100) # types slower, like a user
+        ```
+
         ```py
         page.keyboard.type(\"Hello\") # types instantly
         page.keyboard.type(\"World\", delay=100) # types slower, like a user
         ```
 
-        > NOTE: Modifier keys DO NOT effect `keyboard.type`. Holding down `Shift` will not type the text in upper case.
-        > NOTE: For characters that are not on a US keyboard, only an `input` event will be sent.
+        **NOTE** Modifier keys DO NOT effect `keyboard.type`. Holding down `Shift` will not type the text in upper case.
+
+        **NOTE** For characters that are not on a US keyboard, only an `input` event will be sent.
 
         Parameters
         ----------
@@ -1109,12 +1223,14 @@ def type(self, text: str, *, delay: typing.Optional[float] = None) -> None:
     def press(self, key: str, *, delay: typing.Optional[float] = None) -> None:
         """Keyboard.press
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -1126,6 +1242,20 @@ def press(self, key: str, *, delay: typing.Optional[float] = None) -> None:
         Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
         modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
+        **Usage**
+
+        ```py
+        page = await browser.new_page()
+        await page.goto(\"https://keycode.info\")
+        await page.keyboard.press(\"a\")
+        await page.screenshot(path=\"a.png\")
+        await page.keyboard.press(\"ArrowLeft\")
+        await page.screenshot(path=\"arrow_left.png\")
+        await page.keyboard.press(\"Shift+O\")
+        await page.screenshot(path=\"o.png\")
+        await browser.close()
+        ```
+
         ```py
         page = browser.new_page()
         page.goto(\"https://keycode.info\")
@@ -1283,8 +1413,8 @@ def wheel(self, delta_x: float, delta_y: float) -> None:
 
         Dispatches a `wheel` event.
 
-        > NOTE: Wheel events may cause scrolling if they are not handled, and this method does not wait for the scrolling to
-        finish before returning.
+        **NOTE** Wheel events may cause scrolling if they are not handled, and this method does not wait for the scrolling
+        to finish before returning.
 
         Parameters
         ----------
@@ -1330,9 +1460,15 @@ def evaluate(
 
         This method passes this handle as the first argument to `expression`.
 
-        If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its value.
+        If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its
+        value.
 
-        Examples:
+        **Usage**
+
+        ```py
+        tweet_handle = await page.query_selector(\".tweet .retweets\")
+        assert await tweet_handle.evaluate(\"node => node.innerText\") == \"10 retweets\"
+        ```
 
         ```py
         tweet_handle = page.query_selector(\".tweet .retweets\")
@@ -1342,8 +1478,8 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -1367,19 +1503,19 @@ def evaluate_handle(
 
         This method passes this handle as the first argument to `expression`.
 
-        The only difference between `jsHandle.evaluate` and `jsHandle.evaluateHandle` is that `jsHandle.evaluateHandle` returns
-        `JSHandle`.
+        The only difference between `jsHandle.evaluate` and `jsHandle.evaluateHandle` is that `jsHandle.evaluateHandle`
+        returns `JSHandle`.
 
-        If the function passed to the `jsHandle.evaluateHandle` returns a [Promise], then `jsHandle.evaluateHandle` would wait
-        for the promise to resolve and return its value.
+        If the function passed to the `jsHandle.evaluateHandle` returns a [Promise], then `jsHandle.evaluateHandle` would
+        wait for the promise to resolve and return its value.
 
         See `page.evaluate_handle()` for more details.
 
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -1420,6 +1556,16 @@ def get_properties(self) -> typing.Dict[str, "JSHandle"]:
 
         The method returns a map with **own property names** as keys and JSHandle instances for the property values.
 
+        **Usage**
+
+        ```py
+        handle = await page.evaluate_handle(\"({window, document})\")
+        properties = await handle.get_properties()
+        window_handle = properties.get(\"window\")
+        document_handle = properties.get(\"document\")
+        await handle.dispose()
+        ```
+
         ```py
         handle = page.evaluate_handle(\"({window, document})\")
         properties = handle.get_properties()
@@ -1460,8 +1606,8 @@ def json_value(self) -> typing.Any:
 
         Returns a JSON representation of the object. If the object has a `toJSON` function, it **will not be called**.
 
-        > NOTE: The method will return an empty JSON object if the referenced object is not stringifiable. It will throw an
-        error if the object has circular references.
+        **NOTE** The method will return an empty JSON object if the referenced object is not stringifiable. It will throw
+        an error if the object has circular references.
 
         Returns
         -------
@@ -1647,12 +1793,18 @@ def dispatch_event(
         `click` is dispatched. This is equivalent to calling
         [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
 
+        **Usage**
+
+        ```py
+        await element_handle.dispatch_event(\"click\")
+        ```
+
         ```py
         element_handle.dispatch_event(\"click\")
         ```
 
-        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties
-        and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
+        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
+        properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
@@ -1665,6 +1817,12 @@ def dispatch_event(
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
+        ```py
+        # note you can only create data_transfer in chromium and firefox
+        data_transfer = await page.evaluate_handle(\"new DataTransfer()\")
+        await element_handle.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
+        ```
+
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = page.evaluate_handle(\"new DataTransfer()\")
@@ -1692,8 +1850,8 @@ def scroll_into_view_if_needed(
     ) -> None:
         """ElementHandle.scroll_into_view_if_needed
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then tries to scroll element into view, unless it is
-        completely visible as defined by
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then tries to scroll element into view, unless
+        it is completely visible as defined by
         [IntersectionObserver](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)'s `ratio`.
 
         Throws when `elementHandle` does not point to an element
@@ -1702,8 +1860,8 @@ def scroll_into_view_if_needed(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -1732,29 +1890,29 @@ def hover(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -1795,17 +1953,17 @@ def click(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -1813,17 +1971,17 @@ def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -1862,40 +2020,40 @@ def dblclick(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if the
-           first click of the `dblclick()` triggers a navigation event, this method will throw.
+        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
+           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `elementHandle.dblclick()` dispatches two `click` events and a single `dblclick` event.
+        **NOTE** `elementHandle.dblclick()` dispatches two `click` events and a single `dblclick` event.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -1928,17 +2086,29 @@ def select_option(
     ) -> typing.List[str]:
         """ElementHandle.select_option
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in the
-        `<select>` element and selects these options.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in
+        the `<select>` element and selects these options.
 
-        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside the
-        `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used instead.
+        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside
+        the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used
+        instead.
 
         Returns the array of option values that have been successfully selected.
 
         Triggers a `change` and `input` event once all the provided options have been selected.
 
+        **Usage**
+
+        ```py
+        # single selection matching the value
+        await handle.select_option(\"blue\")
+        # single selection matching the label
+        await handle.select_option(label=\"blue\")
+        # multiple selection
+        await handle.select_option(value=[\"red\", \"green\", \"blue\"])
+        ```
+
         ```py
         # single selection matching the value
         handle.select_option(\"blue\")
@@ -1951,24 +2121,24 @@ def select_option(
         Parameters
         ----------
         value : Union[List[str], str, None]
-            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         index : Union[List[int], int, None]
             Options to select by index. Optional.
         label : Union[List[str], str, None]
-            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
 
         Returns
         -------
@@ -2011,31 +2181,31 @@ def tap(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `elementHandle.tap()` requires that the `hasTouch` option of the browser context be set to true.
+        **NOTE** `elementHandle.tap()` requires that the `hasTouch` option of the browser context be set to true.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -2061,11 +2231,11 @@ def fill(
     ) -> None:
         """ElementHandle.fill
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an `input`
-        event after filling. Note that you can pass an empty string to clear the input field.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an
+        `input` event after filling. Note that you can pass an empty string to clear the input field.
 
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an
+        error. However, if the element is inside the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
@@ -2076,12 +2246,12 @@ def fill(
         value : str
             Value to set for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -2102,20 +2272,20 @@ def select_text(
     ) -> None:
         """ElementHandle.select_text
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then focuses the element and selects all its text
-        content.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then focuses the element and selects all its
+        text content.
 
         If the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), focuses and selects text in the
-        control instead.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), focuses and selects text in
+        the control instead.
 
         Parameters
         ----------
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -2128,13 +2298,14 @@ def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
 
         Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the
+        control.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -2160,24 +2331,24 @@ def set_input_files(
     ) -> None:
         """ElementHandle.set_input_files
 
-        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
-        are resolved relative to the current working directory. For empty array, clears the selected files.
+        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
+        they are resolved relative to the current working directory. For empty array, clears the selected files.
 
         This method expects `ElementHandle` to point to an
-        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
-        `<label>` element that has an associated
+        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
+        the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
 
         Parameters
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -2208,10 +2379,18 @@ def type(
     ) -> None:
         """ElementHandle.type
 
-        Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text.
+        Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the
+        text.
 
         To press a special key, like `Control` or `ArrowDown`, use `element_handle.press()`.
 
+        **Usage**
+
+        ```py
+        await element_handle.type(\"hello\") # types instantly
+        await element_handle.type(\"world\", delay=100) # types slower, like a user
+        ```
+
         ```py
         element_handle.type(\"hello\") # types instantly
         element_handle.type(\"world\", delay=100) # types slower, like a user
@@ -2219,6 +2398,12 @@ def type(
 
         An example of typing into a text field and then submitting the form:
 
+        ```py
+        element_handle = await page.query_selector(\"input\")
+        await element_handle.type(\"some text\")
+        await element_handle.press(\"Enter\")
+        ```
+
         ```py
         element_handle = page.query_selector(\"input\")
         element_handle.type(\"some text\")
@@ -2232,12 +2417,12 @@ def type(
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -2260,12 +2445,14 @@ def press(
 
         Focuses the element, and then uses `keyboard.down()` and `keyboard.up()`.
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -2284,12 +2471,12 @@ def press(
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -2315,35 +2502,35 @@ def set_checked(
         This method checks or unchecks an element by performing the following steps:
         1. Ensure that element is a checkbox or a radio input. If not, this method throws.
         1. If the element already has the right checked state, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -2371,8 +2558,8 @@ def check(
         """ElementHandle.check
 
         This method checks the element by performing the following steps:
-        1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already checked,
-           this method returns immediately.
+        1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already
+           checked, this method returns immediately.
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
@@ -2381,26 +2568,26 @@ def check(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -2437,26 +2624,26 @@ def uncheck(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -2478,14 +2665,21 @@ def bounding_box(self) -> typing.Optional[FloatRect]:
         calculated relative to the main frame viewport - which is usually the same as the browser window.
 
         Scrolling affects the returned bounding box, similarly to
-        [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect). That
-        means `x` and/or `y` may be negative.
+        [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
+        That means `x` and/or `y` may be negative.
 
         Elements from child frames return the bounding box relative to the main frame, unlike the
         [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
 
-        Assuming the page is static, it is safe to use bounding box coordinates to perform input. For example, the following
-        snippet should click the center of the element.
+        Assuming the page is static, it is safe to use bounding box coordinates to perform input. For example, the
+        following snippet should click the center of the element.
+
+        **Usage**
+
+        ```py
+        box = await element_handle.bounding_box()
+        await page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
+        ```
 
         ```py
         box = element_handle.bounding_box()
@@ -2515,49 +2709,49 @@ def screenshot(
         """ElementHandle.screenshot
 
         This method captures a screenshot of the page, clipped to the size and position of this particular element. If the
-        element is covered by other elements, it will not be actually visible on the screenshot. If the element is a scrollable
-        container, only the currently scrolled content will be visible on the screenshot.
+        element is covered by other elements, it will not be actually visible on the screenshot. If the element is a
+        scrollable container, only the currently scrolled content will be visible on the screenshot.
 
-        This method waits for the [actionability](https://playwright.dev/python/docs/actionability) checks, then scrolls element into view before taking a
-        screenshot. If the element is detached from DOM, the method throws an error.
+        This method waits for the [actionability](https://playwright.dev/python/docs/actionability) checks, then scrolls element into view before taking
+        a screenshot. If the element is detached from DOM, the method throws an error.
 
         Returns the buffer with the captured screenshot.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
-            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a relative
-            path, then it is resolved relative to the current working directory. If no path is provided, the image won't be saved to
-            the disk.
+            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a
+            relative path, then it is resolved relative to the current working directory. If no path is provided, the image
+            won't be saved to the disk.
         quality : Union[int, None]
             The quality of the image, between 0-100. Not applicable to `png` images.
         omit_background : Union[bool, None]
             Hides default white background and allows capturing screenshots with transparency. Not applicable to `jpeg` images.
             Defaults to `false`.
         animations : Union["allow", "disabled", None]
-            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different treatment
-            depending on their duration:
+            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different
+            treatment depending on their duration:
             - finite animations are fast-forwarded to completion, so they'll fire `transitionend` event.
             - infinite animations are canceled to initial state, and then played over after the screenshot.
 
             Defaults to `"allow"` that leaves animations untouched.
         caret : Union["hide", "initial", None]
-            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be changed.
-            Defaults to `"hide"`.
+            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be
+            changed.  Defaults to `"hide"`.
         scale : Union["css", "device", None]
-            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
-            high-dpi devices will be twice as large or even larger.
+            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this
+            will keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so
+            screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
-            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-            `#FF00FF` that completely covers its bounding box.
+            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
+            box `#FF00FF` that completely covers its bounding box.
 
         Returns
         -------
@@ -2627,14 +2821,20 @@ def eval_on_selector(
 
         Returns the return value of `expression`.
 
-        The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a first
-        argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the
-        selector, the method throws an error.
+        The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a
+        first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements
+        match the selector, the method throws an error.
 
-        If `expression` returns a [Promise], then `element_handle.eval_on_selector()` would wait for the promise to resolve
-        and return its value.
+        If `expression` returns a [Promise], then `element_handle.eval_on_selector()` would wait for the promise to
+        resolve and return its value.
+
+        **Usage**
 
-        Examples:
+        ```py
+        tweet_handle = await page.query_selector(\".tweet\")
+        assert await tweet_handle.eval_on_selector(\".like\", \"node => node.innerText\") == \"100\"
+        assert await tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") = \"10\"
+        ```
 
         ```py
         tweet_handle = page.query_selector(\".tweet\")
@@ -2647,8 +2847,8 @@ def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -2672,13 +2872,14 @@ def eval_on_selector_all(
 
         Returns the return value of `expression`.
 
-        The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array of
-        matched elements as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details.
+        The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array
+        of matched elements as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more
+        details.
 
         If `expression` returns a [Promise], then `element_handle.eval_on_selector_all()` would wait for the promise to
         resolve and return its value.
 
-        Examples:
+        **Usage**
 
         ```html
         <div class=\"feed\">
@@ -2687,6 +2888,11 @@ def eval_on_selector_all(
         </div>
         ```
 
+        ```py
+        feed_handle = await page.query_selector(\".feed\")
+        assert await feed_handle.eval_on_selector_all(\".tweet\", \"nodes => nodes.map(n => n.innerText)\") == [\"hello!\", \"hi!\"]
+        ```
+
         ```py
         feed_handle = page.query_selector(\".feed\")
         assert feed_handle.eval_on_selector_all(\".tweet\", \"nodes => nodes.map(n => n.innerText)\") == [\"hello!\", \"hi!\"]
@@ -2697,8 +2903,8 @@ def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -2731,7 +2937,8 @@ def wait_for_element_state(
         pass. This method throws when the element is detached while waiting, unless waiting for the `\"hidden\"` state.
         - `\"visible\"` Wait until the element is [visible](https://playwright.dev/python/docs/actionability#visible).
         - `\"hidden\"` Wait until the element is [not visible](https://playwright.dev/python/docs/actionability#visible) or
-          [not attached](https://playwright.dev/python/docs/actionability#attached). Note that waiting for hidden does not throw when the element detaches.
+          [not attached](https://playwright.dev/python/docs/actionability#attached). Note that waiting for hidden does not throw when the element
+          detaches.
         - `\"stable\"` Wait until the element is both [visible](https://playwright.dev/python/docs/actionability#visible) and
           [stable](https://playwright.dev/python/docs/actionability#stable).
         - `\"enabled\"` Wait until the element is [enabled](https://playwright.dev/python/docs/actionability#enabled).
@@ -2745,8 +2952,8 @@ def wait_for_element_state(
         state : Union["disabled", "editable", "enabled", "hidden", "stable", "visible"]
             A state to wait for, see below for more details.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -2770,10 +2977,19 @@ def wait_for_selector(
         Returns element specified by selector when it satisfies `state` option. Returns `null` if waiting for `hidden` or
         `detached`.
 
-        Wait for the `selector` relative to the element handle to satisfy `state` option (either appear/disappear from dom, or
-        become visible/hidden). If at the moment of calling the method `selector` already satisfies the condition, the method
-        will return immediately. If the selector doesn't satisfy the condition for the `timeout` milliseconds, the function will
-        throw.
+        Wait for the `selector` relative to the element handle to satisfy `state` option (either appear/disappear from dom,
+        or become visible/hidden). If at the moment of calling the method `selector` already satisfies the condition, the
+        method will return immediately. If the selector doesn't satisfy the condition for the `timeout` milliseconds, the
+        function will throw.
+
+        **Usage**
+
+        ```py
+        await page.set_content(\"<div><span></span></div>\")
+        div = await page.query_selector(\"div\")
+        # waiting for the \"span\" selector relative to the div.
+        span = await div.wait_for_selector(\"span\", state=\"attached\")
+        ```
 
         ```py
         page.set_content(\"<div><span></span></div>\")
@@ -2782,7 +2998,7 @@ def wait_for_selector(
         span = div.wait_for_selector(\"span\", state=\"attached\")
         ```
 
-        > NOTE: This method does not work across navigations, use `page.wait_for_selector()` instead.
+        **NOTE** This method does not work across navigations, use `page.wait_for_selector()` instead.
 
         Parameters
         ----------
@@ -2792,13 +3008,13 @@ def wait_for_selector(
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
             - `'detached'` - wait for element to not be present in DOM.
-            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element without
-              any content or with `display:none` has an empty bounding box and is not considered visible.
-            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.
-              This is opposite to the `'visible'` option.
+            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element
+              without any content or with `display:none` has an empty bounding box and is not considered visible.
+            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or
+              `visibility:hidden`. This is opposite to the `'visible'` option.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -2829,18 +3045,22 @@ def snapshot(
     ) -> typing.Optional[typing.Dict]:
         """Accessibility.snapshot
 
-        **DEPRECATED** This method is deprecated. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you
-        need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for
-        integration with Axe.
+        Captures the current state of the accessibility tree. The returned object represents the root accessible node of
+        the page.
 
-        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`.
 
-        > 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)
+        ```
+
         ```py
         snapshot = page.accessibility.snapshot()
         print(snapshot)
@@ -2848,6 +3068,22 @@ def 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\"])
+        ```
+
         ```py
         def find_focused_node(node):
             if (node.get(\"focused\"))
@@ -2940,19 +3176,19 @@ def set_files(
     ) -> None:
         """FileChooser.set_files
 
-        Sets the value of the file input this chooser is associated with. If some of the `filePaths` are relative paths, then
-        they are resolved relative to the current working directory. For empty array, clears the selected files.
+        Sets the value of the file input this chooser is associated with. If some of the `filePaths` are relative paths,
+        then they are resolved relative to the current working directory. For empty array, clears the selected files.
 
         Parameters
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -2990,7 +3226,8 @@ def name(self) -> str:
 
         If the name is empty, returns the id attribute instead.
 
-        > NOTE: This value is calculated once when the frame is created, and will not update if the attribute is changed later.
+        **NOTE** This value is calculated once when the frame is created, and will not update if the attribute is changed
+        later.
 
         Returns
         -------
@@ -3044,8 +3281,8 @@ def goto(
     ) -> typing.Optional["Response"]:
         """Frame.goto
 
-        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
-        last redirect.
+        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
+        the last redirect.
 
         The method will throw an error if:
         - there's an SSL error (e.g. in case of self-signed certificates).
@@ -3054,13 +3291,14 @@ def goto(
         - the remote server does not respond or is unreachable.
         - the main resource failed to load.
 
-        The method will not throw an error when any valid HTTP status code is returned by the remote server, including 404 \"Not
-        Found\" and 500 \"Internal Server Error\".  The status code for such responses can be retrieved by calling
+        The method will not throw an error when any valid HTTP status code is returned by the remote server, including 404
+        \"Not Found\" and 500 \"Internal Server Error\".  The status code for such responses can be retrieved by calling
         `response.status()`.
 
-        > NOTE: The method either throws an error or returns a main resource response. The only exceptions are navigation to
-        `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
-        > NOTE: Headless mode doesn't support navigation to a PDF document. See the
+        **NOTE** The method either throws an error or returns a main resource response. The only exceptions are navigation
+        to `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
+
+        **NOTE** Headless mode doesn't support navigation to a PDF document. See the
         [upstream issue](https://bugs.chromium.org/p/chromium/issues/detail?id=761295).
 
         Parameters
@@ -3068,16 +3306,18 @@ def goto(
         url : str
             URL to navigate frame to. The url should include scheme, e.g. `https://`.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         referer : Union[str, None]
             Referer header value. If provided it will take preference over the referer header value set by
             `page.set_extra_http_headers()`.
@@ -3108,12 +3348,20 @@ def expect_navigation(
     ) -> EventContextManager["Response"]:
         """Frame.expect_navigation
 
-        Waits for the frame navigation and returns the main resource response. In case of multiple redirects, the navigation
-        will resolve with the response of the last redirect. In case of navigation to a different anchor or navigation due to
-        History API usage, the navigation will resolve with `null`.
+        Waits for the frame navigation and returns the main resource response. In case of multiple redirects, the
+        navigation will resolve with the response of the last redirect. In case of navigation to a different anchor or
+        navigation due to History API usage, the navigation will resolve with `null`.
+
+        **Usage**
 
-        This method waits for the frame to navigate to a new URL. It is useful for when you run code which will indirectly cause
-        the frame to navigate. Consider this example:
+        This method waits for the frame to navigate to a new URL. It is useful for when you run code which will indirectly
+        cause the frame to navigate. Consider this example:
+
+        ```py
+        async with frame.expect_navigation():
+            await frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+        # Resolves after navigation has finished
+        ```
 
         ```py
         with frame.expect_navigation():
@@ -3121,24 +3369,26 @@ def expect_navigation(
         # Resolves after navigation has finished
         ```
 
-        > NOTE: Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL is
-        considered a navigation.
+        **NOTE** Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL
+        is considered a 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 the
-            parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to
-            the string.
+            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]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
 
@@ -3166,6 +3416,13 @@ def wait_for_url(
 
         Waits for the frame to navigate to the given URL.
 
+        **Usage**
+
+        ```py
+        await frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+        await frame.wait_for_url(\"**/target.html\")
+        ```
+
         ```py
         frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
         frame.wait_for_url(\"**/target.html\")
@@ -3174,18 +3431,20 @@ 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 the
-            parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to
-            the string.
+            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]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         """
@@ -3210,8 +3469,16 @@ def wait_for_load_state(
 
         Waits for the required load state to be reached.
 
-        This returns when the frame reaches a required load state, `load` by default. The navigation must have been committed
-        when this method is called. If current document has already reached the required state, resolves immediately.
+        This returns when the frame reaches a required load state, `load` by default. The navigation must have been
+        committed when this method is called. If current document has already reached the required state, resolves
+        immediately.
+
+        **Usage**
+
+        ```py
+        await frame.click(\"button\") # click triggers navigation.
+        await frame.wait_for_load_state() # the promise resolves after \"load\" event.
+        ```
 
         ```py
         frame.click(\"button\") # click triggers navigation.
@@ -3227,8 +3494,8 @@ def wait_for_load_state(
             - `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired.
             - `'networkidle'` - wait until there are no network connections for at least `500` ms.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         """
@@ -3242,11 +3509,19 @@ def frame_element(self) -> "ElementHandle":
 
         Returns the `frame` or `iframe` element handle which corresponds to this frame.
 
-        This is an inverse of `element_handle.content_frame()`. Note that returned handle actually belongs to the parent
-        frame.
+        This is an inverse of `element_handle.content_frame()`. Note that returned handle actually belongs to the
+        parent frame.
 
         This method throws an error if the frame has been detached before `frameElement()` returns.
 
+        **Usage**
+
+        ```py
+        frame_element = await frame.frame_element()
+        content_frame = await frame_element.content_frame()
+        assert frame == content_frame
+        ```
+
         ```py
         frame_element = frame.frame_element()
         content_frame = frame_element.content_frame()
@@ -3267,12 +3542,19 @@ def evaluate(
 
         Returns the return value of `expression`.
 
-        If the function passed to the `frame.evaluate()` returns a [Promise], then `frame.evaluate()` would wait
-        for the promise to resolve and return its value.
+        If the function passed to the `frame.evaluate()` returns a [Promise], then `frame.evaluate()` would
+        wait for the promise to resolve and return its value.
 
         If the function passed to the `frame.evaluate()` returns a non-[Serializable] value, then
-        `frame.evaluate()` returns `undefined`. Playwright also supports transferring some additional values that are
-        not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
+        `frame.evaluate()` returns `undefined`. Playwright also supports transferring some additional values that
+        are not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
+
+        **Usage**
+
+        ```py
+        result = await frame.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
+        print(result) # prints \"56\"
+        ```
 
         ```py
         result = frame.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
@@ -3281,6 +3563,12 @@ def evaluate(
 
         A string can also be passed in instead of a function.
 
+        ```py
+        print(await frame.evaluate(\"1 + 2\")) # prints \"3\"
+        x = 10
+        print(await frame.evaluate(f\"1 + {x}\")) # prints \"11\"
+        ```
+
         ```py
         print(frame.evaluate(\"1 + 2\")) # prints \"3\"
         x = 10
@@ -3289,6 +3577,12 @@ def evaluate(
 
         `ElementHandle` instances can be passed as an argument to the `frame.evaluate()`:
 
+        ```py
+        body_handle = await frame.evaluate(\"document.body\")
+        html = await frame.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
+        await body_handle.dispose()
+        ```
+
         ```py
         body_handle = frame.evaluate(\"document.body\")
         html = frame.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
@@ -3298,8 +3592,8 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3327,6 +3621,13 @@ def evaluate_handle(
         If the function, passed to the `frame.evaluate_handle()`, returns a [Promise], then
         `frame.evaluate_handle()` would wait for the promise to resolve and return its value.
 
+        **Usage**
+
+        ```py
+        a_window_handle = await frame.evaluate_handle(\"Promise.resolve(window)\")
+        a_window_handle # handle for the window object.
+        ```
+
         ```py
         a_window_handle = frame.evaluate_handle(\"Promise.resolve(window)\")
         a_window_handle # handle for the window object.
@@ -3334,12 +3635,23 @@ def evaluate_handle(
 
         A string can also be passed in instead of a function.
 
+        ```py
+        a_handle = await page.evaluate_handle(\"document\") # handle for the \"document\"
+        ```
+
         ```py
         a_handle = page.evaluate_handle(\"document\") # handle for the \"document\"
         ```
 
         `JSHandle` instances can be passed as an argument to the `frame.evaluate_handle()`:
 
+        ```py
+        a_handle = await page.evaluate_handle(\"document.body\")
+        result_handle = await page.evaluate_handle(\"body => body.innerHTML\", a_handle)
+        print(await result_handle.json_value())
+        await result_handle.dispose()
+        ```
+
         ```py
         a_handle = page.evaluate_handle(\"document.body\")
         result_handle = page.evaluate_handle(\"body => body.innerHTML\", a_handle)
@@ -3350,8 +3662,8 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3375,7 +3687,7 @@ def query_selector(
 
         Returns the ElementHandle pointing to the frame element.
 
-        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
+        **NOTE** The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
 
         The method finds an element matching the specified selector within the frame. See
         [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns `null`.
@@ -3402,7 +3714,7 @@ def query_selector_all(self, selector: str) -> typing.List["ElementHandle"]:
 
         Returns the ElementHandles pointing to the frame elements.
 
-        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects instead.
+        **NOTE** The use of `ElementHandle` is discouraged, use `Locator` objects instead.
 
         The method finds all elements matching the specified selector within the frame. See
         [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns empty array.
@@ -3436,15 +3748,37 @@ def wait_for_selector(
         Returns when element specified by selector satisfies `state` option. Returns `null` if waiting for `hidden` or
         `detached`.
 
-        > NOTE: Playwright automatically waits for element to be ready before performing an action. Using `Locator` objects and
-        web-first assertions make the code wait-for-selector-free.
+        **NOTE** Playwright automatically waits for element to be ready before performing an action. Using `Locator`
+        objects and web-first assertions make the code wait-for-selector-free.
+
+        Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If
+        at the moment of calling the method `selector` already satisfies the condition, the method will return immediately.
+        If the selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
 
-        Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at
-        the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the
-        selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
+        **Usage**
 
         This method works across navigations:
 
+        ```py
+        import asyncio
+        from playwright.async_api import async_playwright
+
+        async def run(playwright):
+            chromium = playwright.chromium
+            browser = await chromium.launch()
+            page = await browser.new_page()
+            for current_url in [\"https://google.com\", \"https://bbc.com\"]:
+                await page.goto(current_url, wait_until=\"domcontentloaded\")
+                element = await page.main_frame.wait_for_selector(\"img\")
+                print(\"Loaded image: \" + str(await element.get_attribute(\"src\")))
+            await browser.close()
+
+        async def main():
+            async with async_playwright() as playwright:
+                await run(playwright)
+        asyncio.run(main())
+        ```
+
         ```py
         from playwright.sync_api import sync_playwright
 
@@ -3470,16 +3804,16 @@ def run(playwright):
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
             - `'detached'` - wait for element to not be present in DOM.
-            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element without
-              any content or with `display:none` has an empty bounding box and is not considered visible.
-            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.
-              This is opposite to the `'visible'` option.
+            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element
+              without any content or with `display:none` has an empty bounding box and is not considered visible.
+            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or
+              `visibility:hidden`. This is opposite to the `'visible'` option.
 
         Returns
         -------
@@ -3508,14 +3842,14 @@ def is_checked(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -3544,14 +3878,14 @@ def is_disabled(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -3580,14 +3914,14 @@ def is_editable(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -3616,14 +3950,14 @@ def is_enabled(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -3647,20 +3981,18 @@ def is_hidden(
     ) -> bool:
         """Frame.is_hidden
 
-        Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).  `selector` that does not
-        match any elements is considered hidden.
+        Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).  `selector` that
+        does not match any elements is considered hidden.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `frame.is_hidden()` does not wait for the element to become hidden and
-            returns immediately.
 
         Returns
         -------
@@ -3684,20 +4016,18 @@ def is_visible(
     ) -> bool:
         """Frame.is_visible
 
-        Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible). `selector` that does not match any elements is
-        considered not visible.
+        Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible). `selector` that does not match any elements
+        is considered not visible.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `frame.is_visible()` does not wait for the element to become visible and
-            returns immediately.
 
         Returns
         -------
@@ -3727,12 +4057,18 @@ def dispatch_event(
         `click` is dispatched. This is equivalent to calling
         [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
 
+        **Usage**
+
+        ```py
+        await frame.dispatch_event(\"button#submit\", \"click\")
+        ```
+
         ```py
         frame.dispatch_event(\"button#submit\", \"click\")
         ```
 
-        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties
-        and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
+        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
+        properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
@@ -3745,6 +4081,12 @@ def dispatch_event(
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
+        ```py
+        # note you can only create data_transfer in chromium and firefox
+        data_transfer = await frame.evaluate_handle(\"new DataTransfer()\")
+        await frame.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
+        ```
+
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = frame.evaluate_handle(\"new DataTransfer()\")
@@ -3754,8 +4096,8 @@ def dispatch_event(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         type : str
             DOM event type: `"click"`, `"dragstart"`, etc.
         event_init : Union[Dict, None]
@@ -3764,8 +4106,8 @@ def dispatch_event(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -3792,17 +4134,20 @@ def eval_on_selector(
 
         Returns the return value of `expression`.
 
-        > NOTE: This method does not wait for the element to pass actionability checks and therefore can lead to the flaky
-        tests. Use `locator.evaluate()`, other `Locator` helper methods or web-first assertions instead.
-
         The method finds an element matching the specified selector within the frame and passes it as a first argument to
-        `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, the
-        method throws an error.
+        `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector,
+        the method throws an error.
 
-        If `expression` returns a [Promise], then `frame.eval_on_selector()` would wait for the promise to resolve and
-        return its value.
+        If `expression` returns a [Promise], then `frame.eval_on_selector()` would wait for the promise to resolve
+        and return its value.
 
-        Examples:
+        **Usage**
+
+        ```py
+        search_value = await frame.eval_on_selector(\"#search\", \"el => el.value\")
+        preload_href = await frame.eval_on_selector(\"link[rel=preload]\", \"el => el.href\")
+        html = await frame.eval_on_selector(\".main-container\", \"(e, suffix) => e.outerHTML + suffix\", \"hello\")
+        ```
 
         ```py
         search_value = frame.eval_on_selector(\"#search\", \"el => el.value\")
@@ -3815,8 +4160,8 @@ def eval_on_selector(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         strict : Union[bool, None]
@@ -3846,16 +4191,17 @@ def eval_on_selector_all(
 
         Returns the return value of `expression`.
 
-        > NOTE: In most cases, `locator.evaluate_all()`, other `Locator` helper methods and web-first assertions do a
-        better job.
+        The method finds all elements matching the specified selector within the frame and passes an array of matched
+        elements as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details.
 
-        The method finds all elements matching the specified selector within the frame and passes an array of matched elements
-        as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details.
+        If `expression` returns a [Promise], then `frame.eval_on_selector_all()` would wait for the promise to resolve
+        and return its value.
 
-        If `expression` returns a [Promise], then `frame.eval_on_selector_all()` would wait for the promise to resolve and
-        return its value.
+        **Usage**
 
-        Examples:
+        ```py
+        divs_counts = await frame.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
+        ```
 
         ```py
         divs_counts = frame.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
@@ -3866,8 +4212,8 @@ def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -3912,16 +4258,18 @@ def set_content(
         html : str
             HTML markup to assign to the page.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         """
 
         return mapping.from_maybe_impl(
@@ -3963,8 +4311,8 @@ def add_script_tag(
         url : Union[str, None]
             URL of a script to be added.
         path : Union[pathlib.Path, str, None]
-            Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative to the
-            current working directory.
+            Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative
+            to the current working directory.
         content : Union[str, None]
             Raw JavaScript content to be injected into frame.
         type : Union[str, None]
@@ -4040,26 +4388,26 @@ def click(
 
         This method clicks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -4067,20 +4415,20 @@ def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4121,48 +4469,48 @@ def dblclick(
 
         This method double clicks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if the
-           first click of the `dblclick()` triggers a navigation event, this method will throw.
+        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
+           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `frame.dblclick()` dispatches two `click` events and a single `dblclick` event.
+        **NOTE** `frame.dblclick()` dispatches two `click` events and a single `dblclick` event.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4200,43 +4548,43 @@ def tap(
 
         This method taps an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `frame.tap()` requires that the `hasTouch` option of the browser context be set to true.
+        **NOTE** `frame.tap()` requires that the `hasTouch` option of the browser context be set to true.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4266,12 +4614,12 @@ def fill(
     ) -> None:
         """Frame.fill
 
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
-        element, fills it and triggers an `input` event after filling. Note that you can pass an empty string to clear the input
-        field.
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks,
+        focuses the element, fills it and triggers an `input` event after filling. Note that you can pass an empty string
+        to clear the input field.
 
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an
+        error. However, if the element is inside the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
@@ -4280,17 +4628,17 @@ def fill(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4320,9 +4668,9 @@ def locator(
     ) -> "Locator":
         """Frame.locator
 
-        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved to
-        the element immediately before performing an action, so a series of actions on the same locator can in fact be performed
-        on different DOM elements. That would happen if the DOM structure between those actions has changed.
+        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved
+        to the element immediately before performing an action, so a series of actions on the same locator can in fact be
+        performed on different DOM elements. That would happen if the DOM structure between those actions has changed.
 
         [Learn more about locators](https://playwright.dev/python/docs/locators).
 
@@ -4333,12 +4681,12 @@ def locator(
         selector : str
             A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
         has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
+            passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
+            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
@@ -4372,8 +4720,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4403,8 +4751,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4433,8 +4781,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4550,9 +4898,10 @@ def get_by_role(
         accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
 
         Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
-        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
-        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
+        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
+        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
+        default values.
 
         Parameters
         ----------
@@ -4565,7 +4914,7 @@ def get_by_role(
         disabled : Union[bool, None]
             An attribute that is usually set by `aria-disabled` or `disabled`.
 
-            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
@@ -4577,8 +4926,8 @@ def get_by_role(
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
         level : Union[int, None]
-            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
-            `<h1>-<h6>` elements.
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values
+            for `<h1>-<h6>` elements.
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
@@ -4595,8 +4944,8 @@ def get_by_role(
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
         exact : Union[bool, None]
-            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
-            expression. Note that exact match still trims whitespace.
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4670,26 +5019,44 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
-        by the text content.
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
 
-        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
-        one, turns line breaks into spaces and ignores leading and trailing whitespace.
-        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
-        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
 
-        Parameters
-        ----------
-        text : Union[Pattern[str], str]
-            Text to locate the element for.
-        exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
 
-        Returns
-        -------
-        Locator
-        """
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
+        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+
+        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
+        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+
+        Parameters
+        ----------
+        text : Union[Pattern[str], str]
+            Text to locate the element for.
+        exact : Union[bool, None]
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
+
+        Returns
+        -------
+        Locator
+        """
 
         return mapping.from_impl(self._impl_obj.get_by_text(text=text, exact=exact))
 
@@ -4701,7 +5068,8 @@ def get_by_title(
     ) -> "Locator":
         """Frame.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
+        order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -4712,8 +5080,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -4725,10 +5093,19 @@ def get_by_title(
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Frame.frame_locator
 
-        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements in
-        that iframe. Following snippet locates element with text \"Submit\" in the iframe with id `my-frame`, like `<iframe
+        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
+        in that iframe.
+
+        **Usage**
+
+        Following snippet locates element with text \"Submit\" in the iframe with id `my-frame`, like `<iframe
         id=\"my-frame\">`:
 
+        ```py
+        locator = frame.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
+        await locator.click()
+        ```
+
         ```py
         locator = frame.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
         locator.click()
@@ -4755,20 +5132,20 @@ def focus(
     ) -> None:
         """Frame.focus
 
-        This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the method
-        waits until a matching element appears in the DOM.
+        This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the
+        method waits until a matching element appears in the DOM.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -4791,14 +5168,14 @@ def text_content(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -4827,14 +5204,14 @@ def inner_text(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -4863,14 +5240,14 @@ def inner_html(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -4900,16 +5277,16 @@ def get_attribute(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         name : str
             Attribute name to get the value for.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -4942,41 +5319,41 @@ def hover(
 
         This method hovers over an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5012,11 +5389,11 @@ def drag_and_drop(
         Parameters
         ----------
         source : str
-            A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
-        target : str
-            A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will
+            A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will
             be used. See [working with selectors](../selectors.md) for more details.
+        target : str
+            A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first
+            will be used. See [working with selectors](../selectors.md) for more details.
         source_position : Union[{x: float, y: float}, None]
             Clicks on the source 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.
@@ -5026,18 +5403,18 @@ def drag_and_drop(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5073,17 +5450,29 @@ def select_option(
     ) -> typing.List[str]:
         """Frame.select_option
 
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until
-        all specified options are present in the `<select>` element and selects these options.
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits
+        until all specified options are present in the `<select>` element and selects these options.
 
-        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside the
-        `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used instead.
+        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside
+        the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used
+        instead.
 
         Returns the array of option values that have been successfully selected.
 
         Triggers a `change` and `input` event once all the provided options have been selected.
 
+        **Usage**
+
+        ```py
+        # single selection matching the value
+        await frame.select_option(\"select#colors\", \"blue\")
+        # single selection matching the label
+        await frame.select_option(\"select#colors\", label=\"blue\")
+        # multiple selection
+        await frame.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
+        ```
+
         ```py
         # single selection matching the value
         frame.select_option(\"select#colors\", \"blue\")
@@ -5098,22 +5487,22 @@ def select_option(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         value : Union[List[str], str, None]
-            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         index : Union[List[int], int, None]
             Options to select by index. Optional.
         label : Union[List[str], str, None]
-            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5153,19 +5542,20 @@ def input_value(
         Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
 
         Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the
+        control.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -5197,30 +5587,30 @@ def set_input_files(
     ) -> None:
         """Frame.set_input_files
 
-        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
-        are resolved relative to the current working directory. For empty array, clears the selected files.
+        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
+        they are resolved relative to the current working directory. For empty array, clears the selected files.
 
         This method expects `selector` to point to an
-        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
-        `<label>` element that has an associated
+        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
+        the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -5247,11 +5637,18 @@ def type(
     ) -> None:
         """Frame.type
 
-        Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `frame.type` can be used to
-        send fine-grained keyboard events. To fill values in form fields, use `frame.fill()`.
+        Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `frame.type` can be used
+        to send fine-grained keyboard events. To fill values in form fields, use `frame.fill()`.
 
         To press a special key, like `Control` or `ArrowDown`, use `keyboard.press()`.
 
+        **Usage**
+
+        ```py
+        await frame.type(\"#mytextarea\", \"hello\") # types instantly
+        await frame.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
+        ```
+
         ```py
         frame.type(\"#mytextarea\", \"hello\") # types instantly
         frame.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
@@ -5260,8 +5657,8 @@ def type(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         text : str
             A text to type into a focused element.
         delay : Union[float, None]
@@ -5270,12 +5667,12 @@ def type(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -5303,12 +5700,14 @@ def press(
     ) -> None:
         """Frame.press
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -5323,8 +5722,8 @@ def press(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         key : str
             Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
         delay : Union[float, None]
@@ -5333,12 +5732,12 @@ def press(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -5369,41 +5768,41 @@ def check(
 
         This method checks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is already
-           checked, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is
+           already checked, this method returns immediately.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5435,41 +5834,41 @@ def uncheck(
 
         This method checks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is already
-           unchecked, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is
+           already unchecked, this method returns immediately.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5491,8 +5890,8 @@ def wait_for_timeout(self, timeout: float) -> None:
 
         Waits for the given `timeout` in milliseconds.
 
-        Note that `frame.waitForTimeout()` should only be used for debugging. Tests using the timer in production are going to
-        be flaky. Use signals such as network events, selectors becoming visible and others instead.
+        Note that `frame.waitForTimeout()` should only be used for debugging. Tests using the timer in production are going
+        to be flaky. Use signals such as network events, selectors becoming visible and others instead.
 
         Parameters
         ----------
@@ -5516,8 +5915,28 @@ def wait_for_function(
 
         Returns when the `expression` returns a truthy value, returns that value.
 
+        **Usage**
+
         The `frame.wait_for_function()` can be used to observe viewport size change:
 
+        ```py
+        import asyncio
+        from playwright.async_api import async_playwright
+
+        async def run(playwright):
+            webkit = playwright.webkit
+            browser = await webkit.launch()
+            page = await browser.new_page()
+            await page.evaluate(\"window.x = 0; setTimeout(() => { window.x = 100 }, 1000);\")
+            await page.main_frame.wait_for_function(\"() => window.x > 0\")
+            await browser.close()
+
+        async def main():
+            async with async_playwright() as playwright:
+                await run(playwright)
+        asyncio.run(main())
+        ```
+
         ```py
         from playwright.sync_api import sync_playwright
 
@@ -5535,6 +5954,11 @@ def run(playwright):
 
         To pass an argument to the predicate of `frame.waitForFunction` function:
 
+        ```py
+        selector = \".foo\"
+        await frame.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
+        ```
+
         ```py
         selector = \".foo\"
         frame.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
@@ -5543,16 +5967,17 @@ def run(playwright):
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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()`.
+            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()`.
         polling : Union["raf", float, None]
-            If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling` is a
-            number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to `raf`.
+            If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling`
+            is a number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to
+            `raf`.
 
         Returns
         -------
@@ -5600,41 +6025,41 @@ def set_checked(
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
         1. Ensure that matched element is a checkbox or a radio input. If not, this method throws.
         1. If the element already has the right checked state, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5690,8 +6115,8 @@ def locator(
     ) -> "Locator":
         """FrameLocator.locator
 
-        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter options,
-        similar to `locator.filter()` method.
+        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter
+        options, similar to `locator.filter()` method.
 
         [Learn more about locators](https://playwright.dev/python/docs/locators).
 
@@ -5700,12 +6125,12 @@ def locator(
         selector : str
             A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
         has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
+            passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
+            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
@@ -5739,8 +6164,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5770,8 +6195,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5800,8 +6225,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -5917,9 +6342,10 @@ def get_by_role(
         accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
 
         Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
-        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
-        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
+        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
+        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
+        default values.
 
         Parameters
         ----------
@@ -5932,7 +6358,7 @@ def get_by_role(
         disabled : Union[bool, None]
             An attribute that is usually set by `aria-disabled` or `disabled`.
 
-            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
@@ -5944,8 +6370,8 @@ def get_by_role(
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
         level : Union[int, None]
-            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
-            `<h1>-<h6>` elements.
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values
+            for `<h1>-<h6>` elements.
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
@@ -5962,8 +6388,8 @@ def get_by_role(
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
         exact : Union[bool, None]
-            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
-            expression. Note that exact match still trims whitespace.
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -6037,21 +6463,39 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
-        by the text content.
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
+        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
 
-        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
-        one, turns line breaks into spaces and ignores leading and trailing whitespace.
-        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
-        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
+        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -6068,7 +6512,8 @@ def get_by_title(
     ) -> "Locator":
         """FrameLocator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
+        order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -6079,8 +6524,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -6092,8 +6537,8 @@ def get_by_title(
     def frame_locator(self, selector: str) -> "FrameLocator":
         """FrameLocator.frame_locator
 
-        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements in
-        that iframe.
+        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
+        in that iframe.
 
         Parameters
         ----------
@@ -6132,14 +6577,16 @@ 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."""
+        Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is
+        terminated."""
         return super().on(event=event, f=f)
 
     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."""
+        Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is
+        terminated."""
         return super().once(event=event, f=f)
 
     @property
@@ -6159,18 +6606,18 @@ def evaluate(
 
         Returns the return value of `expression`.
 
-        If the function passed to the `worker.evaluate()` returns a [Promise], then `worker.evaluate()` would
-        wait for the promise to resolve and return its value.
+        If the function passed to the `worker.evaluate()` returns a [Promise], then `worker.evaluate()`
+        would wait for the promise to resolve and return its value.
 
         If the function passed to the `worker.evaluate()` returns a non-[Serializable] value, then
-        `worker.evaluate()` returns `undefined`. Playwright also supports transferring some additional values that are
-        not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
+        `worker.evaluate()` returns `undefined`. Playwright also supports transferring some additional values that
+        are not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
 
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -6201,8 +6648,8 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -6234,8 +6681,49 @@ def register(
     ) -> None:
         """Selectors.register
 
+        **Usage**
+
         An example of registering selector engine that queries elements based on a tag name:
 
+        ```py
+        import asyncio
+        from playwright.async_api import async_playwright
+
+        async def run(playwright):
+            tag_selector = \"\"\"
+              {
+                  // Returns the first element matching given selector in the root's subtree.
+                  query(root, selector) {
+                      return root.querySelector(selector);
+                  },
+                  // Returns all elements matching given selector in the root's subtree.
+                  queryAll(root, selector) {
+                      return Array.from(root.querySelectorAll(selector));
+                  }
+              }\"\"\"
+
+            # Register the engine. Selectors will be prefixed with \"tag=\".
+            await playwright.selectors.register(\"tag\", tag_selector)
+            browser = await playwright.chromium.launch()
+            page = await browser.new_page()
+            await page.set_content('<div><button>Click me</button></div>')
+
+            # Use the selector prefixed with its name.
+            button = await page.query_selector('tag=button')
+            # Combine it with other selector engines.
+            await page.locator('tag=div >> text=\"Click me\"').click()
+            # Can use it in any methods supporting selectors.
+            button_count = await page.locator('tag=button').count()
+            print(button_count)
+            await browser.close()
+
+        async def main():
+            async with async_playwright() as playwright:
+                await run(playwright)
+
+        asyncio.run(main())
+        ```
+
         ```py
         from playwright.sync_api import sync_playwright
 
@@ -6282,9 +6770,9 @@ def run(playwright):
             Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to the current working
             directory.
         content_script : Union[bool, None]
-            Whether to run this selector engine in isolated JavaScript environment. This environment has access to the same DOM, but
-            not any JavaScript objects from the frame's scripts. Defaults to `false`. Note that running as a content script is not
-            guaranteed when this engine is used together with other registered engines.
+            Whether to run this selector engine in isolated JavaScript environment. This environment has access to the same
+            DOM, but not any JavaScript objects from the frame's scripts. Defaults to `false`. Note that running as a content
+            script is not guaranteed when this engine is used together with other registered engines.
         """
 
         return mapping.from_maybe_impl(
@@ -6320,8 +6808,8 @@ def type(self) -> str:
         """ConsoleMessage.type
 
         One of the following values: `'log'`, `'debug'`, `'info'`, `'error'`, `'warning'`, `'dir'`, `'dirxml'`, `'table'`,
-        `'trace'`, `'clear'`, `'startGroup'`, `'startGroupCollapsed'`, `'endGroup'`, `'assert'`, `'profile'`, `'profileEnd'`,
-        `'count'`, `'timeEnd'`.
+        `'trace'`, `'clear'`, `'startGroup'`, `'startGroupCollapsed'`, `'endGroup'`, `'assert'`, `'profile'`,
+        `'profileEnd'`, `'count'`, `'timeEnd'`.
 
         Returns
         -------
@@ -6461,9 +6949,9 @@ def suggested_filename(self) -> str:
         """Download.suggested_filename
 
         Returns suggested filename for this download. It is typically computed by the browser from the
-        [`Content-Disposition`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition) response header
-        or the `download` attribute. See the spec on [whatwg](https://html.spec.whatwg.org/#downloading-resources). Different
-        browsers can use different logic for computing it.
+        [`Content-Disposition`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition) response
+        header or the `download` attribute. See the spec on [whatwg](https://html.spec.whatwg.org/#downloading-resources).
+        Different browsers can use different logic for computing it.
 
         Returns
         -------
@@ -6494,11 +6982,11 @@ def failure(self) -> typing.Optional[str]:
     def path(self) -> typing.Optional[pathlib.Path]:
         """Download.path
 
-        Returns path to the downloaded file in case of successful download. The method will wait for the download to finish if
-        necessary. The method throws when connected remotely.
+        Returns path to the downloaded file in case of successful download. The method will wait for the download to finish
+        if necessary. The method throws when connected remotely.
 
-        Note that the download's file name is a random GUID, use `download.suggested_filename()` to get suggested file
-        name.
+        Note that the download's file name is a random GUID, use `download.suggested_filename()` to get suggested
+        file name.
 
         Returns
         -------
@@ -6510,8 +6998,8 @@ def path(self) -> typing.Optional[pathlib.Path]:
     def save_as(self, path: typing.Union[str, pathlib.Path]) -> None:
         """Download.save_as
 
-        Copy the download to a user-specified path. It is safe to call this method while the download is still in progress. Will
-        wait for the download to finish if necessary.
+        Copy the download to a user-specified path. It is safe to call this method while the download is still in progress.
+        Will wait for the download to finish if necessary.
 
         Parameters
         ----------
@@ -6538,8 +7026,8 @@ class Video(SyncBase):
     def path(self) -> pathlib.Path:
         """Video.path
 
-        Returns the file system path this video will be recorded to. The video is guaranteed to be written to the filesystem
-        upon closing the browser context. This method throws when connected remotely.
+        Returns the file system path this video will be recorded to. The video is guaranteed to be written to the
+        filesystem upon closing the browser context. This method throws when connected remotely.
 
         Returns
         -------
@@ -6551,8 +7039,8 @@ def path(self) -> pathlib.Path:
     def save_as(self, path: typing.Union[str, pathlib.Path]) -> None:
         """Video.save_as
 
-        Saves the video to a user-specified path. It is safe to call this method while the video is still in progress, or after
-        the page has closed. This method waits until the page is closed and the video is fully saved.
+        Saves the video to a user-specified path. It is safe to call this method while the video is still in progress, or
+        after the page has closed. This method waits until the page is closed and the video is fully saved.
 
         Parameters
         ----------
@@ -6592,6 +7080,17 @@ def on(
 
         An example of handling `console` event:
 
+        ```py
+        async def print_args(msg):
+            values = []
+            for arg in msg.args:
+                values.append(await arg.json_value())
+            print(values)
+
+        page.on(\"console\", print_args)
+        await page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        ```
+
         ```py
         def print_args(msg):
             for arg in msg.args:
@@ -6604,11 +7103,21 @@ def print_args(msg):
     @typing.overload
     def on(self, event: Literal["crash"], f: typing.Callable[["Page"], "None"]) -> None:
         """
-        Emitted when the page crashes. Browser pages might crash if they try to allocate too much memory. When the page crashes,
-        ongoing and subsequent operations will throw.
+        Emitted when the page crashes. Browser pages might crash if they try to allocate too much memory. When the page
+        crashes, ongoing and subsequent operations will throw.
 
         The most common way to deal with crashes is to catch an exception:
 
+        ```py
+        try:
+            # crash might happen during a click.
+            await page.click(\"button\")
+            # or while waiting for an event.
+            await page.wait_for_event(\"popup\")
+        except Error as e:
+            # when the page crashes, exception message contains \"crash\".
+        ```
+
         ```py
         try:
             # crash might happen during a click.
@@ -6626,30 +7135,30 @@ def on(
         """
         Emitted when a JavaScript dialog appears, such as `alert`, `prompt`, `confirm` or `beforeunload`. Listener **must**
         either `dialog.accept()` or `dialog.dismiss()` the dialog - otherwise the page will
-        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog, and
-        actions like click will never finish.
+        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
+        and actions like click will never finish.
 
         ```python
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        > NOTE: When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
+        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
 
     @typing.overload
     def on(
         self, event: Literal["domcontentloaded"], f: typing.Callable[["Page"], "None"]
     ) -> None:
         """
-        Emitted when the JavaScript [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded)
-        event is dispatched."""
+        Emitted when the JavaScript
+        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched."""
 
     @typing.overload
     def on(
         self, event: Literal["download"], f: typing.Callable[["Download"], "None"]
     ) -> None:
         """
-        Emitted when attachment download started. User can access basic file operations on downloaded content via the passed
-        `Download` instance."""
+        Emitted when attachment download started. User can access basic file operations on downloaded content via the
+        passed `Download` instance."""
 
     @typing.overload
     def on(
@@ -6700,6 +7209,14 @@ def on(
         # Log all uncaught errors to the terminal
         page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
 
+        # Navigate to a page with an exception.
+        await page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
+        ```
+
+        ```py
+        # Log all uncaught errors to the terminal
+        page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
+
         # Navigate to a page with an exception.
         page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
         ```"""
@@ -6711,8 +7228,15 @@ def on(self, event: Literal["popup"], f: typing.Callable[["Page"], "None"]) -> N
         `browser_context.on('page')`, but only for popups relevant to this page.
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
-        popup with `window.open('http://example.com')`, this event will fire when the network request to \"http://example.com\" is
-        done and its response has started loading in the popup.
+        popup with `window.open('http://example.com')`, this event will fire when the network request to
+        \"http://example.com\" is done and its response has started loading in the popup.
+
+        ```py
+        async with page.expect_event(\"popup\") as page_info:
+            page.evaluate(\"window.open('https://example.com')\")
+        popup = await page_info.value
+        print(await popup.evaluate(\"location.href\"))
+        ```
 
         ```py
         with page.expect_event(\"popup\") as page_info:
@@ -6721,16 +7245,16 @@ def on(self, event: Literal["popup"], f: typing.Callable[["Page"], "None"]) -> N
         print(popup.evaluate(\"location.href\"))
         ```
 
-        > NOTE: Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not need it
-        in most cases)."""
+        **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
+        need it in most cases)."""
 
     @typing.overload
     def on(
         self, event: Literal["request"], f: typing.Callable[["Request"], "None"]
     ) -> None:
         """
-        Emitted when a page issues a request. The [request] object is read-only. In order to intercept and mutate requests, see
-        `page.route()` or `browser_context.route()`."""
+        Emitted when a page issues a request. The [request] object is read-only. In order to intercept and mutate requests,
+        see `page.route()` or `browser_context.route()`."""
 
     @typing.overload
     def on(
@@ -6743,9 +7267,9 @@ def on(
         page.on(\"requestfailed\", lambda request: print(request.url + \" \" + request.failure.error_text))
         ```
 
-        > NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will
-        complete with `page.on('request_finished')` event and not with `page.on('request_failed')`. A request will only be
-        considered failed when the client cannot get an HTTP response from the server, e.g. due to network error
+        **NOTE** HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request
+        will complete with `page.on('request_finished')` event and not with `page.on('request_failed')`. A request will
+        only be considered failed when the client cannot get an HTTP response from the server, e.g. due to network error
         net::ERR_FAILED."""
 
     @typing.overload
@@ -6761,8 +7285,8 @@ def on(
         self, event: Literal["response"], f: typing.Callable[["Response"], "None"]
     ) -> None:
         """
-        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of events
-        is `request`, `response` and `requestfinished`."""
+        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of
+        events is `request`, `response` and `requestfinished`."""
 
     @typing.overload
     def on(
@@ -6776,8 +7300,8 @@ def on(
         self, event: Literal["worker"], f: typing.Callable[["Worker"], "None"]
     ) -> None:
         """
-        Emitted when a dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is spawned by the
-        page."""
+        Emitted when a dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is spawned
+        by the page."""
 
     def on(self, event: str, f: typing.Callable[..., None]) -> None:
         return super().on(event=event, f=f)
@@ -6801,6 +7325,17 @@ def once(
 
         An example of handling `console` event:
 
+        ```py
+        async def print_args(msg):
+            values = []
+            for arg in msg.args:
+                values.append(await arg.json_value())
+            print(values)
+
+        page.on(\"console\", print_args)
+        await page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        ```
+
         ```py
         def print_args(msg):
             for arg in msg.args:
@@ -6815,11 +7350,21 @@ def once(
         self, event: Literal["crash"], f: typing.Callable[["Page"], "None"]
     ) -> None:
         """
-        Emitted when the page crashes. Browser pages might crash if they try to allocate too much memory. When the page crashes,
-        ongoing and subsequent operations will throw.
+        Emitted when the page crashes. Browser pages might crash if they try to allocate too much memory. When the page
+        crashes, ongoing and subsequent operations will throw.
 
         The most common way to deal with crashes is to catch an exception:
 
+        ```py
+        try:
+            # crash might happen during a click.
+            await page.click(\"button\")
+            # or while waiting for an event.
+            await page.wait_for_event(\"popup\")
+        except Error as e:
+            # when the page crashes, exception message contains \"crash\".
+        ```
+
         ```py
         try:
             # crash might happen during a click.
@@ -6837,30 +7382,30 @@ def once(
         """
         Emitted when a JavaScript dialog appears, such as `alert`, `prompt`, `confirm` or `beforeunload`. Listener **must**
         either `dialog.accept()` or `dialog.dismiss()` the dialog - otherwise the page will
-        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog, and
-        actions like click will never finish.
+        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
+        and actions like click will never finish.
 
         ```python
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        > NOTE: When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
+        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
 
     @typing.overload
     def once(
         self, event: Literal["domcontentloaded"], f: typing.Callable[["Page"], "None"]
     ) -> None:
         """
-        Emitted when the JavaScript [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded)
-        event is dispatched."""
+        Emitted when the JavaScript
+        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched."""
 
     @typing.overload
     def once(
         self, event: Literal["download"], f: typing.Callable[["Download"], "None"]
     ) -> None:
         """
-        Emitted when attachment download started. User can access basic file operations on downloaded content via the passed
-        `Download` instance."""
+        Emitted when attachment download started. User can access basic file operations on downloaded content via the
+        passed `Download` instance."""
 
     @typing.overload
     def once(
@@ -6913,6 +7458,14 @@ def once(
         # Log all uncaught errors to the terminal
         page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
 
+        # Navigate to a page with an exception.
+        await page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
+        ```
+
+        ```py
+        # Log all uncaught errors to the terminal
+        page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
+
         # Navigate to a page with an exception.
         page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
         ```"""
@@ -6926,8 +7479,15 @@ def once(
         `browser_context.on('page')`, but only for popups relevant to this page.
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
-        popup with `window.open('http://example.com')`, this event will fire when the network request to \"http://example.com\" is
-        done and its response has started loading in the popup.
+        popup with `window.open('http://example.com')`, this event will fire when the network request to
+        \"http://example.com\" is done and its response has started loading in the popup.
+
+        ```py
+        async with page.expect_event(\"popup\") as page_info:
+            page.evaluate(\"window.open('https://example.com')\")
+        popup = await page_info.value
+        print(await popup.evaluate(\"location.href\"))
+        ```
 
         ```py
         with page.expect_event(\"popup\") as page_info:
@@ -6936,16 +7496,16 @@ def once(
         print(popup.evaluate(\"location.href\"))
         ```
 
-        > NOTE: Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not need it
-        in most cases)."""
+        **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
+        need it in most cases)."""
 
     @typing.overload
     def once(
         self, event: Literal["request"], f: typing.Callable[["Request"], "None"]
     ) -> None:
         """
-        Emitted when a page issues a request. The [request] object is read-only. In order to intercept and mutate requests, see
-        `page.route()` or `browser_context.route()`."""
+        Emitted when a page issues a request. The [request] object is read-only. In order to intercept and mutate requests,
+        see `page.route()` or `browser_context.route()`."""
 
     @typing.overload
     def once(
@@ -6958,9 +7518,9 @@ def once(
         page.on(\"requestfailed\", lambda request: print(request.url + \" \" + request.failure.error_text))
         ```
 
-        > NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will
-        complete with `page.on('request_finished')` event and not with `page.on('request_failed')`. A request will only be
-        considered failed when the client cannot get an HTTP response from the server, e.g. due to network error
+        **NOTE** HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request
+        will complete with `page.on('request_finished')` event and not with `page.on('request_failed')`. A request will
+        only be considered failed when the client cannot get an HTTP response from the server, e.g. due to network error
         net::ERR_FAILED."""
 
     @typing.overload
@@ -6976,8 +7536,8 @@ def once(
         self, event: Literal["response"], f: typing.Callable[["Response"], "None"]
     ) -> None:
         """
-        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of events
-        is `request`, `response` and `requestfinished`."""
+        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of
+        events is `request`, `response` and `requestfinished`."""
 
     @typing.overload
     def once(
@@ -6991,8 +7551,8 @@ def once(
         self, event: Literal["worker"], f: typing.Callable[["Worker"], "None"]
     ) -> None:
         """
-        Emitted when a dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is spawned by the
-        page."""
+        Emitted when a dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is spawned
+        by the page."""
 
     def once(self, event: str, f: typing.Callable[..., None]) -> None:
         return super().once(event=event, f=f)
@@ -7001,10 +7561,6 @@ def once(self, event: str, f: typing.Callable[..., None]) -> None:
     def accessibility(self) -> "Accessibility":
         """Page.accessibility
 
-        **DEPRECATED** This property is deprecated. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you
-        need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for
-        integration with Axe.
-
         Returns
         -------
         Accessibility
@@ -7081,8 +7637,6 @@ def frames(self) -> typing.List["Frame"]:
     def url(self) -> str:
         """Page.url
 
-        Shortcut for main frame's `frame.url()`.
-
         Returns
         -------
         str
@@ -7103,10 +7657,10 @@ def viewport_size(self) -> typing.Optional[ViewportSize]:
     def workers(self) -> typing.List["Worker"]:
         """Page.workers
 
-        This method returns all of the dedicated [WebWorkers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API)
-        associated with the page.
+        This method returns all of the dedicated
+        [WebWorkers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) associated with the page.
 
-        > NOTE: This does not contain ServiceWorkers
+        **NOTE** This does not contain ServiceWorkers
 
         Returns
         -------
@@ -7119,7 +7673,8 @@ def request(self) -> "APIRequestContext":
         """Page.request
 
         API testing helper associated with this page. This method returns the same instance as
-        `browser_context.request` on the page's context. See `browser_context.request` for more details.
+        `browser_context.request` on the page's context. See `browser_context.request` for more
+        details.
 
         Returns
         -------
@@ -7163,6 +7718,8 @@ def frame(
 
         Returns frame matching the specified criteria. Either `name` or `url` must be specified.
 
+        **Usage**
+
         ```py
         frame = page.frame(name=\"frame-name\")
         ```
@@ -7199,7 +7756,7 @@ def set_default_navigation_timeout(self, timeout: float) -> None:
         - `page.expect_navigation()`
         - `page.wait_for_url()`
 
-        > NOTE: `page.set_default_navigation_timeout()` takes priority over `page.set_default_timeout()`,
+        **NOTE** `page.set_default_navigation_timeout()` takes priority over `page.set_default_timeout()`,
         `browser_context.set_default_timeout()` and `browser_context.set_default_navigation_timeout()`.
 
         Parameters
@@ -7217,7 +7774,7 @@ def set_default_timeout(self, timeout: float) -> None:
 
         This setting will change the default maximum time for all the methods accepting `timeout` option.
 
-        > NOTE: `page.set_default_navigation_timeout()` takes priority over `page.set_default_timeout()`.
+        **NOTE** `page.set_default_navigation_timeout()` takes priority over `page.set_default_timeout()`.
 
         Parameters
         ----------
@@ -7234,13 +7791,9 @@ def query_selector(
     ) -> typing.Optional["ElementHandle"]:
         """Page.query_selector
 
-        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
-
         The method finds an element matching the specified selector within the page. If no elements match the selector, the
         return value resolves to `null`. To wait for an element on the page, use `locator.wait_for()`.
 
-        Shortcut for main frame's `frame.query_selector()`.
-
         Parameters
         ----------
         selector : str
@@ -7261,12 +7814,8 @@ def query_selector(
     def query_selector_all(self, selector: str) -> typing.List["ElementHandle"]:
         """Page.query_selector_all
 
-        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
-
-        The method finds all elements matching the specified selector within the page. If no elements match the selector, the
-        return value resolves to `[]`.
-
-        Shortcut for main frame's `frame.query_selector_all()`.
+        The method finds all elements matching the specified selector within the page. If no elements match the selector,
+        the return value resolves to `[]`.
 
         Parameters
         ----------
@@ -7297,15 +7846,37 @@ def wait_for_selector(
         Returns when element specified by selector satisfies `state` option. Returns `null` if waiting for `hidden` or
         `detached`.
 
-        > NOTE: Playwright automatically waits for element to be ready before performing an action. Using `Locator` objects and
-        web-first assertions makes the code wait-for-selector-free.
+        **NOTE** Playwright automatically waits for element to be ready before performing an action. Using `Locator`
+        objects and web-first assertions makes the code wait-for-selector-free.
 
-        Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at
-        the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the
-        selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
+        Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If
+        at the moment of calling the method `selector` already satisfies the condition, the method will return immediately.
+        If the selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
+
+        **Usage**
 
         This method works across navigations:
 
+        ```py
+        import asyncio
+        from playwright.async_api import async_playwright
+
+        async def run(playwright):
+            chromium = playwright.chromium
+            browser = await chromium.launch()
+            page = await browser.new_page()
+            for current_url in [\"https://google.com\", \"https://bbc.com\"]:
+                await page.goto(current_url, wait_until=\"domcontentloaded\")
+                element = await page.wait_for_selector(\"img\")
+                print(\"Loaded image: \" + str(await element.get_attribute(\"src\")))
+            await browser.close()
+
+        async def main():
+            async with async_playwright() as playwright:
+                await run(playwright)
+        asyncio.run(main())
+        ```
+
         ```py
         from playwright.sync_api import sync_playwright
 
@@ -7328,16 +7899,16 @@ def run(playwright):
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
             - `'detached'` - wait for element to not be present in DOM.
-            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element without
-              any content or with `display:none` has an empty bounding box and is not considered visible.
-            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.
-              This is opposite to the `'visible'` option.
+            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element
+              without any content or with `display:none` has an empty bounding box and is not considered visible.
+            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or
+              `visibility:hidden`. This is opposite to the `'visible'` option.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -7369,14 +7940,14 @@ def is_checked(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -7405,14 +7976,14 @@ def is_disabled(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -7441,14 +8012,14 @@ def is_editable(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -7477,14 +8048,14 @@ def is_enabled(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -7508,20 +8079,18 @@ def is_hidden(
     ) -> bool:
         """Page.is_hidden
 
-        Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).  `selector` that does not
-        match any elements is considered hidden.
+        Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).  `selector` that
+        does not match any elements is considered hidden.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `page.is_hidden()` does not wait for the element to become hidden and
-            returns immediately.
 
         Returns
         -------
@@ -7545,20 +8114,18 @@ def is_visible(
     ) -> bool:
         """Page.is_visible
 
-        Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible). `selector` that does not match any elements is
-        considered not visible.
+        Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible). `selector` that does not match any elements
+        is considered not visible.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `page.is_visible()` does not wait for the element to become visible and
-            returns immediately.
 
         Returns
         -------
@@ -7588,12 +8155,18 @@ def dispatch_event(
         `click` is dispatched. This is equivalent to calling
         [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
 
+        **Usage**
+
+        ```py
+        await page.dispatch_event(\"button#submit\", \"click\")
+        ```
+
         ```py
         page.dispatch_event(\"button#submit\", \"click\")
         ```
 
-        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties
-        and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
+        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
+        properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
@@ -7606,6 +8179,12 @@ def dispatch_event(
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
+        ```py
+        # note you can only create data_transfer in chromium and firefox
+        data_transfer = await page.evaluate_handle(\"new DataTransfer()\")
+        await page.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
+        ```
+
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = page.evaluate_handle(\"new DataTransfer()\")
@@ -7615,15 +8194,15 @@ def dispatch_event(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         type : str
             DOM event type: `"click"`, `"dragstart"`, etc.
         event_init : Union[Dict, None]
             Optional event-specific initialization properties.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -7648,15 +8227,22 @@ def evaluate(
 
         Returns the value of the `expression` invocation.
 
-        If the function passed to the `page.evaluate()` returns a [Promise], then `page.evaluate()` would wait
-        for the promise to resolve and return its value.
+        If the function passed to the `page.evaluate()` returns a [Promise], then `page.evaluate()` would
+        wait for the promise to resolve and return its value.
 
         If the function passed to the `page.evaluate()` returns a non-[Serializable] value, then
-        `page.evaluate()` resolves to `undefined`. Playwright also supports transferring some additional values that are
-        not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
+        `page.evaluate()` resolves to `undefined`. Playwright also supports transferring some additional values
+        that are not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
+
+        **Usage**
 
         Passing argument to `expression`:
 
+        ```py
+        result = await page.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
+        print(result) # prints \"56\"
+        ```
+
         ```py
         result = page.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
         print(result) # prints \"56\"
@@ -7664,6 +8250,12 @@ def evaluate(
 
         A string can also be passed in instead of a function:
 
+        ```py
+        print(await page.evaluate(\"1 + 2\")) # prints \"3\"
+        x = 10
+        print(await page.evaluate(f\"1 + {x}\")) # prints \"11\"
+        ```
+
         ```py
         print(page.evaluate(\"1 + 2\")) # prints \"3\"
         x = 10
@@ -7672,19 +8264,23 @@ def evaluate(
 
         `ElementHandle` instances can be passed as an argument to the `page.evaluate()`:
 
+        ```py
+        body_handle = await page.evaluate(\"document.body\")
+        html = await page.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
+        await body_handle.dispose()
+        ```
+
         ```py
         body_handle = page.evaluate(\"document.body\")
         html = page.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
         body_handle.dispose()
         ```
 
-        Shortcut for main frame's `frame.evaluate()`.
-
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -7709,8 +8305,15 @@ def evaluate_handle(
         The only difference between `page.evaluate()` and `page.evaluate_handle()` is that
         `page.evaluate_handle()` returns `JSHandle`.
 
-        If the function passed to the `page.evaluate_handle()` returns a [Promise], then `page.evaluate_handle()`
-        would wait for the promise to resolve and return its value.
+        If the function passed to the `page.evaluate_handle()` returns a [Promise], then
+        `page.evaluate_handle()` would wait for the promise to resolve and return its value.
+
+        **Usage**
+
+        ```py
+        a_window_handle = await page.evaluate_handle(\"Promise.resolve(window)\")
+        a_window_handle # handle for the window object.
+        ```
 
         ```py
         a_window_handle = page.evaluate_handle(\"Promise.resolve(window)\")
@@ -7719,12 +8322,23 @@ def evaluate_handle(
 
         A string can also be passed in instead of a function:
 
+        ```py
+        a_handle = await page.evaluate_handle(\"document\") # handle for the \"document\"
+        ```
+
         ```py
         a_handle = page.evaluate_handle(\"document\") # handle for the \"document\"
         ```
 
         `JSHandle` instances can be passed as an argument to the `page.evaluate_handle()`:
 
+        ```py
+        a_handle = await page.evaluate_handle(\"document.body\")
+        result_handle = await page.evaluate_handle(\"body => body.innerHTML\", a_handle)
+        print(await result_handle.json_value())
+        await result_handle.dispose()
+        ```
+
         ```py
         a_handle = page.evaluate_handle(\"document.body\")
         result_handle = page.evaluate_handle(\"body => body.innerHTML\", a_handle)
@@ -7735,8 +8349,8 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -7763,16 +8377,19 @@ def eval_on_selector(
     ) -> typing.Any:
         """Page.eval_on_selector
 
-        > NOTE: This method does not wait for the element to pass actionability checks and therefore can lead to the flaky
-        tests. Use `locator.evaluate()`, other `Locator` helper methods or web-first assertions instead.
-
         The method finds an element matching the specified selector within the page and passes it as a first argument to
         `expression`. If no elements match the selector, the method throws an error. Returns the value of `expression`.
 
         If `expression` returns a [Promise], then `page.eval_on_selector()` would wait for the promise to resolve and
         return its value.
 
-        Examples:
+        **Usage**
+
+        ```py
+        search_value = await page.eval_on_selector(\"#search\", \"el => el.value\")
+        preload_href = await page.eval_on_selector(\"link[rel=preload]\", \"el => el.href\")
+        html = await page.eval_on_selector(\".main-container\", \"(e, suffix) => e.outer_html + suffix\", \"hello\")
+        ```
 
         ```py
         search_value = page.eval_on_selector(\"#search\", \"el => el.value\")
@@ -7780,15 +8397,13 @@ def eval_on_selector(
         html = page.eval_on_selector(\".main-container\", \"(e, suffix) => e.outer_html + suffix\", \"hello\")
         ```
 
-        Shortcut for main frame's `frame.eval_on_selector()`.
-
         Parameters
         ----------
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         strict : Union[bool, None]
@@ -7816,16 +8431,17 @@ def eval_on_selector_all(
     ) -> typing.Any:
         """Page.eval_on_selector_all
 
-        > NOTE: In most cases, `locator.evaluate_all()`, other `Locator` helper methods and web-first assertions do a
-        better job.
+        The method finds all elements matching the specified selector within the page and passes an array of matched
+        elements as a first argument to `expression`. Returns the result of `expression` invocation.
 
-        The method finds all elements matching the specified selector within the page and passes an array of matched elements as
-        a first argument to `expression`. Returns the result of `expression` invocation.
+        If `expression` returns a [Promise], then `page.eval_on_selector_all()` would wait for the promise to resolve
+        and return its value.
 
-        If `expression` returns a [Promise], then `page.eval_on_selector_all()` would wait for the promise to resolve and
-        return its value.
+        **Usage**
 
-        Examples:
+        ```py
+        div_counts = await page.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
+        ```
 
         ```py
         div_counts = page.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
@@ -7836,8 +8452,8 @@ def eval_on_selector_all(
         selector : str
             A selector to query for. See [working with selectors](../selectors.md) for more details.
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -7867,15 +8483,13 @@ def add_script_tag(
         Adds a `<script>` tag into the page with the desired url or content. Returns the added tag when the script's onload
         fires or when the script content was injected into frame.
 
-        Shortcut for main frame's `frame.add_script_tag()`.
-
         Parameters
         ----------
         url : Union[str, None]
             URL of a script to be added.
         path : Union[pathlib.Path, str, None]
-            Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative to the
-            current working directory.
+            Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative
+            to the current working directory.
         content : Union[str, None]
             Raw JavaScript content to be injected into frame.
         type : Union[str, None]
@@ -7907,8 +8521,6 @@ def add_style_tag(
         Adds a `<link rel=\"stylesheet\">` tag into the page with the desired url or a `<style type=\"text/css\">` tag with the
         content. Returns the added tag when the stylesheet's onload fires or when the CSS content was injected into frame.
 
-        Shortcut for main frame's `frame.add_style_tag()`.
-
         Parameters
         ----------
         url : Union[str, None]
@@ -7933,17 +8545,51 @@ def add_style_tag(
     def expose_function(self, name: str, callback: typing.Callable) -> None:
         """Page.expose_function
 
-        The method adds a function called `name` on the `window` object of every frame in the page. When called, the function
-        executes `callback` and returns a [Promise] which resolves to the return value of `callback`.
+        The method adds a function called `name` on the `window` object of every frame in the page. When called, the
+        function executes `callback` and returns a [Promise] which resolves to the return value of `callback`.
 
         If the `callback` returns a [Promise], it will be awaited.
 
         See `browser_context.expose_function()` for context-wide exposed function.
 
-        > NOTE: Functions installed via `page.expose_function()` survive navigations.
+        **NOTE** Functions installed via `page.expose_function()` survive navigations.
+
+        **Usage**
 
         An example of adding a `sha256` function to the page:
 
+        ```py
+        import asyncio
+        import hashlib
+        from playwright.async_api import async_playwright
+
+        def sha256(text):
+            m = hashlib.sha256()
+            m.update(bytes(text, \"utf8\"))
+            return m.hexdigest()
+
+        async def run(playwright):
+            webkit = playwright.webkit
+            browser = await webkit.launch(headless=False)
+            page = await browser.new_page()
+            await page.expose_function(\"sha256\", sha256)
+            await page.set_content(\"\"\"
+                <script>
+                  async function onClick() {
+                    document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
+                  }
+                </script>
+                <button onclick=\"onClick()\">Click me</button>
+                <div></div>
+            \"\"\")
+            await page.click(\"button\")
+
+        async def main():
+            async with async_playwright() as playwright:
+                await run(playwright)
+        asyncio.run(main())
+        ```
+
         ```py
         import hashlib
         from playwright.sync_api import sync_playwright
@@ -7998,19 +8644,48 @@ def expose_binding(
     ) -> None:
         """Page.expose_binding
 
-        The method adds a function called `name` on the `window` object of every frame in this page. When called, the function
-        executes `callback` and returns a [Promise] which resolves to the return value of `callback`. If the `callback` returns
-        a [Promise], it will be awaited.
+        The method adds a function called `name` on the `window` object of every frame in this page. When called, the
+        function executes `callback` and returns a [Promise] which resolves to the return value of `callback`. If the
+        `callback` returns a [Promise], it will be awaited.
 
-        The first argument of the `callback` function contains information about the caller: `{ browserContext: BrowserContext,
-        page: Page, frame: Frame }`.
+        The first argument of the `callback` function contains information about the caller: `{ browserContext:
+        BrowserContext, page: Page, frame: Frame }`.
 
         See `browser_context.expose_binding()` for the context-wide version.
 
-        > NOTE: Functions installed via `page.expose_binding()` survive navigations.
+        **NOTE** Functions installed via `page.expose_binding()` survive navigations.
+
+        **Usage**
 
         An example of exposing page URL to all frames in a page:
 
+        ```py
+        import asyncio
+        from playwright.async_api import async_playwright
+
+        async def run(playwright):
+            webkit = playwright.webkit
+            browser = await webkit.launch(headless=false)
+            context = await browser.new_context()
+            page = await context.new_page()
+            await page.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
+            await page.set_content(\"\"\"
+            <script>
+              async function onClick() {
+                document.querySelector('div').textContent = await window.pageURL();
+              }
+            </script>
+            <button onclick=\"onClick()\">Click me</button>
+            <div></div>
+            \"\"\")
+            await page.click(\"button\")
+
+        async def main():
+            async with async_playwright() as playwright:
+                await run(playwright)
+        asyncio.run(main())
+        ```
+
         ```py
         from playwright.sync_api import sync_playwright
 
@@ -8037,6 +8712,20 @@ def run(playwright):
 
         An example of passing an element handle:
 
+        ```py
+        async def print(source, element):
+            print(await element.text_content())
+
+        await page.expose_binding(\"clicked\", print, handle=true)
+        await page.set_content(\"\"\"
+          <script>
+            document.addEventListener('click', event => window.clicked(event.target));
+          </script>
+          <div>Click me</div>
+          <div>Or click me</div>
+        \"\"\")
+        ```
+
         ```py
         def print(source, element):
             print(element.text_content())
@@ -8075,7 +8764,7 @@ def set_extra_http_headers(self, headers: typing.Dict[str, str]) -> None:
 
         The extra HTTP headers will be sent with every request the page initiates.
 
-        > NOTE: `page.set_extra_http_headers()` does not guarantee the order of headers in the outgoing requests.
+        **NOTE** `page.set_extra_http_headers()` does not guarantee the order of headers in the outgoing requests.
 
         Parameters
         ----------
@@ -8117,16 +8806,18 @@ def set_content(
         html : str
             HTML markup to assign to the page.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         """
 
         return mapping.from_maybe_impl(
@@ -8159,34 +8850,35 @@ def goto(
         - the remote server does not respond or is unreachable.
         - the main resource failed to load.
 
-        The method will not throw an error when any valid HTTP status code is returned by the remote server, including 404 \"Not
-        Found\" and 500 \"Internal Server Error\".  The status code for such responses can be retrieved by calling
+        The method will not throw an error when any valid HTTP status code is returned by the remote server, including 404
+        \"Not Found\" and 500 \"Internal Server Error\".  The status code for such responses can be retrieved by calling
         `response.status()`.
 
-        > NOTE: The method either throws an error or returns a main resource response. The only exceptions are navigation to
-        `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
-        > NOTE: Headless mode doesn't support navigation to a PDF document. See the
-        [upstream issue](https://bugs.chromium.org/p/chromium/issues/detail?id=761295).
+        **NOTE** The method either throws an error or returns a main resource response. The only exceptions are navigation
+        to `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
 
-        Shortcut for main frame's `frame.goto()`
+        **NOTE** Headless mode doesn't support navigation to a PDF document. See the
+        [upstream issue](https://bugs.chromium.org/p/chromium/issues/detail?id=761295).
 
         Parameters
         ----------
         url : str
-            URL to navigate page to. The url should include scheme, e.g. `https://`. When a `baseURL` via the context options was
-            provided and the passed URL is a path, it gets merged via the
+            URL to navigate page to. The url should include scheme, e.g. `https://`. 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.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         referer : Union[str, None]
             Referer header value. If provided it will take preference over the referer header value set by
             `page.set_extra_http_headers()`.
@@ -8214,22 +8906,25 @@ def reload(
     ) -> typing.Optional["Response"]:
         """Page.reload
 
-        This method reloads the current page, in the same way as if the user had triggered a browser refresh. Returns the main
-        resource response. In case of multiple redirects, the navigation will resolve with the response of the last redirect.
+        This method reloads the current page, in the same way as if the user had triggered a browser refresh. Returns the
+        main resource response. In case of multiple redirects, the navigation will resolve with the response of the last
+        redirect.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
 
         Returns
         -------
@@ -8252,14 +8947,31 @@ def wait_for_load_state(
 
         Returns when the required load state has been reached.
 
-        This resolves when the page reaches a required load state, `load` by default. The navigation must have been committed
-        when this method is called. If current document has already reached the required state, resolves immediately.
+        This resolves when the page reaches a required load state, `load` by default. The navigation must have been
+        committed when this method is called. If current document has already reached the required state, resolves
+        immediately.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"button\").click() # click triggers navigation.
+        await page.wait_for_load_state() # the promise resolves after \"load\" event.
+        ```
 
         ```py
         page.get_by_role(\"button\").click() # click triggers navigation.
         page.wait_for_load_state() # the promise resolves after \"load\" event.
         ```
 
+        ```py
+        async with page.expect_popup() as page_info:
+            await page.get_by_role(\"button\").click() # click triggers a popup.
+        popup = await page_info.value
+         # Following resolves after \"domcontentloaded\" event.
+        await popup.wait_for_load_state(\"domcontentloaded\")
+        print(await popup.title()) # popup is ready to use.
+        ```
+
         ```py
         with page.expect_popup() as page_info:
             page.get_by_role(\"button\").click() # click triggers a popup.
@@ -8269,8 +8981,6 @@ def wait_for_load_state(
         print(popup.title()) # popup is ready to use.
         ```
 
-        Shortcut for main frame's `frame.wait_for_load_state()`.
-
         Parameters
         ----------
         state : Union["domcontentloaded", "load", "networkidle", None]
@@ -8280,8 +8990,8 @@ def wait_for_load_state(
             - `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired.
             - `'networkidle'` - wait until there are no network connections for at least `500` ms.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         """
@@ -8303,28 +9013,35 @@ def wait_for_url(
 
         Waits for the main frame to navigate to the given URL.
 
+        **Usage**
+
+        ```py
+        await page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+        await page.wait_for_url(\"**/target.html\")
+        ```
+
         ```py
         page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
         page.wait_for_url(\"**/target.html\")
         ```
 
-        Shortcut for main frame's `frame.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 the
-            parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to
-            the string.
+            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]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         """
@@ -8346,11 +9063,11 @@ def wait_for_event(
     ) -> typing.Any:
         """Page.wait_for_event
 
-        > NOTE: In most cases, you should use `page.expect_event()`.
+        **NOTE** In most cases, you should use `page.expect_event()`.
 
-        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function and
-        waits for `predicate(event)` to return a truthy value. Will throw an error if the page is closed before the `event` is
-        fired.
+        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function
+        and waits for `predicate(event)` to return a truthy value. Will throw an error if the page is closed before the
+        `event` is fired.
 
         Parameters
         ----------
@@ -8359,8 +9076,8 @@ def wait_for_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()`.
+            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
         -------
@@ -8387,24 +9104,26 @@ def go_back(
     ) -> typing.Optional["Response"]:
         """Page.go_back
 
-        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
-        last redirect. If can not go back, returns `null`.
+        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
+        the last redirect. If can not go back, returns `null`.
 
         Navigate to the previous page in history.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
 
         Returns
         -------
@@ -8425,24 +9144,26 @@ def go_forward(
     ) -> typing.Optional["Response"]:
         """Page.go_forward
 
-        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
-        last redirect. If can not go forward, returns `null`.
+        Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
+        the last redirect. If can not go forward, returns `null`.
 
         Navigate to the next page in history.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
 
         Returns
         -------
@@ -8470,6 +9191,27 @@ def emulate_media(
         This method changes the `CSS media type` through the `media` argument, and/or the `'prefers-colors-scheme'` media
         feature, using the `colorScheme` argument.
 
+        **Usage**
+
+        ```py
+        await page.evaluate(\"matchMedia('screen').matches\")
+        # → True
+        await page.evaluate(\"matchMedia('print').matches\")
+        # → False
+
+        await page.emulate_media(media=\"print\")
+        await page.evaluate(\"matchMedia('screen').matches\")
+        # → False
+        await page.evaluate(\"matchMedia('print').matches\")
+        # → True
+
+        await page.emulate_media()
+        await page.evaluate(\"matchMedia('screen').matches\")
+        # → True
+        await page.evaluate(\"matchMedia('print').matches\")
+        # → False
+        ```
+
         ```py
         page.evaluate(\"matchMedia('screen').matches\")
         # → True
@@ -8489,6 +9231,16 @@ def emulate_media(
         # → False
         ```
 
+        ```py
+        await page.emulate_media(color_scheme=\"dark\")
+        await page.evaluate(\"matchMedia('(prefers-color-scheme: dark)').matches\")
+        # → True
+        await page.evaluate(\"matchMedia('(prefers-color-scheme: light)').matches\")
+        # → False
+        await page.evaluate(\"matchMedia('(prefers-color-scheme: no-preference)').matches\")
+        # → False
+        ```
+
         ```py
         page.emulate_media(color_scheme=\"dark\")
         page.evaluate(\"matchMedia('(prefers-color-scheme: dark)').matches\")
@@ -8501,14 +9253,14 @@ def emulate_media(
         Parameters
         ----------
         media : Union["null", "print", "screen", None]
-            Changes the CSS media type of the page. The only allowed values are `'Screen'`, `'Print'` and `'Null'`. Passing `'Null'`
-            disables CSS media emulation.
+            Changes the CSS media type of the page. The only allowed values are `'Screen'`, `'Print'` and `'Null'`. Passing
+            `'Null'` disables CSS media emulation.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
-            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. Passing
-            `'Null'` disables color scheme emulation.
+            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`.
+            Passing `'Null'` disables color scheme emulation.
         reduced_motion : Union["no-preference", "null", "reduce", None]
-            Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. Passing `null`
-            disables reduced motion emulation.
+            Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. Passing
+            `null` disables reduced motion emulation.
         forced_colors : Union["active", "none", "null", None]
         """
 
@@ -8530,9 +9282,17 @@ def set_viewport_size(self, viewport_size: ViewportSize) -> None:
         `browser.new_context()` allows to set viewport size (and more) for all pages in the context at once.
 
         `page.set_viewport_size()` will resize the page. A lot of websites don't expect phones to change size, so you
-        should set the viewport size before navigating to the page. `page.set_viewport_size()` will also reset `screen`
-        size, use `browser.new_context()` with `screen` and `viewport` parameters if you need better control of these
-        properties.
+        should set the viewport size before navigating to the page. `page.set_viewport_size()` will also reset
+        `screen` size, use `browser.new_context()` with `screen` and `viewport` parameters if you need better
+        control of these properties.
+
+        **Usage**
+
+        ```py
+        page = await browser.new_page()
+        await page.set_viewport_size({\"width\": 640, \"height\": 480})
+        await page.goto(\"https://example.com\")
+        ```
 
         ```py
         page = browser.new_page()
@@ -8567,20 +9327,27 @@ def add_init_script(
 
         Adds a script which would be evaluated in one of the following scenarios:
         - Whenever the page is navigated.
-        - Whenever the child frame is attached or navigated. In this case, the script is evaluated in the context of the newly
-          attached frame.
+        - Whenever the child frame is attached or navigated. In this case, the script is evaluated in the context of the
+          newly attached frame.
 
-        The script is evaluated after the document was created but before any of its scripts were run. This is useful to amend
-        the JavaScript environment, e.g. to seed `Math.random`.
+        The script is evaluated after the document was created but before any of its scripts were run. This is useful to
+        amend the JavaScript environment, e.g. to seed `Math.random`.
+
+        **Usage**
 
         An example of overriding `Math.random` before the page loads:
 
+        ```py
+        # in your playwright script, assuming the preload.js file is in same directory
+        await page.add_init_script(path=\"./preload.js\")
+        ```
+
         ```py
         # in your playwright script, assuming the preload.js file is in same directory
         page.add_init_script(path=\"./preload.js\")
         ```
 
-        > NOTE: The order of evaluation of multiple scripts installed via `browser_context.add_init_script()` and
+        **NOTE** The order of evaluation of multiple scripts installed via `browser_context.add_init_script()` and
         `page.add_init_script()` is not defined.
 
         Parameters
@@ -8610,15 +9377,26 @@ def route(
 
         Routing provides the capability to modify network requests that are made by a page.
 
-        Once routing is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or aborted.
+        Once routing is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or
+        aborted.
+
+        **NOTE** The handler will only be called for the first url if the response is a redirect.
 
-        > NOTE: The handler will only be called for the first url if the response is a redirect.
-        > NOTE: `page.route()` will not intercept requests intercepted by Service Worker. See
-        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
-        request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        **NOTE** `page.route()` will not intercept requests intercepted by Service Worker. See
+        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
+        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+
+        **Usage**
 
         An example of a naive handler that aborts all image requests:
 
+        ```py
+        page = await browser.new_page()
+        await page.route(\"**/*.{png,jpg,jpeg}\", lambda route: route.abort())
+        await page.goto(\"https://example.com\")
+        await browser.close()
+        ```
+
         ```py
         page = browser.new_page()
         page.route(\"**/*.{png,jpg,jpeg}\", lambda route: route.abort())
@@ -8628,6 +9406,13 @@ def route(
 
         or the same snippet using a regex pattern instead:
 
+        ```py
+        page = await browser.new_page()
+        await page.route(re.compile(r\"(\\.png$)|(\\.jpg$)\"), lambda route: route.abort())
+        await page.goto(\"https://example.com\")
+        await browser.close()
+        ```
+
         ```py
         page = browser.new_page()
         page.route(re.compile(r\"(\\.png$)|(\\.jpg$)\"), lambda route: route.abort())
@@ -8635,8 +9420,17 @@ def route(
         browser.close()
         ```
 
-        It is possible to examine the request to decide the route action. For example, mocking all requests that contain some
-        post data, and leaving all other requests as is:
+        It is possible to examine the request to decide the route action. For example, mocking all requests that contain
+        some post data, and leaving all other requests as is:
+
+        ```py
+        def handle_route(route):
+          if (\"my-string\" in route.request.post_data)
+            route.fulfill(body=\"mocked-data\")
+          else
+            route.continue_()
+        await page.route(\"/api/**\", handle_route)
+        ```
 
         ```py
         def handle_route(route):
@@ -8652,7 +9446,7 @@ def handle_route(route):
 
         To remove a route with its handler you can use `page.unroute()`.
 
-        > NOTE: Enabling routing disables http cache.
+        **NOTE** Enabling routing disables http cache.
 
         Parameters
         ----------
@@ -8688,7 +9482,8 @@ def unroute(
     ) -> None:
         """Page.unroute
 
-        Removes a route created with `page.route()`. When `handler` is not specified, removes all routes for the `url`.
+        Removes a route created with `page.route()`. When `handler` is not specified, removes all routes for the
+        `url`.
 
         Parameters
         ----------
@@ -8720,8 +9515,8 @@ def route_from_har(
         [Replaying from HAR](https://playwright.dev/python/docs/network#replaying-from-har).
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
-        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
-        request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
+        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
 
         Parameters
         ----------
@@ -8729,8 +9524,8 @@ def route_from_har(
             Path to a [HAR](http://www.softwareishard.com/blog/har-12-spec) file with prerecorded network data. If `path` is a
             relative path, then it is resolved relative to the current working directory.
         url : Union[Pattern[str], str, None]
-            A glob pattern, regular expression or predicate to match the request URL. Only requests with URL matching the pattern
-            will be served from the HAR file. If not specified, all requests are served from the HAR file.
+            A glob pattern, regular expression or predicate to match the request URL. Only requests with URL matching the
+            pattern will be served from the HAR file. If not specified, all requests are served from the HAR file.
         not_found : Union["abort", "fallback", None]
             - If set to 'abort' any request not found in the HAR file will be aborted.
             - If set to 'fallback' missing requests will be sent to the network.
@@ -8771,14 +9566,14 @@ def screenshot(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
-            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a relative
-            path, then it is resolved relative to the current working directory. If no path is provided, the image won't be saved to
-            the disk.
+            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a
+            relative path, then it is resolved relative to the current working directory. If no path is provided, the image
+            won't be saved to the disk.
         quality : Union[int, None]
             The quality of the image, between 0-100. Not applicable to `png` images.
         omit_background : Union[bool, None]
@@ -8790,24 +9585,24 @@ def screenshot(
         clip : Union[{x: float, y: float, width: float, height: float}, None]
             An object which specifies clipping of the resulting image. Should have the following fields:
         animations : Union["allow", "disabled", None]
-            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different treatment
-            depending on their duration:
+            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different
+            treatment depending on their duration:
             - finite animations are fast-forwarded to completion, so they'll fire `transitionend` event.
             - infinite animations are canceled to initial state, and then played over after the screenshot.
 
             Defaults to `"allow"` that leaves animations untouched.
         caret : Union["hide", "initial", None]
-            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be changed.
-            Defaults to `"hide"`.
+            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be
+            changed.  Defaults to `"hide"`.
         scale : Union["css", "device", None]
-            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
-            high-dpi devices will be twice as large or even larger.
+            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this
+            will keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so
+            screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
-            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-            `#FF00FF` that completely covers its bounding box.
+            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
+            box `#FF00FF` that completely covers its bounding box.
 
         Returns
         -------
@@ -8835,7 +9630,7 @@ def screenshot(
     def title(self) -> str:
         """Page.title
 
-        Returns the page's title. Shortcut for main frame's `frame.title()`.
+        Returns the page's title.
 
         Returns
         -------
@@ -8852,8 +9647,8 @@ def close(self, *, run_before_unload: typing.Optional[bool] = None) -> None:
 
         By default, `page.close()` **does not** run `beforeunload` handlers.
 
-        > NOTE: if `runBeforeUnload` is passed as true, a `beforeunload` dialog might be summoned and should be handled manually
-        via `page.on('dialog')` event.
+        **NOTE** if `runBeforeUnload` is passed as true, a `beforeunload` dialog might be summoned and should be handled
+        manually via `page.on('dialog')` event.
 
         Parameters
         ----------
@@ -8899,28 +9694,26 @@ def click(
 
         This method clicks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        Shortcut for main frame's `frame.click()`.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -8928,17 +9721,17 @@ def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8982,50 +9775,48 @@ def dblclick(
 
         This method double clicks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if the
-           first click of the `dblclick()` triggers a navigation event, this method will throw.
-
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
+           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
-        > NOTE: `page.dblclick()` dispatches two `click` events and a single `dblclick` event.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        Shortcut for main frame's `frame.dblclick()`.
+        **NOTE** `page.dblclick()` dispatches two `click` events and a single `dblclick` event.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -9063,45 +9854,43 @@ def tap(
 
         This method taps an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        > NOTE: `page.tap()` requires that the `hasTouch` option of the browser context be set to true.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        Shortcut for main frame's `frame.tap()`.
+        **NOTE** `page.tap()` requires that the `hasTouch` option of the browser context be set to true.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -9131,33 +9920,31 @@ def fill(
     ) -> None:
         """Page.fill
 
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the
-        element, fills it and triggers an `input` event after filling. Note that you can pass an empty string to clear the input
-        field.
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks,
+        focuses the element, fills it and triggers an `input` event after filling. Note that you can pass an empty string
+        to clear the input field.
 
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an
+        error. However, if the element is inside the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
         To send fine-grained keyboard events, use `page.type()`.
 
-        Shortcut for main frame's `frame.fill()`.
-
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9187,9 +9974,9 @@ def locator(
     ) -> "Locator":
         """Page.locator
 
-        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved to
-        the element immediately before performing an action, so a series of actions on the same locator can in fact be performed
-        on different DOM elements. That would happen if the DOM structure between those actions has changed.
+        The method returns an element locator that can be used to perform actions on this page / frame. Locator is resolved
+        to the element immediately before performing an action, so a series of actions on the same locator can in fact be
+        performed on different DOM elements. That would happen if the DOM structure between those actions has changed.
 
         [Learn more about locators](https://playwright.dev/python/docs/locators).
 
@@ -9198,12 +9985,12 @@ def locator(
         selector : str
             A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
         has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
+            passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
+            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
@@ -9237,8 +10024,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9268,8 +10055,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9298,8 +10085,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9415,9 +10202,10 @@ def get_by_role(
         accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
 
         Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
-        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
-        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
+        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
+        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
+        default values.
 
         Parameters
         ----------
@@ -9430,7 +10218,7 @@ def get_by_role(
         disabled : Union[bool, None]
             An attribute that is usually set by `aria-disabled` or `disabled`.
 
-            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
@@ -9442,8 +10230,8 @@ def get_by_role(
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
         level : Union[int, None]
-            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
-            `<h1>-<h6>` elements.
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values
+            for `<h1>-<h6>` elements.
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
@@ -9460,8 +10248,8 @@ def get_by_role(
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
         exact : Union[bool, None]
-            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
-            expression. Note that exact match still trims whitespace.
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9535,21 +10323,39 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
-        by the text content.
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
 
-        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
-        one, turns line breaks into spaces and ignores leading and trailing whitespace.
-        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
-        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
+        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+
+        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
+        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9566,7 +10372,8 @@ def get_by_title(
     ) -> "Locator":
         """Page.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
+        order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -9577,8 +10384,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -9590,10 +10397,19 @@ def get_by_title(
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Page.frame_locator
 
-        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements in
-        that iframe. Following snippet locates element with text \"Submit\" in the iframe with id `my-frame`, like `<iframe
+        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
+        in that iframe.
+
+        **Usage**
+
+        Following snippet locates element with text \"Submit\" in the iframe with id `my-frame`, like `<iframe
         id=\"my-frame\">`:
 
+        ```py
+        locator = page.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
+        await locator.click()
+        ```
+
         ```py
         locator = page.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
         locator.click()
@@ -9620,22 +10436,20 @@ def focus(
     ) -> None:
         """Page.focus
 
-        This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the method
-        waits until a matching element appears in the DOM.
-
-        Shortcut for main frame's `frame.focus()`.
+        This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the
+        method waits until a matching element appears in the DOM.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -9658,14 +10472,14 @@ def text_content(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -9694,14 +10508,14 @@ def inner_text(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -9730,14 +10544,14 @@ def inner_html(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -9767,16 +10581,16 @@ def get_attribute(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         name : str
             Attribute name to get the value for.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -9809,43 +10623,41 @@ def hover(
 
         This method hovers over an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        Shortcut for main frame's `frame.hover()`.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -9881,6 +10693,19 @@ def drag_and_drop(
         This method drags the source element to the target element. It will first move to the source element, perform a
         `mousedown`, then move to the target element and perform a `mouseup`.
 
+        **Usage**
+
+        ```py
+        await page.drag_and_drop(\"#source\", \"#target\")
+        # or specify exact positions relative to the top-left corners of the elements:
+        await page.drag_and_drop(
+          \"#source\",
+          \"#target\",
+          source_position={\"x\": 34, \"y\": 7},
+          target_position={\"x\": 10, \"y\": 20}
+        )
+        ```
+
         ```py
         page.drag_and_drop(\"#source\", \"#target\")
         # or specify exact positions relative to the top-left corners of the elements:
@@ -9895,11 +10720,11 @@ def drag_and_drop(
         Parameters
         ----------
         source : str
-            A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
-        target : str
-            A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will
+            A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will
             be used. See [working with selectors](../selectors.md) for more details.
+        target : str
+            A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first
+            will be used. See [working with selectors](../selectors.md) for more details.
         source_position : Union[{x: float, y: float}, None]
             Clicks on the source 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.
@@ -9909,18 +10734,18 @@ def drag_and_drop(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -9956,17 +10781,29 @@ def select_option(
     ) -> typing.List[str]:
         """Page.select_option
 
-        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until
-        all specified options are present in the `<select>` element and selects these options.
+        This method waits for an element matching `selector`, waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits
+        until all specified options are present in the `<select>` element and selects these options.
 
-        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside the
-        `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used instead.
+        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside
+        the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used
+        instead.
 
         Returns the array of option values that have been successfully selected.
 
         Triggers a `change` and `input` event once all the provided options have been selected.
 
+        **Usage**
+
+        ```py
+        # single selection matching the value
+        await page.select_option(\"select#colors\", \"blue\")
+        # single selection matching the label
+        await page.select_option(\"select#colors\", label=\"blue\")
+        # multiple selection
+        await page.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
+        ```
+
         ```py
         # single selection matching the value
         page.select_option(\"select#colors\", \"blue\")
@@ -9976,30 +10813,28 @@ def select_option(
         page.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
         ```
 
-        Shortcut for main frame's `frame.select_option()`.
-
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         value : Union[List[str], str, None]
-            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         index : Union[List[int], int, None]
             Options to select by index. Optional.
         label : Union[List[str], str, None]
-            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -10039,19 +10874,20 @@ def input_value(
         Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
 
         Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the
+        control.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -10083,30 +10919,30 @@ def set_input_files(
     ) -> None:
         """Page.set_input_files
 
-        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
-        are resolved relative to the current working directory. For empty array, clears the selected files.
+        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
+        they are resolved relative to the current working directory. For empty array, clears the selected files.
 
         This method expects `selector` to point to an
-        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
-        `<label>` element that has an associated
+        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
+        the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -10133,34 +10969,39 @@ def type(
     ) -> None:
         """Page.type
 
-        Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `page.type` can be used to send
-        fine-grained keyboard events. To fill values in form fields, use `page.fill()`.
+        Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `page.type` can be used to
+        send fine-grained keyboard events. To fill values in form fields, use `page.fill()`.
 
         To press a special key, like `Control` or `ArrowDown`, use `keyboard.press()`.
 
+        **Usage**
+
+        ```py
+        await page.type(\"#mytextarea\", \"hello\") # types instantly
+        await page.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
+        ```
+
         ```py
         page.type(\"#mytextarea\", \"hello\") # types instantly
         page.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
         ```
 
-        Shortcut for main frame's `frame.type()`.
-
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         text : str
             A text to type into a focused element.
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10193,12 +11034,14 @@ def press(
 
         Focuses the element, and then uses `keyboard.down()` and `keyboard.up()`.
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -10210,6 +11053,20 @@ def press(
         Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
         modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
+        **Usage**
+
+        ```py
+        page = await browser.new_page()
+        await page.goto(\"https://keycode.info\")
+        await page.press(\"body\", \"A\")
+        await page.screenshot(path=\"a.png\")
+        await page.press(\"body\", \"ArrowLeft\")
+        await page.screenshot(path=\"arrow_left.png\")
+        await page.press(\"body\", \"Shift+O\")
+        await page.screenshot(path=\"o.png\")
+        await browser.close()
+        ```
+
         ```py
         page = browser.new_page()
         page.goto(\"https://keycode.info\")
@@ -10225,19 +11082,19 @@ def press(
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         key : str
             Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10271,43 +11128,41 @@ def check(
 
         This method checks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is already
-           checked, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is
+           already checked, this method returns immediately.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        Shortcut for main frame's `frame.check()`.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -10339,43 +11194,41 @@ def uncheck(
 
         This method unchecks an element matching `selector` by performing the following steps:
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
-        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is already
-           unchecked, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is
+           already unchecked, this method returns immediately.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        Shortcut for main frame's `frame.uncheck()`.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -10397,15 +11250,20 @@ def wait_for_timeout(self, timeout: float) -> None:
 
         Waits for the given `timeout` in milliseconds.
 
-        Note that `page.waitForTimeout()` should only be used for debugging. Tests using the timer in production are going to be
-        flaky. Use signals such as network events, selectors becoming visible and others instead.
+        Note that `page.waitForTimeout()` should only be used for debugging. Tests using the timer in production are going
+        to be flaky. Use signals such as network events, selectors becoming visible and others instead.
+
+        **Usage**
 
         ```py
         # wait for 1 second
-        page.wait_for_timeout(1000)
+        await page.wait_for_timeout(1000)
         ```
 
-        Shortcut for main frame's `frame.wait_for_timeout()`.
+        ```py
+        # wait for 1 second
+        page.wait_for_timeout(1000)
+        ```
 
         Parameters
         ----------
@@ -10429,8 +11287,28 @@ def wait_for_function(
 
         Returns when the `expression` returns a truthy value. It resolves to a JSHandle of the truthy value.
 
+        **Usage**
+
         The `page.wait_for_function()` can be used to observe viewport size change:
 
+        ```py
+        import asyncio
+        from playwright.async_api import async_playwright
+
+        async def run(playwright):
+            webkit = playwright.webkit
+            browser = await webkit.launch()
+            page = await browser.new_page()
+            await page.evaluate(\"window.x = 0; setTimeout(() => { window.x = 100 }, 1000);\")
+            await page.wait_for_function(\"() => window.x > 0\")
+            await browser.close()
+
+        async def main():
+            async with async_playwright() as playwright:
+                await run(playwright)
+        asyncio.run(main())
+        ```
+
         ```py
         from playwright.sync_api import sync_playwright
 
@@ -10450,24 +11328,28 @@ def run(playwright):
 
         ```py
         selector = \".foo\"
-        page.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
+        await page.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
         ```
 
-        Shortcut for main frame's `frame.wait_for_function()`.
+        ```py
+        selector = \".foo\"
+        page.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
+        ```
 
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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()`.
+            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()`.
         polling : Union["raf", float, None]
-            If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling` is a
-            number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to `raf`.
+            If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling`
+            is a number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to
+            `raf`.
 
         Returns
         -------
@@ -10488,13 +11370,13 @@ def run(playwright):
     def pause(self) -> None:
         """Page.pause
 
-        Pauses script execution. Playwright will stop executing the script and wait for the user to either press 'Resume' button
-        in the page overlay or to call `playwright.resume()` in the DevTools console.
+        Pauses script execution. Playwright will stop executing the script and wait for the user to either press 'Resume'
+        button in the page overlay or to call `playwright.resume()` in the DevTools console.
 
-        User can inspect selectors or perform manual steps while paused. Resume will continue running the original script from
-        the place it was paused.
+        User can inspect selectors or perform manual steps while paused. Resume will continue running the original script
+        from the place it was paused.
 
-        > NOTE: This method requires Playwright to be started in a headed mode, with a falsy `headless` value in the
+        **NOTE** This method requires Playwright to be started in a headed mode, with a falsy `headless` value in the
         `browser_type.launch()`.
         """
 
@@ -10521,14 +11403,22 @@ def pdf(
 
         Returns the PDF buffer.
 
-        > NOTE: Generating a pdf is currently only supported in Chromium headless.
+        **NOTE** Generating a pdf is currently only supported in Chromium headless.
 
         `page.pdf()` generates a pdf of the page with `print` css media. To generate a pdf with `screen` media, call
         `page.emulate_media()` before calling `page.pdf()`:
 
-        > NOTE: By default, `page.pdf()` generates a pdf with modified colors for printing. Use the
-        [`-webkit-print-color-adjust`](https://developer.mozilla.org/en-US/docs/Web/CSS/-webkit-print-color-adjust) property to
-        force rendering of exact colors.
+        **NOTE** By default, `page.pdf()` generates a pdf with modified colors for printing. Use the
+        [`-webkit-print-color-adjust`](https://developer.mozilla.org/en-US/docs/Web/CSS/-webkit-print-color-adjust)
+        property to force rendering of exact colors.
+
+        **Usage**
+
+        ```py
+        # generates a pdf with \"screen\" media type.
+        await page.emulate_media(media=\"screen\")
+        await page.pdf(path=\"page.pdf\")
+        ```
 
         ```py
         # generates a pdf with \"screen\" media type.
@@ -10536,7 +11426,8 @@ def pdf(
         page.pdf(path=\"page.pdf\")
         ```
 
-        The `width`, `height`, and `margin` options accept values labeled with units. Unlabeled values are treated as pixels.
+        The `width`, `height`, and `margin` options accept values labeled with units. Unlabeled values are treated as
+        pixels.
 
         A few examples:
         - `page.pdf({width: 100})` - prints with width set to 100 pixels
@@ -10562,8 +11453,8 @@ def pdf(
         - `A5`: 5.83in x 8.27in
         - `A6`: 4.13in x 5.83in
 
-        > NOTE: `headerTemplate` and `footerTemplate` markup have the following limitations: > 1. Script tags inside templates
-        are not evaluated. > 2. Page styles are not visible inside templates.
+        **NOTE** `headerTemplate` and `footerTemplate` markup have the following limitations: > 1. Script tags inside
+        templates are not evaluated. > 2. Page styles are not visible inside templates.
 
         Parameters
         ----------
@@ -10572,8 +11463,8 @@ def pdf(
         display_header_footer : Union[bool, None]
             Display header and footer. Defaults to `false`.
         header_template : Union[str, None]
-            HTML template for the print header. Should be valid HTML markup with following classes used to inject printing values
-            into them:
+            HTML template for the print header. Should be valid HTML markup with following classes used to inject printing
+            values into them:
             - `'date'` formatted print date
             - `'title'` document title
             - `'url'` document location
@@ -10639,6 +11530,14 @@ def 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
+        ```
+
         ```py
         with page.expect_event(\"framenavigated\") as event_info:
             page.get_by_role(\"button\")
@@ -10652,8 +11551,8 @@ def expect_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()`.
+            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
         -------
@@ -10675,16 +11574,16 @@ def expect_console_message(
         """Page.expect_console_message
 
         Performs action and waits for a `ConsoleMessage` to be logged by in the page. If predicate is provided, it passes
-        `ConsoleMessage` value into the `predicate` function and waits for `predicate(message)` to return a truthy value. Will
-        throw an error if the page is closed before the `page.on('console')` event is fired.
+        `ConsoleMessage` value into the `predicate` function and waits for `predicate(message)` to return a truthy value.
+        Will throw an error if the page is closed before the `page.on('console')` event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[ConsoleMessage], bool], None]
             Receives the `ConsoleMessage` object 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()`.
+            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
         -------
@@ -10706,16 +11605,16 @@ def expect_download(
         """Page.expect_download
 
         Performs action and waits for a new `Download`. If predicate is provided, it passes `Download` value into the
-        `predicate` function and waits for `predicate(download)` to return a truthy value. Will throw an error if the page is
-        closed before the download event is fired.
+        `predicate` function and waits for `predicate(download)` to return a truthy value. Will throw an error if the page
+        is closed before the download event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[Download], bool], None]
             Receives the `Download` object 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()`.
+            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
         -------
@@ -10736,17 +11635,17 @@ def expect_file_chooser(
     ) -> EventContextManager["FileChooser"]:
         """Page.expect_file_chooser
 
-        Performs action and waits for a new `FileChooser` to be created. If predicate is provided, it passes `FileChooser` value
-        into the `predicate` function and waits for `predicate(fileChooser)` to return a truthy value. Will throw an error if
-        the page is closed before the file chooser is opened.
+        Performs action and waits for a new `FileChooser` to be created. If predicate is provided, it passes `FileChooser`
+        value into the `predicate` function and waits for `predicate(fileChooser)` to return a truthy value. Will throw an
+        error if the page is closed before the file chooser is opened.
 
         Parameters
         ----------
         predicate : Union[Callable[[FileChooser], bool], None]
             Receives the `FileChooser` object 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()`.
+            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
         -------
@@ -10776,9 +11675,17 @@ def expect_navigation(
         navigation will resolve with the response of the last redirect. In case of navigation to a different anchor or
         navigation due to History API usage, the navigation will resolve with `null`.
 
-        This resolves when the page navigates to a new URL or reloads. It is useful for when you run code which will indirectly
-        cause the page to navigate. e.g. The click target has an `onclick` handler that triggers navigation from a `setTimeout`.
-        Consider this example:
+        **Usage**
+
+        This resolves when the page navigates to a new URL or reloads. It is useful for when you run code which will
+        indirectly cause the page to navigate. e.g. The click target has an `onclick` handler that triggers navigation from
+        a `setTimeout`. Consider this example:
+
+        ```py
+        async with page.expect_navigation():
+            await page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+        # Resolves after navigation has finished
+        ```
 
         ```py
         with page.expect_navigation():
@@ -10786,26 +11693,26 @@ def expect_navigation(
         # Resolves after navigation has finished
         ```
 
-        > NOTE: Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL is
-        considered a navigation.
-
-        Shortcut for main frame's `frame.expect_navigation()`.
+        **NOTE** Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL
+        is considered a 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 the
-            parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to
-            the string.
+            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]
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
-            - `'commit'` - consider operation to be finished when network response is received and the document started loading.
+            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
+              ms.
+            - `'commit'` - consider operation to be finished when network response is received and the document started
+              loading.
         timeout : Union[float, None]
-            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be
-            changed by using the `browser_context.set_default_navigation_timeout()`,
+            Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_navigation_timeout()`,
             `browser_context.set_default_timeout()`, `page.set_default_navigation_timeout()` or
             `page.set_default_timeout()` methods.
 
@@ -10828,17 +11735,17 @@ def expect_popup(
     ) -> EventContextManager["Page"]:
         """Page.expect_popup
 
-        Performs action and waits for a popup `Page`. If predicate is provided, it passes [Popup] value into the `predicate`
-        function and waits for `predicate(page)` to return a truthy value. Will throw an error if the page is closed before the
-        popup event is fired.
+        Performs action and waits for a popup `Page`. If predicate is provided, it passes [Popup] value into the
+        `predicate` function and waits for `predicate(page)` to return a truthy value. Will throw an error if the page is
+        closed before the popup event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[Page], bool], None]
             Receives the `Page` object 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()`.
+            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
         -------
@@ -10861,8 +11768,21 @@ def expect_request(
     ) -> EventContextManager["Request"]:
         """Page.expect_request
 
-        Waits for the matching request and returns it. See [waiting for event](https://playwright.dev/python/docs/events#waiting-for-event) for more details
-        about events.
+        Waits for the matching request and returns it. See [waiting for event](https://playwright.dev/python/docs/events#waiting-for-event) for more
+        details about events.
+
+        **Usage**
+
+        ```py
+        async with page.expect_request(\"http://example.com/resource\") as first:
+            await page.click('button')
+        first_request = await first.value
+
+        # or with a lambda
+        async with page.expect_request(lambda request: request.url == \"http://example.com\" and request.method == \"get\") as second:
+            await page.click('img')
+        second_request = await second.value
+        ```
 
         ```py
         with page.expect_request(\"http://example.com/resource\") as first:
@@ -10878,12 +11798,12 @@ def expect_request(
         Parameters
         ----------
         url_or_predicate : Union[Callable[[Request], 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
+            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.
         timeout : Union[float, None]
-            Maximum wait time in milliseconds, defaults to 30 seconds, pass `0` to disable the timeout. The default value can be
-            changed by using the `page.set_default_timeout()` method.
+            Maximum wait time in milliseconds, defaults to 30 seconds, pass `0` to disable the timeout. The default value can
+            be changed by using the `page.set_default_timeout()` method.
 
         Returns
         -------
@@ -10904,17 +11824,17 @@ def expect_request_finished(
     ) -> EventContextManager["Request"]:
         """Page.expect_request_finished
 
-        Performs action and waits for a `Request` to finish loading. If predicate is provided, it passes `Request` value into
-        the `predicate` function and waits for `predicate(request)` to return a truthy value. Will throw an error if the page is
-        closed before the `page.on('request_finished')` event is fired.
+        Performs action and waits for a `Request` to finish loading. If predicate is provided, it passes `Request` value
+        into the `predicate` function and waits for `predicate(request)` to return a truthy value. Will throw an error if
+        the page is closed before the `page.on('request_finished')` event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[Request], bool], None]
             Receives the `Request` object 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()`.
+            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
         -------
@@ -10937,7 +11857,23 @@ def expect_response(
     ) -> EventContextManager["Response"]:
         """Page.expect_response
 
-        Returns the matched response. See [waiting for event](https://playwright.dev/python/docs/events#waiting-for-event) for more details about events.
+        Returns the matched response. See [waiting for event](https://playwright.dev/python/docs/events#waiting-for-event) for more details about
+        events.
+
+        **Usage**
+
+        ```py
+        async with page.expect_response(\"https://example.com/resource\") as response_info:
+            await page.click(\"input\")
+        response = await response_info.value
+        return response.ok
+
+        # or with a lambda
+        async with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200) as response_info:
+            await page.click(\"input\")
+        response = await response_info.value
+        return response.ok
+        ```
 
         ```py
         with page.expect_response(\"https://example.com/resource\") as response_info:
@@ -10959,8 +11895,8 @@ def expect_response(
             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.
         timeout : Union[float, None]
-            Maximum wait time in milliseconds, defaults to 30 seconds, pass `0` to disable the timeout. The default value can be
-            changed by using the `browser_context.set_default_timeout()` or `page.set_default_timeout()` methods.
+            Maximum wait time in milliseconds, defaults to 30 seconds, pass `0` to disable the timeout. The default value can
+            be changed by using the `browser_context.set_default_timeout()` or `page.set_default_timeout()` methods.
 
         Returns
         -------
@@ -10982,16 +11918,16 @@ def expect_websocket(
         """Page.expect_websocket
 
         Performs action and waits for a new `WebSocket`. If predicate is provided, it passes `WebSocket` value into the
-        `predicate` function and waits for `predicate(webSocket)` to return a truthy value. Will throw an error if the page is
-        closed before the WebSocket event is fired.
+        `predicate` function and waits for `predicate(webSocket)` to return a truthy value. Will throw an error if the page
+        is closed before the WebSocket event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[WebSocket], bool], None]
             Receives the `WebSocket` object 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()`.
+            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
         -------
@@ -11012,17 +11948,17 @@ def expect_worker(
     ) -> EventContextManager["Worker"]:
         """Page.expect_worker
 
-        Performs action and waits for a new `Worker`. If predicate is provided, it passes `Worker` value into the `predicate`
-        function and waits for `predicate(worker)` to return a truthy value. Will throw an error if the page is closed before
-        the worker event is fired.
+        Performs action and waits for a new `Worker`. If predicate is provided, it passes `Worker` value into the
+        `predicate` function and waits for `predicate(worker)` to return a truthy value. Will throw an error if the page is
+        closed before the worker event is fired.
 
         Parameters
         ----------
         predicate : Union[Callable[[Worker], bool], None]
             Receives the `Worker` object 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()`.
+            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
         -------
@@ -11053,43 +11989,41 @@ def set_checked(
         1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
         1. Ensure that matched element is a checkbox or a radio input. If not, this method throws.
         1. If the element already has the right checked state, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
-
-        Shortcut for main frame's `frame.set_checked()`.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         selector : str
-            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used. See
-            [working with selectors](../selectors.md) for more details.
+            A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
+            used. See [working with selectors](../selectors.md) for more details.
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -11117,10 +12051,14 @@ def on(
         self, event: Literal["backgroundpage"], f: typing.Callable[["Page"], "None"]
     ) -> None:
         """
-        > NOTE: Only works with Chromium browser's persistent context.
+        **NOTE** Only works with Chromium browser's persistent context.
 
         Emitted when new background page is created in the context.
 
+        ```py
+        background_page = await context.wait_for_event(\"backgroundpage\")
+        ```
+
         ```py
         background_page = context.wait_for_event(\"backgroundpage\")
         ```"""
@@ -11138,12 +12076,20 @@ def on(
     @typing.overload
     def on(self, event: Literal["page"], f: typing.Callable[["Page"], "None"]) -> None:
         """
-        The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event will
-        also fire for popup pages. See also `page.on('popup')` to receive events about popups relevant to a specific page.
+        The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event
+        will also fire for popup pages. See also `page.on('popup')` to receive events about popups relevant to a
+        specific page.
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
-        popup with `window.open('http://example.com')`, this event will fire when the network request to \"http://example.com\" is
-        done and its response has started loading in the popup.
+        popup with `window.open('http://example.com')`, this event will fire when the network request to
+        \"http://example.com\" is done and its response has started loading in the popup.
+
+        ```py
+        async with context.expect_page() as page_info:
+            await page.locator(\"a[target=_blank]\").click(),
+        page = await page_info.value
+        print(await page.evaluate(\"location.href\"))
+        ```
 
         ```py
         with context.expect_page() as page_info:
@@ -11152,16 +12098,16 @@ def on(self, event: Literal["page"], f: typing.Callable[["Page"], "None"]) -> No
         print(page.evaluate(\"location.href\"))
         ```
 
-        > NOTE: Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not need it
-        in most cases)."""
+        **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
+        need it in most cases)."""
 
     @typing.overload
     def on(
         self, event: Literal["request"], f: typing.Callable[["Request"], "None"]
     ) -> None:
         """
-        Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To only
-        listen for requests from a particular page, use `page.on('request')`.
+        Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To
+        only listen for requests from a particular page, use `page.on('request')`.
 
         In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`."""
 
@@ -11170,11 +12116,12 @@ def on(
         self, event: Literal["requestfailed"], f: typing.Callable[["Request"], "None"]
     ) -> None:
         """
-        Emitted when a request fails, for example by timing out. To only listen for failed requests from a particular page, use
-        `page.on('request_failed')`.
+        Emitted when a request fails, for example by timing out. To only listen for failed requests from a particular page,
+        use `page.on('request_failed')`.
 
-        > NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will
-        complete with `browser_context.on('request_finished')` event and not with `browser_context.on('request_failed')`."""
+        **NOTE** HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request
+        will complete with `browser_context.on('request_finished')` event and not with
+        `browser_context.on('request_failed')`."""
 
     @typing.overload
     def on(
@@ -11182,16 +12129,16 @@ def on(
     ) -> None:
         """
         Emitted when a request finishes successfully after downloading the response body. For a successful response, the
-        sequence of events is `request`, `response` and `requestfinished`. To listen for successful requests from a particular
-        page, use `page.on('request_finished')`."""
+        sequence of events is `request`, `response` and `requestfinished`. To listen for successful requests from a
+        particular page, use `page.on('request_finished')`."""
 
     @typing.overload
     def on(
         self, event: Literal["response"], f: typing.Callable[["Response"], "None"]
     ) -> None:
         """
-        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of events
-        is `request`, `response` and `requestfinished`. To listen for response events from a particular page, use
+        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of
+        events is `request`, `response` and `requestfinished`. To listen for response events from a particular page, use
         `page.on('response')`."""
 
     @typing.overload
@@ -11199,7 +12146,7 @@ def on(
         self, event: Literal["serviceworker"], f: typing.Callable[["Worker"], "None"]
     ) -> None:
         """
-        > NOTE: Service workers are only supported on Chromium-based browsers.
+        **NOTE** Service workers are only supported on Chromium-based browsers.
 
         Emitted when new service worker is created in the context."""
 
@@ -11211,10 +12158,14 @@ def once(
         self, event: Literal["backgroundpage"], f: typing.Callable[["Page"], "None"]
     ) -> None:
         """
-        > NOTE: Only works with Chromium browser's persistent context.
+        **NOTE** Only works with Chromium browser's persistent context.
 
         Emitted when new background page is created in the context.
 
+        ```py
+        background_page = await context.wait_for_event(\"backgroundpage\")
+        ```
+
         ```py
         background_page = context.wait_for_event(\"backgroundpage\")
         ```"""
@@ -11234,12 +12185,20 @@ def once(
         self, event: Literal["page"], f: typing.Callable[["Page"], "None"]
     ) -> None:
         """
-        The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event will
-        also fire for popup pages. See also `page.on('popup')` to receive events about popups relevant to a specific page.
+        The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event
+        will also fire for popup pages. See also `page.on('popup')` to receive events about popups relevant to a
+        specific page.
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
-        popup with `window.open('http://example.com')`, this event will fire when the network request to \"http://example.com\" is
-        done and its response has started loading in the popup.
+        popup with `window.open('http://example.com')`, this event will fire when the network request to
+        \"http://example.com\" is done and its response has started loading in the popup.
+
+        ```py
+        async with context.expect_page() as page_info:
+            await page.locator(\"a[target=_blank]\").click(),
+        page = await page_info.value
+        print(await page.evaluate(\"location.href\"))
+        ```
 
         ```py
         with context.expect_page() as page_info:
@@ -11248,16 +12207,16 @@ def once(
         print(page.evaluate(\"location.href\"))
         ```
 
-        > NOTE: Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not need it
-        in most cases)."""
+        **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
+        need it in most cases)."""
 
     @typing.overload
     def once(
         self, event: Literal["request"], f: typing.Callable[["Request"], "None"]
     ) -> None:
         """
-        Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To only
-        listen for requests from a particular page, use `page.on('request')`.
+        Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To
+        only listen for requests from a particular page, use `page.on('request')`.
 
         In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`."""
 
@@ -11266,11 +12225,12 @@ def once(
         self, event: Literal["requestfailed"], f: typing.Callable[["Request"], "None"]
     ) -> None:
         """
-        Emitted when a request fails, for example by timing out. To only listen for failed requests from a particular page, use
-        `page.on('request_failed')`.
+        Emitted when a request fails, for example by timing out. To only listen for failed requests from a particular page,
+        use `page.on('request_failed')`.
 
-        > NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will
-        complete with `browser_context.on('request_finished')` event and not with `browser_context.on('request_failed')`."""
+        **NOTE** HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request
+        will complete with `browser_context.on('request_finished')` event and not with
+        `browser_context.on('request_failed')`."""
 
     @typing.overload
     def once(
@@ -11278,16 +12238,16 @@ def once(
     ) -> None:
         """
         Emitted when a request finishes successfully after downloading the response body. For a successful response, the
-        sequence of events is `request`, `response` and `requestfinished`. To listen for successful requests from a particular
-        page, use `page.on('request_finished')`."""
+        sequence of events is `request`, `response` and `requestfinished`. To listen for successful requests from a
+        particular page, use `page.on('request_finished')`."""
 
     @typing.overload
     def once(
         self, event: Literal["response"], f: typing.Callable[["Response"], "None"]
     ) -> None:
         """
-        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of events
-        is `request`, `response` and `requestfinished`. To listen for response events from a particular page, use
+        Emitted when [response] status and headers are received for a request. For a successful response, the sequence of
+        events is `request`, `response` and `requestfinished`. To listen for response events from a particular page, use
         `page.on('response')`."""
 
     @typing.overload
@@ -11295,7 +12255,7 @@ def once(
         self, event: Literal["serviceworker"], f: typing.Callable[["Worker"], "None"]
     ) -> None:
         """
-        > NOTE: Service workers are only supported on Chromium-based browsers.
+        **NOTE** Service workers are only supported on Chromium-based browsers.
 
         Emitted when new service worker is created in the context."""
 
@@ -11330,7 +12290,7 @@ def browser(self) -> typing.Optional["Browser"]:
     def background_pages(self) -> typing.List["Page"]:
         """BrowserContext.background_pages
 
-        > NOTE: Background pages are only supported on Chromium-based browsers.
+        **NOTE** Background pages are only supported on Chromium-based browsers.
 
         All existing background pages in the context.
 
@@ -11344,7 +12304,7 @@ def background_pages(self) -> typing.List["Page"]:
     def service_workers(self) -> typing.List["Worker"]:
         """BrowserContext.service_workers
 
-        > NOTE: Service workers are only supported on Chromium-based browsers.
+        **NOTE** Service workers are only supported on Chromium-based browsers.
 
         All existing service workers in the context.
 
@@ -11387,7 +12347,7 @@ def set_default_navigation_timeout(self, timeout: float) -> None:
         - `page.set_content()`
         - `page.expect_navigation()`
 
-        > NOTE: `page.set_default_navigation_timeout()` and `page.set_default_timeout()` take priority over
+        **NOTE** `page.set_default_navigation_timeout()` and `page.set_default_timeout()` take priority over
         `browser_context.set_default_navigation_timeout()`.
 
         Parameters
@@ -11405,8 +12365,9 @@ def set_default_timeout(self, timeout: float) -> None:
 
         This setting will change the default maximum time for all the methods accepting `timeout` option.
 
-        > NOTE: `page.set_default_navigation_timeout()`, `page.set_default_timeout()` and
-        `browser_context.set_default_navigation_timeout()` take priority over `browser_context.set_default_timeout()`.
+        **NOTE** `page.set_default_navigation_timeout()`, `page.set_default_timeout()` and
+        `browser_context.set_default_navigation_timeout()` take priority over
+        `browser_context.set_default_timeout()`.
 
         Parameters
         ----------
@@ -11435,8 +12396,8 @@ def cookies(
     ) -> typing.List[Cookie]:
         """BrowserContext.cookies
 
-        If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those URLs
-        are returned.
+        If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those
+        URLs are returned.
 
         Parameters
         ----------
@@ -11455,8 +12416,14 @@ def cookies(
     def add_cookies(self, cookies: typing.List[SetCookieParam]) -> None:
         """BrowserContext.add_cookies
 
-        Adds cookies into this browser context. All pages within this context will have these cookies installed. Cookies can be
-        obtained via `browser_context.cookies()`.
+        Adds cookies into this browser context. All pages within this context will have these cookies installed. Cookies
+        can be obtained via `browser_context.cookies()`.
+
+        **Usage**
+
+        ```py
+        await browser_context.add_cookies([cookie_object1, cookie_object2])
+        ```
 
         ```py
         browser_context.add_cookies([cookie_object1, cookie_object2])
@@ -11523,6 +12490,15 @@ def clear_permissions(self) -> None:
 
         Clears all permission overrides for the browser context.
 
+        **Usage**
+
+        ```py
+        context = await browser.new_context()
+        await context.grant_permissions([\"clipboard-read\"])
+        # do stuff ..
+        context.clear_permissions()
+        ```
+
         ```py
         context = browser.new_context()
         context.grant_permissions([\"clipboard-read\"])
@@ -11538,12 +12514,18 @@ def set_geolocation(self, geolocation: typing.Optional[Geolocation] = None) -> N
 
         Sets the context's geolocation. Passing `null` or `undefined` emulates position unavailable.
 
+        **Usage**
+
+        ```py
+        await browser_context.set_geolocation({\"latitude\": 59.95, \"longitude\": 30.31667})
+        ```
+
         ```py
         browser_context.set_geolocation({\"latitude\": 59.95, \"longitude\": 30.31667})
         ```
 
-        > NOTE: Consider using `browser_context.grant_permissions()` to grant permissions for the browser context pages to
-        read its geolocation.
+        **NOTE** Consider using `browser_context.grant_permissions()` to grant permissions for the browser context
+        pages to read its geolocation.
 
         Parameters
         ----------
@@ -11557,11 +12539,12 @@ def set_geolocation(self, geolocation: typing.Optional[Geolocation] = None) -> N
     def set_extra_http_headers(self, headers: typing.Dict[str, str]) -> None:
         """BrowserContext.set_extra_http_headers
 
-        The extra HTTP headers will be sent with every request initiated by any page in the context. These headers are merged
-        with page-specific extra HTTP headers set with `page.set_extra_http_headers()`. If page overrides a particular
-        header, page-specific header value will be used instead of the browser context header value.
+        The extra HTTP headers will be sent with every request initiated by any page in the context. These headers are
+        merged with page-specific extra HTTP headers set with `page.set_extra_http_headers()`. If page overrides a
+        particular header, page-specific header value will be used instead of the browser context header value.
 
-        > NOTE: `browser_context.set_extra_http_headers()` does not guarantee the order of headers in the outgoing requests.
+        **NOTE** `browser_context.set_extra_http_headers()` does not guarantee the order of headers in the outgoing
+        requests.
 
         Parameters
         ----------
@@ -11601,17 +12584,24 @@ def add_init_script(
         - Whenever a child frame is attached or navigated in any page in the browser context. In this case, the script is
           evaluated in the context of the newly attached frame.
 
-        The script is evaluated after the document was created but before any of its scripts were run. This is useful to amend
-        the JavaScript environment, e.g. to seed `Math.random`.
+        The script is evaluated after the document was created but before any of its scripts were run. This is useful to
+        amend the JavaScript environment, e.g. to seed `Math.random`.
+
+        **Usage**
 
         An example of overriding `Math.random` before the page loads:
 
+        ```py
+        # in your playwright script, assuming the preload.js file is in same directory.
+        await browser_context.add_init_script(path=\"preload.js\")
+        ```
+
         ```py
         # in your playwright script, assuming the preload.js file is in same directory.
         browser_context.add_init_script(path=\"preload.js\")
         ```
 
-        > NOTE: The order of evaluation of multiple scripts installed via `browser_context.add_init_script()` and
+        **NOTE** The order of evaluation of multiple scripts installed via `browser_context.add_init_script()` and
         `page.add_init_script()` is not defined.
 
         Parameters
@@ -11637,16 +12627,45 @@ def expose_binding(
         """BrowserContext.expose_binding
 
         The method adds a function called `name` on the `window` object of every frame in every page in the context. When
-        called, the function executes `callback` and returns a [Promise] which resolves to the return value of `callback`. If
-        the `callback` returns a [Promise], it will be awaited.
+        called, the function executes `callback` and returns a [Promise] which resolves to the return value of `callback`.
+        If the `callback` returns a [Promise], it will be awaited.
 
-        The first argument of the `callback` function contains information about the caller: `{ browserContext: BrowserContext,
-        page: Page, frame: Frame }`.
+        The first argument of the `callback` function contains information about the caller: `{ browserContext:
+        BrowserContext, page: Page, frame: Frame }`.
 
         See `page.expose_binding()` for page-only version.
 
+        **Usage**
+
         An example of exposing page URL to all frames in all pages in the context:
 
+        ```py
+        import asyncio
+        from playwright.async_api import async_playwright
+
+        async def run(playwright):
+            webkit = playwright.webkit
+            browser = await webkit.launch(headless=false)
+            context = await browser.new_context()
+            await context.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
+            page = await context.new_page()
+            await page.set_content(\"\"\"
+            <script>
+              async function onClick() {
+                document.querySelector('div').textContent = await window.pageURL();
+              }
+            </script>
+            <button onclick=\"onClick()\">Click me</button>
+            <div></div>
+            \"\"\")
+            await page.get_by_role(\"button\").click()
+
+        async def main():
+            async with async_playwright() as playwright:
+                await run(playwright)
+        asyncio.run(main())
+        ```
+
         ```py
         from playwright.sync_api import sync_playwright
 
@@ -11673,6 +12692,20 @@ def run(playwright):
 
         An example of passing an element handle:
 
+        ```py
+        async def print(source, element):
+            print(await element.text_content())
+
+        await context.expose_binding(\"clicked\", print, handle=true)
+        await page.set_content(\"\"\"
+          <script>
+            document.addEventListener('click', event => window.clicked(event.target));
+          </script>
+          <div>Click me</div>
+          <div>Or click me</div>
+        \"\"\")
+        ```
+
         ```py
         def print(source, element):
             print(element.text_content())
@@ -11716,8 +12749,43 @@ def expose_function(self, name: str, callback: typing.Callable) -> None:
 
         See `page.expose_function()` for page-only version.
 
+        **Usage**
+
         An example of adding a `sha256` function to all pages in the context:
 
+        ```py
+        import asyncio
+        import hashlib
+        from playwright.async_api import async_playwright
+
+        def sha256(text):
+            m = hashlib.sha256()
+            m.update(bytes(text, \"utf8\"))
+            return m.hexdigest()
+
+        async def run(playwright):
+            webkit = playwright.webkit
+            browser = await webkit.launch(headless=False)
+            context = await browser.new_context()
+            await context.expose_function(\"sha256\", sha256)
+            page = await context.new_page()
+            await page.set_content(\"\"\"
+                <script>
+                  async function onClick() {
+                    document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
+                  }
+                </script>
+                <button onclick=\"onClick()\">Click me</button>
+                <div></div>
+            \"\"\")
+            await page.get_by_role(\"button\").click()
+
+        async def main():
+            async with async_playwright() as playwright:
+                await run(playwright)
+        asyncio.run(main())
+        ```
+
         ```py
         import hashlib
         from playwright.sync_api import sync_playwright
@@ -11776,15 +12844,25 @@ def route(
     ) -> None:
         """BrowserContext.route
 
-        Routing provides the capability to modify network requests that are made by any page in the browser context. Once route
-        is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or aborted.
+        Routing provides the capability to modify network requests that are made by any page in the browser context. Once
+        route is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or aborted.
+
+        **NOTE** `browser_context.route()` will not intercept requests intercepted by Service Worker. See
+        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
+        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
 
-        > NOTE: `browser_context.route()` will not intercept requests intercepted by Service Worker. See
-        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
-        request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        **Usage**
 
         An example of a naive handler that aborts all image requests:
 
+        ```py
+        context = await browser.new_context()
+        page = await context.new_page()
+        await context.route(\"**/*.{png,jpg,jpeg}\", lambda route: route.abort())
+        await page.goto(\"https://example.com\")
+        await browser.close()
+        ```
+
         ```py
         context = browser.new_context()
         page = context.new_page()
@@ -11795,6 +12873,15 @@ def route(
 
         or the same snippet using a regex pattern instead:
 
+        ```py
+        context = await browser.new_context()
+        page = await context.new_page()
+        await context.route(re.compile(r\"(\\.png$)|(\\.jpg$)\"), lambda route: route.abort())
+        page = await context.new_page()
+        await page.goto(\"https://example.com\")
+        await browser.close()
+        ```
+
         ```py
         context = browser.new_context()
         page = context.new_page()
@@ -11805,8 +12892,17 @@ def route(
         browser.close()
         ```
 
-        It is possible to examine the request to decide the route action. For example, mocking all requests that contain some
-        post data, and leaving all other requests as is:
+        It is possible to examine the request to decide the route action. For example, mocking all requests that contain
+        some post data, and leaving all other requests as is:
+
+        ```py
+        def handle_route(route):
+          if (\"my-string\" in route.request.post_data)
+            route.fulfill(body=\"mocked-data\")
+          else
+            route.continue_()
+        await context.route(\"/api/**\", handle_route)
+        ```
 
         ```py
         def handle_route(route):
@@ -11817,12 +12913,12 @@ def handle_route(route):
         context.route(\"/api/**\", handle_route)
         ```
 
-        Page routes (set up with `page.route()`) take precedence over browser context routes when request matches both
-        handlers.
+        Page routes (set up with `page.route()`) take precedence over browser context routes when request matches
+        both handlers.
 
         To remove a route with its handler you can use `browser_context.unroute()`.
 
-        > NOTE: Enabling routing disables http cache.
+        **NOTE** Enabling routing disables http cache.
 
         Parameters
         ----------
@@ -11858,8 +12954,8 @@ def unroute(
     ) -> None:
         """BrowserContext.unroute
 
-        Removes a route created with `browser_context.route()`. When `handler` is not specified, removes all routes for
-        the `url`.
+        Removes a route created with `browser_context.route()`. When `handler` is not specified, removes all routes
+        for the `url`.
 
         Parameters
         ----------
@@ -11892,8 +12988,8 @@ def route_from_har(
         [Replaying from HAR](https://playwright.dev/python/docs/network#replaying-from-har).
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
-        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
-        request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
+        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
 
         Parameters
         ----------
@@ -11901,8 +12997,8 @@ def route_from_har(
             Path to a [HAR](http://www.softwareishard.com/blog/har-12-spec) file with prerecorded network data. If `path` is a
             relative path, then it is resolved relative to the current working directory.
         url : Union[Pattern[str], str, None]
-            A glob pattern, regular expression or predicate to match the request URL. Only requests with URL matching the pattern
-            will be served from the HAR file. If not specified, all requests are served from the HAR file.
+            A glob pattern, regular expression or predicate to match the request URL. Only requests with URL matching the
+            pattern will be served from the HAR file. If not specified, all requests are served from the HAR file.
         not_found : Union["abort", "fallback", None]
             - If set to 'abort' any request not found in the HAR file will be aborted.
             - If set to 'fallback' falls through to the next route handler in the handler chain.
@@ -11933,6 +13029,14 @@ def 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 context closes before the event is fired. Returns the event data value.
 
+        **Usage**
+
+        ```py
+        async with context.expect_event(\"page\") as event_info:
+            await page.get_by_role(\"button\").click()
+        page = await event_info.value
+        ```
+
         ```py
         with context.expect_event(\"page\") as event_info:
             page.get_by_role(\"button\").click()
@@ -11946,8 +13050,8 @@ def expect_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()`.
+            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
         -------
@@ -11965,7 +13069,7 @@ def close(self) -> None:
 
         Closes the browser context. All the pages that belong to the browser context will be closed.
 
-        > NOTE: The default browser context cannot be closed.
+        **NOTE** The default browser context cannot be closed.
         """
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.close()))
@@ -11999,11 +13103,11 @@ def wait_for_event(
     ) -> typing.Any:
         """BrowserContext.wait_for_event
 
-        > NOTE: In most cases, you should use `browser_context.expect_event()`.
+        **NOTE** In most cases, you should use `browser_context.expect_event()`.
 
-        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function and
-        waits for `predicate(event)` to return a truthy value. Will throw an error if the browser context is closed before the
-        `event` is fired.
+        Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function
+        and waits for `predicate(event)` to return a truthy value. Will throw an error if the browser context is closed
+        before the `event` is fired.
 
         Parameters
         ----------
@@ -12012,8 +13116,8 @@ def wait_for_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()`.
+            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
         -------
@@ -12039,16 +13143,16 @@ def expect_page(
         """BrowserContext.expect_page
 
         Performs action and waits for a new `Page` to be created in the context. If predicate is provided, it passes `Page`
-        value into the `predicate` function and waits for `predicate(event)` to return a truthy value. Will throw an error if
-        the context closes before new `Page` is created.
+        value into the `predicate` function and waits for `predicate(event)` to return a truthy value. Will throw an error
+        if the context closes before new `Page` is created.
 
         Parameters
         ----------
         predicate : Union[Callable[[Page], bool], None]
             Receives the `Page` object 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()`.
+            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
         -------
@@ -12064,15 +13168,15 @@ def expect_page(
     def new_cdp_session(self, page: typing.Union["Page", "Frame"]) -> "CDPSession":
         """BrowserContext.new_cdp_session
 
-        > NOTE: CDP sessions are only supported on Chromium-based browsers.
+        **NOTE** CDP sessions are only supported on Chromium-based browsers.
 
         Returns the newly created session.
 
         Parameters
         ----------
         page : Union[Frame, Page]
-            Target to create new session for. For backwards-compatibility, this parameter is named `page`, but it can be a `Page` or
-            `Frame` type.
+            Target to create new session for. For backwards-compatibility, this parameter is named `page`, but it can be a
+            `Page` or `Frame` type.
 
         Returns
         -------
@@ -12112,8 +13216,8 @@ def send(
     def detach(self) -> None:
         """CDPSession.detach
 
-        Detaches the CDPSession from the target. Once detached, the CDPSession object won't emit any events and can't be used to
-        send messages.
+        Detaches the CDPSession from the target. Once detached, the CDPSession object won't emit any events and can't be
+        used to send messages.
         """
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.detach()))
@@ -12127,7 +13231,8 @@ def on(
         self, event: Literal["disconnected"], f: typing.Callable[["Browser"], "None"]
     ) -> None:
         """
-        Emitted when Browser gets disconnected from the browser application. This might happen because of one of the following:
+        Emitted when Browser gets disconnected from the browser application. This might happen because of one of the
+        following:
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
         return super().on(event=event, f=f)
@@ -12136,7 +13241,8 @@ def once(
         self, event: Literal["disconnected"], f: typing.Callable[["Browser"], "None"]
     ) -> None:
         """
-        Emitted when Browser gets disconnected from the browser application. This might happen because of one of the following:
+        Emitted when Browser gets disconnected from the browser application. This might happen because of one of the
+        following:
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
         return super().once(event=event, f=f)
@@ -12147,6 +13253,15 @@ def contexts(self) -> typing.List["BrowserContext"]:
 
         Returns an array of all open browser contexts. In a newly created browser, this will return zero browser contexts.
 
+        **Usage**
+
+        ```py
+        browser = await pw.webkit.launch()
+        print(len(browser.contexts())) # prints `0`
+        context = await browser.new_context()
+        print(len(browser.contexts())) # prints `1`
+        ```
+
         ```py
         browser = pw.webkit.launch()
         print(len(browser.contexts())) # prints `0`
@@ -12246,10 +13361,25 @@ def new_context(
 
         Creates a new browser context. It won't share cookies/cache with other browser contexts.
 
-        > NOTE: If directly using this method to create `BrowserContext`s, it is best practice to explicitly close the returned
-        context via `browser_context.close()` when your code is done with the `BrowserContext`, and before calling
-        `browser.close()`. This will ensure the `context` is closed gracefully and any artifacts—like HARs and
-        videos—are fully flushed and saved.
+        **NOTE** If directly using this method to create `BrowserContext`s, it is best practice to explicitly close the
+        returned context via `browser_context.close()` when your code is done with the `BrowserContext`, and before
+        calling `browser.close()`. This will ensure the `context` is closed gracefully and any artifacts—like HARs
+        and videos—are fully flushed and saved.
+
+        **Usage**
+
+        ```py
+        browser = await playwright.firefox.launch() # or \"chromium\" or \"webkit\".
+        # create a new incognito browser context.
+        context = await browser.new_context()
+        # create a new page in a pristine context.
+        page = await context.new_page()
+        await page.goto(\"https://example.com\")
+
+        # gracefully close up everything
+        await context.close()
+        await browser.close()
+        ```
 
         ```py
         browser = playwright.firefox.launch() # or \"chromium\" or \"webkit\".
@@ -12267,10 +13397,11 @@ def new_context(
         Parameters
         ----------
         viewport : Union[{width: int, height: int}, None]
-            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed viewport.
+            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
+            viewport.
         screen : Union[{width: int, height: int}, None]
-            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the `viewport`
-            is set.
+            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
+            `viewport` is set.
         no_viewport : Union[bool, None]
             Does not enforce fixed viewport, allows resizing window in the headed mode.
         ignore_https_errors : Union[bool, None]
@@ -12282,16 +13413,16 @@ def new_context(
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
-            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `Accept-Language`
-            request header value as well as number and date formatting rules.
+            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
+            `Accept-Language` request header value as well as number and date formatting rules.
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
-            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for more
-            details.
+            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
+            more details.
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
@@ -12301,8 +13432,8 @@ def new_context(
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not supported
-            in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
+            supported in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
@@ -12314,58 +13445,61 @@ def new_context(
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'no-preference'`.
         forced_colors : Union["active", "none", "null", None]
-            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
+            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'none'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings to use with this context.
 
-            > NOTE: For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If all
-            contexts override the proxy, global proxy will be never used and can be any string, for example `launch({ proxy: {
-            server: 'http://per-context' } })`.
+            **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
+            all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
+            proxy: { server: 'http://per-context' } })`.
         record_har_path : Union[pathlib.Path, str, None]
-            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file on the
-            filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()` for the HAR to
-            be saved.
+            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
+            on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
+            for the HAR to be saved.
         record_har_omit_content : Union[bool, None]
             Optional setting to control whether to omit request content from the HAR. Defaults to `false`.
         record_video_dir : Union[pathlib.Path, str, None]
-            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make sure
-            to call `browser_context.close()` for videos to be saved.
+            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make
+            sure to call `browser_context.close()` for videos to be saved.
         record_video_size : Union[{width: int, height: int}, None]
             Dimensions of the recorded videos. If not specified the size will be equal to `viewport` scaled down to fit into
-            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page will
-            be scaled down if necessary to fit the specified size.
+            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
+            will be scaled down if necessary to fit the specified size.
         storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
-            Populates context with given storage state. This option can be used to initialize context with logged-in information
-            obtained via `browser_context.storage_state()`. Either a path to the file with saved storage, or an object with
-            the following fields:
+            Populates context with given storage state. This option can be used to initialize context with logged-in
+            information obtained via `browser_context.storage_state()`. Either a path to the file with saved storage, or
+            an object with the following fields:
         base_url : Union[str, None]
-            When using `page.goto()`, `page.route()`, `page.wait_for_url()`, `page.expect_request()`,
-            or `page.expect_response()` it takes the base URL in consideration by using the
-            [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the corresponding URL.
-            Examples:
+            When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
+            `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
+            using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
+            corresponding URL. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
-            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in `http://localhost:3000/foo/bar.html`
+            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
+              `http://localhost:3000/foo/bar.html`
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
-            that imply single target DOM element will throw when more than one element matches the selector. See `Locator` to learn
-            more about the strict mode.
+            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. See
+            `Locator` to learn more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
-            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be registered.
+            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
+              registered.
             - `'block'`: Playwright will block all registration of Service Workers.
         record_har_url_filter : Union[Pattern[str], str, None]
         record_har_mode : Union["full", "minimal", None]
-            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page, cookies,
-            security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
+            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
-            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
-            Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
+            `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
+            HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
         -------
@@ -12463,17 +13597,18 @@ def new_page(
 
         Creates a new page in a new browser context. Closing this page will close the context as well.
 
-        This is a convenience API that should only be used for the single-page scenarios and short snippets. Production code and
-        testing frameworks should explicitly create `browser.new_context()` followed by the
+        This is a convenience API that should only be used for the single-page scenarios and short snippets. Production
+        code and testing frameworks should explicitly create `browser.new_context()` followed by the
         `browser_context.new_page()` to control their exact life times.
 
         Parameters
         ----------
         viewport : Union[{width: int, height: int}, None]
-            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed viewport.
+            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
+            viewport.
         screen : Union[{width: int, height: int}, None]
-            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the `viewport`
-            is set.
+            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
+            `viewport` is set.
         no_viewport : Union[bool, None]
             Does not enforce fixed viewport, allows resizing window in the headed mode.
         ignore_https_errors : Union[bool, None]
@@ -12485,16 +13620,16 @@ def new_page(
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
-            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `Accept-Language`
-            request header value as well as number and date formatting rules.
+            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
+            `Accept-Language` request header value as well as number and date formatting rules.
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
-            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for more
-            details.
+            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
+            more details.
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
@@ -12504,8 +13639,8 @@ def new_page(
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not supported
-            in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
+            supported in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
@@ -12513,8 +13648,9 @@ def new_page(
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'light'`.
         forced_colors : Union["active", "none", "null", None]
-            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
+            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'none'`.
         reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -12524,51 +13660,53 @@ def new_page(
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings to use with this context.
 
-            > NOTE: For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If all
-            contexts override the proxy, global proxy will be never used and can be any string, for example `launch({ proxy: {
-            server: 'http://per-context' } })`.
+            **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
+            all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
+            proxy: { server: 'http://per-context' } })`.
         record_har_path : Union[pathlib.Path, str, None]
-            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file on the
-            filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()` for the HAR to
-            be saved.
+            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
+            on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
+            for the HAR to be saved.
         record_har_omit_content : Union[bool, None]
             Optional setting to control whether to omit request content from the HAR. Defaults to `false`.
         record_video_dir : Union[pathlib.Path, str, None]
-            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make sure
-            to call `browser_context.close()` for videos to be saved.
+            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make
+            sure to call `browser_context.close()` for videos to be saved.
         record_video_size : Union[{width: int, height: int}, None]
             Dimensions of the recorded videos. If not specified the size will be equal to `viewport` scaled down to fit into
-            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page will
-            be scaled down if necessary to fit the specified size.
+            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
+            will be scaled down if necessary to fit the specified size.
         storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
-            Populates context with given storage state. This option can be used to initialize context with logged-in information
-            obtained via `browser_context.storage_state()`. Either a path to the file with saved storage, or an object with
-            the following fields:
+            Populates context with given storage state. This option can be used to initialize context with logged-in
+            information obtained via `browser_context.storage_state()`. Either a path to the file with saved storage, or
+            an object with the following fields:
         base_url : Union[str, None]
-            When using `page.goto()`, `page.route()`, `page.wait_for_url()`, `page.expect_request()`,
-            or `page.expect_response()` it takes the base URL in consideration by using the
-            [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the corresponding URL.
-            Examples:
+            When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
+            `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
+            using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
+            corresponding URL. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
-            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in `http://localhost:3000/foo/bar.html`
+            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
+              `http://localhost:3000/foo/bar.html`
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
-            that imply single target DOM element will throw when more than one element matches the selector. See `Locator` to learn
-            more about the strict mode.
+            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. See
+            `Locator` to learn more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
-            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be registered.
+            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
+              registered.
             - `'block'`: Playwright will block all registration of Service Workers.
         record_har_url_filter : Union[Pattern[str], str, None]
         record_har_mode : Union["full", "minimal", None]
-            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page, cookies,
-            security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
+            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
-            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
-            Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
+            `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
+            HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
         -------
@@ -12619,14 +13757,14 @@ def new_page(
     def close(self) -> None:
         """Browser.close
 
-        In case this browser is obtained using `browser_type.launch()`, closes the browser and all of its pages (if any
-        were opened).
+        In case this browser is obtained using `browser_type.launch()`, closes the browser and all of its pages (if
+        any were opened).
 
-        In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from the
-        browser server.
+        In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from
+        the browser server.
 
-        > NOTE: This is similar to force quitting the browser. Therefore, you should call `browser_context.close()` on
-        any `BrowserContext`'s you explicitly created earlier with `browser.new_context()` **before** calling
+        **NOTE** This is similar to force quitting the browser. Therefore, you should call `browser_context.close()`
+        on any `BrowserContext`'s you explicitly created earlier with `browser.new_context()` **before** calling
         `browser.close()`.
 
         The `Browser` object itself is considered to be disposed and cannot be used anymore.
@@ -12637,7 +13775,7 @@ def close(self) -> None:
     def new_browser_cdp_session(self) -> "CDPSession":
         """Browser.new_browser_cdp_session
 
-        > NOTE: CDP Sessions are only supported on Chromium-based browsers.
+        **NOTE** CDP Sessions are only supported on Chromium-based browsers.
 
         Returns the newly created browser session.
 
@@ -12658,13 +13796,22 @@ def start_tracing(
     ) -> None:
         """Browser.start_tracing
 
-        > NOTE: This API controls [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool)
-        which is a low-level chromium-specific debugging tool. API to control [Playwright Tracing](https://playwright.dev/python/docs/trace-viewer) could be
-        found [here](https://playwright.dev/python/docs/api/class-tracing).
+        **NOTE** This API controls
+        [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool) which is a low-level
+        chromium-specific debugging tool. API to control [Playwright Tracing](https://playwright.dev/python/docs/trace-viewer) could be found
+        [here](https://playwright.dev/python/docs/api/class-tracing).
 
         You can use `browser.start_tracing()` and `browser.stop_tracing()` to create a trace file that can be
         opened in Chrome DevTools performance panel.
 
+        **Usage**
+
+        ```py
+        await browser.start_tracing(page, path=\"trace.json\")
+        await page.goto(\"https://www.google.com\")
+        await browser.stop_tracing()
+        ```
+
         ```py
         browser.start_tracing(page, path=\"trace.json\")
         page.goto(\"https://www.google.com\")
@@ -12697,9 +13844,10 @@ def start_tracing(
     def stop_tracing(self) -> bytes:
         """Browser.stop_tracing
 
-        > NOTE: This API controls [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool)
-        which is a low-level chromium-specific debugging tool. API to control [Playwright Tracing](https://playwright.dev/python/docs/trace-viewer) could be
-        found [here](https://playwright.dev/python/docs/api/class-tracing).
+        **NOTE** This API controls
+        [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool) which is a low-level
+        chromium-specific debugging tool. API to control [Playwright Tracing](https://playwright.dev/python/docs/trace-viewer) could be found
+        [here](https://playwright.dev/python/docs/api/class-tracing).
 
         Returns the buffer with trace data.
 
@@ -12768,26 +13916,34 @@ def launch(
 
         Returns the browser instance.
 
+        **Usage**
+
         You can use `ignoreDefaultArgs` to filter out `--mute-audio` from default arguments:
 
+        ```py
+        browser = await playwright.chromium.launch( # or \"firefox\" or \"webkit\".
+            ignore_default_args=[\"--mute-audio\"]
+        )
+        ```
+
         ```py
         browser = playwright.chromium.launch( # or \"firefox\" or \"webkit\".
             ignore_default_args=[\"--mute-audio\"]
         )
         ```
 
-        > **Chromium-only** Playwright can also be used to control the Google Chrome or Microsoft Edge browsers, but it works
-        best with the version of Chromium it is bundled with. There is no guarantee it will work with any other version. Use
-        `executablePath` option with extreme caution.
+        > **Chromium-only** Playwright can also be used to control the Google Chrome or Microsoft Edge browsers, but it
+        works best with the version of Chromium it is bundled with. There is no guarantee it will work with any other
+        version. Use `executablePath` option with extreme caution.
         >
         > If Google Chrome (rather than Chromium) is preferred, a
         [Chrome Canary](https://www.google.com/chrome/browser/canary.html) or
         [Dev Channel](https://www.chromium.org/getting-involved/dev-channel) build is suggested.
         >
-        > Stock browsers like Google Chrome and Microsoft Edge are suitable for tests that require proprietary media codecs for
-        video playback. See
-        [this article](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for other
-        differences between Chromium and Chrome.
+        > Stock browsers like Google Chrome and Microsoft Edge are suitable for tests that require proprietary media codecs
+        for video playback. See
+        [this article](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for
+        other differences between Chromium and Chrome.
         [This article](https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md)
         describes some differences for Linux users.
 
@@ -12795,11 +13951,11 @@ def launch(
         ----------
         executable_path : Union[pathlib.Path, str, None]
             Path to a browser executable to run instead of the bundled one. If `executablePath` is a relative path, then it is
-            resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium, Firefox
-            or WebKit, use at your own risk.
+            resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
+            Firefox or WebKit, use at your own risk.
         channel : Union[str, None]
-            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge",
-            "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
+            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
+            "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
             [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
         args : Union[List[str], None]
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
@@ -12814,8 +13970,8 @@ def launch(
         handle_sighup : Union[bool, None]
             Close the browser process on SIGHUP. Defaults to `true`.
         timeout : Union[float, None]
-            Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0` to
-            disable timeout.
+            Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0`
+            to disable timeout.
         env : Union[Dict[str, Union[bool, float, str]], None]
             Specify environment variables that will be visible to the browser. Defaults to `process.env`.
         headless : Union[bool, None]
@@ -12824,16 +13980,17 @@ def launch(
             [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). 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`.
+            **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`.
         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]
-            If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is
-            deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in
-            is closed.
+            If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and
+            is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were
+            created in is closed.
         slow_mo : Union[float, None]
-            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
+            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going
+            on.
         traces_dir : Union[pathlib.Path, str, None]
             If specified, traces are saved into this directory.
         chromium_sandbox : Union[bool, None]
@@ -12943,17 +14100,17 @@ def launch_persistent_context(
         user_data_dir : Union[pathlib.Path, str]
             Path to a User Data Directory, which stores browser session data like cookies and local storage. More details for
             [Chromium](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md#introduction) and
-            [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile). Note that Chromium's user
-            data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty string to use
-            a temporary directory instead.
+            [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile). Note that Chromium's
+            user data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty
+            string to use a temporary directory instead.
         channel : Union[str, None]
-            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge",
-            "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
+            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
+            "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
             [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
         executable_path : Union[pathlib.Path, str, None]
             Path to a browser executable to run instead of the bundled one. If `executablePath` is a relative path, then it is
-            resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium, Firefox
-            or WebKit, use at your own risk.
+            resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
+            Firefox or WebKit, use at your own risk.
         args : Union[List[str], None]
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
             [here](http://peter.sh/experiments/chromium-command-line-switches/).
@@ -12967,8 +14124,8 @@ def launch_persistent_context(
         handle_sighup : Union[bool, None]
             Close the browser process on SIGHUP. Defaults to `true`.
         timeout : Union[float, None]
-            Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0` to
-            disable timeout.
+            Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0`
+            to disable timeout.
         env : Union[Dict[str, Union[bool, float, str]], None]
             Specify environment variables that will be visible to the browser. Defaults to `process.env`.
         headless : Union[bool, None]
@@ -12977,21 +14134,23 @@ def launch_persistent_context(
             [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). 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`.
+            **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`.
         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]
-            If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is
-            deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in
-            is closed.
+            If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and
+            is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were
+            created in is closed.
         slow_mo : Union[float, None]
-            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
+            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going
+            on.
         viewport : Union[{width: int, height: int}, None]
-            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed viewport.
+            Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
+            viewport.
         screen : Union[{width: int, height: int}, None]
-            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the `viewport`
-            is set.
+            Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
+            `viewport` is set.
         no_viewport : Union[bool, None]
             Does not enforce fixed viewport, allows resizing window in the headed mode.
         ignore_https_errors : Union[bool, None]
@@ -13003,16 +14162,16 @@ def launch_persistent_context(
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
-            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `Accept-Language`
-            request header value as well as number and date formatting rules.
+            Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
+            `Accept-Language` request header value as well as number and date formatting rules.
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
-            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for more
-            details.
+            A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
+            more details.
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
@@ -13022,8 +14181,8 @@ def launch_persistent_context(
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not supported
-            in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
+            supported in Firefox.
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
@@ -13035,8 +14194,9 @@ def launch_persistent_context(
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'no-preference'`.
         forced_colors : Union["active", "none", "null", None]
-            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See `page.emulate_media()`
-            for more details. Passing `'null'` resets emulation to system defaults. Defaults to `'none'`.
+            Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'none'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         traces_dir : Union[pathlib.Path, str, None]
@@ -13044,43 +14204,45 @@ def launch_persistent_context(
         chromium_sandbox : Union[bool, None]
             Enable Chromium sandboxing. Defaults to `false`.
         record_har_path : Union[pathlib.Path, str, None]
-            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file on the
-            filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()` for the HAR to
-            be saved.
+            Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
+            on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
+            for the HAR to be saved.
         record_har_omit_content : Union[bool, None]
             Optional setting to control whether to omit request content from the HAR. Defaults to `false`.
         record_video_dir : Union[pathlib.Path, str, None]
-            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make sure
-            to call `browser_context.close()` for videos to be saved.
+            Enables video recording for all pages into the specified directory. If not specified videos are not recorded. Make
+            sure to call `browser_context.close()` for videos to be saved.
         record_video_size : Union[{width: int, height: int}, None]
             Dimensions of the recorded videos. If not specified the size will be equal to `viewport` scaled down to fit into
-            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page will
-            be scaled down if necessary to fit the specified size.
+            800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
+            will be scaled down if necessary to fit the specified size.
         base_url : Union[str, None]
-            When using `page.goto()`, `page.route()`, `page.wait_for_url()`, `page.expect_request()`,
-            or `page.expect_response()` it takes the base URL in consideration by using the
-            [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the corresponding URL.
-            Examples:
+            When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
+            `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
+            using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
+            corresponding URL. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
-            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in `http://localhost:3000/foo/bar.html`
+            - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
+              `http://localhost:3000/foo/bar.html`
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
-            that imply single target DOM element will throw when more than one element matches the selector. See `Locator` to learn
-            more about the strict mode.
+            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. See
+            `Locator` to learn more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
-            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be registered.
+            - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
+              registered.
             - `'block'`: Playwright will block all registration of Service Workers.
         record_har_url_filter : Union[Pattern[str], str, None]
         record_har_mode : Union["full", "minimal", None]
-            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page, cookies,
-            security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
+            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         record_har_content : Union["attach", "embed", "omit", None]
-            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If `attach`
-            is specified, resources are persisted as separate files and all of these files are archived along with the HAR file.
-            Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
+            `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
+            HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
 
         Returns
         -------
@@ -13156,7 +14318,15 @@ def connect_over_cdp(
 
         The default browser context is accessible via `browser.contexts()`.
 
-        > NOTE: Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
+        **NOTE** Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
+
+        **Usage**
+
+        ```py
+        browser = await playwright.chromium.connect_over_cdp(\"http://localhost:9222\")
+        default_context = browser.contexts[0]
+        page = default_context.pages[0]
+        ```
 
         ```py
         browser = playwright.chromium.connect_over_cdp(\"http://localhost:9222\")
@@ -13170,11 +14340,11 @@ def connect_over_cdp(
             A CDP websocket endpoint or http url to connect to. For example `http://localhost:9222/` or
             `ws://127.0.0.1:9222/devtools/browser/387adf4c-243f-4051-a181-46798f4a46f4`.
         timeout : Union[float, None]
-            Maximum time in milliseconds to wait for the connection to be established. Defaults to `30000` (30 seconds). Pass `0` to
-            disable timeout.
+            Maximum time in milliseconds to wait for the connection to be established. Defaults to `30000` (30 seconds). Pass
+            `0` to disable timeout.
         slow_mo : Union[float, None]
-            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
-            Defaults to 0.
+            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going
+            on. Defaults to 0.
         headers : Union[Dict[str, str], None]
             Additional HTTP headers to be sent with connect request. Optional.
 
@@ -13215,8 +14385,8 @@ def connect(
         timeout : Union[float, None]
             Maximum time in milliseconds to wait for the connection to be established. Defaults to `0` (no timeout).
         slow_mo : Union[float, None]
-            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
-            Defaults to 0.
+            Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going
+            on. Defaults to 0.
         headers : Union[Dict[str, str], None]
             Additional HTTP headers to be sent with web socket connect request. Optional.
 
@@ -13247,6 +14417,26 @@ def devices(self) -> typing.Dict:
 
         Returns a dictionary of devices to be used with `browser.new_context()` or `browser.new_page()`.
 
+        ```py
+        import asyncio
+        from playwright.async_api import async_playwright
+
+        async def run(playwright):
+            webkit = playwright.webkit
+            iphone = playwright.devices[\"iPhone 6\"]
+            browser = await webkit.launch()
+            context = await browser.new_context(**iphone)
+            page = await context.new_page()
+            await page.goto(\"http://example.com\")
+            # other actions...
+            await browser.close()
+
+        async def main():
+            async with async_playwright() as playwright:
+                await run(playwright)
+        asyncio.run(main())
+        ```
+
         ```py
         from playwright.sync_api import sync_playwright
 
@@ -13338,8 +14528,8 @@ def __getitem__(self, value: str) -> "BrowserType":
     def stop(self) -> None:
         """Playwright.stop
 
-        Terminates this instance of Playwright in case it was created bypassing the Python context manager. This is useful in
-        REPL applications.
+        Terminates this instance of Playwright in case it was created bypassing the Python context manager. This is useful
+        in REPL applications.
 
         ```py
         >>> from playwright.sync_api import sync_playwright
@@ -13376,6 +14566,15 @@ def start(
 
         Start tracing.
 
+        **Usage**
+
+        ```py
+        await context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        page = await context.new_page()
+        await page.goto(\"https://playwright.dev\")
+        await context.tracing.stop(path = \"trace.zip\")
+        ```
+
         ```py
         context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
         page = context.new_page()
@@ -13386,8 +14585,8 @@ def start(
         Parameters
         ----------
         name : Union[str, None]
-            If specified, the trace is going to be saved into the file with the given name inside the `tracesDir` folder specified
-            in `browser_type.launch()`.
+            If specified, the trace is going to be saved into the file with the given name inside the `tracesDir` folder
+            specified in `browser_type.launch()`.
         title : Union[str, None]
             Trace name to be shown in the Trace Viewer.
         snapshots : Union[bool, None]
@@ -13419,6 +14618,24 @@ def start_chunk(self, *, title: typing.Optional[str] = None) -> None:
         `tracing.start()` once, and then create multiple trace chunks with `tracing.start_chunk()` and
         `tracing.stop_chunk()`.
 
+        **Usage**
+
+        ```py
+        await context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        page = await context.new_page()
+        await page.goto(\"https://playwright.dev\")
+
+        await context.tracing.start_chunk()
+        await page.get_by_text(\"Get Started\").click()
+        # Everything between start_chunk and stop_chunk will be recorded in the trace.
+        await context.tracing.stop_chunk(path = \"trace1.zip\")
+
+        await context.tracing.start_chunk()
+        await page.goto(\"http://example.com\")
+        # Save a second trace file with different actions.
+        await context.tracing.stop_chunk(path = \"trace2.zip\")
+        ```
+
         ```py
         context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
         page = context.new_page()
@@ -13525,14 +14742,21 @@ def bounding_box(
         calculated relative to the main frame viewport - which is usually the same as the browser window.
 
         Scrolling affects the returned bounding box, similarly to
-        [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect). That
-        means `x` and/or `y` may be negative.
+        [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
+        That means `x` and/or `y` may be negative.
 
         Elements from child frames return the bounding box relative to the main frame, unlike the
         [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
 
-        Assuming the page is static, it is safe to use bounding box coordinates to perform input. For example, the following
-        snippet should click the center of the element.
+        Assuming the page is static, it is safe to use bounding box coordinates to perform input. For example, the
+        following snippet should click the center of the element.
+
+        **Usage**
+
+        ```py
+        box = await element.bounding_box()
+        await page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
+        ```
 
         ```py
         box = element.bounding_box()
@@ -13542,8 +14766,8 @@ def bounding_box(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -13566,8 +14790,8 @@ def check(
         """Locator.check
 
         This method checks the element by performing the following steps:
-        1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already checked,
-           this method returns immediately.
+        1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already
+           checked, this method returns immediately.
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
@@ -13576,26 +14800,26 @@ def check(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -13635,17 +14859,17 @@ def click(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -13653,17 +14877,17 @@ def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -13702,40 +14926,40 @@ def dblclick(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if the
-           first click of the `dblclick()` triggers a navigation event, this method will throw.
+        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
+           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `element.dblclick()` dispatches two `click` events and a single `dblclick` event.
+        **NOTE** `element.dblclick()` dispatches two `click` events and a single `dblclick` event.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -13766,12 +14990,18 @@ def dispatch_event(
         `click` is dispatched. This is equivalent to calling
         [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
 
+        **Usage**
+
+        ```py
+        await element.dispatch_event(\"click\")
+        ```
+
         ```py
         element.dispatch_event(\"click\")
         ```
 
-        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties
-        and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
+        Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
+        properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
@@ -13784,6 +15014,12 @@ def dispatch_event(
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
+        ```py
+        # note you can only create data_transfer in chromium and firefox
+        data_transfer = await page.evaluate_handle(\"new DataTransfer()\")
+        await element.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
+        ```
+
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = page.evaluate_handle(\"new DataTransfer()\")
@@ -13797,8 +15033,8 @@ def dispatch_event(
         event_init : Union[Dict, None]
             Optional event-specific initialization properties.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -13822,9 +15058,15 @@ def evaluate(
 
         This method passes this handle as the first argument to `expression`.
 
-        If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its value.
+        If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its
+        value.
 
-        Examples:
+        **Usage**
+
+        ```py
+        tweets = page.locator(\".tweet .retweets\")
+        assert await tweets.evaluate(\"node => node.innerText\") == \"10 retweets\"
+        ```
 
         ```py
         tweets = page.locator(\".tweet .retweets\")
@@ -13834,13 +15076,13 @@ def evaluate(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -13860,24 +15102,29 @@ def evaluate_all(
     ) -> typing.Any:
         """Locator.evaluate_all
 
-        The method finds all elements matching the specified locator and passes an array of matched elements as a first argument
-        to `expression`. Returns the result of `expression` invocation.
+        The method finds all elements matching the specified locator and passes an array of matched elements as a first
+        argument to `expression`. Returns the result of `expression` invocation.
 
         If `expression` returns a [Promise], then `locator.evaluate_all()` would wait for the promise to resolve and
         return its value.
 
-        Examples:
+        **Usage**
+
+        ```py
+        elements = page.locator(\"div\")
+        div_counts = await elements.evaluate_all(\"(divs, min) => divs.length >= min\", 10)
+        ```
 
         ```py
         elements = page.locator(\"div\")
-        div_counts = elements(\"(divs, min) => divs.length >= min\", 10)
+        div_counts = elements.evaluate_all(\"(divs, min) => divs.length >= min\", 10)
         ```
 
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
 
@@ -13918,13 +15165,13 @@ def evaluate_handle(
         Parameters
         ----------
         expression : str
-            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the function is
-            automatically invoked.
+            JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
+            function is automatically invoked.
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -13949,11 +15196,11 @@ def fill(
     ) -> None:
         """Locator.fill
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an `input`
-        event after filling. Note that you can pass an empty string to clear the input field.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an
+        `input` event after filling. Note that you can pass an empty string to clear the input field.
 
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an
+        error. However, if the element is inside the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
@@ -13964,12 +15211,12 @@ def fill(
         value : str
             Value to set for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -13994,20 +15241,20 @@ def clear(
         This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
         `input` event after clearing.
 
-        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
-        However, if the element is inside the `<label>` element that has an associated
+        If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an
+        error. However, if the element is inside the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
         instead.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -14029,8 +15276,8 @@ def locator(
     ) -> "Locator":
         """Locator.locator
 
-        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter options,
-        similar to `locator.filter()` method.
+        The method finds an element matching the specified selector in the locator's subtree. It also accepts filter
+        options, similar to `locator.filter()` method.
 
         [Learn more about locators](https://playwright.dev/python/docs/locators).
 
@@ -14039,12 +15286,12 @@ def locator(
         selector : str
             A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
         has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
+            passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
+            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
@@ -14078,8 +15325,8 @@ def get_by_alt_text(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14109,8 +15356,8 @@ def get_by_label(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14139,8 +15386,8 @@ def get_by_placeholder(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14256,9 +15503,10 @@ def get_by_role(
         accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
 
         Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector. You
-        can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not
-        recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
+        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
+        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
+        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
+        default values.
 
         Parameters
         ----------
@@ -14271,7 +15519,7 @@ def get_by_role(
         disabled : Union[bool, None]
             An attribute that is usually set by `aria-disabled` or `disabled`.
 
-            > NOTE: Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
+            **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
@@ -14283,8 +15531,8 @@ def get_by_role(
 
             Learn more about [`aria-hidden`](https://www.w3.org/TR/wai-aria-1.2/#aria-hidden).
         level : Union[int, None]
-            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values for
-            `<h1>-<h6>` elements.
+            A number attribute that is usually present for roles `heading`, `listitem`, `row`, `treeitem`, with default values
+            for `<h1>-<h6>` elements.
 
             Learn more about [`aria-level`](https://www.w3.org/TR/wai-aria-1.2/#aria-level).
         name : Union[Pattern[str], str, None]
@@ -14301,8 +15549,8 @@ def get_by_role(
 
             Learn more about [`aria-selected`](https://www.w3.org/TR/wai-aria-1.2/#aria-selected).
         exact : Union[bool, None]
-            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a regular
-            expression. Note that exact match still trims whitespace.
+            Whether `name` is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when `name` is a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14376,21 +15624,39 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then filter
-        by the text content.
+        ```py
+        # Matches <span>
+        page.get_by_text(\"world\")
+
+        # Matches first <div>
+        page.get_by_text(\"Hello world\")
+
+        # Matches second <div>
+        page.get_by_text(\"Hello\", exact=True)
+
+        # Matches both <div>s
+        page.get_by_text(re.compile(\"Hello\"))
+
+        # Matches second <div>
+        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
+        ```
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
+        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
 
-        > NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
-        one, turns line breaks into spaces and ignores leading and trailing whitespace.
-        > NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
-        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
+        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14407,7 +15673,8 @@ def get_by_title(
     ) -> "Locator":
         """Locator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the order\":
+        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
+        order\":
 
         ```html
         <button title='Place the order'>Order Now</button>
@@ -14418,8 +15685,8 @@ def get_by_title(
         text : Union[Pattern[str], str]
             Text to locate the element for.
         exact : Union[bool, None]
-            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a regular
-            expression. Note that exact match still trims whitespace.
+            Whether to find an exact match: case-sensitive and whole-string. Default to false. Ignored when locating by a
+            regular expression. Note that exact match still trims whitespace.
 
         Returns
         -------
@@ -14431,8 +15698,15 @@ def get_by_title(
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Locator.frame_locator
 
-        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements in
-        that iframe:
+        **Usage**
+
+        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
+        in that iframe:
+
+        ```py
+        locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
+        await locator.click()
+        ```
 
         ```py
         locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
@@ -14456,14 +15730,14 @@ def element_handle(
     ) -> "ElementHandle":
         """Locator.element_handle
 
-        Resolves given locator to the first matching DOM element. If no elements matching the query are visible, waits for them
-        up to a given timeout. If multiple elements match the selector, throws.
+        Resolves given locator to the first matching DOM element. If no elements matching the query are visible, waits for
+        them up to a given timeout. If multiple elements match the selector, throws.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14510,8 +15784,19 @@ def filter(
     ) -> "Locator":
         """Locator.filter
 
-        This method narrows existing locator according to the options, for example filters by text. It can be chained to filter
-        multiple times.
+        This method narrows existing locator according to the options, for example filters by text. It can be chained to
+        filter multiple times.
+
+        **Usage**
+
+        ```py
+        row_locator = page.locator(\"tr\")
+        # ...
+        await row_locator
+            .filter(has_text=\"text in column 1\")
+            .filter(has=page.get_by_role(\"button\", name=\"column 2 button\"))
+            .screenshot()
+        ```
 
         ```py
         row_locator = page.locator(\"tr\")
@@ -14525,12 +15810,12 @@ def filter(
         Parameters
         ----------
         has_text : Union[Pattern[str], str, None]
-            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When passed a
-            [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
+            Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
+            passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-            For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
+            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
@@ -14551,8 +15836,8 @@ def focus(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -14567,8 +15852,8 @@ def blur(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.blur(timeout=timeout)))
@@ -14598,8 +15883,23 @@ def drag_to(
     ) -> None:
         """Locator.drag_to
 
-        This method drags the locator to another target locator or target position. It will first move to the source element,
-        perform a `mousedown`, then move to the target element or position and perform a `mouseup`.
+        This method drags the locator to another target locator or target position. It will first move to the source
+        element, perform a `mousedown`, then move to the target element or position and perform a `mouseup`.
+
+        **Usage**
+
+        ```py
+        source = page.locator(\"#source\")
+        target = page.locator(\"#target\")
+
+        await source.drag_to(target)
+        # or specify exact positions relative to the top-left corners of the elements:
+        await source.drag_to(
+          target,
+          source_position={\"x\": 34, \"y\": 7},
+          target_position={\"x\": 10, \"y\": 20}
+        )
+        ```
 
         ```py
         source = page.locator(\"#source\")
@@ -14621,15 +15921,15 @@ def drag_to(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         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.
+            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.
         source_position : Union[{x: float, y: float}, None]
             Clicks on the source 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.
@@ -14664,8 +15964,8 @@ def get_attribute(
         name : str
             Attribute name to get the value for.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14698,29 +15998,29 @@ def hover(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -14744,8 +16044,8 @@ def inner_html(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14764,8 +16064,8 @@ def inner_text(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14782,13 +16082,14 @@ def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
 
         Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the
+        control.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14807,8 +16108,8 @@ def is_checked(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14827,8 +16128,8 @@ def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14847,8 +16148,8 @@ def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14867,8 +16168,8 @@ def is_enabled(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -14887,8 +16188,6 @@ def is_hidden(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `locator.is_hidden()` does not wait for the element to become hidden and
-            returns immediately.
 
         Returns
         -------
@@ -14907,8 +16206,6 @@ def is_visible(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            **DEPRECATED** This option is ignored. `locator.is_visible()` does not wait for the element to become visible and
-            returns immediately.
 
         Returns
         -------
@@ -14931,12 +16228,14 @@ def press(
 
         Focuses the element, and then uses `keyboard.down()` and `keyboard.up()`.
 
-        `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
-        value or a single character to generate the text for. A superset of the `key` values can be found
+        `key` can specify the intended
+        [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
+        to generate the text for. A superset of the `key` values can be found
         [here](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values). Examples of the keys are:
 
         `F1` - `F12`, `Digit0`- `Digit9`, `KeyA`- `KeyZ`, `Backquote`, `Minus`, `Equal`, `Backslash`, `Backspace`, `Tab`,
-        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`, etc.
+        `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
+        etc.
 
         Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
 
@@ -14955,12 +16254,12 @@ def press(
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -14986,50 +16285,50 @@ def screenshot(
     ) -> bytes:
         """Locator.screenshot
 
-        This method captures a screenshot of the page, clipped to the size and position of a particular element matching the
-        locator. If the element is covered by other elements, it will not be actually visible on the screenshot. If the element
-        is a scrollable container, only the currently scrolled content will be visible on the screenshot.
+        This method captures a screenshot of the page, clipped to the size and position of a particular element matching
+        the locator. If the element is covered by other elements, it will not be actually visible on the screenshot. If the
+        element is a scrollable container, only the currently scrolled content will be visible on the screenshot.
 
-        This method waits for the [actionability](https://playwright.dev/python/docs/actionability) checks, then scrolls element into view before taking a
-        screenshot. If the element is detached from DOM, the method throws an error.
+        This method waits for the [actionability](https://playwright.dev/python/docs/actionability) checks, then scrolls element into view before taking
+        a screenshot. If the element is detached from DOM, the method throws an error.
 
         Returns the buffer with the captured screenshot.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
-            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a relative
-            path, then it is resolved relative to the current working directory. If no path is provided, the image won't be saved to
-            the disk.
+            The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a
+            relative path, then it is resolved relative to the current working directory. If no path is provided, the image
+            won't be saved to the disk.
         quality : Union[int, None]
             The quality of the image, between 0-100. Not applicable to `png` images.
         omit_background : Union[bool, None]
             Hides default white background and allows capturing screenshots with transparency. Not applicable to `jpeg` images.
             Defaults to `false`.
         animations : Union["allow", "disabled", None]
-            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different treatment
-            depending on their duration:
+            When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different
+            treatment depending on their duration:
             - finite animations are fast-forwarded to completion, so they'll fire `transitionend` event.
             - infinite animations are canceled to initial state, and then played over after the screenshot.
 
             Defaults to `"allow"` that leaves animations untouched.
         caret : Union["hide", "initial", None]
-            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be changed.
-            Defaults to `"hide"`.
+            When set to `"hide"`, screenshot will hide text caret. When set to `"initial"`, text caret behavior will not be
+            changed.  Defaults to `"hide"`.
         scale : Union["css", "device", None]
-            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this will
-            keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so screenshots of
-            high-dpi devices will be twice as large or even larger.
+            When set to `"css"`, screenshot will have a single pixel per each css pixel on the page. For high-dpi devices, this
+            will keep screenshots small. Using `"device"` option will produce a single pixel per each device pixel, so
+            screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
-            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-            `#FF00FF` that completely covers its bounding box.
+            Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
+            box `#FF00FF` that completely covers its bounding box.
 
         Returns
         -------
@@ -15057,15 +16356,15 @@ def scroll_into_view_if_needed(
     ) -> None:
         """Locator.scroll_into_view_if_needed
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then tries to scroll element into view, unless it is
-        completely visible as defined by
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then tries to scroll element into view, unless
+        it is completely visible as defined by
         [IntersectionObserver](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)'s `ratio`.
 
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -15087,17 +16386,29 @@ def select_option(
     ) -> typing.List[str]:
         """Locator.select_option
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in the
-        `<select>` element and selects these options.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in
+        the `<select>` element and selects these options.
 
-        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside the
-        `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used instead.
+        If the target element is not a `<select>` element, this method throws an error. However, if the element is inside
+        the `<label>` element that has an associated
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be used
+        instead.
 
         Returns the array of option values that have been successfully selected.
 
         Triggers a `change` and `input` event once all the provided options have been selected.
 
+        **Usage**
+
+        ```py
+        # single selection matching the value
+        await element.select_option(\"blue\")
+        # single selection matching the label
+        await element.select_option(label=\"blue\")
+        # multiple selection
+        await element.select_option(value=[\"red\", \"green\", \"blue\"])
+        ```
+
         ```py
         # single selection matching the value
         element.select_option(\"blue\")
@@ -15110,22 +16421,22 @@ def select_option(
         Parameters
         ----------
         value : Union[List[str], str, None]
-            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         index : Union[List[int], int, None]
             Options to select by index. Optional.
         label : Union[List[str], str, None]
-            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected, otherwise
-            only the first option matching one of the passed options is selected. Optional.
+            Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
+            otherwise only the first option matching one of the passed options is selected. Optional.
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
 
@@ -15156,20 +16467,20 @@ def select_text(
     ) -> None:
         """Locator.select_text
 
-        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then focuses the element and selects all its text
-        content.
+        This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, then focuses the element and selects all its
+        text content.
 
         If the element is inside the `<label>` element that has an associated
-        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), focuses and selects text in the
-        control instead.
+        [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), focuses and selects text in
+        the control instead.
 
         Parameters
         ----------
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         """
 
         return mapping.from_maybe_impl(
@@ -15191,24 +16502,24 @@ def set_input_files(
     ) -> None:
         """Locator.set_input_files
 
-        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
-        are resolved relative to the current working directory. For empty array, clears the selected files.
+        Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
+        they are resolved relative to the current working directory. For empty array, clears the selected files.
 
         This method expects `Locator` to point to an
-        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
-        `<label>` element that has an associated
+        [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
+        the `<label>` element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
 
         Parameters
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -15243,31 +16554,31 @@ def tap(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
-        > NOTE: `element.tap()` requires that the `hasTouch` option of the browser context be set to true.
+        **NOTE** `element.tap()` requires that the `hasTouch` option of the browser context be set to true.
 
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
-            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-            modifiers back. If not specified, currently pressed modifiers are used.
+            Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
+            current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15293,8 +16604,8 @@ def text_content(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
 
         Returns
         -------
@@ -15315,10 +16626,18 @@ def type(
     ) -> None:
         """Locator.type
 
-        Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text.
+        Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the
+        text.
 
         To press a special key, like `Control` or `ArrowDown`, use `locator.press()`.
 
+        **Usage**
+
+        ```py
+        await element.type(\"hello\") # types instantly
+        await element.type(\"world\", delay=100) # types slower, like a user
+        ```
+
         ```py
         element.type(\"hello\") # types instantly
         element.type(\"world\", delay=100) # types slower, like a user
@@ -15326,6 +16645,12 @@ def type(
 
         An example of typing into a text field and then submitting the form:
 
+        ```py
+        element = page.get_by_label(\"Password\")
+        await element.type(\"my password\")
+        await element.press(\"Enter\")
+        ```
+
         ```py
         element = page.get_by_label(\"Password\")
         element.type(\"my password\")
@@ -15339,12 +16664,12 @@ def type(
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         """
 
         return mapping.from_maybe_impl(
@@ -15377,26 +16702,26 @@ def uncheck(
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15447,8 +16772,15 @@ def wait_for(
 
         Returns when element specified by locator satisfies the `state` option.
 
-        If target element already satisfies the condition, the method returns immediately. Otherwise, waits for up to `timeout`
-        milliseconds until the condition is met.
+        If target element already satisfies the condition, the method returns immediately. Otherwise, waits for up to
+        `timeout` milliseconds until the condition is met.
+
+        **Usage**
+
+        ```py
+        order_sent = page.locator(\"#order-sent\")
+        await order_sent.wait_for()
+        ```
 
         ```py
         order_sent = page.locator(\"#order-sent\")
@@ -15458,16 +16790,16 @@ def wait_for(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
             - `'detached'` - wait for element to not be present in DOM.
-            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element without
-              any content or with `display:none` has an empty bounding box and is not considered visible.
-            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or `visibility:hidden`.
-              This is opposite to the `'visible'` option.
+            - `'visible'` - wait for element to have non-empty bounding box and no `visibility:hidden`. Note that element
+              without any content or with `display:none` has an empty bounding box and is not considered visible.
+            - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or
+              `visibility:hidden`. This is opposite to the `'visible'` option.
         """
 
         return mapping.from_maybe_impl(
@@ -15489,35 +16821,35 @@ def set_checked(
         This method checks or unchecks an element by performing the following steps:
         1. Ensure that matched element is a checkbox or a radio input. If not, this method throws.
         1. If the element already has the right checked state, this method returns immediately.
-        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If the
-           element is detached during the checks, the whole action is retried.
+        1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
+           the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
         1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
-        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
-        zero timeout disables this.
+        When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
+        Passing zero timeout disables this.
 
         Parameters
         ----------
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
-            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of the
-            element.
+            A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
+            the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            Maximum time in milliseconds, defaults to 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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
-            opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
-            inaccessible pages. Defaults to `false`.
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15611,8 +16943,8 @@ def headers(self) -> typing.Dict[str, str]:
     def headers_array(self) -> typing.List[NameValue]:
         """APIResponse.headers_array
 
-        An array with all the request HTTP headers associated with this response. Header names are not lower-cased. Headers with
-        multiple entries, such as `Set-Cookie`, appear in the array multiple times.
+        An array with all the request HTTP headers associated with this response. Header names are not lower-cased. Headers
+        with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
 
         Returns
         -------
@@ -15674,8 +17006,8 @@ class APIRequestContext(SyncBase):
     def dispose(self) -> None:
         """APIRequestContext.dispose
 
-        All responses returned by `a_pi_request_context.get()` and similar methods are stored in the memory, so that you
-        can later call `a_pi_response.body()`. This method discards all stored responses, and makes
+        All responses returned by `a_pi_request_context.get()` and similar methods are stored in the memory, so that
+        you can later call `a_pi_response.body()`. This method discards all stored responses, and makes
         `a_pi_response.body()` throw \"Response disposed\" error.
         """
 
@@ -15702,8 +17034,8 @@ def delete(
         """APIRequestContext.delete
 
         Sends HTTP(S) [DELETE](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/DELETE) request and returns its
-        response. The method will populate request cookies from the context and update context cookies from the response. The
-        method will automatically follow redirects.
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
 
         Parameters
         ----------
@@ -15714,22 +17046,24 @@ def delete(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -15778,9 +17112,9 @@ def head(
     ) -> "APIResponse":
         """APIRequestContext.head
 
-        Sends HTTP(S) [HEAD](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/HEAD) request and returns its response.
-        The method will populate request cookies from the context and update context cookies from the response. The method will
-        automatically follow redirects.
+        Sends HTTP(S) [HEAD](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/HEAD) request and returns its
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
 
         Parameters
         ----------
@@ -15791,22 +17125,24 @@ def head(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -15855,9 +17191,11 @@ def get(
     ) -> "APIResponse":
         """APIRequestContext.get
 
-        Sends HTTP(S) [GET](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/GET) request and returns its response. The
-        method will populate request cookies from the context and update context cookies from the response. The method will
-        automatically follow redirects.
+        Sends HTTP(S) [GET](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/GET) request and returns its
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
+
+        **Usage**
 
         Request parameters can be configured with `params` option, they will be serialized into the URL search parameters:
 
@@ -15878,22 +17216,24 @@ def get(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -15942,9 +17282,9 @@ def patch(
     ) -> "APIResponse":
         """APIRequestContext.patch
 
-        Sends HTTP(S) [PATCH](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PATCH) request and returns its response.
-        The method will populate request cookies from the context and update context cookies from the response. The method will
-        automatically follow redirects.
+        Sends HTTP(S) [PATCH](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PATCH) request and returns its
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
 
         Parameters
         ----------
@@ -15955,22 +17295,24 @@ def patch(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -16019,9 +17361,9 @@ def put(
     ) -> "APIResponse":
         """APIRequestContext.put
 
-        Sends HTTP(S) [PUT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT) request and returns its response. The
-        method will populate request cookies from the context and update context cookies from the response. The method will
-        automatically follow redirects.
+        Sends HTTP(S) [PUT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT) request and returns its
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
 
         Parameters
         ----------
@@ -16032,22 +17374,24 @@ def put(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -16096,9 +17440,11 @@ def post(
     ) -> "APIResponse":
         """APIRequestContext.post
 
-        Sends HTTP(S) [POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST) request and returns its response.
-        The method will populate request cookies from the context and update context cookies from the response. The method will
-        automatically follow redirects.
+        Sends HTTP(S) [POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST) request and returns its
+        response. The method will populate request cookies from the context and update context cookies from the response.
+        The method will automatically follow redirects.
+
+        **Usage**
 
         JSON objects can be passed directly to the request:
 
@@ -16111,7 +17457,8 @@ def post(
         ```
 
         To send form data to the server use `form` option. Its value will be encoded into the request body with
-        `application/x-www-form-urlencoded` encoding (see below how to use `multipart/form-data` form encoding to send files):
+        `application/x-www-form-urlencoded` encoding (see below how to use `multipart/form-data` form encoding to send
+        files):
 
         ```python
         formData = {
@@ -16145,22 +17492,24 @@ def post(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -16210,10 +17559,11 @@ def fetch(
     ) -> "APIResponse":
         """APIRequestContext.fetch
 
-        Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and update
-        context cookies from the response. The method will automatically follow redirects.
+        Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and
+        update context cookies from the response. The method will automatically follow redirects. JSON objects can be
+        passed directly to the request.
 
-        JSON objects can be passed directly to the request:
+        **Usage**
 
         ```python
         data = {
@@ -16251,22 +17601,24 @@ def fetch(
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers.
         data : Union[Any, bytes, str, None]
-            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and
-            `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will
-            be set to `application/octet-stream` if not explicitly set.
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
         form : Union[Dict[str, Union[bool, float, str]], None]
-            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent as
-            this request body. If this parameter is specified `content-type` header will be set to
+            Provides an object that will be serialized as html form using `application/x-www-form-urlencoded` encoding and sent
+            as this request body. If this parameter is specified `content-type` header will be set to
             `application/x-www-form-urlencoded` unless explicitly provided.
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
-            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this request
-            body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless explicitly
-            provided. File values can be passed either as [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream)
-            or as file-like object containing file name, mime-type and its content.
+            Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
+            request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
+            explicitly provided. File values can be passed either as
+            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
+            name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
-            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         max_redirects : Union[int, None]
@@ -16301,8 +17653,8 @@ def storage_state(
     ) -> StorageState:
         """APIRequestContext.storage_state
 
-        Returns storage state for this request context, contains current cookies and local storage snapshot if it was passed to
-        the constructor.
+        Returns storage state for this request context, contains current cookies and local storage snapshot if it was
+        passed to the constructor.
 
         Parameters
         ----------
@@ -16362,12 +17714,13 @@ def new_context(
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         timeout : Union[float, None]
-            Maximum time in milliseconds to wait for the response. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
+            Maximum time in milliseconds to wait for the response. Defaults to `30000` (30 seconds). Pass `0` to disable
+            timeout.
         storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
-            Populates context with given storage state. This option can be used to initialize context with logged-in information
-            obtained via `browser_context.storage_state()` or `a_pi_request_context.storage_state()`. Either a path to the
-            file with saved storage, or the value returned by one of `browser_context.storage_state()` or
-            `a_pi_request_context.storage_state()` methods.
+            Populates context with given storage state. This option can be used to initialize context with logged-in
+            information obtained via `browser_context.storage_state()` or `a_pi_request_context.storage_state()`.
+            Either a path to the file with saved storage, or the value returned by one of
+            `browser_context.storage_state()` or `a_pi_request_context.storage_state()` methods.
 
         Returns
         -------
@@ -16404,6 +17757,16 @@ def to_have_title(
 
         Ensures the page has the given title.
 
+        **Usage**
+
+        ```py
+        import re
+        from playwright.async_api import expect
+
+        # ...
+        await expect(page).to_have_title(re.compile(r\".*checkout\"))
+        ```
+
         ```py
         import re
         from playwright.sync_api import expect
@@ -16466,6 +17829,16 @@ def to_have_url(
 
         Ensures the page is navigated to the given URL.
 
+        **Usage**
+
+        ```py
+        import re
+        from playwright.async_api import expect
+
+        # ...
+        await expect(page).to_have_url(re.compile(\".*checkout\"))
+        ```
+
         ```py
         import re
         from playwright.sync_api import expect
@@ -16526,6 +17899,8 @@ class LocatorAssertions(SyncBase):
     def to_contain_text(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -16537,8 +17912,19 @@ def to_contain_text(
     ) -> None:
         """LocatorAssertions.to_contain_text
 
-        Ensures the `Locator` points to an element that contains the given text. You can use regular expressions for the value
-        as well.
+        Ensures the `Locator` points to an element that contains the given text. You can use regular expressions for the
+        value as well.
+
+        **Usage**
+
+        ```py
+        import re
+        from playwright.async_api import expect
+
+        locator = page.locator('.title')
+        await expect(locator).to_contain_text(\"substring\")
+        await expect(locator).to_contain_text(re.compile(r\"\\d messages\"))
+        ```
 
         ```py
         import re
@@ -16567,6 +17953,22 @@ def to_contain_text(
 
         Let's see how we can use the assertion:
 
+        ```py
+        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\"])
+
+        # ✖ Wrong order
+        await expect(page.locator(\"ul > li\")).to_contain_text([\"Text 3\", \"Text 2\"])
+
+        # ✖ No item contains this text
+        await expect(page.locator(\"ul > li\")).to_contain_text([\"Some 33\"])
+
+        # ✖ Locator points to the outer list element, not to the list items
+        await expect(page.locator(\"ul\")).to_contain_text([\"Text 3\"])
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -16585,7 +17987,7 @@ def to_contain_text(
 
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -16611,6 +18013,8 @@ def to_contain_text(
     def not_to_contain_text(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -16626,7 +18030,7 @@ def not_to_contain_text(
 
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -16660,6 +18064,15 @@ def to_have_attribute(
 
         Ensures the `Locator` points to an element with given attribute.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator(\"input\")
+        await expect(locator).to_have_attribute(\"type\", \"text\")
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -16719,6 +18132,8 @@ def not_to_have_attribute(
     def to_have_class(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -16731,10 +18146,20 @@ def to_have_class(
         Ensures the `Locator` points to an element with given CSS classes. This needs to be a full match or using a relaxed
         regular expression.
 
+        **Usage**
+
         ```html
         <div class='selected row' id='component'></div>
         ```
 
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator(\"#component\")
+        await expect(locator).to_have_class(re.compile(r\"selected\"))
+        await expect(locator).to_have_class(\"selected row\")
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -16745,6 +18170,13 @@ def to_have_class(
 
         Note that if array is passed as an expected value, entire lists of elements can be asserted:
 
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator(\"list > .component\")
+        await expect(locator).to_have_class([\"component\", \"component selected\", \"component\"])
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -16754,7 +18186,7 @@ def to_have_class(
 
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
             Time to retry the assertion for.
@@ -16772,6 +18204,8 @@ def to_have_class(
     def not_to_have_class(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -16785,7 +18219,7 @@ def not_to_have_class(
 
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
             Time to retry the assertion for.
@@ -16807,6 +18241,15 @@ def to_have_count(
 
         Ensures the `Locator` resolves to an exact number of DOM nodes.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator(\"list > .component\")
+        await expect(locator).to_have_count(3)
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -16858,6 +18301,15 @@ def to_have_css(
 
         Ensures the `Locator` resolves to an element with the given computed CSS style.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.get_by_role(\"button\")
+        await expect(locator).to_have_css(\"display\", \"flex\")
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -16920,6 +18372,15 @@ def to_have_id(
 
         Ensures the `Locator` points to an element with the given DOM Node ID.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.get_by_role(\"textbox\")
+        await expect(locator).to_have_id(\"lastname\")
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -16968,8 +18429,17 @@ def to_have_js_property(
     ) -> None:
         """LocatorAssertions.to_have_js_property
 
-        Ensures the `Locator` points to an element with given JavaScript property. Note that this property can be of a primitive
-        type as well as a plain serializable JavaScript object.
+        Ensures the `Locator` points to an element with given JavaScript property. Note that this property can be of a
+        primitive type as well as a plain serializable JavaScript object.
+
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator(\".component\")
+        await expect(locator).to_have_js_property(\"loaded\", True)
+        ```
 
         ```py
         from playwright.sync_api import expect
@@ -17031,8 +18501,18 @@ def to_have_value(
     ) -> None:
         """LocatorAssertions.to_have_value
 
-        Ensures the `Locator` points to an element with the given input value. You can use regular expressions for the value as
-        well.
+        Ensures the `Locator` points to an element with the given input value. You can use regular expressions for the
+        value as well.
+
+        **Usage**
+
+        ```py
+        import re
+        from playwright.async_api import expect
+
+        locator = page.locator(\"input[type=number]\")
+        await expect(locator).to_have_value(re.compile(r\"[0-9]\"))
+        ```
 
         ```py
         import re
@@ -17080,14 +18560,20 @@ def not_to_have_value(
 
     def to_have_values(
         self,
-        values: typing.List[typing.Union[typing.Pattern[str], str]],
+        values: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
+            typing.List[typing.Union[typing.Pattern[str], str]],
+        ],
         *,
         timeout: typing.Optional[float] = None
     ) -> None:
         """LocatorAssertions.to_have_values
 
-        Ensures the `Locator` points to multi-select/combobox (i.e. a `select` with the `multiple` attribute) and the specified
-        values are selected.
+        Ensures the `Locator` points to multi-select/combobox (i.e. a `select` with the `multiple` attribute) and the
+        specified values are selected.
+
+        **Usage**
 
         For example, given the following element:
 
@@ -17099,6 +18585,15 @@ def to_have_values(
         </select>
         ```
 
+        ```py
+        import re
+        from playwright.async_api import expect
+
+        locator = page.locator(\"id=favorite-colors\")
+        await locator.select_option([\"R\", \"G\"])
+        await expect(locator).to_have_values([re.compile(r\"R\"), re.compile(r\"G\")])
+        ```
+
         ```py
         import re
         from playwright.sync_api import expect
@@ -17110,7 +18605,7 @@ def to_have_values(
 
         Parameters
         ----------
-        values : List[Union[Pattern[str], str]]
+        values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
             Expected options currently selected.
         timeout : Union[float, None]
             Time to retry the assertion for.
@@ -17127,7 +18622,11 @@ def to_have_values(
 
     def not_to_have_values(
         self,
-        values: typing.List[typing.Union[typing.Pattern[str], str]],
+        values: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
+            typing.List[typing.Union[typing.Pattern[str], str]],
+        ],
         *,
         timeout: typing.Optional[float] = None
     ) -> None:
@@ -17137,7 +18636,7 @@ def not_to_have_values(
 
         Parameters
         ----------
-        values : List[Union[Pattern[str], str]]
+        values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
             Expected options currently selected.
         timeout : Union[float, None]
             Time to retry the assertion for.
@@ -17155,6 +18654,8 @@ def not_to_have_values(
     def to_have_text(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -17166,7 +18667,19 @@ def to_have_text(
     ) -> None:
         """LocatorAssertions.to_have_text
 
-        Ensures the `Locator` points to an element with the given text. You can use regular expressions for the value as well.
+        Ensures the `Locator` points to an element with the given text. You can use regular expressions for the value as
+        well.
+
+        **Usage**
+
+        ```py
+        import re
+        from playwright.async_api import expect
+
+        locator = page.locator(\".title\")
+        await expect(locator).to_have_text(re.compile(r\"Welcome, Test User\"))
+        await expect(locator).to_have_text(re.compile(r\"Welcome, .*\"))
+        ```
 
         ```py
         import re
@@ -17194,6 +18707,22 @@ def to_have_text(
 
         Let's see how we can use the assertion:
 
+        ```py
+        from playwright.async_api import expect
+
+        # ✓ Has the right items in the right order
+        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
+
+        # ✖ Wrong order
+        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 3\", \"Text 2\", \"Text 1\"])
+
+        # ✖ Last item does not match
+        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text\"])
+
+        # ✖ Locator points to the outer list element, not to the list items
+        await expect(page.locator(\"ul\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -17212,7 +18741,7 @@ def to_have_text(
 
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -17238,6 +18767,8 @@ def to_have_text(
     def not_to_have_text(
         self,
         expected: typing.Union[
+            typing.List[str],
+            typing.List[typing.Pattern[str]],
             typing.List[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
@@ -17253,7 +18784,7 @@ def not_to_have_text(
 
         Parameters
         ----------
-        expected : Union[List[Union[Pattern[str], str]], Pattern[str], str]
+        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -17286,6 +18817,15 @@ def to_be_checked(
 
         Ensures the `Locator` points to a checked input.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.get_by_label(\"Subscribe to newsletter\")
+        await expect(locator).to_be_checked()
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -17324,11 +18864,21 @@ def not_to_be_checked(self, *, timeout: typing.Optional[float] = None) -> None:
     def to_be_disabled(self, *, timeout: typing.Optional[float] = None) -> None:
         """LocatorAssertions.to_be_disabled
 
-        Ensures the `Locator` points to a disabled element. Element is disabled if it has \"disabled\" attribute or is disabled
-        via ['aria-disabled'](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled). Note
+        Ensures the `Locator` points to a disabled element. Element is disabled if it has \"disabled\" attribute or is
+        disabled via
+        ['aria-disabled'](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled). Note
         that only native control elements such as HTML `button`, `input`, `select`, `textarea`, `option`, `optgroup` can be
         disabled by setting \"disabled\" attribute. \"disabled\" attribute on other elements is ignored by the browser.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator(\"button.submit\")
+        await expect(locator).to_be_disabled()
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -17373,6 +18923,15 @@ def to_be_editable(
 
         Ensures the `Locator` points to an editable element.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.get_by_role(\"textbox\")
+        await expect(locator).to_be_editable()
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -17423,6 +18982,15 @@ def to_be_empty(self, *, timeout: typing.Optional[float] = None) -> None:
 
         Ensures the `Locator` points to an empty editable element or to a DOM node that has no text.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator(\"div.warning\")
+        await expect(locator).to_be_empty()
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -17467,6 +19035,15 @@ def to_be_enabled(
 
         Ensures the `Locator` points to an enabled element.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator(\"button.submit\")
+        await expect(locator).to_be_enabled()
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -17514,7 +19091,16 @@ def to_be_hidden(self, *, timeout: typing.Optional[float] = None) -> None:
         """LocatorAssertions.to_be_hidden
 
         Ensures that `Locator` either does not resolve to any DOM node, or resolves to a
-        [non-visible](https://playwright.dev/python/docs/api/actionability#visible) one.
+        [non-visible](https://playwright.dev/python/docs/actionability#visible) one.
+
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator('.my-element')
+        await expect(locator).to_be_hidden()
+        ```
 
         ```py
         from playwright.sync_api import expect
@@ -17558,8 +19144,17 @@ def to_be_visible(
     ) -> None:
         """LocatorAssertions.to_be_visible
 
-        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/api/actionability#attached) and [visible](https://playwright.dev/python/docs/api/actionability#visible)
-        DOM node.
+        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/actionability#attached) and
+        [visible](https://playwright.dev/python/docs/actionability#visible) DOM node.
+
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator('.my-element')
+        await expect(locator).to_be_visible()
+        ```
 
         ```py
         from playwright.sync_api import expect
@@ -17609,6 +19204,15 @@ def to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None:
 
         Ensures the `Locator` points to a focused DOM node.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.get_by_role(\"textbox\")
+        await expect(locator).to_be_focused()
+        ```
+
         ```py
         from playwright.sync_api import expect
 
@@ -17653,6 +19257,15 @@ def to_be_ok(self) -> None:
 
         Ensures the response status code is within `200..299` range.
 
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        # ...
+        await expect(response).to_be_ok()
+        ```
+
         ```py
         import re
         from playwright.sync_api import expect
diff --git a/pyproject.toml b/pyproject.toml
index 4fd73ed8c..e0ea95cc7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -21,7 +21,6 @@ warn_redundant_casts = true
 warn_unused_configs = true
 check_untyped_defs = true
 disallow_untyped_defs = true
-exclude = ["examples"]
 
 [[tool.mypy.overrides]]
 module = "tests/async.*"
diff --git a/setup.py b/setup.py
index 7f9427da2..c3b2aa365 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.28.0"
+driver_version = "1.29.0-alpha-nov-25-2022"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/server.py b/tests/server.py
index b6f12d87f..fd3f6e36f 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -42,6 +42,10 @@ def find_free_port() -> int:
         return s.getsockname()[1]
 
 
+class HttpRequestWitPostBody(http.Request):
+    post_body = None
+
+
 T = TypeVar("T")
 
 
@@ -158,20 +162,20 @@ class MyHttpFactory(http.HTTPFactory):
 
         self.listen(MyHttpFactory())
 
-    async def wait_for_request(self, path: str) -> http.Request:
+    async def wait_for_request(self, path: str) -> HttpRequestWitPostBody:
         if path in self.request_subscribers:
             return await self.request_subscribers[path]
-        future: asyncio.Future["http.Request"] = asyncio.Future()
+        future: asyncio.Future["HttpRequestWitPostBody"] = asyncio.Future()
         self.request_subscribers[path] = future
         return await future
 
     @contextlib.contextmanager
     def expect_request(
         self, path: str
-    ) -> Generator[ExpectResponse[http.Request], None, None]:
+    ) -> Generator[ExpectResponse[HttpRequestWitPostBody], None, None]:
         future = asyncio.create_task(self.wait_for_request(path))
 
-        cb_wrapper: ExpectResponse[http.Request] = ExpectResponse()
+        cb_wrapper: ExpectResponse[HttpRequestWitPostBody] = ExpectResponse()
 
         def done_cb(task: asyncio.Task) -> None:
             cb_wrapper._value = future.result()
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 1f813ff74..165f77788 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -90,7 +90,9 @@ def test_assertions_locator_to_contain_text(page: Page, server: Server) -> None:
         expect(page.locator("div#foobar")).to_contain_text("bar", timeout=100)
 
     page.set_content("<div>Text \n1</div><div>Text2</div><div>Text3</div>")
-    expect(page.locator("div")).to_contain_text(["ext     1", re.compile("ext3")])
+    expect(page.locator("div")).to_contain_text(
+        ["ext     1", re.compile("ext3")]  # type: ignore
+    )
 
 
 def test_assertions_locator_to_have_attribute(page: Page, server: Server) -> None:
@@ -235,7 +237,9 @@ def test_to_have_js_property_assertions_locator_to_have_text(
 
     page.set_content("<div>Text    \n1</div><div>Text   2a</div>")
     # Should only normalize whitespace in the first item.
-    expect(page.locator("div")).to_have_text(["Text  1", re.compile(r"Text   \d+a")])
+    expect(page.locator("div")).to_have_text(
+        ["Text  1", re.compile(r"Text   \d+a")]  # type: ignore
+    )
 
 
 @pytest.mark.parametrize(
diff --git a/tests/sync/test_browsercontext_request_fallback.py b/tests/sync/test_browsercontext_request_fallback.py
index 85a7d4be6..24c25f131 100644
--- a/tests/sync/test_browsercontext_request_fallback.py
+++ b/tests/sync/test_browsercontext_request_fallback.py
@@ -12,8 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# mypy: ignore-errors
-# pyright: reportUndefinedVariable=false, reportGeneralTypeIssues=false, reportOptionalMemberAccess=false
+from typing import Any, Callable, List
 
 import pytest
 
@@ -21,31 +20,35 @@
 from tests.server import Server
 
 
+def _append_with_return_value(values: List, value: Any) -> Any:
+    values.append(value)
+
+
 def test_should_work(page: Page, context: BrowserContext, server: Server) -> None:
     context.route("**/*", lambda route: route.fallback())
     page.goto(server.EMPTY_PAGE)
 
 
 def test_should_fall_back(page: Page, context: BrowserContext, server: Server) -> None:
-    intercepted = []
+    intercepted: List[int] = []
     context.route(
         "**/empty.html",
         lambda route: (
-            intercepted.append(1),
+            _append_with_return_value(intercepted, 1),
             route.fallback(),
         ),
     )
     context.route(
         "**/empty.html",
         lambda route: (
-            intercepted.append(2),
+            _append_with_return_value(intercepted, 2),
             route.fallback(),
         ),
     )
     context.route(
         "**/empty.html",
         lambda route: (
-            intercepted.append(3),
+            _append_with_return_value(intercepted, 3),
             route.fallback(),
         ),
     )
@@ -59,8 +62,8 @@ def test_should_fall_back_async_delayed(
 ) -> None:
     intercepted = []
 
-    def create_handler(i: int):
-        def handler(route):
+    def create_handler(i: int) -> Callable[[Route], None]:
+        def handler(route: Route) -> None:
             intercepted.append(i)
             page.wait_for_timeout(500)
             route.fallback()
@@ -83,6 +86,7 @@ def test_should_chain_once(page: Page, context: BrowserContext, server: Server)
     context.route("**/madeup.txt", lambda route: route.fallback(), times=1)
 
     resp = page.goto(server.PREFIX + "/madeup.txt")
+    assert resp
     body = resp.body()
     assert body == b"fulfilled one"
 
@@ -92,7 +96,7 @@ def test_should_not_chain_fulfill(
 ) -> None:
     failed = [False]
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         failed[0] = True
 
     context.route("**/empty.html", handler)
@@ -103,6 +107,7 @@ def handler(route: Route):
     context.route("**/empty.html", lambda route: route.fallback())
 
     response = page.goto(server.EMPTY_PAGE)
+    assert response
     body = response.body()
     assert body == b"fulfilled"
     assert not failed[0]
@@ -117,7 +122,7 @@ def test_should_not_chain_abort(
 ) -> None:
     failed = [False]
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         failed[0] = True
 
     context.route("**/empty.html", handler)
@@ -140,9 +145,9 @@ def test_should_fall_back_after_exception(
 ) -> None:
     context.route("**/empty.html", lambda route: route.continue_())
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         try:
-            route.fulfill(response=47)
+            route.fulfill(response=47)  # type: ignore
         except Exception:
             route.fallback()
 
@@ -156,14 +161,14 @@ def test_should_amend_http_headers(
 ) -> None:
     values = []
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         values.append(route.request.headers.get("foo"))
         values.append(route.request.header_value("FOO"))
         route.continue_()
 
     context.route("**/sleep.zzz", handler)
 
-    def handler_with_header_mods(route: Route):
+    def handler_with_header_mods(route: Route) -> None:
         route.fallback(headers={**route.request.headers, "FOO": "bar"})
 
     context.route("**/*", handler_with_header_mods)
@@ -191,15 +196,15 @@ def test_should_delete_header_with_undefined_value(
 
     intercepted_request = []
 
-    def capture_and_continue(route: Route, request: Request):
+    def capture_and_continue(route: Route, request: Request) -> None:
         intercepted_request.append(request)
         route.continue_()
 
     context.route("**/*", capture_and_continue)
 
-    def delete_foo_header(route: Route, request: Request):
+    def delete_foo_header(route: Route, request: Request) -> None:
         headers = request.all_headers()
-        route.fallback(headers={**headers, "foo": None})
+        route.fallback(headers={**headers, "foo": None})  # type: ignore
 
     context.route(server.PREFIX + "/something", delete_foo_header)
     with server.expect_request("/something") as server_req_info:
@@ -229,11 +234,11 @@ def test_should_amend_method(
     page: Page, context: BrowserContext, server: Server
 ) -> None:
     page.goto(server.EMPTY_PAGE)
-    method = []
+    method: List[str] = []
     context.route(
         "**/*",
         lambda route: (
-            method.append(route.request.method),
+            _append_with_return_value(method, route.request.method),
             route.continue_(),
         ),
     )
@@ -249,11 +254,11 @@ def test_should_amend_method(
 def test_should_override_request_url(
     page: Page, context: BrowserContext, server: Server
 ) -> None:
-    url = []
+    url: List[str] = []
     context.route(
         "**/global-var.html",
         lambda route: (
-            url.append(route.request.url),
+            _append_with_return_value(url, route.request.url),
             route.continue_(),
         ),
     )
@@ -279,11 +284,11 @@ def test_should_amend_post_data(
     page: Page, context: BrowserContext, server: Server
 ) -> None:
     page.goto(server.EMPTY_PAGE)
-    post_data = []
+    post_data: List[str] = []
     context.route(
         "**/*",
         lambda route: (
-            post_data.append(route.request.post_data),
+            _append_with_return_value(post_data, route.request.post_data),
             route.continue_(),
         ),
     )
@@ -300,11 +305,11 @@ def test_should_amend_binary_post_data(
     page: Page, context: BrowserContext, server: Server
 ) -> None:
     page.goto(server.EMPTY_PAGE)
-    post_data_buffer = []
+    post_data_buffer: List[str] = []
     context.route(
         "**/*",
         lambda route: (
-            post_data_buffer.append(route.request.post_data),
+            _append_with_return_value(post_data_buffer, route.request.post_data),
             route.continue_(),
         ),
     )
@@ -324,19 +329,31 @@ def test_should_amend_binary_post_data(
 def test_should_chain_fallback_into_page(
     context: BrowserContext, page: Page, server: Server
 ) -> None:
-    intercepted = []
+    intercepted: List[int] = []
     context.route(
-        "**/empty.html", lambda route: (intercepted.append(1), route.fallback())
+        "**/empty.html",
+        lambda route: (_append_with_return_value(intercepted, 1), route.fallback()),
     )
     context.route(
-        "**/empty.html", lambda route: (intercepted.append(2), route.fallback())
+        "**/empty.html",
+        lambda route: (_append_with_return_value(intercepted, 2), route.fallback()),
     )
     context.route(
-        "**/empty.html", lambda route: (intercepted.append(3), route.fallback())
+        "**/empty.html",
+        lambda route: (_append_with_return_value(intercepted, 3), route.fallback()),
+    )
+    page.route(
+        "**/empty.html",
+        lambda route: (_append_with_return_value(intercepted, 4), route.fallback()),
+    )
+    page.route(
+        "**/empty.html",
+        lambda route: (_append_with_return_value(intercepted, 5), route.fallback()),
+    )
+    page.route(
+        "**/empty.html",
+        lambda route: (_append_with_return_value(intercepted, 6), route.fallback()),
     )
-    page.route("**/empty.html", lambda route: (intercepted.append(4), route.fallback()))
-    page.route("**/empty.html", lambda route: (intercepted.append(5), route.fallback()))
-    page.route("**/empty.html", lambda route: (intercepted.append(6), route.fallback()))
 
     page.goto(server.EMPTY_PAGE)
     assert intercepted == [6, 5, 4, 3, 2, 1]
diff --git a/tests/sync/test_page_request_fallback.py b/tests/sync/test_page_request_fallback.py
index 0529ecdc7..5166da66e 100644
--- a/tests/sync/test_page_request_fallback.py
+++ b/tests/sync/test_page_request_fallback.py
@@ -12,8 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# mypy: ignore-errors
-# pyright: reportUndefinedVariable=false, reportGeneralTypeIssues=false, reportOptionalMemberAccess=false
+from typing import Any, Callable, List
 
 import pytest
 
@@ -21,31 +20,35 @@
 from tests.server import Server
 
 
+def _append_with_return_value(values: List, value: Any) -> Any:
+    values.append(value)
+
+
 def test_should_work(page: Page, server: Server) -> None:
     page.route("**/*", lambda route: route.fallback())
     page.goto(server.EMPTY_PAGE)
 
 
 def test_should_fall_back(page: Page, server: Server) -> None:
-    intercepted = []
+    intercepted: List[str] = []
     page.route(
         "**/empty.html",
         lambda route: (
-            intercepted.append(1),
+            _append_with_return_value(intercepted, 1),
             route.fallback(),
         ),
     )
     page.route(
         "**/empty.html",
         lambda route: (
-            intercepted.append(2),
+            _append_with_return_value(intercepted, 2),
             route.fallback(),
         ),
     )
     page.route(
         "**/empty.html",
         lambda route: (
-            intercepted.append(3),
+            _append_with_return_value(intercepted, 3),
             route.fallback(),
         ),
     )
@@ -55,11 +58,11 @@ def test_should_fall_back(page: Page, server: Server) -> None:
 
 
 def test_should_fall_back_async_delayed(page: Page, server: Server) -> None:
-    intercepted = []
+    intercepted: List[str] = []
 
-    def create_handler(i: int):
-        def handler(route):
-            intercepted.append(i)
+    def create_handler(i: int) -> Callable[[Route], None]:
+        def handler(route: Route) -> None:
+            _append_with_return_value(intercepted, i)
             page.wait_for_timeout(500)
             route.fallback()
 
@@ -81,14 +84,15 @@ def test_should_chain_once(page: Page, server: Server) -> None:
     page.route("**/madeup.txt", lambda route: route.fallback(), times=1)
 
     resp = page.goto(server.PREFIX + "/madeup.txt")
+    assert resp
     body = resp.body()
     assert body == b"fulfilled one"
 
 
 def test_should_not_chain_fulfill(page: Page, server: Server) -> None:
-    failed = [False]
+    failed: List[bool] = [False]
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         failed[0] = True
 
     page.route("**/empty.html", handler)
@@ -99,6 +103,7 @@ def handler(route: Route):
     page.route("**/empty.html", lambda route: route.fallback())
 
     response = page.goto(server.EMPTY_PAGE)
+    assert response
     body = response.body()
     assert body == b"fulfilled"
     assert not failed[0]
@@ -107,9 +112,9 @@ def handler(route: Route):
 def test_should_not_chain_abort(
     page: Page, server: Server, is_webkit: bool, is_firefox: bool
 ) -> None:
-    failed = [False]
+    failed: List[bool] = [False]
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         failed[0] = True
 
     page.route("**/empty.html", handler)
@@ -130,9 +135,9 @@ def handler(route: Route):
 def test_should_fall_back_after_exception(page: Page, server: Server) -> None:
     page.route("**/empty.html", lambda route: route.continue_())
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         try:
-            route.fulfill(response=47)
+            route.fulfill(response=47)  # type: ignore
         except Exception:
             route.fallback()
 
@@ -142,16 +147,16 @@ def handler(route: Route):
 
 
 def test_should_amend_http_headers(page: Page, server: Server) -> None:
-    values = []
+    values: List[str] = []
 
-    def handler(route: Route):
-        values.append(route.request.headers.get("foo"))
-        values.append(route.request.header_value("FOO"))
+    def handler(route: Route) -> None:
+        _append_with_return_value(values, route.request.headers.get("foo"))
+        _append_with_return_value(values, route.request.header_value("FOO"))
         route.continue_()
 
     page.route("**/sleep.zzz", handler)
 
-    def handler_with_header_mods(route: Route):
+    def handler_with_header_mods(route: Route) -> None:
         route.fallback(headers={**route.request.headers, "FOO": "bar"})
 
     page.route("**/*", handler_with_header_mods)
@@ -160,7 +165,7 @@ def handler_with_header_mods(route: Route):
     with page.expect_request("/sleep.zzz") as request_info:
         page.evaluate("() => fetch('/sleep.zzz')")
     request = request_info.value
-    values.append(request.headers.get("foo"))
+    _append_with_return_value(values, request.headers.get("foo"))
     assert values == ["bar", "bar", "bar"]
 
 
@@ -177,15 +182,15 @@ def test_should_delete_header_with_undefined_value(page: Page, server: Server) -
 
     intercepted_request = []
 
-    def capture_and_continue(route: Route, request: Request):
+    def capture_and_continue(route: Route, request: Request) -> None:
         intercepted_request.append(request)
         route.continue_()
 
     page.route("**/*", capture_and_continue)
 
-    def delete_foo_header(route: Route, request: Request):
+    def delete_foo_header(route: Route, request: Request) -> None:
         headers = request.all_headers()
-        route.fallback(headers={**headers, "foo": None})
+        route.fallback(headers={**headers, "foo": None})  # type: ignore
 
     page.route(server.PREFIX + "/something", delete_foo_header)
     with server.expect_request("/something") as server_req_info:
@@ -213,11 +218,11 @@ def delete_foo_header(route: Route, request: Request):
 
 def test_should_amend_method(page: Page, server: Server) -> None:
     page.goto(server.EMPTY_PAGE)
-    method = []
+    method: List[str] = []
     page.route(
         "**/*",
         lambda route: (
-            method.append(route.request.method),
+            _append_with_return_value(method, route.request.method),
             route.continue_(),
         ),
     )
@@ -231,11 +236,11 @@ def test_should_amend_method(page: Page, server: Server) -> None:
 
 
 def test_should_override_request_url(page: Page, server: Server) -> None:
-    url = []
+    url: List[str] = []
     page.route(
         "**/global-var.html",
         lambda route: (
-            url.append(route.request.url),
+            _append_with_return_value(url, route.request.url),
             route.continue_(),
         ),
     )
@@ -259,11 +264,11 @@ def test_should_override_request_url(page: Page, server: Server) -> None:
 
 def test_should_amend_post_data(page: Page, server: Server) -> None:
     page.goto(server.EMPTY_PAGE)
-    post_data = []
+    post_data: List[str] = []
     page.route(
         "**/*",
         lambda route: (
-            post_data.append(route.request.post_data),
+            _append_with_return_value(post_data, route.request.post_data),
             route.continue_(),
         ),
     )
@@ -278,11 +283,11 @@ def test_should_amend_post_data(page: Page, server: Server) -> None:
 
 def test_should_amend_binary_post_data(page: Page, server: Server) -> None:
     page.goto(server.EMPTY_PAGE)
-    post_data_buffer = []
+    post_data_buffer: List[str] = []
     page.route(
         "**/*",
         lambda route: (
-            post_data_buffer.append(route.request.post_data),
+            _append_with_return_value(post_data_buffer, route.request.post_data),
             route.continue_(),
         ),
     )
@@ -298,22 +303,25 @@ def test_should_amend_binary_post_data(page: Page, server: Server) -> None:
 
 
 def test_should_chain_fallback_with_dynamic_url(server: Server, page: Page) -> None:
-    intercepted = []
+    intercepted: List[int] = []
     page.route(
         "**/bar",
-        lambda route: (intercepted.append(1), route.fallback(url=server.EMPTY_PAGE)),
+        lambda route: (
+            _append_with_return_value(intercepted, 1),
+            route.fallback(url=server.EMPTY_PAGE),
+        ),
     )
     page.route(
         "**/foo",
         lambda route: (
-            intercepted.append(2),
+            _append_with_return_value(intercepted, 2),
             route.fallback(url="http://localhost/bar"),
         ),
     )
     page.route(
         "**/empty.html",
         lambda route: (
-            intercepted.append(3),
+            _append_with_return_value(intercepted, 3),
             route.fallback(url="http://localhost/foo"),
         ),
     )

From 92a331679b2b917947f1ed1f8bcd43c09244c3a5 Mon Sep 17 00:00:00 2001
From: Pavel Feldman <pavel.feldman@gmail.com>
Date: Thu, 15 Dec 2022 21:14:07 -0800
Subject: [PATCH 026/438] chore: roll to ToT (#1684)

---
 README.md                                  |   4 +-
 playwright/_impl/_element_handle.py        |   2 +-
 playwright/_impl/_fetch.py                 |  33 +-
 playwright/_impl/_frame.py                 |   2 +-
 playwright/_impl/_helper.py                |   7 -
 playwright/_impl/_locator.py               |  18 +-
 playwright/_impl/_network.py               | 119 ++++--
 playwright/_impl/_page.py                  |   2 +-
 playwright/async_api/_generated.py         | 432 ++++++++++++--------
 playwright/sync_api/_generated.py          | 434 +++++++++++++--------
 setup.py                                   |   2 +-
 tests/async/test_locators.py               |   8 +
 tests/async/test_page.py                   | 177 ---------
 tests/async/test_page_request_fallback.py  |  23 ++
 tests/async/test_page_request_intercept.py |  42 ++
 tests/async/test_page_select_option.py     | 220 +++++++++++
 tests/sync/test_locators.py                |   8 +
 tests/sync/test_page_request_fallback.py   |  20 +
 tests/sync/test_page_request_intercept.py  |  28 ++
 tests/sync/test_page_select_option.py      | 214 ++++++++++
 20 files changed, 1245 insertions(+), 550 deletions(-)
 create mode 100644 tests/async/test_page_request_intercept.py
 create mode 100644 tests/async/test_page_select_option.py
 create mode 100644 tests/sync/test_page_request_intercept.py
 create mode 100644 tests/sync/test_page_select_option.py

diff --git a/README.md b/README.md
index 04c25a7b1..bcf88ee0a 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 -->108.0.5359.48<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->109.0.5414.46<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->106.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->107.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 0cf33a160..efb5925ae 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -392,7 +392,7 @@ def convert_select_option_values(
     if value:
         if not isinstance(value, list):
             value = [value]
-        options = (options or []) + list(map(lambda e: dict(value=e), value))
+        options = (options or []) + list(map(lambda e: dict(valueOrLabel=e), value))
     if index:
         if not isinstance(index, list):
             index = [index]
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index c4428a37e..1d351c124 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -273,6 +273,7 @@ async def fetch(
         ignoreHTTPSErrors: bool = None,
         maxRedirects: int = None,
     ) -> "APIResponse":
+        url = urlOrRequest if isinstance(urlOrRequest, str) else None
         request = (
             cast(network.Request, to_impl(urlOrRequest))
             if isinstance(to_impl(urlOrRequest), network.Request)
@@ -281,13 +282,43 @@ async def fetch(
         assert request or isinstance(
             urlOrRequest, str
         ), "First argument must be either URL string or Request"
+        return await self._inner_fetch(
+            request,
+            url,
+            method,
+            headers,
+            data,
+            params,
+            form,
+            multipart,
+            timeout,
+            failOnStatusCode,
+            ignoreHTTPSErrors,
+            maxRedirects,
+        )
+
+    async def _inner_fetch(
+        self,
+        request: Optional[network.Request],
+        url: Optional[str],
+        method: str = None,
+        headers: Headers = None,
+        data: DataType = None,
+        params: ParamsType = None,
+        form: FormType = None,
+        multipart: Dict[str, Union[bytes, bool, float, str, FilePayload]] = None,
+        timeout: float = None,
+        failOnStatusCode: bool = None,
+        ignoreHTTPSErrors: bool = None,
+        maxRedirects: int = None,
+    ) -> "APIResponse":
         assert (
             (1 if data else 0) + (1 if form else 0) + (1 if multipart else 0)
         ) <= 1, "Only one of 'data', 'form' or 'multipart' can be specified"
         assert (
             maxRedirects is None or maxRedirects >= 0
         ), "'max_redirects' must be greater than or equal to '0'"
-        url = request.url if request else urlOrRequest
+        url = url or (request.url if request else url)
         method = method or (request.method if request else "GET")
         # Cannot call allHeaders() here as the request may be paused inside route handler.
         headers_obj = headers or (request.headers if request else None)
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index ca7f4cccb..573a56a72 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -578,7 +578,7 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, testId: str) -> "Locator":
+    def get_by_test_id(self, testId: Union[str, Pattern[str]]) -> "Locator":
         return self.locator(get_by_test_id_selector(test_id_attribute_name(), testId))
 
     def get_by_text(
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 43b465c2d..a9857591c 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -79,13 +79,6 @@ class ErrorPayload(TypedDict, total=False):
     value: Optional[Any]
 
 
-class FallbackOverrideParameters(TypedDict, total=False):
-    url: Optional[str]
-    method: Optional[str]
-    headers: Optional[Dict[str, str]]
-    postData: Optional[Union[str, bytes]]
-
-
 class HarRecordingMetadata(TypedDict, total=False):
     path: str
     content: Optional[HarContentPolicy]
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 1597a66f3..5d59d5561 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -261,7 +261,7 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, testId: str) -> "Locator":
+    def get_by_test_id(self, testId: Union[str, Pattern[str]]) -> "Locator":
         return self.locator(get_by_test_id_selector(test_id_attribute_name(), testId))
 
     def get_by_text(
@@ -328,6 +328,14 @@ async def blur(self, timeout: float = None) -> None:
             },
         )
 
+    async def all(
+        self,
+    ) -> List["Locator"]:
+        result = []
+        for index in range(await self.count()):
+            result.append(self.nth(index))
+        return result
+
     async def count(
         self,
     ) -> int:
@@ -709,7 +717,7 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, testId: str) -> "Locator":
+    def get_by_test_id(self, testId: Union[str, Pattern[str]]) -> "Locator":
         return self.locator(get_by_test_id_selector(test_id_attribute_name(), testId))
 
     def get_by_text(
@@ -755,7 +763,11 @@ def set_test_id_attribute_name(attribute_name: str) -> None:
     _test_id_attribute_name = attribute_name
 
 
-def get_by_test_id_selector(test_id_attribute_name: str, test_id: str) -> str:
+def get_by_test_id_selector(
+    test_id_attribute_name: str, test_id: Union[str, Pattern[str]]
+) -> str:
+    if isinstance(test_id, Pattern):
+        return f"internal:testid=[{test_id_attribute_name}=/{test_id.pattern}/{escape_regex_flags(test_id)}]"
     return f"internal:testid=[{test_id_attribute_name}={escape_for_attribute_selector(test_id, True)}]"
 
 
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 46fadf62c..132c67a49 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -17,6 +17,7 @@
 import inspect
 import json
 import mimetypes
+import sys
 from collections import defaultdict
 from pathlib import Path
 from types import SimpleNamespace
@@ -31,6 +32,11 @@
     Union,
     cast,
 )
+
+if sys.version_info >= (3, 8):  # pragma: no cover
+    from typing import TypedDict
+else:  # pragma: no cover
+    from typing_extensions import TypedDict
 from urllib import parse
 
 from playwright._impl._api_structures import (
@@ -48,7 +54,7 @@
     from_nullable_channel,
 )
 from playwright._impl._event_context_manager import EventContextManagerImpl
-from playwright._impl._helper import FallbackOverrideParameters, locals_to_params
+from playwright._impl._helper import locals_to_params
 from playwright._impl._wait_helper import WaitHelper
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -57,6 +63,21 @@
     from playwright._impl._page import Page
 
 
+class FallbackOverrideParameters(TypedDict, total=False):
+    url: Optional[str]
+    method: Optional[str]
+    headers: Optional[Dict[str, str]]
+    postData: Optional[Union[str, bytes]]
+
+
+class SerializedFallbackOverrides:
+    def __init__(self) -> None:
+        self.url: Optional[str] = None
+        self.method: Optional[str] = None
+        self.headers: Optional[Dict[str, str]] = None
+        self.post_data_buffer: Optional[bytes] = None
+
+
 def serialize_headers(headers: Dict[str, str]) -> HeadersArray:
     return [
         {"name": name, "value": value}
@@ -90,21 +111,39 @@ def __init__(
         }
         self._provisional_headers = RawHeaders(self._initializer["headers"])
         self._all_headers_future: Optional[asyncio.Future[RawHeaders]] = None
-        self._fallback_overrides: FallbackOverrideParameters = (
-            FallbackOverrideParameters()
+        self._fallback_overrides: SerializedFallbackOverrides = (
+            SerializedFallbackOverrides()
         )
+        base64_post_data = initializer.get("postData")
+        if base64_post_data is not None:
+            self._fallback_overrides.post_data_buffer = base64.b64decode(
+                base64_post_data
+            )
 
     def __repr__(self) -> str:
         return f"<Request url={self.url!r} method={self.method!r}>"
 
     def _apply_fallback_overrides(self, overrides: FallbackOverrideParameters) -> None:
-        self._fallback_overrides = cast(
-            FallbackOverrideParameters, {**self._fallback_overrides, **overrides}
+        self._fallback_overrides.url = overrides.get(
+            "url", self._fallback_overrides.url
         )
+        self._fallback_overrides.method = overrides.get(
+            "method", self._fallback_overrides.method
+        )
+        self._fallback_overrides.headers = overrides.get(
+            "headers", self._fallback_overrides.headers
+        )
+        post_data = overrides.get("postData")
+        if isinstance(post_data, str):
+            self._fallback_overrides.post_data_buffer = post_data.encode()
+        elif isinstance(post_data, bytes):
+            self._fallback_overrides.post_data_buffer = post_data
+        elif post_data is not None:
+            self._fallback_overrides.post_data_buffer = json.dumps(post_data).encode()
 
     @property
     def url(self) -> str:
-        return cast(str, self._fallback_overrides.get("url", self._initializer["url"]))
+        return cast(str, self._fallback_overrides.url or self._initializer["url"])
 
     @property
     def resource_type(self) -> str:
@@ -112,9 +151,7 @@ def resource_type(self) -> str:
 
     @property
     def method(self) -> str:
-        return cast(
-            str, self._fallback_overrides.get("method", self._initializer["method"])
-        )
+        return cast(str, self._fallback_overrides.method or self._initializer["method"])
 
     async def sizes(self) -> RequestSizes:
         response = await self.response()
@@ -124,7 +161,7 @@ async def sizes(self) -> RequestSizes:
 
     @property
     def post_data(self) -> Optional[str]:
-        data = self._fallback_overrides.get("postData", self.post_data_buffer)
+        data = self._fallback_overrides.post_data_buffer
         if not data:
             return None
         return data.decode() if isinstance(data, bytes) else data
@@ -144,17 +181,7 @@ def post_data_json(self) -> Optional[Any]:
 
     @property
     def post_data_buffer(self) -> Optional[bytes]:
-        override = self._fallback_overrides.get("post_data")
-        if override:
-            return (
-                override.encode()
-                if isinstance(override, str)
-                else cast(bytes, override)
-            )
-        b64_content = self._initializer.get("postData")
-        if b64_content is None:
-            return None
-        return base64.b64decode(b64_content)
+        return self._fallback_overrides.post_data_buffer
 
     async def response(self) -> Optional["Response"]:
         return from_nullable_channel(await self._channel.send("response"))
@@ -189,7 +216,7 @@ def _set_response_end_timing(self, response_end_timing: float) -> None:
 
     @property
     def headers(self) -> Headers:
-        override = self._fallback_overrides.get("headers")
+        override = self._fallback_overrides.headers
         if override:
             return RawHeaders._from_headers_dict_lossy(override).headers()
         return self._provisional_headers.headers()
@@ -204,7 +231,7 @@ async def header_value(self, name: str) -> Optional[str]:
         return (await self._actual_headers()).get(name)
 
     async def _actual_headers(self) -> "RawHeaders":
-        override = self._fallback_overrides.get("headers")
+        override = self._fallback_overrides.headers
         if override:
             return RawHeaders(serialize_headers(override))
         if not self._all_headers_future:
@@ -254,6 +281,7 @@ async def fulfill(
         status: int = None,
         headers: Dict[str, str] = None,
         body: Union[str, bytes] = None,
+        json: Any = None,
         path: Union[str, Path] = None,
         contentType: str = None,
         response: "APIResponse" = None,
@@ -270,6 +298,8 @@ async def fulfill(
             )
             from playwright._impl._fetch import APIResponse
 
+            if json is not None:
+                body = json.dumps(json)
             if body is None and path is None and isinstance(response, APIResponse):
                 if response._request._connection is self._connection:
                     params["fetchResponseUid"] = response._fetch_uid
@@ -295,6 +325,8 @@ async def fulfill(
         headers = {k.lower(): str(v) for k, v in params.get("headers", {}).items()}
         if params.get("contentType"):
             headers["content-type"] = params["contentType"]
+        elif json:
+            headers["content-type"] = "application/json"
         elif path:
             headers["content-type"] = (
                 mimetypes.guess_type(str(Path(path)))[0] or "application/octet-stream"
@@ -305,12 +337,24 @@ async def fulfill(
         await self._race_with_page_close(self._channel.send("fulfill", params))
         self._report_handled(True)
 
+    async def fetch(
+        self,
+        url: str = None,
+        method: str = None,
+        headers: Dict[str, str] = None,
+        postData: Union[Any, str, bytes] = None,
+    ) -> "APIResponse":
+        page = self.request.frame._page
+        return await page.context.request._inner_fetch(
+            self.request, url, method, headers, postData
+        )
+
     async def fallback(
         self,
         url: str = None,
         method: str = None,
         headers: Dict[str, str] = None,
-        postData: Union[str, bytes] = None,
+        postData: Union[Any, str, bytes] = None,
     ) -> None:
         overrides = cast(FallbackOverrideParameters, locals_to_params(locals()))
         self._check_not_handled()
@@ -322,7 +366,7 @@ async def continue_(
         url: str = None,
         method: str = None,
         headers: Dict[str, str] = None,
-        postData: Union[str, bytes] = None,
+        postData: Union[Any, str, bytes] = None,
     ) -> None:
         overrides = cast(FallbackOverrideParameters, locals_to_params(locals()))
         self._check_not_handled()
@@ -335,23 +379,18 @@ def _internal_continue(
     ) -> Coroutine[Any, Any, None]:
         async def continue_route() -> None:
             try:
-                post_data_for_wire: Optional[str] = None
-                post_data_from_overrides = self.request._fallback_overrides.get(
-                    "postData"
-                )
-                if post_data_from_overrides is not None:
-                    post_data_for_wire = (
-                        base64.b64encode(post_data_from_overrides.encode()).decode()
-                        if isinstance(post_data_from_overrides, str)
-                        else base64.b64encode(post_data_from_overrides).decode()
-                    )
-                params = locals_to_params(
-                    cast(Dict[str, str], self.request._fallback_overrides)
-                )
+                params: Dict[str, Any] = {}
+                params["url"] = self.request._fallback_overrides.url
+                params["method"] = self.request._fallback_overrides.method
+                params["headers"] = self.request._fallback_overrides.headers
+                if self.request._fallback_overrides.post_data_buffer is not None:
+                    params["postData"] = base64.b64encode(
+                        self.request._fallback_overrides.post_data_buffer
+                    ).decode()
+                params = locals_to_params(params)
+
                 if "headers" in params:
                     params["headers"] = serialize_headers(params["headers"])
-                if post_data_for_wire is not None:
-                    params["postData"] = post_data_for_wire
                 await self._connection.wrap_api_call(
                     lambda: self._race_with_page_close(
                         self._channel.send(
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index f2e05acdf..da524d4b8 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -788,7 +788,7 @@ def get_by_role(
             exact=exact,
         )
 
-    def get_by_test_id(self, testId: str) -> "Locator":
+    def get_by_test_id(self, testId: Union[str, Pattern[str]]) -> "Locator":
         return self._main_frame.get_by_test_id(testId)
 
     def get_by_text(
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 499701797..24efc0ceb 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -668,6 +668,7 @@ async def fulfill(
         status: typing.Optional[int] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
         body: typing.Optional[typing.Union[str, bytes]] = None,
+        json: typing.Optional[typing.Any] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         content_type: typing.Optional[str] = None,
         response: typing.Optional["APIResponse"] = None
@@ -712,6 +713,8 @@ async def fulfill(
             Response headers. Header values will be converted to a string.
         body : Union[bytes, str, None]
             Response body.
+        json : Union[Any, None]
+            JSON response. This method will set the content type to `application/json` if not set.
         path : Union[pathlib.Path, str, None]
             File path to respond with. The content type will be inferred from file extension. If `path` is a relative path,
             then it is resolved relative to the current working directory.
@@ -727,19 +730,82 @@ async def fulfill(
                 status=status,
                 headers=mapping.to_impl(headers),
                 body=body,
+                json=mapping.to_impl(json),
                 path=path,
                 contentType=content_type,
                 response=response._impl_obj if response else None,
             )
         )
 
+    async def fetch(
+        self,
+        *,
+        url: typing.Optional[str] = None,
+        method: typing.Optional[str] = None,
+        headers: typing.Optional[typing.Dict[str, str]] = None,
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
+    ) -> "APIResponse":
+        """Route.fetch
+
+        Performs the request and fetches result without fulfilling it, so that the response could be modified and then
+        fulfilled.
+
+        **Usage**
+
+        ```py
+        async def handle(route):
+            response = await route.fulfill()
+            json = await response.json()
+            json[\"message\"][\"big_red_dog\"] = []
+            await route.fulfill(response=response, json=json)
+
+        await page.route(\"https://dog.ceo/api/breeds/list/all\", handle)
+        ```
+
+        ```py
+        def handle(route):
+            response = route.fulfill()
+            json = response.json()
+            json[\"message\"][\"big_red_dog\"] = []
+            route.fulfill(response=response, json=json)
+
+        page.route(\"https://dog.ceo/api/breeds/list/all\", handle)
+        ```
+
+        Parameters
+        ----------
+        url : Union[str, None]
+            If set changes the request URL. New URL must have same protocol as original one.
+        method : Union[str, None]
+            If set changes the request method (e.g. GET or POST).
+        headers : Union[Dict[str, str], None]
+            If set changes the request HTTP headers. Header values will be converted to a string.
+        post_data : Union[Any, bytes, str, None]
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
+
+        Returns
+        -------
+        APIResponse
+        """
+
+        return mapping.from_impl(
+            await self._impl_obj.fetch(
+                url=url,
+                method=method,
+                headers=mapping.to_impl(headers),
+                postData=mapping.to_impl(post_data),
+            )
+        )
+
     async def fallback(
         self,
         *,
         url: typing.Optional[str] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        post_data: typing.Optional[typing.Union[str, bytes]] = None
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
     ) -> None:
         """Route.fallback
 
@@ -819,7 +885,7 @@ async def handle(route, request):
                 \"bar\": None # remove \"bar\" header
             }
             await route.fallback(headers=headers)
-        }
+
         await page.route(\"**/*\", handle)
         ```
 
@@ -832,7 +898,7 @@ def handle(route, request):
                 \"bar\": None # remove \"bar\" header
             }
             route.fallback(headers=headers)
-        }
+
         page.route(\"**/*\", handle)
         ```
 
@@ -842,11 +908,11 @@ def handle(route, request):
             If set changes the request URL. New URL must have same protocol as original one. Changing the URL won't affect the
             route matching, all the routes are matched using the original request URL.
         method : Union[str, None]
-            If set changes the request method (e.g. GET or POST)
+            If set changes the request method (e.g. GET or POST).
         headers : Union[Dict[str, str], None]
             If set changes the request HTTP headers. Header values will be converted to a string.
-        post_data : Union[bytes, str, None]
-            If set changes the post data of request
+        post_data : Union[Any, bytes, str, None]
+            If set changes the post data of request.
         """
 
         return mapping.from_maybe_impl(
@@ -854,7 +920,7 @@ def handle(route, request):
                 url=url,
                 method=method,
                 headers=mapping.to_impl(headers),
-                postData=post_data,
+                postData=mapping.to_impl(post_data),
             )
         )
 
@@ -864,7 +930,7 @@ async def continue_(
         url: typing.Optional[str] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        post_data: typing.Optional[typing.Union[str, bytes]] = None
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
     ) -> None:
         """Route.continue_
 
@@ -881,7 +947,7 @@ async def handle(route, request):
                 \"bar\": None # remove \"bar\" header
             }
             await route.continue_(headers=headers)
-        }
+
         await page.route(\"**/*\", handle)
         ```
 
@@ -894,7 +960,7 @@ def handle(route, request):
                 \"bar\": None # remove \"bar\" header
             }
             route.continue_(headers=headers)
-        }
+
         page.route(\"**/*\", handle)
         ```
 
@@ -903,11 +969,11 @@ def handle(route, request):
         url : Union[str, None]
             If set changes the request URL. New URL must have same protocol as original one.
         method : Union[str, None]
-            If set changes the request method (e.g. GET or POST)
+            If set changes the request method (e.g. GET or POST).
         headers : Union[Dict[str, str], None]
             If set changes the request HTTP headers. Header values will be converted to a string.
-        post_data : Union[bytes, str, None]
-            If set changes the post data of request
+        post_data : Union[Any, bytes, str, None]
+            If set changes the post data of request.
         """
 
         return mapping.from_maybe_impl(
@@ -915,7 +981,7 @@ def handle(route, request):
                 url=url,
                 method=method,
                 headers=mapping.to_impl(headers),
-                postData=post_data,
+                postData=mapping.to_impl(post_data),
             )
         )
 
@@ -2747,13 +2813,13 @@ async def screenshot(
     async def query_selector(self, selector: str) -> typing.Optional["ElementHandle"]:
         """ElementHandle.query_selector
 
-        The method finds an element matching the specified selector in the `ElementHandle`'s subtree. See
-        [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns `null`.
+        The method finds an element matching the specified selector in the `ElementHandle`'s subtree. If no elements match
+        the selector, returns `null`.
 
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
 
         Returns
         -------
@@ -2767,13 +2833,13 @@ async def query_selector(self, selector: str) -> typing.Optional["ElementHandle"
     async def query_selector_all(self, selector: str) -> typing.List["ElementHandle"]:
         """ElementHandle.query_selector_all
 
-        The method finds all elements matching the specified selector in the `ElementHandle`s subtree. See
-        [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns empty array.
+        The method finds all elements matching the specified selector in the `ElementHandle`s subtree. If no elements match
+        the selector, returns empty array.
 
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
 
         Returns
         -------
@@ -2792,8 +2858,7 @@ async def eval_on_selector(
         Returns the return value of `expression`.
 
         The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a
-        first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements
-        match the selector, the method throws an error.
+        first argument to `expression`. If no elements match the selector, the method throws an error.
 
         If `expression` returns a [Promise], then `element_handle.eval_on_selector()` would wait for the promise to
         resolve and return its value.
@@ -2815,7 +2880,7 @@ async def eval_on_selector(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -2841,8 +2906,7 @@ async def eval_on_selector_all(
         Returns the return value of `expression`.
 
         The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array
-        of matched elements as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more
-        details.
+        of matched elements as a first argument to `expression`.
 
         If `expression` returns a [Promise], then `element_handle.eval_on_selector_all()` would wait for the promise to
         resolve and return its value.
@@ -2869,7 +2933,7 @@ async def eval_on_selector_all(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -2967,7 +3031,7 @@ async def wait_for_selector(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
@@ -3639,13 +3703,13 @@ async def query_selector(
 
         **NOTE** The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
 
-        The method finds an element matching the specified selector within the frame. See
-        [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns `null`.
+        The method finds an element matching the specified selector within the frame. If no elements match the selector,
+        returns `null`.
 
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3666,13 +3730,13 @@ async def query_selector_all(self, selector: str) -> typing.List["ElementHandle"
 
         **NOTE** The use of `ElementHandle` is discouraged, use `Locator` objects instead.
 
-        The method finds all elements matching the specified selector within the frame. See
-        [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns empty array.
+        The method finds all elements matching the specified selector within the frame. If no elements match the selector,
+        returns empty array.
 
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
 
         Returns
         -------
@@ -3749,7 +3813,7 @@ def run(playwright):
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3791,7 +3855,7 @@ async def is_checked(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3825,7 +3889,7 @@ async def is_disabled(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3859,7 +3923,7 @@ async def is_editable(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3893,7 +3957,7 @@ async def is_enabled(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3928,7 +3992,7 @@ async def is_hidden(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3961,7 +4025,7 @@ async def is_visible(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4033,7 +4097,7 @@ async def dispatch_event(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         type : str
             DOM event type: `"click"`, `"dragstart"`, etc.
         event_init : Union[Dict, None]
@@ -4069,8 +4133,7 @@ async def eval_on_selector(
         Returns the return value of `expression`.
 
         The method finds an element matching the specified selector within the frame and passes it as a first argument to
-        `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector,
-        the method throws an error.
+        `expression`. If no elements match the selector, the method throws an error.
 
         If `expression` returns a [Promise], then `frame.eval_on_selector()` would wait for the promise to resolve
         and return its value.
@@ -4092,7 +4155,7 @@ async def eval_on_selector(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -4124,7 +4187,7 @@ async def eval_on_selector_all(
         Returns the return value of `expression`.
 
         The method finds all elements matching the specified selector within the frame and passes an array of matched
-        elements as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details.
+        elements as a first argument to `expression`.
 
         If `expression` returns a [Promise], then `frame.eval_on_selector_all()` would wait for the promise to resolve
         and return its value.
@@ -4142,7 +4205,7 @@ async def eval_on_selector_all(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -4325,7 +4388,7 @@ async def click(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -4407,7 +4470,7 @@ async def dblclick(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -4483,7 +4546,7 @@ async def tap(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -4547,7 +4610,7 @@ async def fill(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
@@ -4595,7 +4658,7 @@ def locator(
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -4883,7 +4946,9 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, test_id: str) -> "Locator":
+    def get_by_test_id(
+        self, test_id: typing.Union[str, typing.Pattern[str]]
+    ) -> "Locator":
         """Frame.get_by_test_id
 
         Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
@@ -4891,7 +4956,7 @@ def get_by_test_id(self, test_id: str) -> "Locator":
 
         Parameters
         ----------
-        test_id : str
+        test_id : Union[Pattern[str], str]
             Id to locate the element by.
 
         Returns
@@ -5030,7 +5095,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
 
         Returns
         -------
@@ -5055,7 +5120,7 @@ async def focus(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5085,7 +5150,7 @@ async def text_content(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5119,7 +5184,7 @@ async def inner_text(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5153,7 +5218,7 @@ async def inner_html(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5188,7 +5253,7 @@ async def get_attribute(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         name : str
             Attribute name to get the value for.
         strict : Union[bool, None]
@@ -5240,7 +5305,7 @@ async def hover(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -5296,10 +5361,10 @@ async def drag_and_drop(
         ----------
         source : str
             A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will
-            be used. See [working with selectors](../selectors.md) for more details.
+            be used.
         target : str
             A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first
-            will be used. See [working with selectors](../selectors.md) for more details.
+            will be used.
         source_position : Union[{x: float, y: float}, None]
             Clicks on the source 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.
@@ -5389,7 +5454,7 @@ async def select_option(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         value : Union[List[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
@@ -5451,7 +5516,7 @@ async def input_value(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5499,7 +5564,7 @@ async def set_input_files(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
@@ -5556,7 +5621,7 @@ async def type(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         text : str
             A text to type into a focused element.
         delay : Union[float, None]
@@ -5619,7 +5684,7 @@ async def press(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         key : str
             Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
         delay : Union[float, None]
@@ -5678,7 +5743,7 @@ async def check(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -5742,7 +5807,7 @@ async def uncheck(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -5927,7 +5992,7 @@ async def set_checked(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
@@ -6009,7 +6074,7 @@ def locator(
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -6297,7 +6362,9 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, test_id: str) -> "Locator":
+    def get_by_test_id(
+        self, test_id: typing.Union[str, typing.Pattern[str]]
+    ) -> "Locator":
         """FrameLocator.get_by_test_id
 
         Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
@@ -6305,7 +6372,7 @@ def get_by_test_id(self, test_id: str) -> "Locator":
 
         Parameters
         ----------
-        test_id : str
+        test_id : Union[Pattern[str], str]
             Id to locate the element by.
 
         Returns
@@ -6429,7 +6496,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
 
         Returns
         -------
@@ -7157,14 +7224,14 @@ def on(
 
         ```py
         async with page.expect_event(\"popup\") as page_info:
-            page.evaluate(\"window.open('https://example.com')\")
+            await page.get_by_text(\"open the popup\").click()
         popup = await page_info.value
         print(await popup.evaluate(\"location.href\"))
         ```
 
         ```py
         with page.expect_event(\"popup\") as page_info:
-            page.evaluate(\"window.open('https://example.com')\")
+            page.get_by_text(\"open the popup\").click()
         popup = page_info.value
         print(popup.evaluate(\"location.href\"))
         ```
@@ -7454,14 +7521,14 @@ def once(
 
         ```py
         async with page.expect_event(\"popup\") as page_info:
-            page.evaluate(\"window.open('https://example.com')\")
+            await page.get_by_text(\"open the popup\").click()
         popup = await page_info.value
         print(await popup.evaluate(\"location.href\"))
         ```
 
         ```py
         with page.expect_event(\"popup\") as page_info:
-            page.evaluate(\"window.open('https://example.com')\")
+            page.get_by_text(\"open the popup\").click()
         popup = page_info.value
         print(popup.evaluate(\"location.href\"))
         ```
@@ -7783,7 +7850,7 @@ async def query_selector(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -7806,7 +7873,7 @@ async def query_selector_all(self, selector: str) -> typing.List["ElementHandle"
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
 
         Returns
         -------
@@ -7883,7 +7950,7 @@ def run(playwright):
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 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.
@@ -7925,7 +7992,7 @@ async def is_checked(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -7959,7 +8026,7 @@ async def is_disabled(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -7993,7 +8060,7 @@ async def is_editable(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8027,7 +8094,7 @@ async def is_enabled(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8062,7 +8129,7 @@ async def is_hidden(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8095,7 +8162,7 @@ async def is_visible(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8167,7 +8234,7 @@ async def dispatch_event(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         type : str
             DOM event type: `"click"`, `"dragstart"`, etc.
         event_init : Union[Dict, None]
@@ -8368,7 +8435,7 @@ async def eval_on_selector(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -8416,7 +8483,7 @@ async def eval_on_selector_all(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -8919,7 +8986,7 @@ async def wait_for_load_state(
         async with page.expect_popup() as page_info:
             await page.get_by_role(\"button\").click() # click triggers a popup.
         popup = await page_info.value
-         # Following resolves after \"domcontentloaded\" event.
+        # Wait for the \"DOMContentLoaded\" event.
         await popup.wait_for_load_state(\"domcontentloaded\")
         print(await popup.title()) # popup is ready to use.
         ```
@@ -8928,7 +8995,7 @@ async def wait_for_load_state(
         with page.expect_popup() as page_info:
             page.get_by_role(\"button\").click() # click triggers a popup.
         popup = page_info.value
-         # Following resolves after \"domcontentloaded\" event.
+        # Wait for the \"DOMContentLoaded\" event.
         popup.wait_for_load_state(\"domcontentloaded\")
         print(popup.title()) # popup is ready to use.
         ```
@@ -9643,7 +9710,7 @@ async def click(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -9725,7 +9792,7 @@ async def dblclick(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -9801,7 +9868,7 @@ async def tap(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -9865,7 +9932,7 @@ async def fill(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
@@ -9911,7 +9978,7 @@ def locator(
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -10199,7 +10266,9 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, test_id: str) -> "Locator":
+    def get_by_test_id(
+        self, test_id: typing.Union[str, typing.Pattern[str]]
+    ) -> "Locator":
         """Page.get_by_test_id
 
         Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
@@ -10207,7 +10276,7 @@ def get_by_test_id(self, test_id: str) -> "Locator":
 
         Parameters
         ----------
-        test_id : str
+        test_id : Union[Pattern[str], str]
             Id to locate the element by.
 
         Returns
@@ -10346,7 +10415,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
 
         Returns
         -------
@@ -10371,7 +10440,7 @@ async def focus(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10401,7 +10470,7 @@ async def text_content(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10435,7 +10504,7 @@ async def inner_text(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10469,7 +10538,7 @@ async def inner_html(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10504,7 +10573,7 @@ async def get_attribute(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         name : str
             Attribute name to get the value for.
         strict : Union[bool, None]
@@ -10556,7 +10625,7 @@ async def hover(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -10639,10 +10708,10 @@ async def drag_and_drop(
         ----------
         source : str
             A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will
-            be used. See [working with selectors](../selectors.md) for more details.
+            be used.
         target : str
             A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first
-            will be used. See [working with selectors](../selectors.md) for more details.
+            will be used.
         source_position : Union[{x: float, y: float}, None]
             Clicks on the source 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.
@@ -10733,7 +10802,7 @@ async def select_option(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         value : Union[List[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
@@ -10795,7 +10864,7 @@ async def input_value(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10843,7 +10912,7 @@ async def set_input_files(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed
@@ -10900,7 +10969,7 @@ async def type(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         text : str
             A text to type into a focused element.
         delay : Union[float, None]
@@ -10991,7 +11060,7 @@ async def press(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         key : str
             Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
         delay : Union[float, None]
@@ -11050,7 +11119,7 @@ async def check(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -11114,7 +11183,7 @@ async def uncheck(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -11581,13 +11650,15 @@ def expect_navigation(
 
         ```py
         async with page.expect_navigation():
-            await page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+            # This action triggers the navigation after a timeout.
+            await page.get_by_text(\"Navigate after timeout\").click()
         # Resolves after navigation has finished
         ```
 
         ```py
         with page.expect_navigation():
-            page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+            # This action triggers the navigation after a timeout.
+            page.get_by_text(\"Navigate after timeout\").click()
         # Resolves after navigation has finished
         ```
 
@@ -11673,23 +11744,23 @@ def expect_request(
 
         ```py
         async with page.expect_request(\"http://example.com/resource\") as first:
-            await page.click('button')
+            await page.get_by_text(\"trigger request\").click()
         first_request = await first.value
 
         # or with a lambda
         async with page.expect_request(lambda request: request.url == \"http://example.com\" and request.method == \"get\") as second:
-            await page.click('img')
+            await page.get_by_text(\"trigger request\").click()
         second_request = await second.value
         ```
 
         ```py
         with page.expect_request(\"http://example.com/resource\") as first:
-            page.click('button')
+            page.get_by_text(\"trigger request\").click()
         first_request = first.value
 
         # or with a lambda
         with page.expect_request(lambda request: request.url == \"http://example.com\" and request.method == \"get\") as second:
-            page.click('img')
+            page.get_by_text(\"trigger request\").click()
         second_request = second.value
         ```
 
@@ -11762,26 +11833,26 @@ def expect_response(
 
         ```py
         async with page.expect_response(\"https://example.com/resource\") as response_info:
-            await page.click(\"input\")
+            await page.get_by_text(\"trigger response\").click()
         response = await response_info.value
         return response.ok
 
         # or with a lambda
         async with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200) as response_info:
-            await page.click(\"input\")
+            await page.get_by_text(\"trigger response\").click()
         response = await response_info.value
         return response.ok
         ```
 
         ```py
         with page.expect_response(\"https://example.com/resource\") as response_info:
-            page.click(\"input\")
+            page.get_by_text(\"trigger response\").click()
         response = response_info.value
         return response.ok
 
         # or with a lambda
         with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200) as response_info:
-            page.click(\"input\")
+            page.get_by_text(\"trigger response\").click()
         response = response_info.value
         return response.ok
         ```
@@ -11901,7 +11972,7 @@ async def set_checked(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
@@ -11992,14 +12063,14 @@ def on(
 
         ```py
         async with context.expect_page() as page_info:
-            await page.locator(\"a[target=_blank]\").click(),
+            await page.get_by_text(\"open new page\").click(),
         page = await page_info.value
         print(await page.evaluate(\"location.href\"))
         ```
 
         ```py
         with context.expect_page() as page_info:
-            page.locator(\"a[target=_blank]\").click(),
+            page.get_by_text(\"open new page\").click(),
         page = page_info.value
         print(page.evaluate(\"location.href\"))
         ```
@@ -12123,14 +12194,14 @@ def once(
 
         ```py
         async with context.expect_page() as page_info:
-            await page.locator(\"a[target=_blank]\").click(),
+            await page.get_by_text(\"open new page\").click(),
         page = await page_info.value
         print(await page.evaluate(\"location.href\"))
         ```
 
         ```py
         with context.expect_page() as page_info:
-            page.locator(\"a[target=_blank]\").click(),
+            page.get_by_text(\"open new page\").click(),
         page = page_info.value
         print(page.evaluate(\"location.href\"))
         ```
@@ -13416,9 +13487,10 @@ async def new_context(
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
-            selectors that imply single target DOM element will throw when more than one element matches the selector. See
-            `Locator` to learn more about the strict mode.
+            If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. This
+            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
+            mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -13621,9 +13693,10 @@ async def new_page(
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
-            selectors that imply single target DOM element will throw when more than one element matches the selector. See
-            `Locator` to learn more about the strict mode.
+            If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. This
+            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
+            mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -14151,9 +14224,10 @@ async def launch_persistent_context(
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
-            selectors that imply single target DOM element will throw when more than one element matches the selector. See
-            `Locator` to learn more about the strict mode.
+            If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. This
+            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
+            mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -14382,7 +14456,7 @@ def run(playwright):
     def selectors(self) -> "Selectors":
         """Playwright.selectors
 
-        Selectors can be used to install custom selector engines. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more
+        Selectors can be used to install custom selector engines. See [extensibility](https://playwright.dev/python/docs/extensibility) for more
         information.
 
         Returns
@@ -14763,6 +14837,10 @@ async def click(
     ) -> None:
         """Locator.click
 
+        Click an element.
+
+        **Details**
+
         This method clicks the element by performing the following steps:
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
@@ -15180,7 +15258,7 @@ def locator(
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -15468,7 +15546,9 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, test_id: str) -> "Locator":
+    def get_by_test_id(
+        self, test_id: typing.Union[str, typing.Pattern[str]]
+    ) -> "Locator":
         """Locator.get_by_test_id
 
         Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
@@ -15476,7 +15556,7 @@ def get_by_test_id(self, test_id: str) -> "Locator":
 
         Parameters
         ----------
-        test_id : str
+        test_id : Union[Pattern[str], str]
             Id to locate the element by.
 
         Returns
@@ -15612,7 +15692,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
 
         Returns
         -------
@@ -15750,6 +15830,30 @@ async def blur(self, *, timeout: typing.Optional[float] = None) -> None:
 
         return mapping.from_maybe_impl(await self._impl_obj.blur(timeout=timeout))
 
+    async def all(self) -> typing.List["Locator"]:
+        """Locator.all
+
+        When locator points to a list of elements, returns array of locators, pointing to respective elements.
+
+        **Usage**
+
+        ```py
+        for li in await page.get_by_role('listitem').all():
+          await li.click();
+        ```
+
+        ```py
+        for li in page.get_by_role('listitem').all():
+          li.click();
+        ```
+
+        Returns
+        -------
+        List[Locator]
+        """
+
+        return mapping.from_impl_list(await self._impl_obj.all())
+
     async def count(self) -> int:
         """Locator.count
 
@@ -16258,6 +16362,10 @@ async def select_option(
     ) -> typing.List[str]:
         """Locator.select_option
 
+        Selects option or options in `<select>`.
+
+        **Details**
+
         This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in
         the `<select>` element and selects these options.
 
@@ -16272,21 +16380,29 @@ async def select_option(
 
         **Usage**
 
+        ```html
+        <select multiple>
+          <option value=\"red\">Red</div>
+          <option value=\"green\">Green</div>
+          <option value=\"blue\">Blue</div>
+        </select>
+        ```
+
         ```py
-        # single selection matching the value
+        # single selection matching the value or label
         await element.select_option(\"blue\")
         # single selection matching the label
         await element.select_option(label=\"blue\")
-        # multiple selection
+        # multiple selection for blue, red and second option
         await element.select_option(value=[\"red\", \"green\", \"blue\"])
         ```
 
         ```py
-        # single selection matching the value
+        # single selection matching the value or label
         element.select_option(\"blue\")
-        # single selection matching both the label
+        # single selection matching the label
         element.select_option(label=\"blue\")
-        # multiple selection
+        # multiple selection for blue, red and second option
         element.select_option(value=[\"red\", \"green\", \"blue\"])
         ```
 
@@ -16879,7 +16995,7 @@ async def delete(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -16956,7 +17072,7 @@ async def head(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17033,7 +17149,7 @@ async def get(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17122,7 +17238,7 @@ async def patch(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17199,7 +17315,7 @@ async def put(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17276,7 +17392,7 @@ async def post(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17393,7 +17509,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, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -18554,7 +18670,7 @@ async def to_have_text(
         Parameters
         ----------
         expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
-            Expected substring or RegExp or a list of those.
+            Expected string or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
@@ -18595,7 +18711,7 @@ async def not_to_have_text(
         Parameters
         ----------
         expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
-            Expected substring or RegExp or a list of those.
+            Expected string or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index cb0955615..424730562 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -676,6 +676,7 @@ def fulfill(
         status: typing.Optional[int] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
         body: typing.Optional[typing.Union[str, bytes]] = None,
+        json: typing.Optional[typing.Any] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         content_type: typing.Optional[str] = None,
         response: typing.Optional["APIResponse"] = None
@@ -720,6 +721,8 @@ def fulfill(
             Response headers. Header values will be converted to a string.
         body : Union[bytes, str, None]
             Response body.
+        json : Union[Any, None]
+            JSON response. This method will set the content type to `application/json` if not set.
         path : Union[pathlib.Path, str, None]
             File path to respond with. The content type will be inferred from file extension. If `path` is a relative path,
             then it is resolved relative to the current working directory.
@@ -736,6 +739,7 @@ def fulfill(
                     status=status,
                     headers=mapping.to_impl(headers),
                     body=body,
+                    json=mapping.to_impl(json),
                     path=path,
                     contentType=content_type,
                     response=response._impl_obj if response else None,
@@ -743,13 +747,77 @@ def fulfill(
             )
         )
 
+    def fetch(
+        self,
+        *,
+        url: typing.Optional[str] = None,
+        method: typing.Optional[str] = None,
+        headers: typing.Optional[typing.Dict[str, str]] = None,
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
+    ) -> "APIResponse":
+        """Route.fetch
+
+        Performs the request and fetches result without fulfilling it, so that the response could be modified and then
+        fulfilled.
+
+        **Usage**
+
+        ```py
+        async def handle(route):
+            response = await route.fulfill()
+            json = await response.json()
+            json[\"message\"][\"big_red_dog\"] = []
+            await route.fulfill(response=response, json=json)
+
+        await page.route(\"https://dog.ceo/api/breeds/list/all\", handle)
+        ```
+
+        ```py
+        def handle(route):
+            response = route.fulfill()
+            json = response.json()
+            json[\"message\"][\"big_red_dog\"] = []
+            route.fulfill(response=response, json=json)
+
+        page.route(\"https://dog.ceo/api/breeds/list/all\", handle)
+        ```
+
+        Parameters
+        ----------
+        url : Union[str, None]
+            If set changes the request URL. New URL must have same protocol as original one.
+        method : Union[str, None]
+            If set changes the request method (e.g. GET or POST).
+        headers : Union[Dict[str, str], None]
+            If set changes the request HTTP headers. Header values will be converted to a string.
+        post_data : Union[Any, bytes, str, None]
+            Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
+            and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
+            header will be set to `application/octet-stream` if not explicitly set.
+
+        Returns
+        -------
+        APIResponse
+        """
+
+        return mapping.from_impl(
+            self._sync(
+                self._impl_obj.fetch(
+                    url=url,
+                    method=method,
+                    headers=mapping.to_impl(headers),
+                    postData=mapping.to_impl(post_data),
+                )
+            )
+        )
+
     def fallback(
         self,
         *,
         url: typing.Optional[str] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        post_data: typing.Optional[typing.Union[str, bytes]] = None
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
     ) -> None:
         """Route.fallback
 
@@ -829,7 +897,7 @@ async def handle(route, request):
                 \"bar\": None # remove \"bar\" header
             }
             await route.fallback(headers=headers)
-        }
+
         await page.route(\"**/*\", handle)
         ```
 
@@ -842,7 +910,7 @@ def handle(route, request):
                 \"bar\": None # remove \"bar\" header
             }
             route.fallback(headers=headers)
-        }
+
         page.route(\"**/*\", handle)
         ```
 
@@ -852,11 +920,11 @@ def handle(route, request):
             If set changes the request URL. New URL must have same protocol as original one. Changing the URL won't affect the
             route matching, all the routes are matched using the original request URL.
         method : Union[str, None]
-            If set changes the request method (e.g. GET or POST)
+            If set changes the request method (e.g. GET or POST).
         headers : Union[Dict[str, str], None]
             If set changes the request HTTP headers. Header values will be converted to a string.
-        post_data : Union[bytes, str, None]
-            If set changes the post data of request
+        post_data : Union[Any, bytes, str, None]
+            If set changes the post data of request.
         """
 
         return mapping.from_maybe_impl(
@@ -865,7 +933,7 @@ def handle(route, request):
                     url=url,
                     method=method,
                     headers=mapping.to_impl(headers),
-                    postData=post_data,
+                    postData=mapping.to_impl(post_data),
                 )
             )
         )
@@ -876,7 +944,7 @@ def continue_(
         url: typing.Optional[str] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        post_data: typing.Optional[typing.Union[str, bytes]] = None
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
     ) -> None:
         """Route.continue_
 
@@ -893,7 +961,7 @@ async def handle(route, request):
                 \"bar\": None # remove \"bar\" header
             }
             await route.continue_(headers=headers)
-        }
+
         await page.route(\"**/*\", handle)
         ```
 
@@ -906,7 +974,7 @@ def handle(route, request):
                 \"bar\": None # remove \"bar\" header
             }
             route.continue_(headers=headers)
-        }
+
         page.route(\"**/*\", handle)
         ```
 
@@ -915,11 +983,11 @@ def handle(route, request):
         url : Union[str, None]
             If set changes the request URL. New URL must have same protocol as original one.
         method : Union[str, None]
-            If set changes the request method (e.g. GET or POST)
+            If set changes the request method (e.g. GET or POST).
         headers : Union[Dict[str, str], None]
             If set changes the request HTTP headers. Header values will be converted to a string.
-        post_data : Union[bytes, str, None]
-            If set changes the post data of request
+        post_data : Union[Any, bytes, str, None]
+            If set changes the post data of request.
         """
 
         return mapping.from_maybe_impl(
@@ -928,7 +996,7 @@ def handle(route, request):
                     url=url,
                     method=method,
                     headers=mapping.to_impl(headers),
-                    postData=post_data,
+                    postData=mapping.to_impl(post_data),
                 )
             )
         )
@@ -2777,13 +2845,13 @@ def screenshot(
     def query_selector(self, selector: str) -> typing.Optional["ElementHandle"]:
         """ElementHandle.query_selector
 
-        The method finds an element matching the specified selector in the `ElementHandle`'s subtree. See
-        [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns `null`.
+        The method finds an element matching the specified selector in the `ElementHandle`'s subtree. If no elements match
+        the selector, returns `null`.
 
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
 
         Returns
         -------
@@ -2797,13 +2865,13 @@ def query_selector(self, selector: str) -> typing.Optional["ElementHandle"]:
     def query_selector_all(self, selector: str) -> typing.List["ElementHandle"]:
         """ElementHandle.query_selector_all
 
-        The method finds all elements matching the specified selector in the `ElementHandle`s subtree. See
-        [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns empty array.
+        The method finds all elements matching the specified selector in the `ElementHandle`s subtree. If no elements match
+        the selector, returns empty array.
 
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
 
         Returns
         -------
@@ -2822,8 +2890,7 @@ def eval_on_selector(
         Returns the return value of `expression`.
 
         The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a
-        first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements
-        match the selector, the method throws an error.
+        first argument to `expression`. If no elements match the selector, the method throws an error.
 
         If `expression` returns a [Promise], then `element_handle.eval_on_selector()` would wait for the promise to
         resolve and return its value.
@@ -2845,7 +2912,7 @@ def eval_on_selector(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -2873,8 +2940,7 @@ def eval_on_selector_all(
         Returns the return value of `expression`.
 
         The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array
-        of matched elements as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more
-        details.
+        of matched elements as a first argument to `expression`.
 
         If `expression` returns a [Promise], then `element_handle.eval_on_selector_all()` would wait for the promise to
         resolve and return its value.
@@ -2901,7 +2967,7 @@ def eval_on_selector_all(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -3003,7 +3069,7 @@ def wait_for_selector(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
@@ -3689,13 +3755,13 @@ def query_selector(
 
         **NOTE** The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
 
-        The method finds an element matching the specified selector within the frame. See
-        [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns `null`.
+        The method finds an element matching the specified selector within the frame. If no elements match the selector,
+        returns `null`.
 
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3716,13 +3782,13 @@ def query_selector_all(self, selector: str) -> typing.List["ElementHandle"]:
 
         **NOTE** The use of `ElementHandle` is discouraged, use `Locator` objects instead.
 
-        The method finds all elements matching the specified selector within the frame. See
-        [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector, returns empty array.
+        The method finds all elements matching the specified selector within the frame. If no elements match the selector,
+        returns empty array.
 
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
 
         Returns
         -------
@@ -3799,7 +3865,7 @@ def run(playwright):
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3843,7 +3909,7 @@ def is_checked(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3879,7 +3945,7 @@ def is_disabled(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3915,7 +3981,7 @@ def is_editable(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3951,7 +4017,7 @@ def is_enabled(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3988,7 +4054,7 @@ def is_hidden(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4023,7 +4089,7 @@ def is_visible(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4097,7 +4163,7 @@ def dispatch_event(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         type : str
             DOM event type: `"click"`, `"dragstart"`, etc.
         event_init : Union[Dict, None]
@@ -4135,8 +4201,7 @@ def eval_on_selector(
         Returns the return value of `expression`.
 
         The method finds an element matching the specified selector within the frame and passes it as a first argument to
-        `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details. If no elements match the selector,
-        the method throws an error.
+        `expression`. If no elements match the selector, the method throws an error.
 
         If `expression` returns a [Promise], then `frame.eval_on_selector()` would wait for the promise to resolve
         and return its value.
@@ -4158,7 +4223,7 @@ def eval_on_selector(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -4192,7 +4257,7 @@ def eval_on_selector_all(
         Returns the return value of `expression`.
 
         The method finds all elements matching the specified selector within the frame and passes an array of matched
-        elements as a first argument to `expression`. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more details.
+        elements as a first argument to `expression`.
 
         If `expression` returns a [Promise], then `frame.eval_on_selector_all()` would wait for the promise to resolve
         and return its value.
@@ -4210,7 +4275,7 @@ def eval_on_selector_all(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -4401,7 +4466,7 @@ def click(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -4485,7 +4550,7 @@ def dblclick(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -4563,7 +4628,7 @@ def tap(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -4629,7 +4694,7 @@ def fill(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
@@ -4679,7 +4744,7 @@ def locator(
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -4967,7 +5032,9 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, test_id: str) -> "Locator":
+    def get_by_test_id(
+        self, test_id: typing.Union[str, typing.Pattern[str]]
+    ) -> "Locator":
         """Frame.get_by_test_id
 
         Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
@@ -4975,7 +5042,7 @@ def get_by_test_id(self, test_id: str) -> "Locator":
 
         Parameters
         ----------
-        test_id : str
+        test_id : Union[Pattern[str], str]
             Id to locate the element by.
 
         Returns
@@ -5114,7 +5181,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
 
         Returns
         -------
@@ -5139,7 +5206,7 @@ def focus(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5169,7 +5236,7 @@ def text_content(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5205,7 +5272,7 @@ def inner_text(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5241,7 +5308,7 @@ def inner_html(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5278,7 +5345,7 @@ def get_attribute(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         name : str
             Attribute name to get the value for.
         strict : Union[bool, None]
@@ -5332,7 +5399,7 @@ def hover(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -5390,10 +5457,10 @@ def drag_and_drop(
         ----------
         source : str
             A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will
-            be used. See [working with selectors](../selectors.md) for more details.
+            be used.
         target : str
             A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first
-            will be used. See [working with selectors](../selectors.md) for more details.
+            will be used.
         source_position : Union[{x: float, y: float}, None]
             Clicks on the source 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.
@@ -5485,7 +5552,7 @@ def select_option(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         value : Union[List[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
@@ -5549,7 +5616,7 @@ def input_value(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5599,7 +5666,7 @@ def set_input_files(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
@@ -5658,7 +5725,7 @@ def type(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         text : str
             A text to type into a focused element.
         delay : Union[float, None]
@@ -5723,7 +5790,7 @@ def press(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         key : str
             Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
         delay : Union[float, None]
@@ -5784,7 +5851,7 @@ def check(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -5850,7 +5917,7 @@ def uncheck(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -6039,7 +6106,7 @@ def set_checked(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
@@ -6123,7 +6190,7 @@ def locator(
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -6411,7 +6478,9 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, test_id: str) -> "Locator":
+    def get_by_test_id(
+        self, test_id: typing.Union[str, typing.Pattern[str]]
+    ) -> "Locator":
         """FrameLocator.get_by_test_id
 
         Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
@@ -6419,7 +6488,7 @@ def get_by_test_id(self, test_id: str) -> "Locator":
 
         Parameters
         ----------
-        test_id : str
+        test_id : Union[Pattern[str], str]
             Id to locate the element by.
 
         Returns
@@ -6543,7 +6612,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
 
         Returns
         -------
@@ -7233,14 +7302,14 @@ def on(self, event: Literal["popup"], f: typing.Callable[["Page"], "None"]) -> N
 
         ```py
         async with page.expect_event(\"popup\") as page_info:
-            page.evaluate(\"window.open('https://example.com')\")
+            await page.get_by_text(\"open the popup\").click()
         popup = await page_info.value
         print(await popup.evaluate(\"location.href\"))
         ```
 
         ```py
         with page.expect_event(\"popup\") as page_info:
-            page.evaluate(\"window.open('https://example.com')\")
+            page.get_by_text(\"open the popup\").click()
         popup = page_info.value
         print(popup.evaluate(\"location.href\"))
         ```
@@ -7484,14 +7553,14 @@ def once(
 
         ```py
         async with page.expect_event(\"popup\") as page_info:
-            page.evaluate(\"window.open('https://example.com')\")
+            await page.get_by_text(\"open the popup\").click()
         popup = await page_info.value
         print(await popup.evaluate(\"location.href\"))
         ```
 
         ```py
         with page.expect_event(\"popup\") as page_info:
-            page.evaluate(\"window.open('https://example.com')\")
+            page.get_by_text(\"open the popup\").click()
         popup = page_info.value
         print(popup.evaluate(\"location.href\"))
         ```
@@ -7797,7 +7866,7 @@ def query_selector(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -7820,7 +7889,7 @@ def query_selector_all(self, selector: str) -> typing.List["ElementHandle"]:
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
 
         Returns
         -------
@@ -7897,7 +7966,7 @@ def run(playwright):
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 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.
@@ -7941,7 +8010,7 @@ def is_checked(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -7977,7 +8046,7 @@ def is_disabled(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8013,7 +8082,7 @@ def is_editable(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8049,7 +8118,7 @@ def is_enabled(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8086,7 +8155,7 @@ def is_hidden(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8121,7 +8190,7 @@ def is_visible(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8195,7 +8264,7 @@ def dispatch_event(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         type : str
             DOM event type: `"click"`, `"dragstart"`, etc.
         event_init : Union[Dict, None]
@@ -8400,7 +8469,7 @@ def eval_on_selector(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -8450,7 +8519,7 @@ def eval_on_selector_all(
         Parameters
         ----------
         selector : str
-            A selector to query for. See [working with selectors](../selectors.md) for more details.
+            A selector to query for.
         expression : str
             JavaScript expression to be evaluated in the browser context. If the expression evaluates to a function, the
             function is automatically invoked.
@@ -8967,7 +9036,7 @@ def wait_for_load_state(
         async with page.expect_popup() as page_info:
             await page.get_by_role(\"button\").click() # click triggers a popup.
         popup = await page_info.value
-         # Following resolves after \"domcontentloaded\" event.
+        # Wait for the \"DOMContentLoaded\" event.
         await popup.wait_for_load_state(\"domcontentloaded\")
         print(await popup.title()) # popup is ready to use.
         ```
@@ -8976,7 +9045,7 @@ def wait_for_load_state(
         with page.expect_popup() as page_info:
             page.get_by_role(\"button\").click() # click triggers a popup.
         popup = page_info.value
-         # Following resolves after \"domcontentloaded\" event.
+        # Wait for the \"DOMContentLoaded\" event.
         popup.wait_for_load_state(\"domcontentloaded\")
         print(popup.title()) # popup is ready to use.
         ```
@@ -9707,7 +9776,7 @@ def click(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -9791,7 +9860,7 @@ def dblclick(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -9869,7 +9938,7 @@ def tap(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -9935,7 +10004,7 @@ def fill(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
@@ -9983,7 +10052,7 @@ def locator(
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -10271,7 +10340,9 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, test_id: str) -> "Locator":
+    def get_by_test_id(
+        self, test_id: typing.Union[str, typing.Pattern[str]]
+    ) -> "Locator":
         """Page.get_by_test_id
 
         Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
@@ -10279,7 +10350,7 @@ def get_by_test_id(self, test_id: str) -> "Locator":
 
         Parameters
         ----------
-        test_id : str
+        test_id : Union[Pattern[str], str]
             Id to locate the element by.
 
         Returns
@@ -10418,7 +10489,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
 
         Returns
         -------
@@ -10443,7 +10514,7 @@ def focus(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10473,7 +10544,7 @@ def text_content(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10509,7 +10580,7 @@ def inner_text(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10545,7 +10616,7 @@ def inner_html(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10582,7 +10653,7 @@ def get_attribute(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         name : str
             Attribute name to get the value for.
         strict : Union[bool, None]
@@ -10636,7 +10707,7 @@ def hover(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
@@ -10721,10 +10792,10 @@ def drag_and_drop(
         ----------
         source : str
             A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will
-            be used. See [working with selectors](../selectors.md) for more details.
+            be used.
         target : str
             A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first
-            will be used. See [working with selectors](../selectors.md) for more details.
+            will be used.
         source_position : Union[{x: float, y: float}, None]
             Clicks on the source 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.
@@ -10817,7 +10888,7 @@ def select_option(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         value : Union[List[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
@@ -10881,7 +10952,7 @@ def input_value(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10931,7 +11002,7 @@ def set_input_files(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
             Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed
@@ -10990,7 +11061,7 @@ def type(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         text : str
             A text to type into a focused element.
         delay : Union[float, None]
@@ -11083,7 +11154,7 @@ def press(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         key : str
             Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
         delay : Union[float, None]
@@ -11144,7 +11215,7 @@ def check(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -11210,7 +11281,7 @@ def uncheck(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -11683,13 +11754,15 @@ def expect_navigation(
 
         ```py
         async with page.expect_navigation():
-            await page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+            # This action triggers the navigation after a timeout.
+            await page.get_by_text(\"Navigate after timeout\").click()
         # Resolves after navigation has finished
         ```
 
         ```py
         with page.expect_navigation():
-            page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
+            # This action triggers the navigation after a timeout.
+            page.get_by_text(\"Navigate after timeout\").click()
         # Resolves after navigation has finished
         ```
 
@@ -11775,23 +11848,23 @@ def expect_request(
 
         ```py
         async with page.expect_request(\"http://example.com/resource\") as first:
-            await page.click('button')
+            await page.get_by_text(\"trigger request\").click()
         first_request = await first.value
 
         # or with a lambda
         async with page.expect_request(lambda request: request.url == \"http://example.com\" and request.method == \"get\") as second:
-            await page.click('img')
+            await page.get_by_text(\"trigger request\").click()
         second_request = await second.value
         ```
 
         ```py
         with page.expect_request(\"http://example.com/resource\") as first:
-            page.click('button')
+            page.get_by_text(\"trigger request\").click()
         first_request = first.value
 
         # or with a lambda
         with page.expect_request(lambda request: request.url == \"http://example.com\" and request.method == \"get\") as second:
-            page.click('img')
+            page.get_by_text(\"trigger request\").click()
         second_request = second.value
         ```
 
@@ -11864,26 +11937,26 @@ def expect_response(
 
         ```py
         async with page.expect_response(\"https://example.com/resource\") as response_info:
-            await page.click(\"input\")
+            await page.get_by_text(\"trigger response\").click()
         response = await response_info.value
         return response.ok
 
         # or with a lambda
         async with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200) as response_info:
-            await page.click(\"input\")
+            await page.get_by_text(\"trigger response\").click()
         response = await response_info.value
         return response.ok
         ```
 
         ```py
         with page.expect_response(\"https://example.com/resource\") as response_info:
-            page.click(\"input\")
+            page.get_by_text(\"trigger response\").click()
         response = response_info.value
         return response.ok
 
         # or with a lambda
         with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200) as response_info:
-            page.click(\"input\")
+            page.get_by_text(\"trigger response\").click()
         response = response_info.value
         return response.ok
         ```
@@ -12003,7 +12076,7 @@ def set_checked(
         ----------
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
-            used. See [working with selectors](../selectors.md) for more details.
+            used.
         checked : bool
             Whether to check or uncheck the checkbox.
         position : Union[{x: float, y: float}, None]
@@ -12086,14 +12159,14 @@ def on(self, event: Literal["page"], f: typing.Callable[["Page"], "None"]) -> No
 
         ```py
         async with context.expect_page() as page_info:
-            await page.locator(\"a[target=_blank]\").click(),
+            await page.get_by_text(\"open new page\").click(),
         page = await page_info.value
         print(await page.evaluate(\"location.href\"))
         ```
 
         ```py
         with context.expect_page() as page_info:
-            page.locator(\"a[target=_blank]\").click(),
+            page.get_by_text(\"open new page\").click(),
         page = page_info.value
         print(page.evaluate(\"location.href\"))
         ```
@@ -12195,14 +12268,14 @@ def once(
 
         ```py
         async with context.expect_page() as page_info:
-            await page.locator(\"a[target=_blank]\").click(),
+            await page.get_by_text(\"open new page\").click(),
         page = await page_info.value
         print(await page.evaluate(\"location.href\"))
         ```
 
         ```py
         with context.expect_page() as page_info:
-            page.locator(\"a[target=_blank]\").click(),
+            page.get_by_text(\"open new page\").click(),
         page = page_info.value
         print(page.evaluate(\"location.href\"))
         ```
@@ -13484,9 +13557,10 @@ def new_context(
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
-            selectors that imply single target DOM element will throw when more than one element matches the selector. See
-            `Locator` to learn more about the strict mode.
+            If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. This
+            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
+            mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -13691,9 +13765,10 @@ def new_page(
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
-            selectors that imply single target DOM element will throw when more than one element matches the selector. See
-            `Locator` to learn more about the strict mode.
+            If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. This
+            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
+            mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -14227,9 +14302,10 @@ def launch_persistent_context(
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         strict_selectors : Union[bool, None]
-            If specified, enables strict selectors mode for this context. In the strict selectors mode all operations on
-            selectors that imply single target DOM element will throw when more than one element matches the selector. See
-            `Locator` to learn more about the strict mode.
+            If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
+            selectors that imply single target DOM element will throw when more than one element matches the selector. This
+            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
+            mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -14464,7 +14540,7 @@ def run(playwright):
     def selectors(self) -> "Selectors":
         """Playwright.selectors
 
-        Selectors can be used to install custom selector engines. See [Working with selectors](https://playwright.dev/python/docs/selectors) for more
+        Selectors can be used to install custom selector engines. See [extensibility](https://playwright.dev/python/docs/extensibility) for more
         information.
 
         Returns
@@ -14851,6 +14927,10 @@ def click(
     ) -> None:
         """Locator.click
 
+        Click an element.
+
+        **Details**
+
         This method clicks the element by performing the following steps:
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
@@ -15284,7 +15364,7 @@ def locator(
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -15572,7 +15652,9 @@ def get_by_role(
             )
         )
 
-    def get_by_test_id(self, test_id: str) -> "Locator":
+    def get_by_test_id(
+        self, test_id: typing.Union[str, typing.Pattern[str]]
+    ) -> "Locator":
         """Locator.get_by_test_id
 
         Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
@@ -15580,7 +15662,7 @@ def get_by_test_id(self, test_id: str) -> "Locator":
 
         Parameters
         ----------
-        test_id : str
+        test_id : Union[Pattern[str], str]
             Id to locate the element by.
 
         Returns
@@ -15716,7 +15798,7 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         Parameters
         ----------
         selector : str
-            A selector to use when resolving DOM element. See [working with selectors](../selectors.md) for more details.
+            A selector to use when resolving DOM element.
 
         Returns
         -------
@@ -15858,6 +15940,30 @@ def blur(self, *, timeout: typing.Optional[float] = None) -> None:
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.blur(timeout=timeout)))
 
+    def all(self) -> typing.List["Locator"]:
+        """Locator.all
+
+        When locator points to a list of elements, returns array of locators, pointing to respective elements.
+
+        **Usage**
+
+        ```py
+        for li in await page.get_by_role('listitem').all():
+          await li.click();
+        ```
+
+        ```py
+        for li in page.get_by_role('listitem').all():
+          li.click();
+        ```
+
+        Returns
+        -------
+        List[Locator]
+        """
+
+        return mapping.from_impl_list(self._sync(self._impl_obj.all()))
+
     def count(self) -> int:
         """Locator.count
 
@@ -16386,6 +16492,10 @@ def select_option(
     ) -> typing.List[str]:
         """Locator.select_option
 
+        Selects option or options in `<select>`.
+
+        **Details**
+
         This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, waits until all specified options are present in
         the `<select>` element and selects these options.
 
@@ -16400,21 +16510,29 @@ def select_option(
 
         **Usage**
 
+        ```html
+        <select multiple>
+          <option value=\"red\">Red</div>
+          <option value=\"green\">Green</div>
+          <option value=\"blue\">Blue</div>
+        </select>
+        ```
+
         ```py
-        # single selection matching the value
+        # single selection matching the value or label
         await element.select_option(\"blue\")
         # single selection matching the label
         await element.select_option(label=\"blue\")
-        # multiple selection
+        # multiple selection for blue, red and second option
         await element.select_option(value=[\"red\", \"green\", \"blue\"])
         ```
 
         ```py
-        # single selection matching the value
+        # single selection matching the value or label
         element.select_option(\"blue\")
-        # single selection matching both the label
+        # single selection matching the label
         element.select_option(label=\"blue\")
-        # multiple selection
+        # multiple selection for blue, red and second option
         element.select_option(value=[\"red\", \"green\", \"blue\"])
         ```
 
@@ -17021,7 +17139,7 @@ def delete(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17100,7 +17218,7 @@ def head(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17179,7 +17297,7 @@ def get(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17270,7 +17388,7 @@ def patch(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17349,7 +17467,7 @@ def put(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17428,7 +17546,7 @@ def post(
             typing.Dict[str, typing.Union[str, float, bool]]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -17547,7 +17665,7 @@ def fetch(
         ] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
+        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = 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]]
@@ -18742,7 +18860,7 @@ def to_have_text(
         Parameters
         ----------
         expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
-            Expected substring or RegExp or a list of those.
+            Expected string or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
@@ -18785,7 +18903,7 @@ def not_to_have_text(
         Parameters
         ----------
         expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
-            Expected substring or RegExp or a list of those.
+            Expected string or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
diff --git a/setup.py b/setup.py
index c3b2aa365..67a333001 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.29.0-alpha-nov-25-2022"
+driver_version = "1.29.0-beta-1671131879000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 3519d83d2..39d348708 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -869,3 +869,11 @@ async def blur_event() -> None:
     assert focused
     assert blurred
     assert not await button.evaluate("button => document.activeElement === button")
+
+
+async def test_locator_all_should_work(page: Page) -> None:
+    await page.set_content("<div><p>A</p><p>B</p><p>C</p></div>")
+    texts = []
+    for p in await page.locator("p").all():
+        texts.append(await p.text_content())
+    assert texts == ["A", "B", "C"]
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 705c0d76f..47a23fcd2 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -787,183 +787,6 @@ async def test_title_should_return_the_page_title(page, server):
     assert await page.title() == "Woof-Woof"
 
 
-async def test_select_option_should_select_single_option(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.select_option("select", "blue")
-    assert await page.evaluate("result.onInput") == ["blue"]
-    assert await page.evaluate("result.onChange") == ["blue"]
-
-
-async def test_select_option_should_select_single_option_by_value(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.select_option("select", "blue")
-    assert await page.evaluate("result.onInput") == ["blue"]
-    assert await page.evaluate("result.onChange") == ["blue"]
-
-
-async def test_select_option_should_select_single_option_by_label(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.select_option("select", label="Indigo")
-    assert await page.evaluate("result.onInput") == ["indigo"]
-    assert await page.evaluate("result.onChange") == ["indigo"]
-
-
-async def test_select_option_should_select_single_option_by_handle(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.select_option(
-        "select", element=await page.query_selector("[id=whiteOption]")
-    )
-    assert await page.evaluate("result.onInput") == ["white"]
-    assert await page.evaluate("result.onChange") == ["white"]
-
-
-async def test_select_option_should_select_single_option_by_index(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.select_option("select", index=2)
-    assert await page.evaluate("result.onInput") == ["brown"]
-    assert await page.evaluate("result.onChange") == ["brown"]
-
-
-async def test_select_option_should_select_only_first_option(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.select_option("select", ["blue", "green", "red"])
-    assert await page.evaluate("result.onInput") == ["blue"]
-    assert await page.evaluate("result.onChange") == ["blue"]
-
-
-async def test_select_option_should_not_throw_when_select_causes_navigation(
-    page, server
-):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.eval_on_selector(
-        "select",
-        "select => select.addEventListener('input', () => window.location = '/empty.html')",
-    )
-    async with page.expect_navigation():
-        await page.select_option("select", "blue")
-    assert "empty.html" in page.url
-
-
-async def test_select_option_should_select_multiple_options(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.evaluate("makeMultiple()")
-    await page.select_option("select", ["blue", "green", "red"])
-    assert await page.evaluate("result.onInput") == ["blue", "green", "red"]
-    assert await page.evaluate("result.onChange") == ["blue", "green", "red"]
-
-
-async def test_select_option_should_select_multiple_options_with_attributes(
-    page, server
-):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.evaluate("makeMultiple()")
-    await page.select_option(
-        "select",
-        value="blue",
-        label="Green",
-        index=4,
-    )
-    assert await page.evaluate("result.onInput") == ["blue", "gray", "green"]
-    assert await page.evaluate("result.onChange") == ["blue", "gray", "green"]
-
-
-async def test_select_option_should_respect_event_bubbling(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.select_option("select", "blue")
-    assert await page.evaluate("result.onBubblingInput") == ["blue"]
-    assert await page.evaluate("result.onBubblingChange") == ["blue"]
-
-
-async def test_select_option_should_throw_when_element_is_not_a__select_(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    with pytest.raises(Error) as exc_info:
-        await page.select_option("body", "")
-    assert "Element is not a <select> element" in exc_info.value.message
-
-
-async def test_select_option_should_return_on_no_matched_values(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    with pytest.raises(TimeoutError) as exc_info:
-        await page.select_option("select", ["42", "abc"], timeout=1000)
-    assert "Timeout 1000" in exc_info.value.message
-
-
-async def test_select_option_should_return_an_array_of_matched_values(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.evaluate("makeMultiple()")
-    result = await page.select_option("select", ["blue", "black", "magenta"])
-    assert result == ["black", "blue", "magenta"]
-
-
-async def test_select_option_should_return_an_array_of_one_element_when_multiple_is_not_set(
-    page, server
-):
-    await page.goto(server.PREFIX + "/input/select.html")
-    result = await page.select_option("select", ["42", "blue", "black", "magenta"])
-    assert len(result) == 1
-
-
-async def test_select_option_should_return_on_no_values(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    result = await page.select_option("select", [])
-    assert result == []
-
-
-async def test_select_option_should_not_allow_null_items(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.evaluate("makeMultiple()")
-    with pytest.raises(Error) as exc_info:
-        await page.select_option("select", ["blue", None, "black", "magenta"])
-    assert "expected string, got object" in exc_info.value.message
-
-
-async def test_select_option_should_unselect_with_null(page, server):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.evaluate("makeMultiple()")
-    result = await page.select_option("select", ["blue", "black", "magenta"])
-    assert result == ["black", "blue", "magenta"]
-    await page.select_option("select", None)
-    assert await page.eval_on_selector(
-        "select",
-        "select => Array.from(select.options).every(option => !option.selected)",
-    )
-
-
-async def test_select_option_should_deselect_all_options_when_passed_no_values_for_a_multiple_select(
-    page, server
-):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.evaluate("makeMultiple()")
-    await page.select_option("select", ["blue", "black", "magenta"])
-    await page.select_option("select", [])
-    assert await page.eval_on_selector(
-        "select",
-        "select => Array.from(select.options).every(option => !option.selected)",
-    )
-
-
-async def test_select_option_should_deselect_all_options_when_passed_no_values_for_a_select_without_multiple(
-    page, server
-):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.select_option("select", ["blue", "black", "magenta"])
-    await page.select_option("select", [])
-    assert await page.eval_on_selector(
-        "select",
-        "select => Array.from(select.options).every(option => !option.selected)",
-    )
-
-
-async def test_select_option_should_work_when_re_defining_top_level_event_class(
-    page, server
-):
-    await page.goto(server.PREFIX + "/input/select.html")
-    await page.evaluate("window.Event = null")
-    await page.select_option("select", "blue")
-    assert await page.evaluate("result.onInput") == ["blue"]
-    assert await page.evaluate("result.onChange") == ["blue"]
-
-
 async def give_it_a_chance_to_fill(page):
     for i in range(5):
         await page.evaluate(
diff --git a/tests/async/test_page_request_fallback.py b/tests/async/test_page_request_fallback.py
index e5654c515..0102655de 100644
--- a/tests/async/test_page_request_fallback.py
+++ b/tests/async/test_page_request_fallback.py
@@ -353,3 +353,26 @@ async def test_should_chain_fallback_with_dynamic_url(
 
     await page.goto(server.EMPTY_PAGE)
     assert intercepted == [3, 2, 1]
+
+
+async def test_should_amend_json_post_data(server, page):
+    await page.goto(server.EMPTY_PAGE)
+    post_data = []
+    await page.route(
+        "**/*",
+        lambda route: (
+            post_data.append(route.request.post_data),
+            asyncio.create_task(route.continue_()),
+        ),
+    )
+    await page.route(
+        "**/*",
+        lambda route: asyncio.create_task(route.fallback(post_data={"foo": "bar"})),
+    )
+
+    [server_request, _] = await asyncio.gather(
+        server.wait_for_request("/sleep.zzz"),
+        page.evaluate("() => fetch('/sleep.zzz', { method: 'POST', body: 'birdy' })"),
+    )
+    assert post_data == ['{"foo": "bar"}']
+    assert server_request.post_body == b'{"foo": "bar"}'
diff --git a/tests/async/test_page_request_intercept.py b/tests/async/test_page_request_intercept.py
new file mode 100644
index 000000000..9b41d9630
--- /dev/null
+++ b/tests/async/test_page_request_intercept.py
@@ -0,0 +1,42 @@
+# 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 Page, Route
+from tests.server import Server
+
+
+async def test_should_intercept_with_url_override(server: Server, page: Page):
+    async def handle(route: Route):
+        response = await route.fetch(url=server.PREFIX + "/one-style.html")
+        await route.fulfill(response=response)
+
+    await page.route("**/*.html", lambda route: handle(route))
+    response = await page.goto(server.PREFIX + "/empty.html")
+    assert response.status == 200
+    assert "one-style.css" in (await response.body()).decode("utf-8")
+
+
+async def test_should_intercept_with_post_data_override(server: Server, page: Page):
+    request_promise = asyncio.create_task(server.wait_for_request("/empty.html"))
+
+    async def handle(route: Route):
+        response = await route.fetch(post_data={"foo": "bar"})
+        await route.fulfill(response=response)
+
+    await page.route("**/*.html", lambda route: handle(route))
+    await page.goto(server.PREFIX + "/empty.html")
+    request = await request_promise
+    assert request.post_body.decode("utf-8") == '{"foo":"bar"}'
diff --git a/tests/async/test_page_select_option.py b/tests/async/test_page_select_option.py
new file mode 100644
index 000000000..33e9a098a
--- /dev/null
+++ b/tests/async/test_page_select_option.py
@@ -0,0 +1,220 @@
+# 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.async_api import Error, Page, TimeoutError
+from tests.server import Server
+
+
+async def test_select_option_should_select_single_option(page: Page, server: Server):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.select_option("select", "blue")
+    assert await page.evaluate("result.onInput") == ["blue"]
+    assert await page.evaluate("result.onChange") == ["blue"]
+
+
+async def test_select_option_should_select_single_option_by_value(
+    page: Page, server: Server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.select_option("select", "blue")
+    assert await page.evaluate("result.onInput") == ["blue"]
+    assert await page.evaluate("result.onChange") == ["blue"]
+
+
+async def test_select_option_should_select_single_option_by_label(
+    page: Page, server: Server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.select_option("select", label="Indigo")
+    assert await page.evaluate("result.onInput") == ["indigo"]
+    assert await page.evaluate("result.onChange") == ["indigo"]
+
+
+async def test_select_option_should_select_single_option_by_handle(
+    page: Page, server: Server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.select_option(
+        "select", element=await page.query_selector("[id=whiteOption]")
+    )
+    assert await page.evaluate("result.onInput") == ["white"]
+    assert await page.evaluate("result.onChange") == ["white"]
+
+
+async def test_select_option_should_select_single_option_by_index(
+    page: Page, server: Server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.select_option("select", index=2)
+    assert await page.evaluate("result.onInput") == ["brown"]
+    assert await page.evaluate("result.onChange") == ["brown"]
+
+
+async def test_select_option_should_select_only_first_option(
+    page: Page, server: Server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.select_option("select", ["blue", "green", "red"])
+    assert await page.evaluate("result.onInput") == ["blue"]
+    assert await page.evaluate("result.onChange") == ["blue"]
+
+
+async def test_select_option_should_not_throw_when_select_causes_navigation(
+    page, server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.eval_on_selector(
+        "select",
+        "select => select.addEventListener('input', () => window.location = '/empty.html')",
+    )
+    async with page.expect_navigation():
+        await page.select_option("select", "blue")
+    assert "empty.html" in page.url
+
+
+async def test_select_option_should_select_multiple_options(page: Page, server: Server):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.evaluate("makeMultiple()")
+    await page.select_option("select", ["blue", "green", "red"])
+    assert await page.evaluate("result.onInput") == ["blue", "green", "red"]
+    assert await page.evaluate("result.onChange") == ["blue", "green", "red"]
+
+
+async def test_select_option_should_select_multiple_options_with_attributes(
+    page, server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.evaluate("makeMultiple()")
+    await page.select_option(
+        "select",
+        value="blue",
+        label="Green",
+        index=4,
+    )
+    assert await page.evaluate("result.onInput") == ["blue", "gray", "green"]
+    assert await page.evaluate("result.onChange") == ["blue", "gray", "green"]
+
+
+async def test_select_option_should_respect_event_bubbling(page: Page, server: Server):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.select_option("select", "blue")
+    assert await page.evaluate("result.onBubblingInput") == ["blue"]
+    assert await page.evaluate("result.onBubblingChange") == ["blue"]
+
+
+async def test_select_option_should_throw_when_element_is_not_a__select_(
+    page: Page, server: Server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    with pytest.raises(Error) as exc_info:
+        await page.select_option("body", "")
+    assert "Element is not a <select> element" in exc_info.value.message
+
+
+async def test_select_option_should_return_on_no_matched_values(
+    page: Page, server: Server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    with pytest.raises(TimeoutError) as exc_info:
+        await page.select_option("select", ["42", "abc"], timeout=1000)
+    assert "Timeout 1000" in exc_info.value.message
+
+
+async def test_select_option_should_return_an_array_of_matched_values(
+    page: Page, server: Server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.evaluate("makeMultiple()")
+    result = await page.select_option("select", ["blue", "black", "magenta"])
+    assert result == ["black", "blue", "magenta"]
+
+
+async def test_select_option_should_return_an_array_of_one_element_when_multiple_is_not_set(
+    page, server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    result = await page.select_option("select", ["42", "blue", "black", "magenta"])
+    assert len(result) == 1
+
+
+async def test_select_option_should_return_on_no_values(page: Page, server: Server):
+    await page.goto(server.PREFIX + "/input/select.html")
+    result = await page.select_option("select", [])
+    assert result == []
+
+
+async def test_select_option_should_not_allow_null_items(page: Page, server: Server):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.evaluate("makeMultiple()")
+    with pytest.raises(Error) as exc_info:
+        await page.select_option("select", ["blue", None, "black", "magenta"])
+    assert "expected string, got object" in exc_info.value.message
+
+
+async def test_select_option_should_unselect_with_null(page: Page, server: Server):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.evaluate("makeMultiple()")
+    result = await page.select_option("select", ["blue", "black", "magenta"])
+    assert result == ["black", "blue", "magenta"]
+    await page.select_option("select", None)
+    assert await page.eval_on_selector(
+        "select",
+        "select => Array.from(select.options).every(option => !option.selected)",
+    )
+
+
+async def test_select_option_should_deselect_all_options_when_passed_no_values_for_a_multiple_select(
+    page, server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.evaluate("makeMultiple()")
+    await page.select_option("select", ["blue", "black", "magenta"])
+    await page.select_option("select", [])
+    assert await page.eval_on_selector(
+        "select",
+        "select => Array.from(select.options).every(option => !option.selected)",
+    )
+
+
+async def test_select_option_should_deselect_all_options_when_passed_no_values_for_a_select_without_multiple(
+    page, server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.select_option("select", ["blue", "black", "magenta"])
+    await page.select_option("select", [])
+    assert await page.eval_on_selector(
+        "select",
+        "select => Array.from(select.options).every(option => !option.selected)",
+    )
+
+
+async def test_select_option_should_work_when_re_defining_top_level_event_class(
+    page, server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.evaluate("window.Event = null")
+    await page.select_option("select", "blue")
+    assert await page.evaluate("result.onInput") == ["blue"]
+    assert await page.evaluate("result.onChange") == ["blue"]
+
+
+async def test_select_options_should_fall_back_to_selecting_by_label(
+    page: Page, server: Server
+):
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.select_option("select", "Blue")
+    assert await page.evaluate("result.onInput") == ["blue"]
+    assert await page.evaluate("result.onChange") == ["blue"]
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index b1bff8c67..1f751a4b1 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -769,3 +769,11 @@ async def blur_event() -> None:
     assert focused
     assert blurred
     assert not button.evaluate("button => document.activeElement === button")
+
+
+def test_locator_all_should_work(page: Page) -> None:
+    page.set_content("<div><p>A</p><p>B</p><p>C</p></div>")
+    texts = []
+    for p in page.locator("p").all():
+        texts.append(p.text_content())
+    assert texts == ["A", "B", "C"]
diff --git a/tests/sync/test_page_request_fallback.py b/tests/sync/test_page_request_fallback.py
index 5166da66e..b77ffb234 100644
--- a/tests/sync/test_page_request_fallback.py
+++ b/tests/sync/test_page_request_fallback.py
@@ -328,3 +328,23 @@ def test_should_chain_fallback_with_dynamic_url(server: Server, page: Page) -> N
 
     page.goto(server.EMPTY_PAGE)
     assert intercepted == [3, 2, 1]
+
+
+def test_should_amend_json_post_data(server: Server, page: Page) -> None:
+    page.goto(server.EMPTY_PAGE)
+    post_data = []
+
+    def handler(route: Route) -> None:
+        post_data.append(route.request.post_data)
+        route.continue_()
+
+    page.route("**/*", handler)
+    page.route(
+        "**/*",
+        lambda route: route.fallback(post_data={"foo": "bar"}),
+    )
+
+    with server.expect_request("/sleep.zzz") as server_request:
+        page.evaluate("() => fetch('/sleep.zzz', { method: 'POST', body: 'birdy' })"),
+    assert post_data == ['{"foo": "bar"}']
+    assert server_request.value.post_body == b'{"foo": "bar"}'
diff --git a/tests/sync/test_page_request_intercept.py b/tests/sync/test_page_request_intercept.py
new file mode 100644
index 000000000..0face7efe
--- /dev/null
+++ b/tests/sync/test_page_request_intercept.py
@@ -0,0 +1,28 @@
+# 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 Page, Route
+from tests.server import Server
+
+
+def test_should_intercept_with_url_override(server: Server, page: Page) -> None:
+    def handle(route: Route) -> None:
+        response = route.fetch(url=server.PREFIX + "/one-style.html")
+        route.fulfill(response=response)
+
+    page.route("**/*.html", lambda route: handle(route))
+    response = page.goto(server.PREFIX + "/empty.html")
+    assert response
+    assert response.status == 200
+    assert "one-style.css" in response.body().decode("utf-8")
diff --git a/tests/sync/test_page_select_option.py b/tests/sync/test_page_select_option.py
new file mode 100644
index 000000000..3c746dc6c
--- /dev/null
+++ b/tests/sync/test_page_select_option.py
@@ -0,0 +1,214 @@
+# 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 Error, Page
+from tests.server import Server
+
+
+def test_select_option_should_select_single_option(server: Server, page: Page) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.select_option("select", "blue")
+    assert page.evaluate("result.onInput") == ["blue"]
+    assert page.evaluate("result.onChange") == ["blue"]
+
+
+def test_select_option_should_select_single_option_by_value(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.select_option("select", "blue")
+    assert page.evaluate("result.onInput") == ["blue"]
+    assert page.evaluate("result.onChange") == ["blue"]
+
+
+def test_select_option_should_select_single_option_by_label(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.select_option("select", label="Indigo")
+    assert page.evaluate("result.onInput") == ["indigo"]
+    assert page.evaluate("result.onChange") == ["indigo"]
+
+
+def test_select_option_should_select_single_option_by_handle(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.select_option("select", element=page.query_selector("[id=whiteOption]"))
+    assert page.evaluate("result.onInput") == ["white"]
+    assert page.evaluate("result.onChange") == ["white"]
+
+
+def test_select_option_should_select_single_option_by_index(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.select_option("select", index=2)
+    assert page.evaluate("result.onInput") == ["brown"]
+    assert page.evaluate("result.onChange") == ["brown"]
+
+
+def test_select_option_should_select_only_first_option(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.select_option("select", ["blue", "green", "red"])
+    assert page.evaluate("result.onInput") == ["blue"]
+    assert page.evaluate("result.onChange") == ["blue"]
+
+
+def test_select_option_should_not_throw_when_select_causes_navigation(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.eval_on_selector(
+        "select",
+        "select => select.addEventListener('input', () => window.location = '/empty.html')",
+    )
+    with page.expect_navigation():
+        page.select_option("select", "blue")
+    assert "empty.html" in page.url
+
+
+def test_select_option_should_select_multiple_options(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.evaluate("makeMultiple()")
+    page.select_option("select", ["blue", "green", "red"])
+    assert page.evaluate("result.onInput") == ["blue", "green", "red"]
+    assert page.evaluate("result.onChange") == ["blue", "green", "red"]
+
+
+def test_select_option_should_select_multiple_options_with_attributes(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.evaluate("makeMultiple()")
+    page.select_option(
+        "select",
+        value="blue",
+        label="Green",
+        index=4,
+    )
+    assert page.evaluate("result.onInput") == ["blue", "gray", "green"]
+    assert page.evaluate("result.onChange") == ["blue", "gray", "green"]
+
+
+def test_select_option_should_respect_event_bubbling(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.select_option("select", "blue")
+    assert page.evaluate("result.onBubblingInput") == ["blue"]
+    assert page.evaluate("result.onBubblingChange") == ["blue"]
+
+
+def test_select_option_should_throw_when_element_is_not_a__select_(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    with pytest.raises(Error) as exc_info:
+        page.select_option("body", "")
+    assert "Element is not a <select> element" in exc_info.value.message
+
+
+def test_select_option_should_return_on_no_matched_values(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    with pytest.raises(Error) as exc_info:
+        page.select_option("select", ["42", "abc"], timeout=1000)
+    assert "Timeout 1000" in exc_info.value.message
+
+
+def test_select_option_should_return_an_array_of_matched_values(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.evaluate("makeMultiple()")
+    result = page.select_option("select", ["blue", "black", "magenta"])
+    assert result == ["black", "blue", "magenta"]
+
+
+def test_select_option_should_return_an_array_of_one_element_when_multiple_is_not_set(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    result = page.select_option("select", ["42", "blue", "black", "magenta"])
+    assert len(result) == 1
+
+
+def test_select_option_should_return_on_no_values(server: Server, page: Page) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    result = page.select_option("select", [])
+    assert result == []
+
+
+def test_select_option_should_unselect_with_null(server: Server, page: Page) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.evaluate("makeMultiple()")
+    result = page.select_option("select", ["blue", "black", "magenta"])
+    assert result == ["black", "blue", "magenta"]
+    page.select_option("select", None)
+    assert page.eval_on_selector(
+        "select",
+        "select => Array.from(select.options).every(option => !option.selected)",
+    )
+
+
+def test_select_option_should_deselect_all_options_when_passed_no_values_for_a_multiple_select(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.evaluate("makeMultiple()")
+    page.select_option("select", ["blue", "black", "magenta"])
+    page.select_option("select", [])
+    assert page.eval_on_selector(
+        "select",
+        "select => Array.from(select.options).every(option => !option.selected)",
+    )
+
+
+def test_select_option_should_deselect_all_options_when_passed_no_values_for_a_select_without_multiple(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.select_option("select", ["blue", "black", "magenta"])
+    page.select_option("select", [])
+    assert page.eval_on_selector(
+        "select",
+        "select => Array.from(select.options).every(option => !option.selected)",
+    )
+
+
+def test_select_option_should_work_when_re_defining_top_level_event_class(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.evaluate("window.Event = null")
+    page.select_option("select", "blue")
+    assert page.evaluate("result.onInput") == ["blue"]
+    assert page.evaluate("result.onChange") == ["blue"]
+
+
+def test_select_options_should_fall_back_to_selecting_by_label(
+    server: Server, page: Page
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.select_option("select", "Blue")
+    assert page.evaluate("result.onInput") == ["blue"]
+    assert page.evaluate("result.onChange") == ["blue"]

From 20b3137229a0efe8602a7f47a7c617fdb403d5d5 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 20 Dec 2022 13:19:16 +0100
Subject: [PATCH 027/438] chore: roll to 1.29.0 (#1688)

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

diff --git a/setup.py b/setup.py
index 67a333001..2b5c1c216 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.29.0-beta-1671131879000"
+driver_version = "1.29.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From af2a06beb89f898d26e09e16fe2e41fb553042c2 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 22 Dec 2022 00:14:37 +0100
Subject: [PATCH 028/438] chore: roll to 1.29.1 driver (#1691)

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

diff --git a/setup.py b/setup.py
index 2b5c1c216..b082b1529 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.29.0"
+driver_version = "1.29.1"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From eb4b88af72aa6757c95f5a74f11ad6503bf16038 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 27 Dec 2022 23:11:41 +0100
Subject: [PATCH 029/438] build(deps): bump setuptools from 65.5.0 to 65.5.1
 (#1697)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 6e8e9a618..11692ee5f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.1.0
 pytest-xdist==3.0.2
 requests==2.28.1
 service_identity==21.1.0
-setuptools==65.5.0
+setuptools==65.5.1
 twine==4.0.1
 twisted==22.10.0
 types-pyOpenSSL==22.1.0.1

From e341b9aa5238cbd8fb3c24f958d71e663acc65c3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 28 Dec 2022 16:20:07 -0800
Subject: [PATCH 030/438] build(deps): bump wheel from 0.37.1 to 0.38.1 (#1696)

* build(deps): bump wheel from 0.37.1 to 0.38.1

Bumps [wheel](https://github.com/pypa/wheel) from 0.37.1 to 0.38.1.
- [Release notes](https://github.com/pypa/wheel/releases)
- [Changelog](https://github.com/pypa/wheel/blob/main/docs/news.rst)
- [Commits](https://github.com/pypa/wheel/compare/0.37.1...0.38.1)

---
updated-dependencies:
- dependency-name: wheel
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>

* bump dep in pyproject.toml

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Ross Wollman <rwoll@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 pyproject.toml         | 2 +-
 setup.py               | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 11692ee5f..059328913 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -21,4 +21,4 @@ setuptools==65.5.1
 twine==4.0.1
 twisted==22.10.0
 types-pyOpenSSL==22.1.0.1
-wheel==0.37.1
+wheel==0.38.1
diff --git a/pyproject.toml b/pyproject.toml
index e0ea95cc7..1a2ac2e51 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==60.9.3", "setuptools-scm==7.0.5", "wheel==0.37.1", "auditwheel==5.1.2"]
+requires = ["setuptools==60.9.3", "setuptools-scm==7.0.5", "wheel==0.38.1", "auditwheel==5.1.2"]
 build-backend = "setuptools.build_meta"
 
 [tool.pytest.ini_options]
diff --git a/setup.py b/setup.py
index b082b1529..c163ba8b9 100644
--- a/setup.py
+++ b/setup.py
@@ -236,7 +236,7 @@ def _download_and_extract_local_driver(
         "write_to": "playwright/_repo_version.py",
         "write_to_template": 'version = "{version}"\n',
     },
-    setup_requires=["setuptools-scm==7.0.5", "wheel==0.37.1"],
+    setup_requires=["setuptools-scm==7.0.5", "wheel==0.38.1"],
     entry_points={
         "console_scripts": [
             "playwright=playwright.__main__:main",

From 334c27966087748a7275f10ff4199948dc3428d3 Mon Sep 17 00:00:00 2001
From: Ross Wollman <rwoll@users.noreply.github.com>
Date: Thu, 29 Dec 2022 12:07:40 -0500
Subject: [PATCH 031/438] fix: fulfill with json (#1700)

Resolves #1693.

Relates microsoft/playwright#19184 (original upstream change).
Relates #1684 (original Python rolling introducing the feature to the port).
---
 playwright/_impl/_network.py        |  9 +++--
 tests/async/test_request_fulfill.py | 51 +++++++++++++++++++++++++++++
 tests/sync/test_request_fulfill.py  | 47 ++++++++++++++++++++++++++
 3 files changed, 105 insertions(+), 2 deletions(-)

diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 132c67a49..bd8aa4221 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -16,6 +16,7 @@
 import base64
 import inspect
 import json
+import json as json_utils
 import mimetypes
 import sys
 from collections import defaultdict
@@ -288,6 +289,12 @@ async def fulfill(
     ) -> None:
         self._check_not_handled()
         params = locals_to_params(locals())
+
+        if json is not None:
+            if body is not None:
+                raise Error("Can specify either body or json parameters")
+            body = json_utils.dumps(json)
+
         if response:
             del params["response"]
             params["status"] = (
@@ -298,8 +305,6 @@ async def fulfill(
             )
             from playwright._impl._fetch import APIResponse
 
-            if json is not None:
-                body = json.dumps(json)
             if body is None and path is None and isinstance(response, APIResponse):
                 if response._request._connection is self._connection:
                     params["fetchResponseUid"] = response._fetch_uid
diff --git a/tests/async/test_request_fulfill.py b/tests/async/test_request_fulfill.py
index e619a37f9..b48ae8047 100644
--- a/tests/async/test_request_fulfill.py
+++ b/tests/async/test_request_fulfill.py
@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import json
+
 from playwright.async_api import Page, Route
 from tests.server import Server
 
@@ -25,3 +27,52 @@ async def handle(route: Route):
     response = await page.goto(server.PREFIX + "/title.html")
     assert response.status == 200
     assert await page.title() == "Woof-Woof"
+
+
+async def test_should_fulfill_json(page: Page, server: Server) -> None:
+    async def handle(route: Route) -> None:
+        await route.fulfill(status=201, headers={"foo": "bar"}, json={"bar": "baz"})
+
+    await page.route("**/*", handle)
+
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response
+    assert response.status == 201
+    assert response.headers["content-type"] == "application/json"
+    assert json.loads(await page.evaluate("document.body.textContent")) == {
+        "bar": "baz"
+    }
+
+
+async def test_should_fulfill_json_overriding_existing_response(
+    page: Page, server: Server
+) -> None:
+    server.set_route(
+        "/tags",
+        lambda request: (
+            request.setHeader("foo", "bar"),
+            request.write('{"tags": ["a", "b"]}'.encode()),
+            request.finish(),
+        ),
+    )
+
+    original = {}
+
+    async def handle(route: Route) -> None:
+        response = await route.fetch()
+        json = await response.json()
+        original["tags"] = json["tags"]
+        json["tags"] = ["c"]
+        await route.fulfill(response=response, json=json)
+
+    await page.route("**/*", handle)
+
+    response = await page.goto(server.PREFIX + "/tags")
+    assert response
+    assert response.status == 200
+    assert response.headers["content-type"] == "application/json"
+    assert response.headers["foo"] == "bar"
+    assert original["tags"] == ["a", "b"]
+    assert json.loads(await page.evaluate("document.body.textContent")) == {
+        "tags": ["c"]
+    }
diff --git a/tests/sync/test_request_fulfill.py b/tests/sync/test_request_fulfill.py
index f7b44316d..d51737389 100644
--- a/tests/sync/test_request_fulfill.py
+++ b/tests/sync/test_request_fulfill.py
@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import json
+
 from playwright.sync_api import Page, Route
 from tests.server import Server
 
@@ -26,3 +28,48 @@ def handle(route: Route) -> None:
     assert response
     assert response.status == 200
     assert page.title() == "Woof-Woof"
+
+
+def test_should_fulfill_json(page: Page, server: Server) -> None:
+    def handle(route: Route) -> None:
+        route.fulfill(status=201, headers={"foo": "bar"}, json={"bar": "baz"})
+
+    page.route("**/*", handle)
+
+    response = page.goto(server.EMPTY_PAGE)
+    assert response
+    assert response.status == 201
+    assert response.headers["content-type"] == "application/json"
+    assert json.loads(page.evaluate("document.body.textContent")) == {"bar": "baz"}
+
+
+def test_should_fulfill_json_overriding_existing_response(
+    page: Page, server: Server
+) -> None:
+    server.set_route(
+        "/tags",
+        lambda request: (
+            request.setHeader("foo", "bar"),
+            request.write('{"tags": ["a", "b"]}'.encode()),
+            request.finish(),
+        ),
+    )
+
+    original = {}
+
+    def handle(route: Route) -> None:
+        response = route.fetch()
+        json = response.json()
+        original["tags"] = json["tags"]
+        json["tags"] = ["c"]
+        route.fulfill(response=response, json=json)
+
+    page.route("**/*", handle)
+
+    response = page.goto(server.PREFIX + "/tags")
+    assert response
+    assert response.status == 200
+    assert response.headers["content-type"] == "application/json"
+    assert response.headers["foo"] == "bar"
+    assert original["tags"] == ["a", "b"]
+    assert json.loads(page.evaluate("document.body.textContent")) == {"tags": ["c"]}

From 2d0df8eeb7242f0ae7c2fb6b3af6075e70be617e Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 5 Jan 2023 21:55:03 +0100
Subject: [PATCH 032/438] chore: do not set no_window to the process (#1712)

---
 playwright/_impl/_transport.py | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index 9a4127389..92dfeb163 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -16,7 +16,6 @@
 import io
 import json
 import os
-import subprocess
 import sys
 from abc import ABC, abstractmethod
 from pathlib import Path
@@ -107,9 +106,6 @@ async def wait_until_stopped(self) -> None:
 
     async def connect(self) -> None:
         self._stopped_future: asyncio.Future = asyncio.Future()
-        creationflags = 0
-        if sys.platform == "win32":
-            creationflags = subprocess.CREATE_NO_WINDOW
 
         try:
             # For pyinstaller
@@ -124,7 +120,6 @@ async def connect(self) -> None:
                 stdout=asyncio.subprocess.PIPE,
                 stderr=_get_stderr_fileno(),
                 limit=32768,
-                creationflags=creationflags,
                 env=env,
             )
         except Exception as exc:

From b4d34bef8bfe3412572f4c08e176f564dd0edb9d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lewin=20K=C3=A4stner?=
 <118112813+lewinkaestner@users.noreply.github.com>
Date: Mon, 16 Jan 2023 15:55:58 +0100
Subject: [PATCH 033/438] fix: include-hidden arg in get_by_role_selector
 (#1726)

---
 playwright/_impl/_locator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 5d59d5561..e233e6727 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -823,7 +823,7 @@ def get_by_role_selector(
     if expanded is not None:
         props.append(("expanded", str(expanded)))
     if includeHidden is not None:
-        props.append(("include-hiddenen", str(includeHidden)))
+        props.append(("include-hidden", str(includeHidden)))
     if level is not None:
         props.append(("level", str(level)))
     if name is not None:

From db99c368c35ff91c251841b00a0e67d9956eb006 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 17 Jan 2023 19:34:56 +0100
Subject: [PATCH 034/438] chore(roll): roll Playwright to
 1.30.0-alpha-jan-16-2023 (#1725)

---
 README.md                          |    4 +-
 playwright/_impl/_page.py          |    5 +-
 playwright/async_api/_generated.py | 1100 ++++++++++++++++++++++++----
 playwright/sync_api/_generated.py  | 1100 ++++++++++++++++++++++++----
 scripts/expected_api_mismatch.txt  |    5 +-
 setup.py                           |    2 +-
 6 files changed, 1900 insertions(+), 316 deletions(-)

diff --git a/README.md b/README.md
index bcf88ee0a..3bacdb735 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 -->109.0.5414.46<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->109.0.5414.74<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->107.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->108.0.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index da524d4b8..4f7a5d03b 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -954,7 +954,10 @@ def request(self) -> "APIRequestContext":
         return self.context.request
 
     async def pause(self) -> None:
-        await self._browser_context._pause()
+        await asyncio.wait(
+            [self._browser_context._pause(), self._closed_or_crashed_future],
+            return_when=asyncio.FIRST_COMPLETED,
+        )
 
     async def pdf(
         self,
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 24efc0ceb..497d481d5 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -754,7 +754,7 @@ async def fetch(
 
         ```py
         async def handle(route):
-            response = await route.fulfill()
+            response = await route.fetch()
             json = await response.json()
             json[\"message\"][\"big_red_dog\"] = []
             await route.fulfill(response=response, json=json)
@@ -764,7 +764,7 @@ async def handle(route):
 
         ```py
         def handle(route):
-            response = route.fulfill()
+            response = route.fetch()
             json = response.json()
             json[\"message\"][\"big_red_dog\"] = []
             route.fulfill(response=response, json=json)
@@ -4688,10 +4688,22 @@ def get_by_alt_text(
     ) -> "Locator":
         """Frame.get_by_alt_text
 
-        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+        Allows locating elements by their alt text.
+
+        **Usage**
+
+        For example, this method will find the image by alt text \"Playwright logo\":
 
         ```html
-        <img alt='Castle'>
+        <img alt='Playwright logo'>
+        ```
+
+        ```py
+        await page.get_by_alt_text(\"Playwright logo\").click()
+        ```
+
+        ```py
+        page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
         Parameters
@@ -4717,14 +4729,25 @@ def get_by_label(
     ) -> "Locator":
         """Frame.get_by_label
 
-        Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text \"Password\" in the following DOM:
+        Allows locating input elements by the text of the associated label.
+
+        **Usage**
+
+        For example, this method will find the input by label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
+        ```py
+        await page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
+        ```py
+        page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -4748,11 +4771,24 @@ def get_by_placeholder(
     ) -> "Locator":
         """Frame.get_by_placeholder
 
-        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
-        \"Country\":
+        Allows locating input elements by the placeholder text.
+
+        **Usage**
+
+        For example, consider the following DOM structure.
 
         ```html
-        <input placeholder=\"Country\">
+        <input type=\"email\" placeholder=\"name@example.com\" />
+        ```
+
+        You can fill the input after locating it by the placeholder text:
+
+        ```py
+        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
+        ```
+
+        ```py
+        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
         Parameters
@@ -4873,14 +4909,48 @@ def get_by_role(
 
         Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
         [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
-        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
-        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <h3>Sign up</h3>
+        <label>
+          <input type=\"checkbox\" /> Subscribe
+        </label>
+        <br/>
+        <button>Submit</button>
+        ```
+
+        You can locate each element by it's implicit role:
+
+        ```py
+        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        ```py
+        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        **Details**
+
+        Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
+        about the ARIA guidelines.
 
-        Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
-        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
-        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
-        default values.
+        Many html elements have an implicitly [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings)
+        that is recognized by the role selector. You can find all the
+        [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not recommend**
+        duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
 
         Parameters
         ----------
@@ -4951,8 +5021,30 @@ def get_by_test_id(
     ) -> "Locator":
         """Frame.get_by_test_id
 
-        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
-        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+        Locate element by the test id.
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <button data-testid=\"directions\">Itinéraire</button>
+        ```
+
+        You can locate the element by it's test id:
+
+        ```py
+        await page.get_by_test_id(\"directions\").click()
+        ```
+
+        ```py
+        page.get_by_test_id(\"directions\").click()
+        ```
+
+        **Details**
+
+        By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
+        configure a different test id attribute if necessary.
 
         Parameters
         ----------
@@ -4974,7 +5066,14 @@ def get_by_text(
     ) -> "Locator":
         """Frame.get_by_text
 
-        Allows locating elements that contain given text. Consider the following DOM structure:
+        Allows locating elements that contain given text.
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **Usage**
+
+        Consider the following DOM structure:
 
         ```html
         <div>Hello <span>world</span></div>
@@ -5017,14 +5116,13 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
-        filter by the text content.
+        **Details**
 
-        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
-        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
 
-        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
-        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -5049,11 +5147,24 @@ def get_by_title(
     ) -> "Locator":
         """Frame.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
-        order\":
+        Allows locating elements by their title attribute.
+
+        **Usage**
+
+        Consider the following DOM structure.
 
         ```html
-        <button title='Place the order'>Order Now</button>
+        <span title='Issues count'>25 issues</span>
+        ```
+
+        You can check the issues count after locating it by the title text:
+
+        ```py
+        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
+        ```
+
+        ```py
+        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
         Parameters
@@ -6104,10 +6215,22 @@ def get_by_alt_text(
     ) -> "Locator":
         """FrameLocator.get_by_alt_text
 
-        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+        Allows locating elements by their alt text.
+
+        **Usage**
+
+        For example, this method will find the image by alt text \"Playwright logo\":
 
         ```html
-        <img alt='Castle'>
+        <img alt='Playwright logo'>
+        ```
+
+        ```py
+        await page.get_by_alt_text(\"Playwright logo\").click()
+        ```
+
+        ```py
+        page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
         Parameters
@@ -6133,14 +6256,25 @@ def get_by_label(
     ) -> "Locator":
         """FrameLocator.get_by_label
 
-        Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text \"Password\" in the following DOM:
+        Allows locating input elements by the text of the associated label.
+
+        **Usage**
+
+        For example, this method will find the input by label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
+        ```py
+        await page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
+        ```py
+        page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -6164,11 +6298,24 @@ def get_by_placeholder(
     ) -> "Locator":
         """FrameLocator.get_by_placeholder
 
-        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
-        \"Country\":
+        Allows locating input elements by the placeholder text.
+
+        **Usage**
+
+        For example, consider the following DOM structure.
 
         ```html
-        <input placeholder=\"Country\">
+        <input type=\"email\" placeholder=\"name@example.com\" />
+        ```
+
+        You can fill the input after locating it by the placeholder text:
+
+        ```py
+        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
+        ```
+
+        ```py
+        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
         Parameters
@@ -6289,14 +6436,48 @@ def get_by_role(
 
         Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
         [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
-        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
-        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <h3>Sign up</h3>
+        <label>
+          <input type=\"checkbox\" /> Subscribe
+        </label>
+        <br/>
+        <button>Submit</button>
+        ```
+
+        You can locate each element by it's implicit role:
+
+        ```py
+        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        ```py
+        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
 
-        Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
-        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
-        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
-        default values.
+        **Details**
+
+        Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
+        about the ARIA guidelines.
+
+        Many html elements have an implicitly [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings)
+        that is recognized by the role selector. You can find all the
+        [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not recommend**
+        duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
 
         Parameters
         ----------
@@ -6367,8 +6548,30 @@ def get_by_test_id(
     ) -> "Locator":
         """FrameLocator.get_by_test_id
 
-        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
-        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+        Locate element by the test id.
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <button data-testid=\"directions\">Itinéraire</button>
+        ```
+
+        You can locate the element by it's test id:
+
+        ```py
+        await page.get_by_test_id(\"directions\").click()
+        ```
+
+        ```py
+        page.get_by_test_id(\"directions\").click()
+        ```
+
+        **Details**
+
+        By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
+        configure a different test id attribute if necessary.
 
         Parameters
         ----------
@@ -6390,7 +6593,14 @@ def get_by_text(
     ) -> "Locator":
         """FrameLocator.get_by_text
 
-        Allows locating elements that contain given text. Consider the following DOM structure:
+        Allows locating elements that contain given text.
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **Usage**
+
+        Consider the following DOM structure:
 
         ```html
         <div>Hello <span>world</span></div>
@@ -6433,14 +6643,13 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
-        filter by the text content.
+        **Details**
 
-        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
-        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
 
-        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
-        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -6465,11 +6674,24 @@ def get_by_title(
     ) -> "Locator":
         """FrameLocator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
-        order\":
+        Allows locating elements by their title attribute.
+
+        **Usage**
+
+        Consider the following DOM structure.
 
         ```html
-        <button title='Place the order'>Order Now</button>
+        <span title='Issues count'>25 issues</span>
+        ```
+
+        You can check the issues count after locating it by the title text:
+
+        ```py
+        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
+        ```
+
+        ```py
+        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
         Parameters
@@ -10008,10 +10230,22 @@ def get_by_alt_text(
     ) -> "Locator":
         """Page.get_by_alt_text
 
-        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+        Allows locating elements by their alt text.
+
+        **Usage**
+
+        For example, this method will find the image by alt text \"Playwright logo\":
 
         ```html
-        <img alt='Castle'>
+        <img alt='Playwright logo'>
+        ```
+
+        ```py
+        await page.get_by_alt_text(\"Playwright logo\").click()
+        ```
+
+        ```py
+        page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
         Parameters
@@ -10037,14 +10271,25 @@ def get_by_label(
     ) -> "Locator":
         """Page.get_by_label
 
-        Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text \"Password\" in the following DOM:
+        Allows locating input elements by the text of the associated label.
+
+        **Usage**
+
+        For example, this method will find the input by label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
+        ```py
+        await page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
+        ```py
+        page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -10068,11 +10313,24 @@ def get_by_placeholder(
     ) -> "Locator":
         """Page.get_by_placeholder
 
-        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
-        \"Country\":
+        Allows locating input elements by the placeholder text.
+
+        **Usage**
+
+        For example, consider the following DOM structure.
 
         ```html
-        <input placeholder=\"Country\">
+        <input type=\"email\" placeholder=\"name@example.com\" />
+        ```
+
+        You can fill the input after locating it by the placeholder text:
+
+        ```py
+        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
+        ```
+
+        ```py
+        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
         Parameters
@@ -10193,14 +10451,48 @@ def get_by_role(
 
         Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
         [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
-        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
-        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <h3>Sign up</h3>
+        <label>
+          <input type=\"checkbox\" /> Subscribe
+        </label>
+        <br/>
+        <button>Submit</button>
+        ```
+
+        You can locate each element by it's implicit role:
+
+        ```py
+        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        ```py
+        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
 
-        Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
-        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
-        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
-        default values.
+        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        **Details**
+
+        Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
+        about the ARIA guidelines.
+
+        Many html elements have an implicitly [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings)
+        that is recognized by the role selector. You can find all the
+        [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not recommend**
+        duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
 
         Parameters
         ----------
@@ -10271,8 +10563,30 @@ def get_by_test_id(
     ) -> "Locator":
         """Page.get_by_test_id
 
-        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
-        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+        Locate element by the test id.
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <button data-testid=\"directions\">Itinéraire</button>
+        ```
+
+        You can locate the element by it's test id:
+
+        ```py
+        await page.get_by_test_id(\"directions\").click()
+        ```
+
+        ```py
+        page.get_by_test_id(\"directions\").click()
+        ```
+
+        **Details**
+
+        By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
+        configure a different test id attribute if necessary.
 
         Parameters
         ----------
@@ -10294,7 +10608,14 @@ def get_by_text(
     ) -> "Locator":
         """Page.get_by_text
 
-        Allows locating elements that contain given text. Consider the following DOM structure:
+        Allows locating elements that contain given text.
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **Usage**
+
+        Consider the following DOM structure:
 
         ```html
         <div>Hello <span>world</span></div>
@@ -10337,14 +10658,13 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
-        filter by the text content.
+        **Details**
 
-        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
-        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
 
-        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
-        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -10369,11 +10689,24 @@ def get_by_title(
     ) -> "Locator":
         """Page.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
-        order\":
+        Allows locating elements by their title attribute.
+
+        **Usage**
+
+        Consider the following DOM structure.
 
         ```html
-        <button title='Place the order'>Order Now</button>
+        <span title='Issues count'>25 issues</span>
+        ```
+
+        You can check the issues count after locating it by the title text:
+
+        ```py
+        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
+        ```
+
+        ```py
+        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
         Parameters
@@ -14715,19 +15048,32 @@ def last(self) -> "Locator":
 
         Returns locator to the last matching element.
 
-        Returns
-        -------
-        Locator
-        """
-        return mapping.from_impl(self._impl_obj.last)
+        **Usage**
 
-    async def bounding_box(
+        ```py
+        banana = await page.get_by_role(\"listitem\").last()
+        ```
+
+        ```py
+        banana = page.get_by_role(\"listitem\").last()
+        ```
+
+        Returns
+        -------
+        Locator
+        """
+        return mapping.from_impl(self._impl_obj.last)
+
+    async def bounding_box(
         self, *, timeout: typing.Optional[float] = None
     ) -> typing.Optional[FloatRect]:
         """Locator.bounding_box
 
-        This method returns the bounding box of the element, or `null` if the element is not visible. The bounding box is
-        calculated relative to the main frame viewport - which is usually the same as the browser window.
+        This method returns the bounding box of the element matching the locator, or `null` if the element is not visible.
+        The bounding box is calculated relative to the main frame viewport - which is usually the same as the browser
+        window.
+
+        **Details**
 
         Scrolling affects the returned bounding box, similarly to
         [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
@@ -14742,12 +15088,12 @@ async def bounding_box(
         **Usage**
 
         ```py
-        box = await element.bounding_box()
+        box = await page.get_by_role(\"button\").bounding_box()
         await page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
         ```
 
         ```py
-        box = element.bounding_box()
+        box = page.get_by_role(\"button\").bounding_box()
         page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
         ```
 
@@ -14777,7 +15123,11 @@ async def check(
     ) -> None:
         """Locator.check
 
-        This method checks the element by performing the following steps:
+        Ensure that checkbox or radio element is checked.
+
+        **Details**
+
+        Performs the following steps:
         1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already
            checked, this method returns immediately.
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
@@ -14791,6 +15141,16 @@ async def check(
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
 
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"checkbox\").check()
+        ```
+
+        ```py
+        page.get_by_role(\"checkbox\").check()
+        ```
+
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
@@ -14852,6 +15212,32 @@ async def click(
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
 
+        **Usage**
+
+        Click a button:
+
+        ```py
+        await page.get_by_role(\"button\").click()
+        ```
+
+        ```py
+        page.get_by_role(\"button\").click()
+        ```
+
+        Shift-right-click at a specific position on a canvas:
+
+        ```py
+        await page.locator(\"canvas\").click(
+            button=\"right\", modifiers=[\"Shift\"], position={\"x\": 23, \"y\": 32}
+        )
+        ```
+
+        ```py
+        page.locator(\"canvas\").click(
+            button=\"right\", modifiers=[\"Shift\"], position={\"x\": 23, \"y\": 32}
+        )
+        ```
+
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
@@ -14910,6 +15296,10 @@ async def dblclick(
     ) -> None:
         """Locator.dblclick
 
+        Double-click an element.
+
+        **Details**
+
         This method double clicks the element by performing the following steps:
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
@@ -14972,20 +15362,24 @@ async def dispatch_event(
     ) -> None:
         """Locator.dispatch_event
 
-        The snippet below dispatches the `click` event on the element. Regardless of the visibility state of the element,
-        `click` is dispatched. This is equivalent to calling
-        [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
+        Programmaticaly dispatch an event on the matching element.
 
         **Usage**
 
         ```py
-        await element.dispatch_event(\"click\")
+        await locator.dispatch_event(\"click\")
         ```
 
         ```py
-        element.dispatch_event(\"click\")
+        locator.dispatch_event(\"click\")
         ```
 
+        **Details**
+
+        The snippet above dispatches the `click` event on the element. Regardless of the visibility state of the element,
+        `click` is dispatched. This is equivalent to calling
+        [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
+
         Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
@@ -15003,13 +15397,13 @@ async def dispatch_event(
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = await page.evaluate_handle(\"new DataTransfer()\")
-        await element.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
+        await locator.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
         ```
 
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = page.evaluate_handle(\"new DataTransfer()\")
-        element.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
+        locator.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
         ```
 
         Parameters
@@ -15038,12 +15432,16 @@ async def evaluate(
     ) -> typing.Any:
         """Locator.evaluate
 
-        Returns the return value of `expression`.
+        Execute JavaScript code in the page, taking the matching element as an argument.
 
-        This method passes this handle as the first argument to `expression`.
+        **Details**
 
-        If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its
-        value.
+        Returns the return value of `expression`, called with the matching element as a first argument, and `arg` as a
+        second argument.
+
+        If `expression` returns a [Promise], this method will wait for the promise to resolve and return its value.
+
+        If `expression` throws or rejects, this method throws.
 
         **Usage**
 
@@ -15084,22 +15482,27 @@ async def evaluate_all(
     ) -> typing.Any:
         """Locator.evaluate_all
 
-        The method finds all elements matching the specified locator and passes an array of matched elements as a first
-        argument to `expression`. Returns the result of `expression` invocation.
+        Execute JavaScript code in the page, taking all matching elements as an argument.
 
-        If `expression` returns a [Promise], then `locator.evaluate_all()` would wait for the promise to resolve and
-        return its value.
+        **Details**
+
+        Returns the return value of `expression`, called with an array of all matching elements as a first argument, and
+        `arg` as a second argument.
+
+        If `expression` returns a [Promise], this method will wait for the promise to resolve and return its value.
+
+        If `expression` throws or rejects, this method throws.
 
         **Usage**
 
         ```py
-        elements = page.locator(\"div\")
-        div_counts = await elements.evaluate_all(\"(divs, min) => divs.length >= min\", 10)
+        locator = page.locator(\"div\")
+        more_than_ten = await locator.evaluate_all(\"(divs, min) => divs.length > min\", 10)
         ```
 
         ```py
-        elements = page.locator(\"div\")
-        div_counts = elements.evaluate_all(\"(divs, min) => divs.length >= min\", 10)
+        locator = page.locator(\"div\")
+        more_than_ten = locator.evaluate_all(\"(divs, min) => divs.length > min\", 10)
         ```
 
         Parameters
@@ -15130,15 +15533,20 @@ async def evaluate_handle(
     ) -> "JSHandle":
         """Locator.evaluate_handle
 
-        Returns the return value of `expression` as a `JSHandle`.
+        Execute JavaScript code in the page, taking the matching element as an argument, and return a `JSHandle` with the
+        result.
 
-        This method passes this handle as the first argument to `expression`.
+        **Details**
+
+        Returns the return value of `expression` as a`JSHandle`, called with the matching element as a first argument, and
+        `arg` as a second argument.
 
         The only difference between `locator.evaluate()` and `locator.evaluate_handle()` is that
         `locator.evaluate_handle()` returns `JSHandle`.
 
-        If the function passed to the `locator.evaluate_handle()` returns a [Promise], then
-        `locator.evaluate_handle()` would wait for the promise to resolve and return its value.
+        If `expression` returns a [Promise], this method will wait for the promise to resolve and return its value.
+
+        If `expression` throws or rejects, this method throws.
 
         See `page.evaluate_handle()` for more details.
 
@@ -15174,6 +15582,20 @@ async def fill(
     ) -> None:
         """Locator.fill
 
+        Set a value to the input field.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"textbox\").fill(\"example value\")
+        ```
+
+        ```py
+        page.get_by_role(\"textbox\").fill(\"example value\")
+        ```
+
+        **Details**
+
         This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an
         `input` event after filling. Note that you can pass an empty string to clear the input field.
 
@@ -15214,6 +15636,10 @@ async def clear(
     ) -> None:
         """Locator.clear
 
+        Clear the input field.
+
+        **Details**
+
         This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
         `input` event after clearing.
 
@@ -15222,6 +15648,16 @@ async def clear(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
         instead.
 
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"textbox\").clear()
+        ```
+
+        ```py
+        page.get_by_role(\"textbox\").clear()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -15288,10 +15724,22 @@ def get_by_alt_text(
     ) -> "Locator":
         """Locator.get_by_alt_text
 
-        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+        Allows locating elements by their alt text.
+
+        **Usage**
+
+        For example, this method will find the image by alt text \"Playwright logo\":
 
         ```html
-        <img alt='Castle'>
+        <img alt='Playwright logo'>
+        ```
+
+        ```py
+        await page.get_by_alt_text(\"Playwright logo\").click()
+        ```
+
+        ```py
+        page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
         Parameters
@@ -15317,14 +15765,25 @@ def get_by_label(
     ) -> "Locator":
         """Locator.get_by_label
 
-        Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text \"Password\" in the following DOM:
+        Allows locating input elements by the text of the associated label.
+
+        **Usage**
+
+        For example, this method will find the input by label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
+        ```py
+        await page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
+        ```py
+        page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -15348,11 +15807,24 @@ def get_by_placeholder(
     ) -> "Locator":
         """Locator.get_by_placeholder
 
-        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
-        \"Country\":
+        Allows locating input elements by the placeholder text.
+
+        **Usage**
+
+        For example, consider the following DOM structure.
 
         ```html
-        <input placeholder=\"Country\">
+        <input type=\"email\" placeholder=\"name@example.com\" />
+        ```
+
+        You can fill the input after locating it by the placeholder text:
+
+        ```py
+        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
+        ```
+
+        ```py
+        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
         Parameters
@@ -15473,14 +15945,48 @@ def get_by_role(
 
         Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
         [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
-        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
-        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <h3>Sign up</h3>
+        <label>
+          <input type=\"checkbox\" /> Subscribe
+        </label>
+        <br/>
+        <button>Submit</button>
+        ```
+
+        You can locate each element by it's implicit role:
+
+        ```py
+        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        ```py
+        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        **Details**
 
-        Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
-        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
-        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
-        default values.
+        Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
+        about the ARIA guidelines.
+
+        Many html elements have an implicitly [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings)
+        that is recognized by the role selector. You can find all the
+        [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not recommend**
+        duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
 
         Parameters
         ----------
@@ -15551,8 +16057,30 @@ def get_by_test_id(
     ) -> "Locator":
         """Locator.get_by_test_id
 
-        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
-        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+        Locate element by the test id.
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <button data-testid=\"directions\">Itinéraire</button>
+        ```
+
+        You can locate the element by it's test id:
+
+        ```py
+        await page.get_by_test_id(\"directions\").click()
+        ```
+
+        ```py
+        page.get_by_test_id(\"directions\").click()
+        ```
+
+        **Details**
+
+        By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
+        configure a different test id attribute if necessary.
 
         Parameters
         ----------
@@ -15574,7 +16102,14 @@ def get_by_text(
     ) -> "Locator":
         """Locator.get_by_text
 
-        Allows locating elements that contain given text. Consider the following DOM structure:
+        Allows locating elements that contain given text.
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **Usage**
+
+        Consider the following DOM structure:
 
         ```html
         <div>Hello <span>world</span></div>
@@ -15617,14 +16152,13 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
-        filter by the text content.
+        **Details**
 
-        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
-        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
 
-        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
-        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -15649,11 +16183,24 @@ def get_by_title(
     ) -> "Locator":
         """Locator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
-        order\":
+        Allows locating elements by their title attribute.
+
+        **Usage**
+
+        Consider the following DOM structure.
 
         ```html
-        <button title='Place the order'>Order Now</button>
+        <span title='Issues count'>25 issues</span>
+        ```
+
+        You can check the issues count after locating it by the title text:
+
+        ```py
+        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
+        ```
+
+        ```py
+        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
         Parameters
@@ -15674,10 +16221,10 @@ def get_by_title(
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Locator.frame_locator
 
-        **Usage**
+        When working with iframes, you can create a frame locator that will enter the iframe and allow locating elements in
+        that iframe:
 
-        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
-        in that iframe:
+        **Usage**
 
         ```py
         locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
@@ -15706,8 +16253,8 @@ async def element_handle(
     ) -> "ElementHandle":
         """Locator.element_handle
 
-        Resolves given locator to the first matching DOM element. If no elements matching the query are visible, waits for
-        them up to a given timeout. If multiple elements match the selector, throws.
+        Resolves given locator to the first matching DOM element. If there are no matching elements, waits for one. If
+        multiple elements match the locator, throws.
 
         Parameters
         ----------
@@ -15725,7 +16272,7 @@ async def element_handle(
     async def element_handles(self) -> typing.List["ElementHandle"]:
         """Locator.element_handles
 
-        Resolves given locator to all matching DOM elements.
+        Resolves given locator to all matching DOM elements. If there are no matching elements, returns an empty list.
 
         Returns
         -------
@@ -15739,6 +16286,16 @@ def nth(self, index: int) -> "Locator":
 
         Returns locator to the n-th matching element. It's zero based, `nth(0)` selects the first element.
 
+        **Usage**
+
+        ```py
+        banana = await page.get_by_role(\"listitem\").nth(2)
+        ```
+
+        ```py
+        banana = page.get_by_role(\"listitem\").nth(2)
+        ```
+
         Parameters
         ----------
         index : int
@@ -15805,7 +16362,7 @@ def filter(
     async def focus(self, *, timeout: typing.Optional[float] = None) -> None:
         """Locator.focus
 
-        Calls [focus](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus) on the element.
+        Calls [focus](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus) on the matching element.
 
         Parameters
         ----------
@@ -15857,7 +16414,17 @@ async def all(self) -> typing.List["Locator"]:
     async def count(self) -> int:
         """Locator.count
 
-        Returns the number of elements matching given selector.
+        Returns the number of elements matching the locator.
+
+        **Usage**
+
+        ```py
+        count = await page.get_by_role(\"listitem\").count()
+        ```
+
+        ```py
+        count = page.get_by_role(\"listitem\").count()
+        ```
 
         Returns
         -------
@@ -15879,6 +16446,10 @@ async def drag_to(
     ) -> None:
         """Locator.drag_to
 
+        Drag the source element towards the target element and drop it.
+
+        **Details**
+
         This method drags the locator to another target locator or target position. It will first move to the source
         element, perform a `mousedown`, then move to the target element or position and perform a `mouseup`.
 
@@ -15951,7 +16522,7 @@ async def get_attribute(
     ) -> typing.Optional[str]:
         """Locator.get_attribute
 
-        Returns element attribute value.
+        Returns the matching element's attribute value.
 
         Parameters
         ----------
@@ -15984,6 +16555,20 @@ async def hover(
     ) -> None:
         """Locator.hover
 
+        Hover over the matching element.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"link\").hover()
+        ```
+
+        ```py
+        page.get_by_role(\"link\").hover()
+        ```
+
+        **Details**
+
         This method hovers over the element by performing the following steps:
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
@@ -16031,7 +16616,7 @@ async def hover(
     async def inner_html(self, *, timeout: typing.Optional[float] = None) -> str:
         """Locator.inner_html
 
-        Returns the `element.innerHTML`.
+        Returns the [`element.innerHTML`](https://developer.mozilla.org/en-US/docs/Web/API/Element/innerHTML).
 
         Parameters
         ----------
@@ -16049,7 +16634,7 @@ async def inner_html(self, *, timeout: typing.Optional[float] = None) -> str:
     async def inner_text(self, *, timeout: typing.Optional[float] = None) -> str:
         """Locator.inner_text
 
-        Returns the `element.innerText`.
+        Returns the [`element.innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText).
 
         Parameters
         ----------
@@ -16067,9 +16652,22 @@ async def inner_text(self, *, timeout: typing.Optional[float] = None) -> str:
     async def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         """Locator.input_value
 
-        Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
+        Returns the value for the matching `<input>` or `<textarea>` or `<select>` element.
 
-        Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
+        **Usage**
+
+        ```py
+        value = await page.get_by_role(\"textbox\").input_value()
+        ```
+
+        ```py
+        value = page.get_by_role(\"textbox\").input_value()
+        ```
+
+        **Details**
+
+        Throws elements that are not an input, textarea or a select. However, if the element is inside the `<label>`
+        element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the
         control.
 
@@ -16093,6 +16691,16 @@ async def is_checked(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is checked. Throws if the element is not a checkbox or radio input.
 
+        **Usage**
+
+        ```py
+        checked = await page.get_by_role(\"checkbox\").is_checked()
+        ```
+
+        ```py
+        checked = page.get_by_role(\"checkbox\").is_checked()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16111,6 +16719,16 @@ async def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is disabled, the opposite of [enabled](https://playwright.dev/python/docs/actionability#enabled).
 
+        **Usage**
+
+        ```py
+        disabled = await page.get_by_role(\"button\").is_disabled()
+        ```
+
+        ```py
+        disabled = page.get_by_role(\"button\").is_disabled()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16131,6 +16749,16 @@ async def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable).
 
+        **Usage**
+
+        ```py
+        editable = await page.get_by_role(\"textbox\").is_editable()
+        ```
+
+        ```py
+        editable = page.get_by_role(\"textbox\").is_editable()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16151,6 +16779,16 @@ async def is_enabled(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [enabled](https://playwright.dev/python/docs/actionability#enabled).
 
+        **Usage**
+
+        ```py
+        enabled = await page.get_by_role(\"button\").is_enabled()
+        ```
+
+        ```py
+        enabled = page.get_by_role(\"button\").is_enabled()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16169,6 +16807,16 @@ async def is_hidden(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).
 
+        **Usage**
+
+        ```py
+        hidden = await page.get_by_role(\"button\").is_hidden()
+        ```
+
+        ```py
+        hidden = page.get_by_role(\"button\").is_hidden()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16185,6 +16833,16 @@ async def is_visible(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible).
 
+        **Usage**
+
+        ```py
+        visible = await page.get_by_role(\"button\").is_visible()
+        ```
+
+        ```py
+        visible = page.get_by_role(\"button\").is_visible()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16206,6 +16864,20 @@ async def press(
     ) -> None:
         """Locator.press
 
+        Focuses the mathing element and presses a combintation of the keys.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"textbox\").press(\"Backspace\")
+        ```
+
+        ```py
+        page.get_by_role(\"textbox\").press(\"Backspace\")
+        ```
+
+        **Details**
+
         Focuses the element, and then uses `keyboard.down()` and `keyboard.up()`.
 
         `key` can specify the intended
@@ -16263,6 +16935,30 @@ async def screenshot(
     ) -> bytes:
         """Locator.screenshot
 
+        Take a screenshot of the element matching the locator.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"link\").screenshot()
+        ```
+
+        ```py
+        page.get_by_role(\"link\").screenshot()
+        ```
+
+        Disable animations and save screenshot to a file:
+
+        ```py
+        await page.get_by_role(\"link\").screenshot(animations=\"disabled\", path=\"link.png\")
+        ```
+
+        ```py
+        page.get_by_role(\"link\").screenshot(animations=\"disabled\", path=\"link.png\")
+        ```
+
+        **Details**
+
         This method captures a screenshot of the page, clipped to the size and position of a particular element matching
         the locator. If the element is covered by other elements, it will not be actually visible on the screenshot. If the
         element is a scrollable container, only the currently scrolled content will be visible on the screenshot.
@@ -16488,6 +17184,48 @@ async def set_input_files(
     ) -> None:
         """Locator.set_input_files
 
+        Upload file or multiple files into `<input type=file>`.
+
+        **Usage**
+
+        ```py
+        # Select one file
+        await page.get_by_label(\"Upload file\").set_input_files('myfile.pdf')
+
+        # Select multiple files
+        await page.get_by_label(\"Upload files\").set_input_files(['file1.txt', 'file2.txt'])
+
+        # Remove all the selected files
+        await page.get_by_label(\"Upload file\").set_input_files([])
+
+        # Upload buffer from memory
+        await page.get_by_label(\"Upload file\").set_input_files(
+            files=[
+                {\"name\": \"test.txt\", \"mimeType\": \"text/plain\", \"buffer\": b\"this is a test\"}
+            ],
+        )
+        ```
+
+        ```py
+        # Select one file
+        page.get_by_label(\"Upload file\").set_input_files('myfile.pdf')
+
+        # Select multiple files
+        page.get_by_label(\"Upload files\").set_input_files(['file1.txt', 'file2.txt'])
+
+        # Remove all the selected files
+        page.get_by_label(\"Upload file\").set_input_files([])
+
+        # Upload buffer from memory
+        page.get_by_label(\"Upload file\").set_input_files(
+            files=[
+                {\"name\": \"test.txt\", \"mimeType\": \"text/plain\", \"buffer\": b\"this is a test\"}
+            ],
+        )
+        ```
+
+        **Details**
+
         Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
         they are resolved relative to the current working directory. For empty array, clears the selected files.
 
@@ -16528,6 +17266,10 @@ async def tap(
     ) -> None:
         """Locator.tap
 
+        Perform a tap gesture on the element matching the locator.
+
+        **Details**
+
         This method taps the element by performing the following steps:
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
@@ -16579,7 +17321,7 @@ async def text_content(
     ) -> typing.Optional[str]:
         """Locator.text_content
 
-        Returns the `node.textContent`.
+        Returns the [`node.textContent`](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent).
 
         Parameters
         ----------
@@ -16669,7 +17411,21 @@ async def uncheck(
     ) -> None:
         """Locator.uncheck
 
-        This method checks the element by performing the following steps:
+        Ensure that checkbox or radio element is unchecked.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"checkbox\").uncheck()
+        ```
+
+        ```py
+        page.get_by_role(\"checkbox\").uncheck()
+        ```
+
+        **Details**
+
+        This method unchecks the element by performing the following steps:
         1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already
            unchecked, this method returns immediately.
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
@@ -16717,6 +17473,16 @@ async def all_inner_texts(self) -> typing.List[str]:
 
         Returns an array of `node.innerText` values for all matching nodes.
 
+        **Usage**
+
+        ```py
+        texts = await page.get_by_role(\"link\").all_inner_texts()
+        ```
+
+        ```py
+        texts = page.get_by_role(\"link\").all_inner_texts()
+        ```
+
         Returns
         -------
         List[str]
@@ -16729,6 +17495,16 @@ async def all_text_contents(self) -> typing.List[str]:
 
         Returns an array of `node.textContent` values for all matching nodes.
 
+        **Usage**
+
+        ```py
+        texts = await page.get_by_role(\"link\").all_text_contents()
+        ```
+
+        ```py
+        texts = page.get_by_role(\"link\").all_text_contents()
+        ```
+
         Returns
         -------
         List[str]
@@ -16794,6 +17570,20 @@ async def set_checked(
     ) -> None:
         """Locator.set_checked
 
+        Set the state of a checkbox or a radio element.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"checkbox\").set_checked(True)
+        ```
+
+        ```py
+        page.get_by_role(\"checkbox\").set_checked(True)
+        ```
+
+        **Details**
+
         This method checks or unchecks an element by performing the following steps:
         1. Ensure that matched element is a checkbox or a radio input. If not, this method throws.
         1. If the element already has the right checked state, this method returns immediately.
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 424730562..995985d55 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -764,7 +764,7 @@ def fetch(
 
         ```py
         async def handle(route):
-            response = await route.fulfill()
+            response = await route.fetch()
             json = await response.json()
             json[\"message\"][\"big_red_dog\"] = []
             await route.fulfill(response=response, json=json)
@@ -774,7 +774,7 @@ async def handle(route):
 
         ```py
         def handle(route):
-            response = route.fulfill()
+            response = route.fetch()
             json = response.json()
             json[\"message\"][\"big_red_dog\"] = []
             route.fulfill(response=response, json=json)
@@ -4774,10 +4774,22 @@ def get_by_alt_text(
     ) -> "Locator":
         """Frame.get_by_alt_text
 
-        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+        Allows locating elements by their alt text.
+
+        **Usage**
+
+        For example, this method will find the image by alt text \"Playwright logo\":
 
         ```html
-        <img alt='Castle'>
+        <img alt='Playwright logo'>
+        ```
+
+        ```py
+        await page.get_by_alt_text(\"Playwright logo\").click()
+        ```
+
+        ```py
+        page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
         Parameters
@@ -4803,14 +4815,25 @@ def get_by_label(
     ) -> "Locator":
         """Frame.get_by_label
 
-        Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text \"Password\" in the following DOM:
+        Allows locating input elements by the text of the associated label.
+
+        **Usage**
+
+        For example, this method will find the input by label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
+        ```py
+        await page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
+        ```py
+        page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -4834,11 +4857,24 @@ def get_by_placeholder(
     ) -> "Locator":
         """Frame.get_by_placeholder
 
-        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
-        \"Country\":
+        Allows locating input elements by the placeholder text.
+
+        **Usage**
+
+        For example, consider the following DOM structure.
 
         ```html
-        <input placeholder=\"Country\">
+        <input type=\"email\" placeholder=\"name@example.com\" />
+        ```
+
+        You can fill the input after locating it by the placeholder text:
+
+        ```py
+        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
+        ```
+
+        ```py
+        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
         Parameters
@@ -4959,14 +4995,48 @@ def get_by_role(
 
         Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
         [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
-        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
-        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <h3>Sign up</h3>
+        <label>
+          <input type=\"checkbox\" /> Subscribe
+        </label>
+        <br/>
+        <button>Submit</button>
+        ```
+
+        You can locate each element by it's implicit role:
+
+        ```py
+        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        ```py
+        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        **Details**
+
+        Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
+        about the ARIA guidelines.
 
-        Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
-        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
-        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
-        default values.
+        Many html elements have an implicitly [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings)
+        that is recognized by the role selector. You can find all the
+        [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not recommend**
+        duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
 
         Parameters
         ----------
@@ -5037,8 +5107,30 @@ def get_by_test_id(
     ) -> "Locator":
         """Frame.get_by_test_id
 
-        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
-        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+        Locate element by the test id.
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <button data-testid=\"directions\">Itinéraire</button>
+        ```
+
+        You can locate the element by it's test id:
+
+        ```py
+        await page.get_by_test_id(\"directions\").click()
+        ```
+
+        ```py
+        page.get_by_test_id(\"directions\").click()
+        ```
+
+        **Details**
+
+        By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
+        configure a different test id attribute if necessary.
 
         Parameters
         ----------
@@ -5060,7 +5152,14 @@ def get_by_text(
     ) -> "Locator":
         """Frame.get_by_text
 
-        Allows locating elements that contain given text. Consider the following DOM structure:
+        Allows locating elements that contain given text.
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **Usage**
+
+        Consider the following DOM structure:
 
         ```html
         <div>Hello <span>world</span></div>
@@ -5103,14 +5202,13 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
-        filter by the text content.
+        **Details**
 
-        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
-        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
 
-        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
-        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -5135,11 +5233,24 @@ def get_by_title(
     ) -> "Locator":
         """Frame.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
-        order\":
+        Allows locating elements by their title attribute.
+
+        **Usage**
+
+        Consider the following DOM structure.
 
         ```html
-        <button title='Place the order'>Order Now</button>
+        <span title='Issues count'>25 issues</span>
+        ```
+
+        You can check the issues count after locating it by the title text:
+
+        ```py
+        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
+        ```
+
+        ```py
+        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
         Parameters
@@ -6220,10 +6331,22 @@ def get_by_alt_text(
     ) -> "Locator":
         """FrameLocator.get_by_alt_text
 
-        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+        Allows locating elements by their alt text.
+
+        **Usage**
+
+        For example, this method will find the image by alt text \"Playwright logo\":
 
         ```html
-        <img alt='Castle'>
+        <img alt='Playwright logo'>
+        ```
+
+        ```py
+        await page.get_by_alt_text(\"Playwright logo\").click()
+        ```
+
+        ```py
+        page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
         Parameters
@@ -6249,14 +6372,25 @@ def get_by_label(
     ) -> "Locator":
         """FrameLocator.get_by_label
 
-        Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text \"Password\" in the following DOM:
+        Allows locating input elements by the text of the associated label.
+
+        **Usage**
+
+        For example, this method will find the input by label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
+        ```py
+        await page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
+        ```py
+        page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -6280,11 +6414,24 @@ def get_by_placeholder(
     ) -> "Locator":
         """FrameLocator.get_by_placeholder
 
-        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
-        \"Country\":
+        Allows locating input elements by the placeholder text.
+
+        **Usage**
+
+        For example, consider the following DOM structure.
 
         ```html
-        <input placeholder=\"Country\">
+        <input type=\"email\" placeholder=\"name@example.com\" />
+        ```
+
+        You can fill the input after locating it by the placeholder text:
+
+        ```py
+        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
+        ```
+
+        ```py
+        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
         Parameters
@@ -6405,14 +6552,48 @@ def get_by_role(
 
         Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
         [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
-        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
-        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <h3>Sign up</h3>
+        <label>
+          <input type=\"checkbox\" /> Subscribe
+        </label>
+        <br/>
+        <button>Submit</button>
+        ```
+
+        You can locate each element by it's implicit role:
+
+        ```py
+        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        ```py
+        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
 
-        Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
-        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
-        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
-        default values.
+        **Details**
+
+        Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
+        about the ARIA guidelines.
+
+        Many html elements have an implicitly [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings)
+        that is recognized by the role selector. You can find all the
+        [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not recommend**
+        duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
 
         Parameters
         ----------
@@ -6483,8 +6664,30 @@ def get_by_test_id(
     ) -> "Locator":
         """FrameLocator.get_by_test_id
 
-        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
-        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+        Locate element by the test id.
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <button data-testid=\"directions\">Itinéraire</button>
+        ```
+
+        You can locate the element by it's test id:
+
+        ```py
+        await page.get_by_test_id(\"directions\").click()
+        ```
+
+        ```py
+        page.get_by_test_id(\"directions\").click()
+        ```
+
+        **Details**
+
+        By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
+        configure a different test id attribute if necessary.
 
         Parameters
         ----------
@@ -6506,7 +6709,14 @@ def get_by_text(
     ) -> "Locator":
         """FrameLocator.get_by_text
 
-        Allows locating elements that contain given text. Consider the following DOM structure:
+        Allows locating elements that contain given text.
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **Usage**
+
+        Consider the following DOM structure:
 
         ```html
         <div>Hello <span>world</span></div>
@@ -6549,14 +6759,13 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
-        filter by the text content.
+        **Details**
 
-        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
-        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
 
-        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
-        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -6581,11 +6790,24 @@ def get_by_title(
     ) -> "Locator":
         """FrameLocator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
-        order\":
+        Allows locating elements by their title attribute.
+
+        **Usage**
+
+        Consider the following DOM structure.
 
         ```html
-        <button title='Place the order'>Order Now</button>
+        <span title='Issues count'>25 issues</span>
+        ```
+
+        You can check the issues count after locating it by the title text:
+
+        ```py
+        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
+        ```
+
+        ```py
+        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
         Parameters
@@ -10082,10 +10304,22 @@ def get_by_alt_text(
     ) -> "Locator":
         """Page.get_by_alt_text
 
-        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+        Allows locating elements by their alt text.
+
+        **Usage**
+
+        For example, this method will find the image by alt text \"Playwright logo\":
 
         ```html
-        <img alt='Castle'>
+        <img alt='Playwright logo'>
+        ```
+
+        ```py
+        await page.get_by_alt_text(\"Playwright logo\").click()
+        ```
+
+        ```py
+        page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
         Parameters
@@ -10111,14 +10345,25 @@ def get_by_label(
     ) -> "Locator":
         """Page.get_by_label
 
-        Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text \"Password\" in the following DOM:
+        Allows locating input elements by the text of the associated label.
+
+        **Usage**
+
+        For example, this method will find the input by label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
+        ```py
+        await page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
+        ```py
+        page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -10142,11 +10387,24 @@ def get_by_placeholder(
     ) -> "Locator":
         """Page.get_by_placeholder
 
-        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
-        \"Country\":
+        Allows locating input elements by the placeholder text.
+
+        **Usage**
+
+        For example, consider the following DOM structure.
 
         ```html
-        <input placeholder=\"Country\">
+        <input type=\"email\" placeholder=\"name@example.com\" />
+        ```
+
+        You can fill the input after locating it by the placeholder text:
+
+        ```py
+        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
+        ```
+
+        ```py
+        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
         Parameters
@@ -10267,14 +10525,48 @@ def get_by_role(
 
         Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
         [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
-        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
-        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <h3>Sign up</h3>
+        <label>
+          <input type=\"checkbox\" /> Subscribe
+        </label>
+        <br/>
+        <button>Submit</button>
+        ```
+
+        You can locate each element by it's implicit role:
+
+        ```py
+        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        ```py
+        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
 
-        Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
-        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
-        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
-        default values.
+        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        **Details**
+
+        Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
+        about the ARIA guidelines.
+
+        Many html elements have an implicitly [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings)
+        that is recognized by the role selector. You can find all the
+        [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not recommend**
+        duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
 
         Parameters
         ----------
@@ -10345,8 +10637,30 @@ def get_by_test_id(
     ) -> "Locator":
         """Page.get_by_test_id
 
-        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
-        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+        Locate element by the test id.
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <button data-testid=\"directions\">Itinéraire</button>
+        ```
+
+        You can locate the element by it's test id:
+
+        ```py
+        await page.get_by_test_id(\"directions\").click()
+        ```
+
+        ```py
+        page.get_by_test_id(\"directions\").click()
+        ```
+
+        **Details**
+
+        By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
+        configure a different test id attribute if necessary.
 
         Parameters
         ----------
@@ -10368,7 +10682,14 @@ def get_by_text(
     ) -> "Locator":
         """Page.get_by_text
 
-        Allows locating elements that contain given text. Consider the following DOM structure:
+        Allows locating elements that contain given text.
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **Usage**
+
+        Consider the following DOM structure:
 
         ```html
         <div>Hello <span>world</span></div>
@@ -10411,14 +10732,13 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
-        filter by the text content.
+        **Details**
 
-        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
-        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
 
-        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
-        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -10443,11 +10763,24 @@ def get_by_title(
     ) -> "Locator":
         """Page.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
-        order\":
+        Allows locating elements by their title attribute.
+
+        **Usage**
+
+        Consider the following DOM structure.
 
         ```html
-        <button title='Place the order'>Order Now</button>
+        <span title='Issues count'>25 issues</span>
+        ```
+
+        You can check the issues count after locating it by the title text:
+
+        ```py
+        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
+        ```
+
+        ```py
+        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
         Parameters
@@ -14803,19 +15136,32 @@ def last(self) -> "Locator":
 
         Returns locator to the last matching element.
 
-        Returns
-        -------
-        Locator
-        """
-        return mapping.from_impl(self._impl_obj.last)
+        **Usage**
 
-    def bounding_box(
+        ```py
+        banana = await page.get_by_role(\"listitem\").last()
+        ```
+
+        ```py
+        banana = page.get_by_role(\"listitem\").last()
+        ```
+
+        Returns
+        -------
+        Locator
+        """
+        return mapping.from_impl(self._impl_obj.last)
+
+    def bounding_box(
         self, *, timeout: typing.Optional[float] = None
     ) -> typing.Optional[FloatRect]:
         """Locator.bounding_box
 
-        This method returns the bounding box of the element, or `null` if the element is not visible. The bounding box is
-        calculated relative to the main frame viewport - which is usually the same as the browser window.
+        This method returns the bounding box of the element matching the locator, or `null` if the element is not visible.
+        The bounding box is calculated relative to the main frame viewport - which is usually the same as the browser
+        window.
+
+        **Details**
 
         Scrolling affects the returned bounding box, similarly to
         [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect).
@@ -14830,12 +15176,12 @@ def bounding_box(
         **Usage**
 
         ```py
-        box = await element.bounding_box()
+        box = await page.get_by_role(\"button\").bounding_box()
         await page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
         ```
 
         ```py
-        box = element.bounding_box()
+        box = page.get_by_role(\"button\").bounding_box()
         page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
         ```
 
@@ -14865,7 +15211,11 @@ def check(
     ) -> None:
         """Locator.check
 
-        This method checks the element by performing the following steps:
+        Ensure that checkbox or radio element is checked.
+
+        **Details**
+
+        Performs the following steps:
         1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already
            checked, this method returns immediately.
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
@@ -14879,6 +15229,16 @@ def check(
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
 
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"checkbox\").check()
+        ```
+
+        ```py
+        page.get_by_role(\"checkbox\").check()
+        ```
+
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
@@ -14942,6 +15302,32 @@ def click(
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
 
+        **Usage**
+
+        Click a button:
+
+        ```py
+        await page.get_by_role(\"button\").click()
+        ```
+
+        ```py
+        page.get_by_role(\"button\").click()
+        ```
+
+        Shift-right-click at a specific position on a canvas:
+
+        ```py
+        await page.locator(\"canvas\").click(
+            button=\"right\", modifiers=[\"Shift\"], position={\"x\": 23, \"y\": 32}
+        )
+        ```
+
+        ```py
+        page.locator(\"canvas\").click(
+            button=\"right\", modifiers=[\"Shift\"], position={\"x\": 23, \"y\": 32}
+        )
+        ```
+
         Parameters
         ----------
         modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
@@ -15002,6 +15388,10 @@ def dblclick(
     ) -> None:
         """Locator.dblclick
 
+        Double-click an element.
+
+        **Details**
+
         This method double clicks the element by performing the following steps:
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
@@ -15066,20 +15456,24 @@ def dispatch_event(
     ) -> None:
         """Locator.dispatch_event
 
-        The snippet below dispatches the `click` event on the element. Regardless of the visibility state of the element,
-        `click` is dispatched. This is equivalent to calling
-        [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
+        Programmaticaly dispatch an event on the matching element.
 
         **Usage**
 
         ```py
-        await element.dispatch_event(\"click\")
+        await locator.dispatch_event(\"click\")
         ```
 
         ```py
-        element.dispatch_event(\"click\")
+        locator.dispatch_event(\"click\")
         ```
 
+        **Details**
+
+        The snippet above dispatches the `click` event on the element. Regardless of the visibility state of the element,
+        `click` is dispatched. This is equivalent to calling
+        [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
+
         Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
@@ -15097,13 +15491,13 @@ def dispatch_event(
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = await page.evaluate_handle(\"new DataTransfer()\")
-        await element.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
+        await locator.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
         ```
 
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = page.evaluate_handle(\"new DataTransfer()\")
-        element.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
+        locator.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
         ```
 
         Parameters
@@ -15134,12 +15528,16 @@ def evaluate(
     ) -> typing.Any:
         """Locator.evaluate
 
-        Returns the return value of `expression`.
+        Execute JavaScript code in the page, taking the matching element as an argument.
 
-        This method passes this handle as the first argument to `expression`.
+        **Details**
 
-        If `expression` returns a [Promise], then `handle.evaluate` would wait for the promise to resolve and return its
-        value.
+        Returns the return value of `expression`, called with the matching element as a first argument, and `arg` as a
+        second argument.
+
+        If `expression` returns a [Promise], this method will wait for the promise to resolve and return its value.
+
+        If `expression` throws or rejects, this method throws.
 
         **Usage**
 
@@ -15182,22 +15580,27 @@ def evaluate_all(
     ) -> typing.Any:
         """Locator.evaluate_all
 
-        The method finds all elements matching the specified locator and passes an array of matched elements as a first
-        argument to `expression`. Returns the result of `expression` invocation.
+        Execute JavaScript code in the page, taking all matching elements as an argument.
 
-        If `expression` returns a [Promise], then `locator.evaluate_all()` would wait for the promise to resolve and
-        return its value.
+        **Details**
+
+        Returns the return value of `expression`, called with an array of all matching elements as a first argument, and
+        `arg` as a second argument.
+
+        If `expression` returns a [Promise], this method will wait for the promise to resolve and return its value.
+
+        If `expression` throws or rejects, this method throws.
 
         **Usage**
 
         ```py
-        elements = page.locator(\"div\")
-        div_counts = await elements.evaluate_all(\"(divs, min) => divs.length >= min\", 10)
+        locator = page.locator(\"div\")
+        more_than_ten = await locator.evaluate_all(\"(divs, min) => divs.length > min\", 10)
         ```
 
         ```py
-        elements = page.locator(\"div\")
-        div_counts = elements.evaluate_all(\"(divs, min) => divs.length >= min\", 10)
+        locator = page.locator(\"div\")
+        more_than_ten = locator.evaluate_all(\"(divs, min) => divs.length > min\", 10)
         ```
 
         Parameters
@@ -15230,15 +15633,20 @@ def evaluate_handle(
     ) -> "JSHandle":
         """Locator.evaluate_handle
 
-        Returns the return value of `expression` as a `JSHandle`.
+        Execute JavaScript code in the page, taking the matching element as an argument, and return a `JSHandle` with the
+        result.
 
-        This method passes this handle as the first argument to `expression`.
+        **Details**
+
+        Returns the return value of `expression` as a`JSHandle`, called with the matching element as a first argument, and
+        `arg` as a second argument.
 
         The only difference between `locator.evaluate()` and `locator.evaluate_handle()` is that
         `locator.evaluate_handle()` returns `JSHandle`.
 
-        If the function passed to the `locator.evaluate_handle()` returns a [Promise], then
-        `locator.evaluate_handle()` would wait for the promise to resolve and return its value.
+        If `expression` returns a [Promise], this method will wait for the promise to resolve and return its value.
+
+        If `expression` throws or rejects, this method throws.
 
         See `page.evaluate_handle()` for more details.
 
@@ -15276,6 +15684,20 @@ def fill(
     ) -> None:
         """Locator.fill
 
+        Set a value to the input field.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"textbox\").fill(\"example value\")
+        ```
+
+        ```py
+        page.get_by_role(\"textbox\").fill(\"example value\")
+        ```
+
+        **Details**
+
         This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an
         `input` event after filling. Note that you can pass an empty string to clear the input field.
 
@@ -15318,6 +15740,10 @@ def clear(
     ) -> None:
         """Locator.clear
 
+        Clear the input field.
+
+        **Details**
+
         This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
         `input` event after clearing.
 
@@ -15326,6 +15752,16 @@ def clear(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
         instead.
 
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"textbox\").clear()
+        ```
+
+        ```py
+        page.get_by_role(\"textbox\").clear()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -15394,10 +15830,22 @@ def get_by_alt_text(
     ) -> "Locator":
         """Locator.get_by_alt_text
 
-        Allows locating elements by their alt text. For example, this method will find the image by alt text \"Castle\":
+        Allows locating elements by their alt text.
+
+        **Usage**
+
+        For example, this method will find the image by alt text \"Playwright logo\":
 
         ```html
-        <img alt='Castle'>
+        <img alt='Playwright logo'>
+        ```
+
+        ```py
+        await page.get_by_alt_text(\"Playwright logo\").click()
+        ```
+
+        ```py
+        page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
         Parameters
@@ -15423,14 +15871,25 @@ def get_by_label(
     ) -> "Locator":
         """Locator.get_by_label
 
-        Allows locating input elements by the text of the associated label. For example, this method will find the input by
-        label text \"Password\" in the following DOM:
+        Allows locating input elements by the text of the associated label.
+
+        **Usage**
+
+        For example, this method will find the input by label text \"Password\" in the following DOM:
 
         ```html
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
+        ```py
+        await page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
+        ```py
+        page.get_by_label(\"Password\").fill(\"secret\")
+        ```
+
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -15454,11 +15913,24 @@ def get_by_placeholder(
     ) -> "Locator":
         """Locator.get_by_placeholder
 
-        Allows locating input elements by the placeholder text. For example, this method will find the input by placeholder
-        \"Country\":
+        Allows locating input elements by the placeholder text.
+
+        **Usage**
+
+        For example, consider the following DOM structure.
 
         ```html
-        <input placeholder=\"Country\">
+        <input type=\"email\" placeholder=\"name@example.com\" />
+        ```
+
+        You can fill the input after locating it by the placeholder text:
+
+        ```py
+        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
+        ```
+
+        ```py
+        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
         Parameters
@@ -15579,14 +16051,48 @@ def get_by_role(
 
         Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles),
         [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and
-        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name). Note that role selector **does not replace**
-        accessibility audits and conformance tests, but rather gives early feedback about the ARIA guidelines.
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <h3>Sign up</h3>
+        <label>
+          <input type=\"checkbox\" /> Subscribe
+        </label>
+        <br/>
+        <button>Submit</button>
+        ```
+
+        You can locate each element by it's implicit role:
+
+        ```py
+        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        ```py
+        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
+
+        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
+
+        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
+        ```
+
+        **Details**
 
-        Note that many html elements have an implicitly
-        [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings) that is recognized by the role selector.
-        You can find all the [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines
-        **do not recommend** duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to
-        default values.
+        Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
+        about the ARIA guidelines.
+
+        Many html elements have an implicitly [defined role](https://w3c.github.io/html-aam/#html-element-role-mappings)
+        that is recognized by the role selector. You can find all the
+        [supported roles here](https://www.w3.org/TR/wai-aria-1.2/#role_definitions). ARIA guidelines **do not recommend**
+        duplicating implicit roles and attributes by setting `role` and/or `aria-*` attributes to default values.
 
         Parameters
         ----------
@@ -15657,8 +16163,30 @@ def get_by_test_id(
     ) -> "Locator":
         """Locator.get_by_test_id
 
-        Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
-        `selectors.set_test_id_attribute()` to configure a different test id attribute if necessary.
+        Locate element by the test id.
+
+        **Usage**
+
+        Consider the following DOM structure.
+
+        ```html
+        <button data-testid=\"directions\">Itinéraire</button>
+        ```
+
+        You can locate the element by it's test id:
+
+        ```py
+        await page.get_by_test_id(\"directions\").click()
+        ```
+
+        ```py
+        page.get_by_test_id(\"directions\").click()
+        ```
+
+        **Details**
+
+        By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
+        configure a different test id attribute if necessary.
 
         Parameters
         ----------
@@ -15680,7 +16208,14 @@ def get_by_text(
     ) -> "Locator":
         """Locator.get_by_text
 
-        Allows locating elements that contain given text. Consider the following DOM structure:
+        Allows locating elements that contain given text.
+
+        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
+        filter by the text content.
+
+        **Usage**
+
+        Consider the following DOM structure:
 
         ```html
         <div>Hello <span>world</span></div>
@@ -15723,14 +16258,13 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        See also `locator.filter()` that allows to match by another criteria, like an accessible role, and then
-        filter by the text content.
+        **Details**
 
-        **NOTE** Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple
-        spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.
+        Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+        one, turns line breaks into spaces and ignores leading and trailing whitespace.
 
-        **NOTE** Input elements of the type `button` and `submit` are matched by their `value` instead of the text content.
-        For example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
+        Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+        example, locating by text `\"Log in\"` matches `<input type=button value=\"Log in\">`.
 
         Parameters
         ----------
@@ -15755,11 +16289,24 @@ def get_by_title(
     ) -> "Locator":
         """Locator.get_by_title
 
-        Allows locating elements by their title. For example, this method will find the button by its title \"Place the
-        order\":
+        Allows locating elements by their title attribute.
+
+        **Usage**
+
+        Consider the following DOM structure.
 
         ```html
-        <button title='Place the order'>Order Now</button>
+        <span title='Issues count'>25 issues</span>
+        ```
+
+        You can check the issues count after locating it by the title text:
+
+        ```py
+        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
+        ```
+
+        ```py
+        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
         Parameters
@@ -15780,10 +16327,10 @@ def get_by_title(
     def frame_locator(self, selector: str) -> "FrameLocator":
         """Locator.frame_locator
 
-        **Usage**
+        When working with iframes, you can create a frame locator that will enter the iframe and allow locating elements in
+        that iframe:
 
-        When working with iframes, you can create a frame locator that will enter the iframe and allow selecting elements
-        in that iframe:
+        **Usage**
 
         ```py
         locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
@@ -15812,8 +16359,8 @@ def element_handle(
     ) -> "ElementHandle":
         """Locator.element_handle
 
-        Resolves given locator to the first matching DOM element. If no elements matching the query are visible, waits for
-        them up to a given timeout. If multiple elements match the selector, throws.
+        Resolves given locator to the first matching DOM element. If there are no matching elements, waits for one. If
+        multiple elements match the locator, throws.
 
         Parameters
         ----------
@@ -15833,7 +16380,7 @@ def element_handle(
     def element_handles(self) -> typing.List["ElementHandle"]:
         """Locator.element_handles
 
-        Resolves given locator to all matching DOM elements.
+        Resolves given locator to all matching DOM elements. If there are no matching elements, returns an empty list.
 
         Returns
         -------
@@ -15847,6 +16394,16 @@ def nth(self, index: int) -> "Locator":
 
         Returns locator to the n-th matching element. It's zero based, `nth(0)` selects the first element.
 
+        **Usage**
+
+        ```py
+        banana = await page.get_by_role(\"listitem\").nth(2)
+        ```
+
+        ```py
+        banana = page.get_by_role(\"listitem\").nth(2)
+        ```
+
         Parameters
         ----------
         index : int
@@ -15913,7 +16470,7 @@ def filter(
     def focus(self, *, timeout: typing.Optional[float] = None) -> None:
         """Locator.focus
 
-        Calls [focus](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus) on the element.
+        Calls [focus](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus) on the matching element.
 
         Parameters
         ----------
@@ -15967,7 +16524,17 @@ def all(self) -> typing.List["Locator"]:
     def count(self) -> int:
         """Locator.count
 
-        Returns the number of elements matching given selector.
+        Returns the number of elements matching the locator.
+
+        **Usage**
+
+        ```py
+        count = await page.get_by_role(\"listitem\").count()
+        ```
+
+        ```py
+        count = page.get_by_role(\"listitem\").count()
+        ```
 
         Returns
         -------
@@ -15989,6 +16556,10 @@ def drag_to(
     ) -> None:
         """Locator.drag_to
 
+        Drag the source element towards the target element and drop it.
+
+        **Details**
+
         This method drags the locator to another target locator or target position. It will first move to the source
         element, perform a `mousedown`, then move to the target element or position and perform a `mouseup`.
 
@@ -16063,7 +16634,7 @@ def get_attribute(
     ) -> typing.Optional[str]:
         """Locator.get_attribute
 
-        Returns element attribute value.
+        Returns the matching element's attribute value.
 
         Parameters
         ----------
@@ -16096,6 +16667,20 @@ def hover(
     ) -> None:
         """Locator.hover
 
+        Hover over the matching element.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"link\").hover()
+        ```
+
+        ```py
+        page.get_by_role(\"link\").hover()
+        ```
+
+        **Details**
+
         This method hovers over the element by performing the following steps:
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
@@ -16145,7 +16730,7 @@ def hover(
     def inner_html(self, *, timeout: typing.Optional[float] = None) -> str:
         """Locator.inner_html
 
-        Returns the `element.innerHTML`.
+        Returns the [`element.innerHTML`](https://developer.mozilla.org/en-US/docs/Web/API/Element/innerHTML).
 
         Parameters
         ----------
@@ -16165,7 +16750,7 @@ def inner_html(self, *, timeout: typing.Optional[float] = None) -> str:
     def inner_text(self, *, timeout: typing.Optional[float] = None) -> str:
         """Locator.inner_text
 
-        Returns the `element.innerText`.
+        Returns the [`element.innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText).
 
         Parameters
         ----------
@@ -16185,9 +16770,22 @@ def inner_text(self, *, timeout: typing.Optional[float] = None) -> str:
     def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         """Locator.input_value
 
-        Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
+        Returns the value for the matching `<input>` or `<textarea>` or `<select>` element.
 
-        Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
+        **Usage**
+
+        ```py
+        value = await page.get_by_role(\"textbox\").input_value()
+        ```
+
+        ```py
+        value = page.get_by_role(\"textbox\").input_value()
+        ```
+
+        **Details**
+
+        Throws elements that are not an input, textarea or a select. However, if the element is inside the `<label>`
+        element that has an associated
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the
         control.
 
@@ -16211,6 +16809,16 @@ def is_checked(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is checked. Throws if the element is not a checkbox or radio input.
 
+        **Usage**
+
+        ```py
+        checked = await page.get_by_role(\"checkbox\").is_checked()
+        ```
+
+        ```py
+        checked = page.get_by_role(\"checkbox\").is_checked()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16231,6 +16839,16 @@ def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is disabled, the opposite of [enabled](https://playwright.dev/python/docs/actionability#enabled).
 
+        **Usage**
+
+        ```py
+        disabled = await page.get_by_role(\"button\").is_disabled()
+        ```
+
+        ```py
+        disabled = page.get_by_role(\"button\").is_disabled()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16251,6 +16869,16 @@ def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable).
 
+        **Usage**
+
+        ```py
+        editable = await page.get_by_role(\"textbox\").is_editable()
+        ```
+
+        ```py
+        editable = page.get_by_role(\"textbox\").is_editable()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16271,6 +16899,16 @@ def is_enabled(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [enabled](https://playwright.dev/python/docs/actionability#enabled).
 
+        **Usage**
+
+        ```py
+        enabled = await page.get_by_role(\"button\").is_enabled()
+        ```
+
+        ```py
+        enabled = page.get_by_role(\"button\").is_enabled()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16291,6 +16929,16 @@ def is_hidden(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).
 
+        **Usage**
+
+        ```py
+        hidden = await page.get_by_role(\"button\").is_hidden()
+        ```
+
+        ```py
+        hidden = page.get_by_role(\"button\").is_hidden()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16309,6 +16957,16 @@ def is_visible(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible).
 
+        **Usage**
+
+        ```py
+        visible = await page.get_by_role(\"button\").is_visible()
+        ```
+
+        ```py
+        visible = page.get_by_role(\"button\").is_visible()
+        ```
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16332,6 +16990,20 @@ def press(
     ) -> None:
         """Locator.press
 
+        Focuses the mathing element and presses a combintation of the keys.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"textbox\").press(\"Backspace\")
+        ```
+
+        ```py
+        page.get_by_role(\"textbox\").press(\"Backspace\")
+        ```
+
+        **Details**
+
         Focuses the element, and then uses `keyboard.down()` and `keyboard.up()`.
 
         `key` can specify the intended
@@ -16391,6 +17063,30 @@ def screenshot(
     ) -> bytes:
         """Locator.screenshot
 
+        Take a screenshot of the element matching the locator.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"link\").screenshot()
+        ```
+
+        ```py
+        page.get_by_role(\"link\").screenshot()
+        ```
+
+        Disable animations and save screenshot to a file:
+
+        ```py
+        await page.get_by_role(\"link\").screenshot(animations=\"disabled\", path=\"link.png\")
+        ```
+
+        ```py
+        page.get_by_role(\"link\").screenshot(animations=\"disabled\", path=\"link.png\")
+        ```
+
+        **Details**
+
         This method captures a screenshot of the page, clipped to the size and position of a particular element matching
         the locator. If the element is covered by other elements, it will not be actually visible on the screenshot. If the
         element is a scrollable container, only the currently scrolled content will be visible on the screenshot.
@@ -16620,6 +17316,48 @@ def set_input_files(
     ) -> None:
         """Locator.set_input_files
 
+        Upload file or multiple files into `<input type=file>`.
+
+        **Usage**
+
+        ```py
+        # Select one file
+        await page.get_by_label(\"Upload file\").set_input_files('myfile.pdf')
+
+        # Select multiple files
+        await page.get_by_label(\"Upload files\").set_input_files(['file1.txt', 'file2.txt'])
+
+        # Remove all the selected files
+        await page.get_by_label(\"Upload file\").set_input_files([])
+
+        # Upload buffer from memory
+        await page.get_by_label(\"Upload file\").set_input_files(
+            files=[
+                {\"name\": \"test.txt\", \"mimeType\": \"text/plain\", \"buffer\": b\"this is a test\"}
+            ],
+        )
+        ```
+
+        ```py
+        # Select one file
+        page.get_by_label(\"Upload file\").set_input_files('myfile.pdf')
+
+        # Select multiple files
+        page.get_by_label(\"Upload files\").set_input_files(['file1.txt', 'file2.txt'])
+
+        # Remove all the selected files
+        page.get_by_label(\"Upload file\").set_input_files([])
+
+        # Upload buffer from memory
+        page.get_by_label(\"Upload file\").set_input_files(
+            files=[
+                {\"name\": \"test.txt\", \"mimeType\": \"text/plain\", \"buffer\": b\"this is a test\"}
+            ],
+        )
+        ```
+
+        **Details**
+
         Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
         they are resolved relative to the current working directory. For empty array, clears the selected files.
 
@@ -16664,6 +17402,10 @@ def tap(
     ) -> None:
         """Locator.tap
 
+        Perform a tap gesture on the element matching the locator.
+
+        **Details**
+
         This method taps the element by performing the following steps:
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
@@ -16717,7 +17459,7 @@ def text_content(
     ) -> typing.Optional[str]:
         """Locator.text_content
 
-        Returns the `node.textContent`.
+        Returns the [`node.textContent`](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent).
 
         Parameters
         ----------
@@ -16809,7 +17551,21 @@ def uncheck(
     ) -> None:
         """Locator.uncheck
 
-        This method checks the element by performing the following steps:
+        Ensure that checkbox or radio element is unchecked.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"checkbox\").uncheck()
+        ```
+
+        ```py
+        page.get_by_role(\"checkbox\").uncheck()
+        ```
+
+        **Details**
+
+        This method unchecks the element by performing the following steps:
         1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already
            unchecked, this method returns immediately.
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
@@ -16859,6 +17615,16 @@ def all_inner_texts(self) -> typing.List[str]:
 
         Returns an array of `node.innerText` values for all matching nodes.
 
+        **Usage**
+
+        ```py
+        texts = await page.get_by_role(\"link\").all_inner_texts()
+        ```
+
+        ```py
+        texts = page.get_by_role(\"link\").all_inner_texts()
+        ```
+
         Returns
         -------
         List[str]
@@ -16871,6 +17637,16 @@ def all_text_contents(self) -> typing.List[str]:
 
         Returns an array of `node.textContent` values for all matching nodes.
 
+        **Usage**
+
+        ```py
+        texts = await page.get_by_role(\"link\").all_text_contents()
+        ```
+
+        ```py
+        texts = page.get_by_role(\"link\").all_text_contents()
+        ```
+
         Returns
         -------
         List[str]
@@ -16936,6 +17712,20 @@ def set_checked(
     ) -> None:
         """Locator.set_checked
 
+        Set the state of a checkbox or a radio element.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"checkbox\").set_checked(True)
+        ```
+
+        ```py
+        page.get_by_role(\"checkbox\").set_checked(True)
+        ```
+
+        **Details**
+
         This method checks or unchecks an element by performing the following steps:
         1. Ensure that matched element is a checkbox or a radio input. If not, this method throws.
         1. If the element already has the right checked state, this method returns immediately.
diff --git a/scripts/expected_api_mismatch.txt b/scripts/expected_api_mismatch.txt
index c9e9606d5..581817d73 100644
--- a/scripts/expected_api_mismatch.txt
+++ b/scripts/expected_api_mismatch.txt
@@ -8,9 +8,9 @@ Parameter not documented: Browser.new_page(default_browser_type=)
 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], Any], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any]]
+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], Any], None], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
-Parameter type mismatch in Page.route(handler=): documented as Callable[[Route, Request], Any], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any]]
+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]]
 Parameter type mismatch in Page.unroute(handler=): documented as Union[Callable[[Route, Request], Any], None], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
 
 # Temporary Fix
@@ -18,3 +18,4 @@ Method not implemented: Error.name
 Method not implemented: Error.stack
 Method not implemented: Error.message
 Method not implemented: PlaywrightAssertions.expect
+Method not implemented: Locator.viewport_ratio
diff --git a/setup.py b/setup.py
index c163ba8b9..00029b5f6 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.29.1"
+driver_version = "1.30.0-alpha-jan-16-2023"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 9a4587a40688847883956978e3227b1bd4d8277b Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 23 Jan 2023 14:51:59 +0100
Subject: [PATCH 035/438] chore(roll): roll to v1.30 (#1734)

---
 README.md                         | 2 +-
 scripts/expected_api_mismatch.txt | 5 ++---
 setup.py                          | 2 +-
 tests/async/test_fetch_global.py  | 4 ++--
 tests/async/test_page.py          | 2 +-
 tests/sync/test_fetch_global.py   | 4 ++--
 6 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 3bacdb735..e597e4778 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->109.0.5414.74<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->110.0.5481.38<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->108.0.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/scripts/expected_api_mismatch.txt b/scripts/expected_api_mismatch.txt
index 581817d73..4619a29f5 100644
--- a/scripts/expected_api_mismatch.txt
+++ b/scripts/expected_api_mismatch.txt
@@ -9,13 +9,12 @@ Parameter type mismatch in Accessibility.snapshot(return=): documented as Union[
 
 # 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], Any], None], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
+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]
 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]]
-Parameter type mismatch in Page.unroute(handler=): documented as Union[Callable[[Route, Request], Any], None], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
+Parameter type mismatch in Page.unroute(handler=): documented as Union[Callable[[Route, Request], Union[Any, Any]], None], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
 
 # Temporary Fix
 Method not implemented: Error.name
 Method not implemented: Error.stack
 Method not implemented: Error.message
 Method not implemented: PlaywrightAssertions.expect
-Method not implemented: Locator.viewport_ratio
diff --git a/setup.py b/setup.py
index 00029b5f6..6fd420340 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.30.0-alpha-jan-16-2023"
+driver_version = "1.30.0-beta-1674276599000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index 7b1591f8d..6a915fc49 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -70,9 +70,9 @@ async def test_should_support_global_user_agent_option(
 async def test_should_support_global_timeout_option(
     playwright: Playwright, server: Server
 ):
-    request = await playwright.request.new_context(timeout=1)
+    request = await playwright.request.new_context(timeout=100)
     server.set_route("/empty.html", lambda req: None)
-    with pytest.raises(Error, match="Request timed out after 1ms"):
+    with pytest.raises(Error, match="Request timed out after 100ms"):
         await request.get(server.EMPTY_PAGE)
 
 
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 47a23fcd2..fe2a5b45f 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -822,7 +822,7 @@ async def test_fill_should_throw_on_unsupported_inputs(page, server):
         )
         with pytest.raises(Error) as exc_info:
             await page.fill("input", "")
-        assert f'input of type "{type}" cannot be filled' in exc_info.value.message
+        assert f'Input of type "{type}" cannot be filled' in exc_info.value.message
 
 
 async def test_fill_should_fill_different_input_types(page, server):
diff --git a/tests/sync/test_fetch_global.py b/tests/sync/test_fetch_global.py
index 6cdf9b223..fc30cc00c 100644
--- a/tests/sync/test_fetch_global.py
+++ b/tests/sync/test_fetch_global.py
@@ -64,9 +64,9 @@ def test_should_support_global_user_agent_option(
 def test_should_support_global_timeout_option(
     playwright: Playwright, server: Server
 ) -> None:
-    request = playwright.request.new_context(timeout=1)
+    request = playwright.request.new_context(timeout=100)
     server.set_route("/empty.html", lambda req: None)
-    with pytest.raises(Error, match="Request timed out after 1ms"):
+    with pytest.raises(Error, match="Request timed out after 100ms"):
         request.get(server.EMPTY_PAGE)
 
 

From 5ba82253c4e898d6217f3bca284114002dd3dfa7 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 25 Jan 2023 15:52:48 +0000
Subject: [PATCH 036/438] chore(roll): roll to v1.30.0

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

diff --git a/setup.py b/setup.py
index 6fd420340..626396466 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.30.0-beta-1674276599000"
+driver_version = "1.30.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 6939e0f2c68c3de5a479b8ab9e0a9c757244f41f Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 3 Feb 2023 13:34:51 +0100
Subject: [PATCH 037/438] chore: fix page.pause() (#1749)

chore: fix page.pause
---
 playwright/_impl/_page.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 4f7a5d03b..1b930d950 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -955,7 +955,10 @@ def request(self) -> "APIRequestContext":
 
     async def pause(self) -> None:
         await asyncio.wait(
-            [self._browser_context._pause(), self._closed_or_crashed_future],
+            [
+                asyncio.create_task(self._browser_context._pause()),
+                self._closed_or_crashed_future,
+            ],
             return_when=asyncio.FIRST_COMPLETED,
         )
 

From 447892528c56e6d0bbdd09e4ac31a735a73f79d3 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 3 Feb 2023 14:50:35 +0100
Subject: [PATCH 038/438] chore: update pre-commit (#1750)

---
 .pre-commit-config.yaml                 |  6 +++---
 playwright/_impl/_browser.py            |  1 -
 playwright/_impl/_browser_context.py    |  1 -
 playwright/_impl/_network.py            |  1 -
 playwright/_impl/_page.py               |  1 -
 playwright/async_api/_generated.py      | 25 ++++++++++++++++---------
 playwright/sync_api/_context_manager.py |  7 +++++--
 playwright/sync_api/_generated.py       | 25 ++++++++++++++++---------
 scripts/generate_api.py                 |  1 +
 tests/async/test_har.py                 |  1 -
 tests/sync/test_har.py                  |  1 -
 11 files changed, 41 insertions(+), 29 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 6a46b88cc..f1d634094 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -2,7 +2,7 @@
 # See https://pre-commit.com/hooks.html for more hooks
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.3.0
+    rev: v4.4.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -15,7 +15,7 @@ repos:
       - id: check-executables-have-shebangs
       - id: check-merge-conflict
   - repo: https://github.com/psf/black
-    rev: 22.10.0
+    rev: 23.1.0
     hooks:
       - id: black
   - repo: https://github.com/pre-commit/mirrors-mypy
@@ -28,7 +28,7 @@ repos:
     hooks:
       - id: flake8
   - repo: https://github.com/pycqa/isort
-    rev: 5.10.1
+    rev: 5.12.0
     hooks:
       - id: isort
   - repo: local
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index a59f96cc0..e9d0dde1b 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -48,7 +48,6 @@
 
 
 class Browser(ChannelOwner):
-
     Events = SimpleNamespace(
         Disconnected="disconnected",
     )
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 07c9ae79e..2cad9af7b 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -73,7 +73,6 @@
 
 
 class BrowserContext(ChannelOwner):
-
     Events = SimpleNamespace(
         BackgroundPage="backgroundpage",
         Close="close",
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index bd8aa4221..894e802c7 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -545,7 +545,6 @@ def frame(self) -> "Frame":
 
 
 class WebSocket(ChannelOwner):
-
     Events = SimpleNamespace(
         Close="close",
         FrameReceived="framereceived",
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 1b930d950..a40fe4d10 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -102,7 +102,6 @@
 
 
 class Page(ChannelOwner):
-
     Events = SimpleNamespace(
         Close="close",
         Crash="crash",
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 497d481d5..0595f5751 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -7331,7 +7331,8 @@ def on(
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
+        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed.
+        """
 
     @typing.overload
     def on(
@@ -7341,7 +7342,8 @@ def on(
     ) -> None:
         """
         Emitted when the JavaScript
-        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched."""
+        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched.
+        """
 
     @typing.overload
     def on(
@@ -7403,7 +7405,8 @@ def on(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when the JavaScript [`load`](https://developer.mozilla.org/en-US/docs/Web/Events/load) event is dispatched."""
+        Emitted when the JavaScript [`load`](https://developer.mozilla.org/en-US/docs/Web/Events/load) event is dispatched.
+        """
 
     @typing.overload
     def on(
@@ -7628,7 +7631,8 @@ def once(
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
+        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed.
+        """
 
     @typing.overload
     def once(
@@ -7638,7 +7642,8 @@ def once(
     ) -> None:
         """
         Emitted when the JavaScript
-        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched."""
+        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched.
+        """
 
     @typing.overload
     def once(
@@ -7700,7 +7705,8 @@ def once(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when the JavaScript [`load`](https://developer.mozilla.org/en-US/docs/Web/Events/load) event is dispatched."""
+        Emitted when the JavaScript [`load`](https://developer.mozilla.org/en-US/docs/Web/Events/load) event is dispatched.
+        """
 
     @typing.overload
     def once(
@@ -12421,7 +12427,8 @@ def on(
         Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To
         only listen for requests from a particular page, use `page.on('request')`.
 
-        In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`."""
+        In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`.
+        """
 
     @typing.overload
     def on(
@@ -12552,7 +12559,8 @@ def once(
         Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To
         only listen for requests from a particular page, use `page.on('request')`.
 
-        In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`."""
+        In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`.
+        """
 
     @typing.overload
     def once(
@@ -14847,7 +14855,6 @@ def request(self) -> "APIRequest":
         return mapping.from_impl(self._impl_obj.request)
 
     def __getitem__(self, value: str) -> "BrowserType":
-
         return mapping.from_impl(self._impl_obj.__getitem__(value=value))
 
     def stop(self) -> None:
diff --git a/playwright/sync_api/_context_manager.py b/playwright/sync_api/_context_manager.py
index 5cae1ea1d..3b5c6d8b4 100644
--- a/playwright/sync_api/_context_manager.py
+++ b/playwright/sync_api/_context_manager.py
@@ -14,7 +14,7 @@
 
 import asyncio
 import sys
-from typing import Any, Optional, cast
+from typing import TYPE_CHECKING, Any, Optional, cast
 
 from greenlet import greenlet
 
@@ -26,13 +26,16 @@
 from playwright._impl._transport import PipeTransport
 from playwright.sync_api._generated import Playwright as SyncPlaywright
 
+if TYPE_CHECKING:
+    from asyncio.unix_events import AbstractChildWatcher
+
 
 class PlaywrightContextManager:
     def __init__(self) -> None:
         self._playwright: SyncPlaywright
         self._loop: asyncio.AbstractEventLoop
         self._own_loop = False
-        self._watcher: Optional[asyncio.AbstractChildWatcher] = None
+        self._watcher: Optional[AbstractChildWatcher] = None
 
     def __enter__(self) -> SyncPlaywright:
         try:
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 995985d55..5aa50a668 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -7433,7 +7433,8 @@ def on(
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
+        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed.
+        """
 
     @typing.overload
     def on(
@@ -7441,7 +7442,8 @@ def on(
     ) -> None:
         """
         Emitted when the JavaScript
-        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched."""
+        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched.
+        """
 
     @typing.overload
     def on(
@@ -7487,7 +7489,8 @@ def on(
     @typing.overload
     def on(self, event: Literal["load"], f: typing.Callable[["Page"], "None"]) -> None:
         """
-        Emitted when the JavaScript [`load`](https://developer.mozilla.org/en-US/docs/Web/Events/load) event is dispatched."""
+        Emitted when the JavaScript [`load`](https://developer.mozilla.org/en-US/docs/Web/Events/load) event is dispatched.
+        """
 
     @typing.overload
     def on(
@@ -7680,7 +7683,8 @@ def once(
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed."""
+        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed.
+        """
 
     @typing.overload
     def once(
@@ -7688,7 +7692,8 @@ def once(
     ) -> None:
         """
         Emitted when the JavaScript
-        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched."""
+        [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched.
+        """
 
     @typing.overload
     def once(
@@ -7736,7 +7741,8 @@ def once(
         self, event: Literal["load"], f: typing.Callable[["Page"], "None"]
     ) -> None:
         """
-        Emitted when the JavaScript [`load`](https://developer.mozilla.org/en-US/docs/Web/Events/load) event is dispatched."""
+        Emitted when the JavaScript [`load`](https://developer.mozilla.org/en-US/docs/Web/Events/load) event is dispatched.
+        """
 
     @typing.overload
     def once(
@@ -12515,7 +12521,8 @@ def on(
         Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To
         only listen for requests from a particular page, use `page.on('request')`.
 
-        In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`."""
+        In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`.
+        """
 
     @typing.overload
     def on(
@@ -12624,7 +12631,8 @@ def once(
         Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To
         only listen for requests from a particular page, use `page.on('request')`.
 
-        In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`."""
+        In order to intercept and mutate requests, see `browser_context.route()` or `page.route()`.
+        """
 
     @typing.overload
     def once(
@@ -14931,7 +14939,6 @@ def request(self) -> "APIRequest":
         return mapping.from_impl(self._impl_obj.request)
 
     def __getitem__(self, value: str) -> "BrowserType":
-
         return mapping.from_impl(self._impl_obj.__getitem__(value=value))
 
     def stop(self) -> None:
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index 9b2319158..a84327eac 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -289,6 +289,7 @@ def return_value(value: Any) -> List[str]:
 api_globals = globals()
 assert Serializable
 
+
 # Python 3.11+ does not treat default args with None as Optional anymore, this wrapper will still wrap them.
 # https://github.com/python/cpython/issues/90353
 def get_type_hints(func: Any, globalns: Any) -> Dict[str, Any]:
diff --git a/tests/async/test_har.py b/tests/async/test_har.py
index cd1c871a6..d2df88a28 100644
--- a/tests/async/test_har.py
+++ b/tests/async/test_har.py
@@ -486,7 +486,6 @@ async def test_should_fulfill_from_har_with_content_in_a_file(
 async def test_should_round_trip_har_zip(
     browser: Browser, server: Server, assetdir: Path, tmpdir: Path
 ) -> None:
-
     har_path = tmpdir / "har.zip"
     context_1 = await browser.new_context(
         record_har_mode="minimal", record_har_path=har_path
diff --git a/tests/sync/test_har.py b/tests/sync/test_har.py
index 81452c9de..33441826f 100644
--- a/tests/sync/test_har.py
+++ b/tests/sync/test_har.py
@@ -425,7 +425,6 @@ def test_should_fulfill_from_har_with_content_in_a_file(
 def test_should_round_trip_har_zip(
     browser: Browser, server: Server, assetdir: Path, tmpdir: Path
 ) -> None:
-
     har_path = tmpdir / "har.zip"
     context_1 = browser.new_context(record_har_mode="minimal", record_har_path=har_path)
     page_1 = context_1.new_page()

From 7c9a48af85e341abb79ae58ebd2bc1b8eb8c95f2 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 3 Feb 2023 21:30:17 +0100
Subject: [PATCH 039/438] chore: upgrade dev dependencies (#1752)

---
 local-requirements.txt | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 059328913..a252da3bd 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,24 +1,24 @@
-auditwheel==5.2.1
-autobahn==22.7.1
-black==22.10.0
+auditwheel==5.3.0
+autobahn==23.1.1
+black==23.1.0
 flake8==5.0.4
 flaky==3.7.0
 mypy==0.982
 objgraph==3.5.0
-Pillow==9.3.0
+Pillow==9.4.0
 pixelmatch==0.3.0
 pre-commit==2.20.0
-pyOpenSSL==22.1.0
-pytest==7.2.0
-pytest-asyncio==0.20.1
+pyOpenSSL==23.0.0
+pytest==7.2.1
+pytest-asyncio==0.20.3
 pytest-cov==4.0.0
 pytest-repeat==0.9.1
 pytest-timeout==2.1.0
-pytest-xdist==3.0.2
-requests==2.28.1
+pytest-xdist==3.1.0
+requests==2.28.2
 service_identity==21.1.0
-setuptools==65.5.1
-twine==4.0.1
+setuptools==67.1.0
+twine==4.0.2
 twisted==22.10.0
-types-pyOpenSSL==22.1.0.1
-wheel==0.38.1
+types-pyOpenSSL==23.0.0.2
+wheel==0.38.4

From 405de1841bfa8086ab28de14eca6a9ef7c27382d Mon Sep 17 00:00:00 2001
From: Pavel Feldman <pavel.feldman@gmail.com>
Date: Thu, 16 Feb 2023 09:45:54 -0800
Subject: [PATCH 040/438] Update CONTRIBUTING.md

---
 CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4df54ec44..809b8e997 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -22,7 +22,7 @@ pip install -r local-requirements.txt
 Build and install drivers:
 
 ```sh
-pip install -e.
+pip install -e .
 python setup.py bdist_wheel
 # For all platforms
 python setup.py bdist_wheel --all

From 3ffc9a942466089a8c66edccdfad18ee1999ff79 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 21 Feb 2023 19:44:08 +0100
Subject: [PATCH 041/438] chore(roll): roll to 1.31.0-beta-1676906983000
 (#1775)

---
 README.md                                  |   4 +-
 playwright/_impl/_api_structures.py        |   2 +-
 playwright/_impl/_assertions.py            |  19 +++
 playwright/_impl/_browser_context.py       |  21 ++--
 playwright/_impl/_helper.py                |  22 ++++
 playwright/_impl/_locator.py               |   2 +-
 playwright/_impl/_network.py               |  63 ++++++----
 playwright/_impl/_page.py                  |  21 ++--
 playwright/_impl/_str_utils.py             |  12 +-
 playwright/async_api/_generated.py         | 131 +++++++++++++++++---
 playwright/sync_api/_generated.py          | 133 ++++++++++++++++++---
 setup.py                                   |   2 +-
 tests/async/test_expect_misc.py            |  74 ++++++++++++
 tests/async/test_navigation.py             |   9 +-
 tests/async/test_page.py                   |   5 +-
 tests/async/test_page_network_response.py  |  72 +++++++++++
 tests/async/test_page_request_intercept.py |  16 +++
 tests/async/test_resource_timing.py        |   2 +-
 tests/async/test_selectors_get_by.py       |  93 +++++++++++++-
 tests/server.py                            |  10 +-
 tests/sync/test_expect_misc.py             |  72 +++++++++++
 tests/sync/test_page_network_response.py   |  66 ++++++++++
 tests/sync/test_page_request_fallback.py   |   2 +-
 tests/sync/test_request_intercept.py       |  16 +++
 tests/sync/test_resource_timing.py         |   2 +-
 25 files changed, 776 insertions(+), 95 deletions(-)
 create mode 100644 tests/async/test_expect_misc.py
 create mode 100644 tests/async/test_page_network_response.py
 create mode 100644 tests/sync/test_expect_misc.py
 create mode 100644 tests/sync/test_page_network_response.py

diff --git a/README.md b/README.md
index e597e4778..3bd3ec79d 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 -->110.0.5481.38<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->111.0.5563.19<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->108.0.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->109.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index ddbf3576a..b701555da 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -185,7 +185,7 @@ class ExpectedTextValue(TypedDict, total=False):
 class FrameExpectOptions(TypedDict, total=False):
     expressionArg: Any
     expectedText: Optional[List[ExpectedTextValue]]
-    expectedNumber: Optional[int]
+    expectedNumber: Optional[float]
     expectedValue: Optional[Any]
     useInnerText: Optional[bool]
     isNot: bool
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 2253bdabd..6f1948edd 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -618,6 +618,25 @@ async def not_to_be_focused(
         __tracebackhide__ = True
         await self._not.to_be_focused(timeout)
 
+    async def to_be_in_viewport(
+        self,
+        ratio: float = None,
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        await self._expect_impl(
+            "to.be.in.viewport",
+            FrameExpectOptions(timeout=timeout, expectedNumber=ratio),
+            None,
+            "Locator expected to be in viewport",
+        )
+
+    async def not_to_be_in_viewport(
+        self, ratio: float = None, timeout: float = None
+    ) -> None:
+        __tracebackhide__ = True
+        await self._not.to_be_in_viewport(ratio=ratio, timeout=timeout)
+
 
 class APIResponseAssertions:
     def __init__(self, response: APIResponse, is_not: bool = False) -> None:
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 2cad9af7b..4c1262e5f 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -191,7 +191,11 @@ async def _on_route(self, route: Route) -> None:
                 handled = await route_handler.handle(route)
             finally:
                 if len(self._routes) == 0:
-                    asyncio.create_task(self._disable_interception())
+                    asyncio.create_task(
+                        self._connection.wrap_api_call(
+                            lambda: self._update_interception_patterns(), True
+                        )
+                    )
             if handled:
                 return
         await route._internal_continue(is_internal=True)
@@ -304,10 +308,7 @@ async def route(
                 times,
             ),
         )
-        if len(self._routes) == 1:
-            await self._channel.send(
-                "setNetworkInterceptionEnabled", dict(enabled=True)
-            )
+        await self._update_interception_patterns()
 
     async def unroute(
         self, url: URLMatch, handler: Optional[RouteHandlerCallback] = None
@@ -318,8 +319,7 @@ async def unroute(
                 self._routes,
             )
         )
-        if len(self._routes) == 0:
-            await self._disable_interception()
+        await self._update_interception_patterns()
 
     async def _record_into_har(
         self,
@@ -360,8 +360,11 @@ async def route_from_har(
         )
         await router.add_context_route(self)
 
-    async def _disable_interception(self) -> None:
-        await self._channel.send("setNetworkInterceptionEnabled", dict(enabled=False))
+    async def _update_interception_patterns(self) -> None:
+        patterns = RouteHandler.prepare_interception_patterns(self._routes)
+        await self._channel.send(
+            "setNetworkInterceptionPatterns", {"patterns": patterns}
+        )
 
     def expect_event(
         self,
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index a9857591c..065ce101b 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -291,6 +291,28 @@ def impl() -> None:
     def will_expire(self) -> bool:
         return self._handled_count + 1 >= self._times
 
+    @staticmethod
+    def prepare_interception_patterns(
+        handlers: List["RouteHandler"],
+    ) -> List[Dict[str, str]]:
+        patterns = []
+        all = False
+        for handler in handlers:
+            if isinstance(handler.matcher.match, str):
+                patterns.append({"glob": handler.matcher.match})
+            elif isinstance(handler.matcher._regex_obj, re.Pattern):
+                patterns.append(
+                    {
+                        "regexSource": handler.matcher._regex_obj.pattern,
+                        "regexFlags": escape_regex_flags(handler.matcher._regex_obj),
+                    }
+                )
+            else:
+                all = True
+        if all:
+            return [{"glob": "**/*"}]
+        return patterns
+
 
 def is_safe_close_error(error: Exception) -> bool:
     message = str(error)
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index e233e6727..c70691c07 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -643,7 +643,7 @@ async def _expect(
             {
                 "selector": self._selector,
                 "expression": expression,
-                **options,
+                **({k: v for k, v in options.items() if v is not None}),
             },
         )
         if result.get("received"):
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 894e802c7..bdc960647 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -241,6 +241,11 @@ async def _actual_headers(self) -> "RawHeaders":
             self._all_headers_future.set_result(RawHeaders(headers))
         return await self._all_headers_future
 
+    def _target_closed_future(self) -> asyncio.Future:
+        if not hasattr(self.frame, "_page"):
+            return asyncio.Future()
+        return self.frame._page._closed_or_crashed_future
+
 
 class Route(ChannelOwner):
     def __init__(
@@ -348,10 +353,11 @@ async def fetch(
         method: str = None,
         headers: Dict[str, str] = None,
         postData: Union[Any, str, bytes] = None,
+        maxRedirects: int = None,
     ) -> "APIResponse":
         page = self.request.frame._page
         return await page.context.request._inner_fetch(
-            self.request, url, method, headers, postData
+            self.request, url, method, headers, postData, maxRedirects=maxRedirects
         )
 
     async def fallback(
@@ -419,30 +425,22 @@ async def _redirected_navigation_request(self, url: str) -> None:
         self._report_handled(True)
 
     async def _race_with_page_close(self, future: Coroutine) -> None:
-        if hasattr(self.request.frame, "_page"):
-            page = self.request.frame._page
-            # When page closes or crashes, we catch any potential rejects from this Route.
-            # Note that page could be missing when routing popup's initial request that
-            # does not have a Page initialized just yet.
-            fut = asyncio.create_task(future)
-            # Rewrite the user's stack to the new task which runs in the background.
-            setattr(
-                fut,
-                "__pw_stack__",
-                getattr(
-                    asyncio.current_task(self._loop), "__pw_stack__", inspect.stack()
-                ),
-            )
-            await asyncio.wait(
-                [fut, page._closed_or_crashed_future],
-                return_when=asyncio.FIRST_COMPLETED,
-            )
-            if fut.done() and fut.exception():
-                raise cast(BaseException, fut.exception())
-            if page._closed_or_crashed_future.done():
-                await asyncio.gather(fut, return_exceptions=True)
-        else:
-            await future
+        fut = asyncio.create_task(future)
+        # Rewrite the user's stack to the new task which runs in the background.
+        setattr(
+            fut,
+            "__pw_stack__",
+            getattr(asyncio.current_task(self._loop), "__pw_stack__", inspect.stack()),
+        )
+        target_closed_future = self.request._target_closed_future()
+        await asyncio.wait(
+            [fut, target_closed_future],
+            return_when=asyncio.FIRST_COMPLETED,
+        )
+        if fut.done() and fut.exception():
+            raise cast(BaseException, fut.exception())
+        if target_closed_future.done():
+            await asyncio.gather(fut, return_exceptions=True)
 
 
 class Response(ChannelOwner):
@@ -522,7 +520,20 @@ async def security_details(self) -> Optional[SecurityDetails]:
         return await self._channel.send("securityDetails")
 
     async def finished(self) -> None:
-        await self._finished_future
+        async def on_finished() -> None:
+            await self._request._target_closed_future()
+            raise Error("Target closed")
+
+        on_finished_task = asyncio.create_task(on_finished())
+        await asyncio.wait(
+            cast(
+                List[Union[asyncio.Task, asyncio.Future]],
+                [self._finished_future, on_finished_task],
+            ),
+            return_when=asyncio.FIRST_COMPLETED,
+        )
+        if on_finished_task.done():
+            await on_finished_task
 
     async def body(self) -> bytes:
         binary = await self._channel.send("body")
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index a40fe4d10..22a8f72c6 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -254,7 +254,11 @@ async def _on_route(self, route: Route) -> None:
                 handled = await route_handler.handle(route)
             finally:
                 if len(self._routes) == 0:
-                    asyncio.create_task(self._disable_interception())
+                    asyncio.create_task(
+                        self._connection.wrap_api_call(
+                            lambda: self._update_interception_patterns(), True
+                        )
+                    )
             if handled:
                 return
         await self._browser_context._on_route(route)
@@ -594,10 +598,7 @@ async def route(
                 times,
             ),
         )
-        if len(self._routes) == 1:
-            await self._channel.send(
-                "setNetworkInterceptionEnabled", dict(enabled=True)
-            )
+        await self._update_interception_patterns()
 
     async def unroute(
         self, url: URLMatch, handler: Optional[RouteHandlerCallback] = None
@@ -608,8 +609,7 @@ async def unroute(
                 self._routes,
             )
         )
-        if len(self._routes) == 0:
-            await self._disable_interception()
+        await self._update_interception_patterns()
 
     async def route_from_har(
         self,
@@ -629,8 +629,11 @@ async def route_from_har(
         )
         await router.add_page_route(self)
 
-    async def _disable_interception(self) -> None:
-        await self._channel.send("setNetworkInterceptionEnabled", dict(enabled=False))
+    async def _update_interception_patterns(self) -> None:
+        patterns = RouteHandler.prepare_interception_patterns(self._routes)
+        await self._channel.send(
+            "setNetworkInterceptionPatterns", {"patterns": patterns}
+        )
 
     async def screenshot(
         self,
diff --git a/playwright/_impl/_str_utils.py b/playwright/_impl/_str_utils.py
index 45c80184f..769f530de 100644
--- a/playwright/_impl/_str_utils.py
+++ b/playwright/_impl/_str_utils.py
@@ -48,5 +48,13 @@ def escape_for_text_selector(
 
 
 def escape_for_attribute_selector(value: str, exact: bool = None) -> str:
-    suffix = "" if exact else "i"
-    return '"' + value.replace('"', '\\"') + '"' + suffix
+    # TODO: this should actually be
+    #   cssEscape(value).replace(/\\ /g, ' ')
+    # However, our attribute selectors do not conform to CSS parsing spec,
+    # so we escape them differently.
+    return (
+        '"'
+        + value.replace("\\", "\\\\").replace('"', '\\"')
+        + '"'
+        + ("s" if exact else "i")
+    )
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 0595f5751..e8b8757ee 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -743,7 +743,8 @@ async def fetch(
         url: typing.Optional[str] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        max_redirects: typing.Optional[int] = None
     ) -> "APIResponse":
         """Route.fetch
 
@@ -772,6 +773,12 @@ def handle(route):
         page.route(\"https://dog.ceo/api/breeds/list/all\", handle)
         ```
 
+        **Details**
+
+        Note that `headers` option will apply to the fetched request as well as any redirects initiated by it. If you want
+        to only apply `headers` to the original request, but not to redirects, look into `route.continue_()`
+        instead.
+
         Parameters
         ----------
         url : Union[str, None]
@@ -784,6 +791,9 @@ def handle(route):
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
             header will be set to `application/octet-stream` if not explicitly set.
+        max_redirects : Union[int, None]
+            Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
+            exceeded. Defaults to `20`. Pass `0` to not follow redirects.
 
         Returns
         -------
@@ -796,6 +806,7 @@ def handle(route):
                 method=method,
                 headers=mapping.to_impl(headers),
                 postData=mapping.to_impl(post_data),
+                maxRedirects=max_redirects,
             )
         )
 
@@ -964,6 +975,12 @@ def handle(route, request):
         page.route(\"**/*\", handle)
         ```
 
+        **Details**
+
+        Note that any overrides such as `url` or `headers` only apply to the request being routed. If this request results
+        in a redirect, overrides will not be applied to the new redirected request. If you want to propagate a header
+        through redirects, use the combination of `route.fetch()` and `route.fulfill()` instead.
+
         Parameters
         ----------
         url : Union[str, None]
@@ -1508,6 +1525,8 @@ async def tap(self, x: float, y: float) -> None:
 
         Dispatches a `touchstart` and `touchend` event with a single touch at the position (`x`,`y`).
 
+        **NOTE** `page.tap()` the method will throw if `hasTouch` option of the browser context is false.
+
         Parameters
         ----------
         x : float
@@ -6858,6 +6877,8 @@ async def register(
     ) -> None:
         """Selectors.register
 
+        Selectors must be registered before creating the page.
+
         **Usage**
 
         An example of registering selector engine that queries elements based on a tag name:
@@ -6887,8 +6908,8 @@ async def run(playwright):
 
             # Use the selector prefixed with its name.
             button = await page.query_selector('tag=button')
-            # Combine it with other selector engines.
-            await page.locator('tag=div >> text=\"Click me\"').click()
+            # Combine it with built-in locators.
+            await page.locator('tag=div').get_by_text('Click me').click()
             # Can use it in any methods supporting selectors.
             button_count = await page.locator('tag=button').count()
             print(button_count)
@@ -6925,8 +6946,8 @@ def run(playwright):
 
             # Use the selector prefixed with its name.
             button = page.locator('tag=button')
-            # Combine it with other selector engines.
-            page.locator('tag=div >> text=\"Click me\"').click()
+            # Combine it with built-in locators.
+            page.locator('tag=div').get_by_text('Click me').click()
             # Can use it in any methods supporting selectors.
             button_count = page.locator('tag=button').count()
             print(button_count)
@@ -10090,7 +10111,7 @@ async def tap(
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
 
-        **NOTE** `page.tap()` requires that the `hasTouch` option of the browser context be set to true.
+        **NOTE** `page.tap()` the method will throw if `hasTouch` option of the browser context is false.
 
         Parameters
         ----------
@@ -15369,7 +15390,7 @@ async def dispatch_event(
     ) -> None:
         """Locator.dispatch_event
 
-        Programmaticaly dispatch an event on the matching element.
+        Programmatically dispatch an event on the matching element.
 
         **Usage**
 
@@ -16871,7 +16892,7 @@ async def press(
     ) -> None:
         """Locator.press
 
-        Focuses the mathing element and presses a combintation of the keys.
+        Focuses the matching element and presses a combination of the keys.
 
         **Usage**
 
@@ -17815,7 +17836,8 @@ async def delete(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -17892,7 +17914,8 @@ async def head(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -17981,7 +18004,8 @@ async def get(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -18058,7 +18082,8 @@ async def patch(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -18135,7 +18160,8 @@ async def put(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -18251,7 +18277,8 @@ async def post(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -18358,7 +18385,8 @@ async def fetch(
             If set changes the fetch method (e.g. [PUT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT) or
             [POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST)). If not specified, GET method is used.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -19966,6 +19994,79 @@ async def not_to_be_focused(
             await self._impl_obj.not_to_be_focused(timeout=timeout)
         )
 
+    async def to_be_in_viewport(
+        self,
+        *,
+        ratio: typing.Optional[float] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_be_in_viewport
+
+        Ensures the `Locator` points to an element that intersects viewport, according to the
+        [intersection observer API](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API).
+
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.get_by_role(\"button\")
+        # Make sure at least some part of element intersects viewport.
+        await expect(locator).to_be_in_viewport()
+        # Make sure element is fully outside of viewport.
+        await expect(locator).not_to_be_in_viewport()
+        # Make sure that at least half of the element intersects viewport.
+        await expect(locator).to_be_in_viewport(ratio=0.5)
+        ```
+
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.get_by_role(\"button\")
+        # Make sure at least some part of element intersects viewport.
+        expect(locator).to_be_in_viewport()
+        # Make sure element is fully outside of viewport.
+        expect(locator).not_to_be_in_viewport()
+        # Make sure that at least half of the element intersects viewport.
+        expect(locator).to_be_in_viewport(ratio=0.5)
+        ```
+
+        Parameters
+        ----------
+        ratio : Union[float, None]
+            The minimal ratio of the element to intersect viewport. If equals to `0`, then element should intersect viewport at
+            any positive ratio. Defaults to `0`.
+        timeout : Union[float, None]
+            Time to retry the assertion for.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.to_be_in_viewport(ratio=ratio, timeout=timeout)
+        )
+
+    async def not_to_be_in_viewport(
+        self,
+        *,
+        ratio: typing.Optional[float] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_be_in_viewport
+
+        The opposite of `locator_assertions.to_be_in_viewport()`.
+
+        Parameters
+        ----------
+        ratio : Union[float, None]
+        timeout : Union[float, None]
+            Time to retry the assertion for.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.not_to_be_in_viewport(ratio=ratio, timeout=timeout)
+        )
+
 
 mapping.register(LocatorAssertionsImpl, LocatorAssertions)
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 5aa50a668..c84abe680 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -753,7 +753,8 @@ def fetch(
         url: typing.Optional[str] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        max_redirects: typing.Optional[int] = None
     ) -> "APIResponse":
         """Route.fetch
 
@@ -782,6 +783,12 @@ def handle(route):
         page.route(\"https://dog.ceo/api/breeds/list/all\", handle)
         ```
 
+        **Details**
+
+        Note that `headers` option will apply to the fetched request as well as any redirects initiated by it. If you want
+        to only apply `headers` to the original request, but not to redirects, look into `route.continue_()`
+        instead.
+
         Parameters
         ----------
         url : Union[str, None]
@@ -794,6 +801,9 @@ def handle(route):
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
             header will be set to `application/octet-stream` if not explicitly set.
+        max_redirects : Union[int, None]
+            Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
+            exceeded. Defaults to `20`. Pass `0` to not follow redirects.
 
         Returns
         -------
@@ -807,6 +817,7 @@ def handle(route):
                     method=method,
                     headers=mapping.to_impl(headers),
                     postData=mapping.to_impl(post_data),
+                    maxRedirects=max_redirects,
                 )
             )
         )
@@ -978,6 +989,12 @@ def handle(route, request):
         page.route(\"**/*\", handle)
         ```
 
+        **Details**
+
+        Note that any overrides such as `url` or `headers` only apply to the request being routed. If this request results
+        in a redirect, overrides will not be applied to the new redirected request. If you want to propagate a header
+        through redirects, use the combination of `route.fetch()` and `route.fulfill()` instead.
+
         Parameters
         ----------
         url : Union[str, None]
@@ -1506,6 +1523,8 @@ def tap(self, x: float, y: float) -> None:
 
         Dispatches a `touchstart` and `touchend` event with a single touch at the position (`x`,`y`).
 
+        **NOTE** `page.tap()` the method will throw if `hasTouch` option of the browser context is false.
+
         Parameters
         ----------
         x : float
@@ -6972,6 +6991,8 @@ def register(
     ) -> None:
         """Selectors.register
 
+        Selectors must be registered before creating the page.
+
         **Usage**
 
         An example of registering selector engine that queries elements based on a tag name:
@@ -7001,8 +7022,8 @@ async def run(playwright):
 
             # Use the selector prefixed with its name.
             button = await page.query_selector('tag=button')
-            # Combine it with other selector engines.
-            await page.locator('tag=div >> text=\"Click me\"').click()
+            # Combine it with built-in locators.
+            await page.locator('tag=div').get_by_text('Click me').click()
             # Can use it in any methods supporting selectors.
             button_count = await page.locator('tag=button').count()
             print(button_count)
@@ -7039,8 +7060,8 @@ def run(playwright):
 
             # Use the selector prefixed with its name.
             button = page.locator('tag=button')
-            # Combine it with other selector engines.
-            page.locator('tag=div >> text=\"Click me\"').click()
+            # Combine it with built-in locators.
+            page.locator('tag=div').get_by_text('Click me').click()
             # Can use it in any methods supporting selectors.
             button_count = page.locator('tag=button').count()
             print(button_count)
@@ -10160,7 +10181,7 @@ def tap(
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
 
-        **NOTE** `page.tap()` requires that the `hasTouch` option of the browser context be set to true.
+        **NOTE** `page.tap()` the method will throw if `hasTouch` option of the browser context is false.
 
         Parameters
         ----------
@@ -15463,7 +15484,7 @@ def dispatch_event(
     ) -> None:
         """Locator.dispatch_event
 
-        Programmaticaly dispatch an event on the matching element.
+        Programmatically dispatch an event on the matching element.
 
         **Usage**
 
@@ -16997,7 +17018,7 @@ def press(
     ) -> None:
         """Locator.press
 
-        Focuses the mathing element and presses a combintation of the keys.
+        Focuses the matching element and presses a combination of the keys.
 
         **Usage**
 
@@ -17959,7 +17980,8 @@ def delete(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -18038,7 +18060,8 @@ def head(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -18129,7 +18152,8 @@ def get(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -18208,7 +18232,8 @@ def patch(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -18287,7 +18312,8 @@ def put(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -18405,7 +18431,8 @@ def post(
         params : Union[Dict[str, Union[bool, float, str]], None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -18514,7 +18541,8 @@ def fetch(
             If set changes the fetch method (e.g. [PUT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT) or
             [POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST)). If not specified, GET method is used.
         headers : Union[Dict[str, str], None]
-            Allows to set HTTP headers.
+            Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
+            it.
         data : Union[Any, bytes, str, None]
             Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string
             and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type`
@@ -20162,6 +20190,81 @@ def not_to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None:
             self._sync(self._impl_obj.not_to_be_focused(timeout=timeout))
         )
 
+    def to_be_in_viewport(
+        self,
+        *,
+        ratio: typing.Optional[float] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_be_in_viewport
+
+        Ensures the `Locator` points to an element that intersects viewport, according to the
+        [intersection observer API](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API).
+
+        **Usage**
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.get_by_role(\"button\")
+        # Make sure at least some part of element intersects viewport.
+        await expect(locator).to_be_in_viewport()
+        # Make sure element is fully outside of viewport.
+        await expect(locator).not_to_be_in_viewport()
+        # Make sure that at least half of the element intersects viewport.
+        await expect(locator).to_be_in_viewport(ratio=0.5)
+        ```
+
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.get_by_role(\"button\")
+        # Make sure at least some part of element intersects viewport.
+        expect(locator).to_be_in_viewport()
+        # Make sure element is fully outside of viewport.
+        expect(locator).not_to_be_in_viewport()
+        # Make sure that at least half of the element intersects viewport.
+        expect(locator).to_be_in_viewport(ratio=0.5)
+        ```
+
+        Parameters
+        ----------
+        ratio : Union[float, None]
+            The minimal ratio of the element to intersect viewport. If equals to `0`, then element should intersect viewport at
+            any positive ratio. Defaults to `0`.
+        timeout : Union[float, None]
+            Time to retry the assertion for.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.to_be_in_viewport(ratio=ratio, timeout=timeout))
+        )
+
+    def not_to_be_in_viewport(
+        self,
+        *,
+        ratio: typing.Optional[float] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_be_in_viewport
+
+        The opposite of `locator_assertions.to_be_in_viewport()`.
+
+        Parameters
+        ----------
+        ratio : Union[float, None]
+        timeout : Union[float, None]
+            Time to retry the assertion for.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.not_to_be_in_viewport(ratio=ratio, timeout=timeout)
+            )
+        )
+
 
 mapping.register(LocatorAssertionsImpl, LocatorAssertions)
 
diff --git a/setup.py b/setup.py
index 626396466..da75b45a3 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.30.0"
+driver_version = "1.31.0-beta-1676906983000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_expect_misc.py b/tests/async/test_expect_misc.py
new file mode 100644
index 000000000..414909b67
--- /dev/null
+++ b/tests/async/test_expect_misc.py
@@ -0,0 +1,74 @@
+# 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.async_api import Page, expect
+from tests.server import Server
+
+
+async def test_to_be_in_viewport_should_work(page: Page, server: Server) -> None:
+    await page.set_content(
+        """
+      <div id=big style="height: 10000px;"></div>
+      <div id=small>foo</div>
+    """
+    )
+    await expect(page.locator("#big")).to_be_in_viewport()
+    await expect(page.locator("#small")).not_to_be_in_viewport()
+    await page.locator("#small").scroll_into_view_if_needed()
+    await expect(page.locator("#small")).to_be_in_viewport()
+    await expect(page.locator("#small")).to_be_in_viewport(ratio=1)
+
+
+async def test_to_be_in_viewport_should_respect_ratio_option(
+    page: Page, server: Server
+) -> None:
+    await page.set_content(
+        """
+      <style>body, div, html { padding: 0; margin: 0; }</style>
+      <div id=big style="height: 400vh;"></div>
+    """
+    )
+    await expect(page.locator("div")).to_be_in_viewport()
+    await expect(page.locator("div")).to_be_in_viewport(ratio=0.1)
+    await expect(page.locator("div")).to_be_in_viewport(ratio=0.2)
+
+    await expect(page.locator("div")).to_be_in_viewport(ratio=0.25)
+    # In this test, element's ratio is 0.25.
+    await expect(page.locator("div")).not_to_be_in_viewport(ratio=0.26)
+
+    await expect(page.locator("div")).not_to_be_in_viewport(ratio=0.3)
+    await expect(page.locator("div")).not_to_be_in_viewport(ratio=0.7)
+    await expect(page.locator("div")).not_to_be_in_viewport(ratio=0.8)
+
+
+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)
+    assert 'unexpected value "viewport ratio' in str(exc_info.value)
+
+
+async def test_to_be_in_viewport_should_report_intersection_even_if_fully_covered_by_other_element(
+    page: Page, server: Server
+) -> None:
+    await page.set_content(
+        """
+      <h1>hello</h1>
+      <div style="position: relative; height: 10000px; top: -5000px;></div>
+    """
+    )
+    await expect(page.locator("h1")).to_be_in_viewport()
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index 3a921373e..565ee2140 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -887,7 +887,7 @@ async def test_frame_goto_should_navigate_subframes(page, server):
     assert response.frame == page.frames[1]
 
 
-async def test_frame_goto_should_reject_when_frame_detaches(page, server):
+async def test_frame_goto_should_reject_when_frame_detaches(page, server, browser_name):
     await page.goto(server.PREFIX + "/frames/one-frame.html")
 
     await page.route("**/empty.html", lambda route, request: None)
@@ -895,7 +895,12 @@ async def test_frame_goto_should_reject_when_frame_detaches(page, server):
     asyncio.create_task(page.eval_on_selector("iframe", "frame => frame.remove()"))
     with pytest.raises(Error) as exc_info:
         await navigation_task
-    assert "frame was detached" in exc_info.value.message
+    if browser_name == "chromium":
+        assert ("frame was detached" in exc_info.value.message) or (
+            "net::ERR_ABORTED" in exc_info.value.message
+        )
+    else:
+        assert "frame was detached" in exc_info.value.message
 
 
 async def test_frame_goto_should_continue_after_client_redirect(page, server):
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index fe2a5b45f..54abccb9d 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -563,13 +563,12 @@ async def test_set_content_should_respect_default_navigation_timeout(page, serve
 
 
 async def test_set_content_should_await_resources_to_load(page, server):
-    img_path = "/img.png"
     img_route = asyncio.Future()
-    await page.route(img_path, lambda route, request: img_route.set_result(route))
+    await page.route("**/img.png", lambda route, request: img_route.set_result(route))
     loaded = []
 
     async def load():
-        await page.set_content(f'<img src="{server.PREFIX + img_path}"></img>')
+        await page.set_content(f'<img src="{server.PREFIX}/img.png"></img>')
         loaded.append(True)
 
     content_promise = asyncio.create_task(load())
diff --git a/tests/async/test_page_network_response.py b/tests/async/test_page_network_response.py
new file mode 100644
index 000000000..52dd6e64a
--- /dev/null
+++ b/tests/async/test_page_network_response.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
+from tests.server import HttpRequestWithPostBody, Server
+
+
+async def test_should_reject_response_finished_if_page_closes(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+
+    def handle_get(request: HttpRequestWithPostBody):
+        # In Firefox, |fetch| will be hanging until it receives |Content-Type| header
+        # from server.
+        request.setHeader("Content-Type", "text/plain; charset=utf-8")
+        request.write(b"hello ")
+
+    server.set_route("/get", handle_get)
+    # send request and wait for server response
+    [page_response, _] = await asyncio.gather(
+        page.wait_for_event("response"),
+        page.evaluate("() => fetch('./get', { method: 'GET' })"),
+    )
+
+    finish_coroutine = page_response.finished()
+    await page.close()
+    with pytest.raises(Exception) as exc_info:
+        await finish_coroutine
+    error = exc_info.value
+    assert "closed" in error.message
+
+
+async def test_should_reject_response_finished_if_context_closes(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+
+    def handle_get(request: HttpRequestWithPostBody):
+        # In Firefox, |fetch| will be hanging until it receives |Content-Type| header
+        # from server.
+        request.setHeader("Content-Type", "text/plain; charset=utf-8")
+        request.write(b"hello ")
+
+    server.set_route("/get", handle_get)
+    # send request and wait for server response
+    [page_response, _] = await asyncio.gather(
+        page.wait_for_event("response"),
+        page.evaluate("() => fetch('./get', { method: 'GET' })"),
+    )
+
+    finish_coroutine = page_response.finished()
+    await page.context.close()
+    with pytest.raises(Exception) as exc_info:
+        await finish_coroutine
+    error = exc_info.value
+    assert "closed" in error.message
diff --git a/tests/async/test_page_request_intercept.py b/tests/async/test_page_request_intercept.py
index 9b41d9630..bda57cf44 100644
--- a/tests/async/test_page_request_intercept.py
+++ b/tests/async/test_page_request_intercept.py
@@ -18,6 +18,22 @@
 from tests.server import Server
 
 
+async def test_should_not_follow_redirects_when_max_redirects_is_set_to_0_in_route_fetch(
+    server: Server, page: Page
+):
+    server.set_redirect("/foo", "/empty.html")
+
+    async def handle(route: Route):
+        response = await route.fetch(max_redirects=0)
+        assert response.headers["location"] == "/empty.html"
+        assert response.status == 302
+        await route.fulfill(body="hello")
+
+    await page.route("**/*", lambda route: handle(route))
+    await page.goto(server.PREFIX + "/foo")
+    assert "hello" in await page.content()
+
+
 async def test_should_intercept_with_url_override(server: Server, page: Page):
     async def handle(route: Route):
         response = await route.fetch(url=server.PREFIX + "/one-style.html")
diff --git a/tests/async/test_resource_timing.py b/tests/async/test_resource_timing.py
index a948b9f6c..17ea0e10b 100644
--- a/tests/async/test_resource_timing.py
+++ b/tests/async/test_resource_timing.py
@@ -32,7 +32,7 @@ async def test_should_work(page, server):
 
 @flaky
 async def test_should_work_for_subresource(page, server, is_win, is_mac, is_webkit):
-    if is_webkit and is_win:
+    if is_webkit and (is_mac or is_win):
         pytest.skip()
     requests = []
     page.on("requestfinished", lambda request: requests.append(request))
diff --git a/tests/async/test_selectors_get_by.py b/tests/async/test_selectors_get_by.py
index 46a3ef1bc..88cb50947 100644
--- a/tests/async/test_selectors_get_by.py
+++ b/tests/async/test_selectors_get_by.py
@@ -12,7 +12,80 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from playwright.async_api import Page
+from playwright.async_api import Page, expect
+
+
+async def test_get_by_escaping(page: Page) -> None:
+    await page.set_content(
+        """
+        <label id=label for=control>Hello my
+wo"rld</label><input id=control />"""
+    )
+    await page.eval_on_selector(
+        "input",
+        """input => {
+        input.setAttribute('placeholder', 'hello my\\nwo"rld');
+        input.setAttribute('title', 'hello my\\nwo"rld');
+        input.setAttribute('alt', 'hello my\\nwo"rld');
+    }""",
+    )
+    await expect(page.get_by_text('hello my\nwo"rld')).to_have_attribute("id", "label")
+    await expect(page.get_by_text('hello       my     wo"rld')).to_have_attribute(
+        "id", "label"
+    )
+    await expect(page.get_by_label('hello my\nwo"rld')).to_have_attribute(
+        "id", "control"
+    )
+    await expect(page.get_by_placeholder('hello my\nwo"rld')).to_have_attribute(
+        "id", "control"
+    )
+    await expect(page.get_by_alt_text('hello my\nwo"rld')).to_have_attribute(
+        "id", "control"
+    )
+    await expect(page.get_by_title('hello my\nwo"rld')).to_have_attribute(
+        "id", "control"
+    )
+
+    await page.set_content(
+        """
+        <label id=label for=control>Hello my
+world</label><input id=control />"""
+    )
+    await page.eval_on_selector(
+        "input",
+        """input => {
+        input.setAttribute('placeholder', 'hello my\\nworld');
+        input.setAttribute('title', 'hello my\\nworld');
+        input.setAttribute('alt', 'hello my\\nworld');
+    }""",
+    )
+    await expect(page.get_by_text("hello my\nworld")).to_have_attribute("id", "label")
+    await expect(page.get_by_text("hello        my    world")).to_have_attribute(
+        "id", "label"
+    )
+    await expect(page.get_by_label("hello my\nworld")).to_have_attribute(
+        "id", "control"
+    )
+    await expect(page.get_by_placeholder("hello my\nworld")).to_have_attribute(
+        "id", "control"
+    )
+    await expect(page.get_by_alt_text("hello my\nworld")).to_have_attribute(
+        "id", "control"
+    )
+    await expect(page.get_by_title("hello my\nworld")).to_have_attribute(
+        "id", "control"
+    )
+
+    await page.set_content("""<div id=target title="my title">Text here</div>""")
+    await expect(page.get_by_title("my title", exact=True)).to_have_count(
+        1, timeout=500
+    )
+    await expect(page.get_by_title("my t\\itle", exact=True)).to_have_count(
+        0, timeout=500
+    )
+    await expect(page.get_by_title("my t\\\\itle", exact=True)).to_have_count(
+        0, timeout=500
+    )
 
 
 async def test_get_by_role_escaping(
@@ -70,3 +143,21 @@ async def test_get_by_role_escaping(
     ).evaluate_all("els => els.map(e => e.outerHTML)") == [
         """<a href="https://playwright.dev">he llo 56</a>""",
     ]
+
+    assert await page.get_by_role("button", name="Click me", exact=True).evaluate_all(
+        "els => els.map(e => e.outerHTML)"
+    ) == [
+        "<button>Click me</button>",
+    ]
+    assert (
+        await page.get_by_role("button", name="Click \\me", exact=True).evaluate_all(
+            "els => els.map(e => e.outerHTML)"
+        )
+        == []
+    )
+    assert (
+        await page.get_by_role("button", name="Click \\\\me", exact=True).evaluate_all(
+            "els => els.map(e => e.outerHTML)"
+        )
+        == []
+    )
diff --git a/tests/server.py b/tests/server.py
index fd3f6e36f..9b486af3c 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -42,7 +42,7 @@ def find_free_port() -> int:
         return s.getsockname()[1]
 
 
-class HttpRequestWitPostBody(http.Request):
+class HttpRequestWithPostBody(http.Request):
     post_body = None
 
 
@@ -162,20 +162,20 @@ class MyHttpFactory(http.HTTPFactory):
 
         self.listen(MyHttpFactory())
 
-    async def wait_for_request(self, path: str) -> HttpRequestWitPostBody:
+    async def wait_for_request(self, path: str) -> HttpRequestWithPostBody:
         if path in self.request_subscribers:
             return await self.request_subscribers[path]
-        future: asyncio.Future["HttpRequestWitPostBody"] = asyncio.Future()
+        future: asyncio.Future["HttpRequestWithPostBody"] = asyncio.Future()
         self.request_subscribers[path] = future
         return await future
 
     @contextlib.contextmanager
     def expect_request(
         self, path: str
-    ) -> Generator[ExpectResponse[HttpRequestWitPostBody], None, None]:
+    ) -> Generator[ExpectResponse[HttpRequestWithPostBody], None, None]:
         future = asyncio.create_task(self.wait_for_request(path))
 
-        cb_wrapper: ExpectResponse[HttpRequestWitPostBody] = ExpectResponse()
+        cb_wrapper: ExpectResponse[HttpRequestWithPostBody] = ExpectResponse()
 
         def done_cb(task: asyncio.Task) -> None:
             cb_wrapper._value = future.result()
diff --git a/tests/sync/test_expect_misc.py b/tests/sync/test_expect_misc.py
new file mode 100644
index 000000000..042929fde
--- /dev/null
+++ b/tests/sync/test_expect_misc.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 pytest
+
+from playwright.sync_api import Page, expect
+from tests.server import Server
+
+
+def test_to_be_in_viewport_should_work(page: Page) -> None:
+    page.set_content(
+        """
+      <div id=big style="height: 10000px;"></div>
+      <div id=small>foo</div>
+    """
+    )
+    expect(page.locator("#big")).to_be_in_viewport()
+    expect(page.locator("#small")).not_to_be_in_viewport()
+    page.locator("#small").scroll_into_view_if_needed()
+    expect(page.locator("#small")).to_be_in_viewport()
+    expect(page.locator("#small")).to_be_in_viewport(ratio=1)
+
+
+def test_to_be_in_viewport_should_respect_ratio_option(
+    page: Page, server: Server
+) -> None:
+    page.set_content(
+        """
+      <style>body, div, html { padding: 0; margin: 0; }</style>
+      <div id=big style="height: 400vh;"></div>
+    """
+    )
+    expect(page.locator("div")).to_be_in_viewport()
+    expect(page.locator("div")).to_be_in_viewport(ratio=0.1)
+    expect(page.locator("div")).to_be_in_viewport(ratio=0.2)
+
+    expect(page.locator("div")).to_be_in_viewport(ratio=0.25)
+    # In this test, element's ratio is 0.25.
+    expect(page.locator("div")).not_to_be_in_viewport(ratio=0.26)
+
+    expect(page.locator("div")).not_to_be_in_viewport(ratio=0.3)
+    expect(page.locator("div")).not_to_be_in_viewport(ratio=0.7)
+    expect(page.locator("div")).not_to_be_in_viewport(ratio=0.8)
+
+
+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)
+    assert 'unexpected value "viewport ratio' in str(exc_info.value)
+
+
+def test_to_be_in_viewport_should_report_intersection_even_if_fully_covered_by_other_element(
+    page: Page, server: Server
+) -> None:
+    page.set_content(
+        """
+      <h1>hello</h1>
+      <div style="position: relative; height: 10000px; top: -5000px;></div>
+    """
+    )
+    expect(page.locator("h1")).to_be_in_viewport()
diff --git a/tests/sync/test_page_network_response.py b/tests/sync/test_page_network_response.py
new file mode 100644
index 000000000..4f4213d0d
--- /dev/null
+++ b/tests/sync/test_page_network_response.py
@@ -0,0 +1,66 @@
+# 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 twisted.web import http
+
+from playwright.sync_api import Error, Page
+from tests.server import Server
+
+
+def test_should_reject_response_finished_if_page_closes(
+    page: Page, server: Server
+) -> None:
+    page.goto(server.EMPTY_PAGE)
+
+    def handle_get(request: http.Request) -> None:
+        # In Firefox, |fetch| will be hanging until it receives |Content-Type| header
+        # from server.
+        request.setHeader("Content-Type", "text/plain; charset=utf-8")
+        request.write(b"hello ")
+
+    server.set_route("/get", handle_get)
+    # send request and wait for server response
+    with page.expect_response("**/*") as response_info:
+        page.evaluate("() => fetch('./get', { method: 'GET' })")
+    page_response = response_info.value
+    page.close()
+    with pytest.raises(Error) as exc_info:
+        page_response.finished()
+    error = exc_info.value
+    assert "closed" in error.message
+
+
+def test_should_reject_response_finished_if_context_closes(
+    page: Page, server: Server
+) -> None:
+    page.goto(server.EMPTY_PAGE)
+
+    def handle_get(request: http.Request) -> None:
+        # In Firefox, |fetch| will be hanging until it receives |Content-Type| header
+        # from server.
+        request.setHeader("Content-Type", "text/plain; charset=utf-8")
+        request.write(b"hello ")
+
+    server.set_route("/get", handle_get)
+    # send request and wait for server response
+    with page.expect_response("**/*") as response_info:
+        page.evaluate("() => fetch('./get', { method: 'GET' })")
+    page_response = response_info.value
+
+    page.context.close()
+    with pytest.raises(Error) as exc_info:
+        page_response.finished()
+    error = exc_info.value
+    assert "closed" in error.message
diff --git a/tests/sync/test_page_request_fallback.py b/tests/sync/test_page_request_fallback.py
index b77ffb234..09a3c9845 100644
--- a/tests/sync/test_page_request_fallback.py
+++ b/tests/sync/test_page_request_fallback.py
@@ -345,6 +345,6 @@ def handler(route: Route) -> None:
     )
 
     with server.expect_request("/sleep.zzz") as server_request:
-        page.evaluate("() => fetch('/sleep.zzz', { method: 'POST', body: 'birdy' })"),
+        page.evaluate("() => fetch('/sleep.zzz', { method: 'POST', body: 'birdy' })")
     assert post_data == ['{"foo": "bar"}']
     assert server_request.value.post_body == b'{"foo": "bar"}'
diff --git a/tests/sync/test_request_intercept.py b/tests/sync/test_request_intercept.py
index dc714e832..8df41c0c2 100644
--- a/tests/sync/test_request_intercept.py
+++ b/tests/sync/test_request_intercept.py
@@ -20,6 +20,22 @@
 from tests.server import Server
 
 
+def test_should_not_follow_redirects_when_max_redirects_is_set_to_0_in_route_fetch(
+    server: Server, page: Page
+) -> None:
+    server.set_redirect("/foo", "/empty.html")
+
+    def handle(route: Route) -> None:
+        response = route.fetch(max_redirects=0)
+        assert response.headers["location"] == "/empty.html"
+        assert response.status == 302
+        route.fulfill(body="hello")
+
+    page.route("**/*", lambda route: handle(route))
+    page.goto(server.PREFIX + "/foo")
+    assert "hello" in page.content()
+
+
 def test_should_fulfill_intercepted_response(page: Page, server: Server) -> None:
     def handle(route: Route) -> None:
         response = page.request.fetch(route.request)
diff --git a/tests/sync/test_resource_timing.py b/tests/sync/test_resource_timing.py
index 447ab97a2..dcfcc48df 100644
--- a/tests/sync/test_resource_timing.py
+++ b/tests/sync/test_resource_timing.py
@@ -37,7 +37,7 @@ def test_should_work(page: Page, server: Server) -> None:
 def test_should_work_for_subresource(
     page: Page, server: Server, is_win: bool, is_mac: bool, is_webkit: bool
 ) -> None:
-    if is_webkit and is_mac:
+    if is_webkit and (is_mac or is_win):
         pytest.skip()
     requests = []
     page.on("requestfinished", lambda request: requests.append(request))

From 51c1504f559f5b3055cd48fc6d860d24bbc8462b Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 21 Feb 2023 23:38:14 +0100
Subject: [PATCH 042/438] chore: use v1.31.0

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

diff --git a/setup.py b/setup.py
index da75b45a3..b3f15d5b1 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.31.0-beta-1676906983000"
+driver_version = "1.31.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 29fe478f15c93a16af227d919257f7adb209dcb1 Mon Sep 17 00:00:00 2001
From: Nazar <goshkonazar@gmail.com>
Date: Thu, 23 Feb 2023 13:40:42 +0200
Subject: [PATCH 043/438] feat: add support for custom expect message (#1737)

Co-authored-by: Max Schmitt <max@schmitt.mx>
---
 .gitignore                       |  2 ++
 playwright/_impl/_assertions.py  | 51 ++++++++++++++++++++++----------
 playwright/async_api/__init__.py | 20 ++++++++-----
 playwright/sync_api/__init__.py  | 20 ++++++++-----
 tests/async/test_assertions.py   | 13 ++++++++
 tests/sync/test_assertions.py    | 13 ++++++++
 6 files changed, 87 insertions(+), 32 deletions(-)

diff --git a/.gitignore b/.gitignore
index 8deb4777f..919e041a6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,6 +4,8 @@ playwright/driver/
 playwright.egg-info/
 build/
 dist/
+venv/
+.idea/
 **/*.pyc
 env/
 htmlcov/
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 6f1948edd..2022dc7ef 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -24,11 +24,14 @@
 
 
 class AssertionsBase:
-    def __init__(self, locator: Locator, is_not: bool = False) -> None:
+    def __init__(
+        self, locator: Locator, is_not: bool = False, message: Optional[str] = None
+    ) -> None:
         self._actual_locator = locator
         self._loop = locator._loop
         self._dispatcher_fiber = locator._dispatcher_fiber
         self._is_not = is_not
+        self._custom_message = message
 
     async def _expect_impl(
         self,
@@ -51,21 +54,27 @@ async def _expect_impl(
             log = "\n".join(result.get("log", "")).strip()
             if log:
                 log = "\nCall log:\n" + log
-            if expected is not None:
-                raise AssertionError(
-                    f"{message} '{expected}'\nActual value: {actual} {log}"
+            if self._custom_message:
+                out_message = (
+                    f"{self._custom_message}\nExpected value: {expected or '<None>'}"
+                )
+            else:
+                out_message = (
+                    f"{message} '{expected}'" if expected is not None else f"{message}"
                 )
-            raise AssertionError(f"{message}\nActual value: {actual} {log}")
+            raise AssertionError(f"{out_message}\nActual value: {actual} {log}")
 
 
 class PageAssertions(AssertionsBase):
-    def __init__(self, page: Page, is_not: bool = False) -> None:
-        super().__init__(page.locator(":root"), is_not)
+    def __init__(
+        self, page: Page, is_not: bool = False, message: Optional[str] = None
+    ) -> None:
+        super().__init__(page.locator(":root"), is_not, message)
         self._actual_page = page
 
     @property
     def _not(self) -> "PageAssertions":
-        return PageAssertions(self._actual_page, not self._is_not)
+        return PageAssertions(self._actual_page, not self._is_not, self._custom_message)
 
     async def to_have_title(
         self, title_or_reg_exp: Union[Pattern[str], str], timeout: float = None
@@ -110,13 +119,17 @@ async def not_to_have_url(
 
 
 class LocatorAssertions(AssertionsBase):
-    def __init__(self, locator: Locator, is_not: bool = False) -> None:
-        super().__init__(locator, is_not)
+    def __init__(
+        self, locator: Locator, is_not: bool = False, message: Optional[str] = None
+    ) -> None:
+        super().__init__(locator, is_not, message)
         self._actual_locator = locator
 
     @property
     def _not(self) -> "LocatorAssertions":
-        return LocatorAssertions(self._actual_locator, not self._is_not)
+        return LocatorAssertions(
+            self._actual_locator, not self._is_not, self._custom_message
+        )
 
     async def to_contain_text(
         self,
@@ -639,15 +652,20 @@ async def not_to_be_in_viewport(
 
 
 class APIResponseAssertions:
-    def __init__(self, response: APIResponse, is_not: bool = False) -> None:
+    def __init__(
+        self, response: APIResponse, is_not: bool = False, message: Optional[str] = None
+    ) -> None:
         self._loop = response._loop
         self._dispatcher_fiber = response._dispatcher_fiber
         self._is_not = is_not
         self._actual = response
+        self._custom_message = message
 
     @property
     def _not(self) -> "APIResponseAssertions":
-        return APIResponseAssertions(self._actual, not self._is_not)
+        return APIResponseAssertions(
+            self._actual, not self._is_not, self._custom_message
+        )
 
     async def to_be_ok(
         self,
@@ -658,18 +676,19 @@ async def to_be_ok(
         message = f"Response status expected to be within [200..299] range, was '{self._actual.status}'"
         if self._is_not:
             message = message.replace("expected to", "expected not to")
+        out_message = self._custom_message or message
         log_list = await self._actual._fetch_log()
         log = "\n".join(log_list).strip()
         if log:
-            message += f"\n Call log:\n{log}"
+            out_message += f"\n Call log:\n{log}"
 
         content_type = self._actual.headers.get("content-type")
         is_text_encoding = content_type and is_textual_mime_type(content_type)
         text = await self._actual.text() if is_text_encoding else None
         if text is not None:
-            message += f"\n Response Text:\n{text[:1000]}"
+            out_message += f"\n Response Text:\n{text[:1000]}"
 
-        raise AssertionError(message)
+        raise AssertionError(out_message)
 
     async def not_to_be_ok(self) -> None:
         __tracebackhide__ = True
diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index 4c505de2b..59e972c6d 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.py
@@ -18,7 +18,7 @@
 web automation that is ever-green, capable, reliable and fast.
 """
 
-from typing import Union, overload
+from typing import Optional, Union, overload
 
 import playwright._impl._api_structures
 import playwright._impl._api_types
@@ -88,29 +88,33 @@ def async_playwright() -> PlaywrightContextManager:
 
 
 @overload
-def expect(actual: Page) -> PageAssertions:
+def expect(actual: Page, message: Optional[str] = None) -> PageAssertions:
     ...
 
 
 @overload
-def expect(actual: Locator) -> LocatorAssertions:
+def expect(actual: Locator, message: Optional[str] = None) -> LocatorAssertions:
     ...
 
 
 @overload
-def expect(actual: APIResponse) -> APIResponseAssertions:
+def expect(actual: APIResponse, message: Optional[str] = None) -> APIResponseAssertions:
     ...
 
 
 def expect(
-    actual: Union[Page, Locator, APIResponse]
+    actual: Union[Page, Locator, APIResponse], message: Optional[str] = None
 ) -> Union[PageAssertions, LocatorAssertions, APIResponseAssertions]:
     if isinstance(actual, Page):
-        return PageAssertions(PageAssertionsImpl(actual._impl_obj))
+        return PageAssertions(PageAssertionsImpl(actual._impl_obj, message=message))
     elif isinstance(actual, Locator):
-        return LocatorAssertions(LocatorAssertionsImpl(actual._impl_obj))
+        return LocatorAssertions(
+            LocatorAssertionsImpl(actual._impl_obj, message=message)
+        )
     elif isinstance(actual, APIResponse):
-        return APIResponseAssertions(APIResponseAssertionsImpl(actual._impl_obj))
+        return APIResponseAssertions(
+            APIResponseAssertionsImpl(actual._impl_obj, message=message)
+        )
     raise ValueError(f"Unsupported type: {type(actual)}")
 
 
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index f1f6319e4..cf624b040 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -18,7 +18,7 @@
 web automation that is ever-green, capable, reliable and fast.
 """
 
-from typing import Union, overload
+from typing import Optional, Union, overload
 
 import playwright._impl._api_structures
 import playwright._impl._api_types
@@ -88,29 +88,33 @@ def sync_playwright() -> PlaywrightContextManager:
 
 
 @overload
-def expect(actual: Page) -> PageAssertions:
+def expect(actual: Page, message: Optional[str] = None) -> PageAssertions:
     ...
 
 
 @overload
-def expect(actual: Locator) -> LocatorAssertions:
+def expect(actual: Locator, message: Optional[str] = None) -> LocatorAssertions:
     ...
 
 
 @overload
-def expect(actual: APIResponse) -> APIResponseAssertions:
+def expect(actual: APIResponse, message: Optional[str] = None) -> APIResponseAssertions:
     ...
 
 
 def expect(
-    actual: Union[Page, Locator, APIResponse]
+    actual: Union[Page, Locator, APIResponse], message: Optional[str] = None
 ) -> Union[PageAssertions, LocatorAssertions, APIResponseAssertions]:
     if isinstance(actual, Page):
-        return PageAssertions(PageAssertionsImpl(actual._impl_obj))
+        return PageAssertions(PageAssertionsImpl(actual._impl_obj, message=message))
     elif isinstance(actual, Locator):
-        return LocatorAssertions(LocatorAssertionsImpl(actual._impl_obj))
+        return LocatorAssertions(
+            LocatorAssertionsImpl(actual._impl_obj, message=message)
+        )
     elif isinstance(actual, APIResponse):
-        return APIResponseAssertions(APIResponseAssertionsImpl(actual._impl_obj))
+        return APIResponseAssertions(
+            APIResponseAssertionsImpl(actual._impl_obj, message=message)
+        )
     raise ValueError(f"Unsupported type: {type(actual)}")
 
 
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 561c84105..1300dd447 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -658,3 +658,16 @@ async def test_should_print_response_with_text_content_type_if_to_be_ok_fails(
     assert "← 404 Not Found" in error_message
     assert "Response Text:" not in error_message
     assert "Image content type error" not in error_message
+
+
+async def test_should_print_users_message_for_page_based_assertion(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.set_content("<title>new title</title>")
+    with pytest.raises(AssertionError) as excinfo:
+        await expect(page, "Title is not new").to_have_title("old title", timeout=100)
+    assert "Title is not new" in str(excinfo.value)
+    with pytest.raises(AssertionError) as excinfo:
+        await expect(page).to_have_title("old title", timeout=100)
+    assert "Page title expected to be" in str(excinfo.value)
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 165f77788..288b4500f 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -746,3 +746,16 @@ def test_should_print_response_with_text_content_type_if_to_be_ok_fails(
     assert "← 404 Not Found" in error_message
     assert "Response Text:" not in error_message
     assert "Image content type error" not in error_message
+
+
+def test_should_print_users_message_for_page_based_assertion(
+    page: Page, server: Server
+) -> None:
+    page.goto(server.EMPTY_PAGE)
+    page.set_content("<title>new title</title>")
+    with pytest.raises(AssertionError) as excinfo:
+        expect(page, "Title is not new").to_have_title("old title", timeout=100)
+    assert "Title is not new" in str(excinfo.value)
+    with pytest.raises(AssertionError) as excinfo:
+        expect(page).to_have_title("old title", timeout=100)
+    assert "Page title expected to be" in str(excinfo.value)

From 92bb1d04132406fc5e2f0e086abbe1d1d1fe89c5 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 23 Feb 2023 23:10:04 +0100
Subject: [PATCH 044/438] chore: custom expect messages follow-up (#1780)

---
 playwright/_impl/_assertions.py |  6 +++---
 tests/async/test_assertions.py  | 17 +++++++++++++++++
 tests/sync/test_assertions.py   | 15 +++++++++++++++
 3 files changed, 35 insertions(+), 3 deletions(-)

diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 2022dc7ef..975bf2801 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -55,9 +55,9 @@ async def _expect_impl(
             if log:
                 log = "\nCall log:\n" + log
             if self._custom_message:
-                out_message = (
-                    f"{self._custom_message}\nExpected value: {expected or '<None>'}"
-                )
+                out_message = self._custom_message
+                if expected is not None:
+                    out_message += f"\nExpected value: '{expected or '<None>'}'"
             else:
                 out_message = (
                     f"{message} '{expected}'" if expected is not None else f"{message}"
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 1300dd447..b2eb6a850 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -671,3 +671,20 @@ async def test_should_print_users_message_for_page_based_assertion(
     with pytest.raises(AssertionError) as excinfo:
         await expect(page).to_have_title("old title", timeout=100)
     assert "Page title expected to be" in str(excinfo.value)
+
+
+async def test_should_print_expected_value_with_custom_message(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.set_content("<title>new title</title>")
+    with pytest.raises(AssertionError) as excinfo:
+        await expect(page, "custom-message").to_have_title("old title", timeout=100)
+    assert "custom-message" in str(excinfo.value)
+    assert "Expected value: 'old title'" in str(excinfo.value)
+    with pytest.raises(AssertionError) as excinfo:
+        await expect(page.get_by_text("hello"), "custom-message").to_be_visible(
+            timeout=100
+        )
+    assert "custom-message" in str(excinfo.value)
+    assert "Expected value" not in str(excinfo.value)
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 288b4500f..768c46d7d 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -759,3 +759,18 @@ def test_should_print_users_message_for_page_based_assertion(
     with pytest.raises(AssertionError) as excinfo:
         expect(page).to_have_title("old title", timeout=100)
     assert "Page title expected to be" in str(excinfo.value)
+
+
+def test_should_print_expected_value_with_custom_message(
+    page: Page, server: Server
+) -> None:
+    page.goto(server.EMPTY_PAGE)
+    page.set_content("<title>new title</title>")
+    with pytest.raises(AssertionError) as excinfo:
+        expect(page, "custom-message").to_have_title("old title", timeout=100)
+    assert "custom-message" in str(excinfo.value)
+    assert "Expected value: 'old title'" in str(excinfo.value)
+    with pytest.raises(AssertionError) as excinfo:
+        expect(page.get_by_text("hello"), "custom-message").to_be_visible(timeout=100)
+    assert "custom-message" in str(excinfo.value)
+    assert "Expected value" not in str(excinfo.value)

From 324458189692aae4230a5dc159a9418c4e6d75a6 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 6 Mar 2023 17:51:56 +0100
Subject: [PATCH 045/438] fix: throw when driver crashes (#1798)

---
 playwright/_impl/_transport.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index 92dfeb163..5565c62b7 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -154,6 +154,10 @@ async def run(self) -> 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)
 

From e45a219569b6bbe3933f0ab5e651fba53d5f84da Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 15 Mar 2023 17:27:42 +0100
Subject: [PATCH 046/438] test: make wheel tests pass on CR/darwin (#1811)

---
 tests/async/test_input.py | 43 ++++++++++++++++++++++++++++-----------
 1 file changed, 31 insertions(+), 12 deletions(-)

diff --git a/tests/async/test_input.py b/tests/async/test_input.py
index 34a3ecb4c..f93e44fc5 100644
--- a/tests/async/test_input.py
+++ b/tests/async/test_input.py
@@ -15,6 +15,7 @@
 import asyncio
 import os
 import re
+import sys
 
 import pytest
 
@@ -241,7 +242,21 @@ async def test_should_work_for_webkitdirectory(page):
     assert file_chooser.is_multiple()
 
 
-async def test_wheel_should_work(page: Page, server):
+def _assert_wheel_event(expected, received, browser_name):
+    # Chromium reports deltaX/deltaY scaled by host device scale factor.
+    # https://bugs.chromium.org/p/chromium/issues/detail?id=1324819
+    # https://github.com/microsoft/playwright/issues/7362
+    # Different bots have different scale factors (usually 1 or 2), so we just ignore the values
+    # instead of guessing the host scale factor.
+    if sys.platform == "darwin" and browser_name == "chromium":
+        del expected["deltaX"]
+        del expected["deltaY"]
+        del received["deltaX"]
+        del received["deltaY"]
+    assert received == expected
+
+
+async def test_wheel_should_work(page: Page, server, browser_name: str):
     await page.set_content(
         """
         <div style="width: 5000px; height: 5000px;"></div>
@@ -250,17 +265,21 @@ async def test_wheel_should_work(page: Page, server):
     await page.mouse.move(50, 60)
     await _listen_for_wheel_events(page, "div")
     await page.mouse.wheel(0, 100)
-    assert await page.evaluate("window.lastEvent") == {
-        "deltaX": 0,
-        "deltaY": 100,
-        "clientX": 50,
-        "clientY": 60,
-        "deltaMode": 0,
-        "ctrlKey": False,
-        "shiftKey": False,
-        "altKey": False,
-        "metaKey": False,
-    }
+    _assert_wheel_event(
+        await page.evaluate("window.lastEvent"),
+        {
+            "deltaX": 0,
+            "deltaY": 100,
+            "clientX": 50,
+            "clientY": 60,
+            "deltaMode": 0,
+            "ctrlKey": False,
+            "shiftKey": False,
+            "altKey": False,
+            "metaKey": False,
+        },
+        browser_name,
+    )
     await page.wait_for_function("window.scrollY === 100")
 
 

From 344c56f9646e8e3d9c3d7f59f6341d506d6ef3aa Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 16 Mar 2023 09:13:39 +0100
Subject: [PATCH 047/438] chore: roll Playwright to 1.32.0-alpha-mar-15-2023
 (#1812)

---
 README.md                            |   4 +-
 playwright/_impl/_browser_context.py |  16 +-
 playwright/_impl/_connection.py      |  87 +++--
 playwright/_impl/_local_utils.py     |   8 +-
 playwright/_impl/_locator.py         |  29 +-
 playwright/_impl/_page.py            |   8 +-
 playwright/_impl/_tracing.py         |  60 +++-
 playwright/async_api/_generated.py   | 482 ++++++++++++++-------------
 playwright/sync_api/_generated.py    | 482 ++++++++++++++-------------
 scripts/expected_api_mismatch.txt    |   1 -
 setup.py                             |   2 +-
 tests/async/test_element_handle.py   |   8 +-
 tests/async/test_har.py              |  31 +-
 tests/async/test_locators.py         |  69 +++-
 tests/async/test_navigation.py       |  18 +-
 tests/async/test_tracing.py          |  13 +-
 tests/sync/test_element_handle.py    |  12 +-
 tests/sync/test_har.py               |  33 +-
 tests/sync/test_locators.py          |  58 +++-
 tests/sync/test_tracing.py           |  13 +-
 20 files changed, 881 insertions(+), 553 deletions(-)

diff --git a/README.md b/README.md
index 3bd3ec79d..c7b9f0639 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 -->111.0.5563.19<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->112.0.5615.20<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->109.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->110.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 4c1262e5f..42d59b7ee 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -48,6 +48,8 @@
 from playwright._impl._frame import Frame
 from playwright._impl._har_router import HarRouter
 from playwright._impl._helper import (
+    HarContentPolicy,
+    HarMode,
     HarRecordingMetadata,
     RouteFromHarNotFoundPolicy,
     RouteHandler,
@@ -326,13 +328,15 @@ async def _record_into_har(
         har: Union[Path, str],
         page: Optional[Page] = None,
         url: Union[Pattern[str], str] = None,
+        content: HarContentPolicy = None,
+        mode: HarMode = None,
     ) -> None:
         params: Dict[str, Any] = {
             "options": prepare_record_har_options(
                 {
                     "recordHarPath": har,
-                    "recordHarContent": "attach",
-                    "recordHarMode": "minimal",
+                    "recordHarContent": content or "attach",
+                    "recordHarMode": mode or "minimal",
                     "recordHarUrlFilter": url,
                 }
             )
@@ -340,7 +344,7 @@ async def _record_into_har(
         if page:
             params["page"] = page._channel
         har_id = await self._channel.send("harStart", params)
-        self._har_recorders[har_id] = {"path": str(har), "content": "attach"}
+        self._har_recorders[har_id] = {"path": str(har), "content": content or "attach"}
 
     async def route_from_har(
         self,
@@ -348,9 +352,13 @@ async def route_from_har(
         url: Union[Pattern[str], str] = None,
         not_found: RouteFromHarNotFoundPolicy = None,
         update: bool = None,
+        content: HarContentPolicy = None,
+        mode: HarMode = None,
     ) -> None:
         if update:
-            await self._record_into_har(har=har, page=None, url=url)
+            await self._record_into_har(
+                har=har, page=None, url=url, content=content, mode=mode
+            )
             return
         router = await HarRouter.create(
             local_utils=self._connection.local_utils,
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 08652e3e4..88bf1b5a0 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -14,6 +14,7 @@
 
 import asyncio
 import contextvars
+import datetime
 import inspect
 import sys
 import traceback
@@ -33,6 +34,12 @@
     from playwright._impl._playwright import Playwright
 
 
+if sys.version_info >= (3, 8):  # pragma: no cover
+    from typing import TypedDict
+else:  # pragma: no cover
+    from typing_extensions import TypedDict
+
+
 class Channel(AsyncIOEventEmitter):
     def __init__(self, connection: "Connection", guid: str) -> None:
         super().__init__()
@@ -220,10 +227,11 @@ def __init__(
         self._error: Optional[BaseException] = None
         self.is_remote = False
         self._init_task: Optional[asyncio.Task] = None
-        self._api_zone: contextvars.ContextVar[Optional[Dict]] = contextvars.ContextVar(
-            "ApiZone", default=None
-        )
+        self._api_zone: contextvars.ContextVar[
+            Optional[ParsedStackTrace]
+        ] = contextvars.ContextVar("ApiZone", default=None)
         self._local_utils: Optional["LocalUtils"] = local_utils
+        self._stack_collector: List[List[Dict[str, Any]]] = []
 
     @property
     def local_utils(self) -> "LocalUtils":
@@ -271,6 +279,13 @@ def call_on_object_with_known_name(
     ) -> None:
         self._waiting_for_object[guid] = callback
 
+    def start_collecting_call_metadata(self, collector: Any) -> None:
+        if collector not in self._stack_collector:
+            self._stack_collector.append(collector)
+
+    def stop_collecting_call_metadata(self, collector: Any) -> None:
+        self._stack_collector.remove(collector)
+
     def _send_message_to_server(
         self, guid: str, method: str, params: Dict
     ) -> ProtocolCallback:
@@ -283,12 +298,30 @@ def _send_message_to_server(
             getattr(task, "__pw_stack_trace__", traceback.extract_stack()),
         )
         self._callbacks[id] = callback
+        stack_trace_information = cast(ParsedStackTrace, self._api_zone.get())
+        for collector in self._stack_collector:
+            collector.append({"stack": stack_trace_information["frames"], "id": id})
+        frames = stack_trace_information.get("frames", [])
+        location = (
+            {
+                "file": frames[0]["file"],
+                "line": frames[0]["line"],
+                "column": frames[0]["column"],
+            }
+            if len(frames) > 0
+            else None
+        )
         message = {
             "id": id,
             "guid": guid,
             "method": method,
             "params": self._replace_channels_with_guids(params),
-            "metadata": self._api_zone.get(),
+            "metadata": {
+                "wallTime": int(datetime.datetime.now().timestamp() * 1000),
+                "apiName": stack_trace_information["apiName"],
+                "location": location,
+                "internal": not stack_trace_information["apiName"],
+            },
         }
         self._transport.send(message)
         self._callbacks[id] = callback
@@ -412,9 +445,7 @@ async def wrap_api_call(
             return await cb()
         task = asyncio.current_task(self._loop)
         st: List[inspect.FrameInfo] = getattr(task, "__pw_stack__", inspect.stack())
-        metadata = _extract_metadata_from_stack(st, is_internal)
-        if metadata:
-            self._api_zone.set(metadata)
+        self._api_zone.set(_extract_stack_trace_information_from_stack(st, is_internal))
         try:
             return await cb()
         finally:
@@ -427,9 +458,7 @@ def wrap_api_call_sync(
             return cb()
         task = asyncio.current_task(self._loop)
         st: List[inspect.FrameInfo] = getattr(task, "__pw_stack__", inspect.stack())
-        metadata = _extract_metadata_from_stack(st, is_internal)
-        if metadata:
-            self._api_zone.set(metadata)
+        self._api_zone.set(_extract_stack_trace_information_from_stack(st, is_internal))
         try:
             return cb()
         finally:
@@ -444,19 +473,25 @@ def from_nullable_channel(channel: Optional[Channel]) -> Optional[Any]:
     return channel._object if channel else None
 
 
-def _extract_metadata_from_stack(
+class StackFrame(TypedDict):
+    file: str
+    line: int
+    column: int
+    function: Optional[str]
+
+
+class ParsedStackTrace(TypedDict):
+    frames: List[StackFrame]
+    apiName: Optional[str]
+
+
+def _extract_stack_trace_information_from_stack(
     st: List[inspect.FrameInfo], is_internal: bool
-) -> Optional[Dict]:
-    if is_internal:
-        return {
-            "apiName": "",
-            "stack": [],
-            "internal": True,
-        }
+) -> Optional[ParsedStackTrace]:
     playwright_module_path = str(Path(playwright.__file__).parents[0])
     last_internal_api_name = ""
     api_name = ""
-    stack: List[Dict] = []
+    parsed_frames: List[StackFrame] = []
     for frame in st:
         is_playwright_internal = frame.filename.startswith(playwright_module_path)
 
@@ -466,10 +501,11 @@ def _extract_metadata_from_stack(
         method_name += frame[0].f_code.co_name
 
         if not is_playwright_internal:
-            stack.append(
+            parsed_frames.append(
                 {
                     "file": frame.filename,
                     "line": frame.lineno,
+                    "column": 0,
                     "function": method_name,
                 }
             )
@@ -480,9 +516,8 @@ def _extract_metadata_from_stack(
             last_internal_api_name = ""
     if not api_name:
         api_name = last_internal_api_name
-    if api_name:
-        return {
-            "apiName": api_name,
-            "stack": stack,
-        }
-    return None
+
+    return {
+        "frames": parsed_frames,
+        "apiName": "" if is_internal else api_name,
+    }
diff --git a/playwright/_impl/_local_utils.py b/playwright/_impl/_local_utils.py
index 73870ae64..10303008d 100644
--- a/playwright/_impl/_local_utils.py
+++ b/playwright/_impl/_local_utils.py
@@ -13,9 +13,9 @@
 # limitations under the License.
 
 import base64
-from typing import Dict, List, Optional, cast
+from typing import Dict, Optional, cast
 
-from playwright._impl._api_structures import HeadersArray, NameValue
+from playwright._impl._api_structures import HeadersArray
 from playwright._impl._connection import ChannelOwner
 from playwright._impl._helper import HarLookupResult, locals_to_params
 
@@ -26,8 +26,8 @@ def __init__(
     ) -> None:
         super().__init__(parent, type, guid, initializer)
 
-    async def zip(self, zip_file: str, entries: List[NameValue]) -> None:
-        await self._channel.send("zip", {"zipFile": zip_file, "entries": entries})
+    async def zip(self, params: Dict) -> None:
+        await self._channel.send("zip", params)
 
     async def har_open(self, file: str) -> None:
         params = locals_to_params(locals())
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index c70691c07..55b1df75a 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -44,6 +44,7 @@
     MouseButton,
     locals_to_params,
     monotonic_time,
+    to_impl,
 )
 from playwright._impl._js_handle import Serializable, parse_value, serialize_argument
 from playwright._impl._str_utils import (
@@ -207,13 +208,23 @@ async def clear(
 
     def locator(
         self,
-        selector: str,
+        selector_or_locator: Union[str, "Locator"],
         has_text: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
     ) -> "Locator":
+        if isinstance(selector_or_locator, str):
+            return Locator(
+                self._frame,
+                f"{self._selector} >> {selector_or_locator}",
+                has_text=has_text,
+                has=has,
+            )
+        selector_or_locator = to_impl(selector_or_locator)
+        if selector_or_locator._frame != self._frame:
+            raise Error("Locators must belong to the same frame.")
         return Locator(
             self._frame,
-            f"{self._selector} >> {selector}",
+            f"{self._selector} >> {selector_or_locator._selector}",
             has_text=has_text,
             has=has,
         )
@@ -663,13 +674,23 @@ def __init__(self, frame: "Frame", frame_selector: str) -> None:
 
     def locator(
         self,
-        selector: str,
+        selector_or_locator: Union["Locator", str],
         has_text: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
     ) -> Locator:
+        if isinstance(selector_or_locator, str):
+            return Locator(
+                self._frame,
+                f"{self._frame_selector} >> internal:control=enter-frame >> {selector_or_locator}",
+                has_text=has_text,
+                has=has,
+            )
+        selector_or_locator = to_impl(selector_or_locator)
+        if selector_or_locator._frame != self._frame:
+            raise ValueError("Locators must belong to the same frame.")
         return Locator(
             self._frame,
-            f"{self._frame_selector} >> internal:control=enter-frame >> {selector}",
+            f"{self._frame_selector} >> internal:control=enter-frame >> {selector_or_locator._selector}",
             has_text=has_text,
             has=has,
         )
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 22a8f72c6..897cfbc14 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -59,6 +59,8 @@
     ColorScheme,
     DocumentLoadState,
     ForcedColors,
+    HarContentPolicy,
+    HarMode,
     KeyboardModifier,
     MouseButton,
     ReducedMotion,
@@ -617,9 +619,13 @@ async def route_from_har(
         url: Union[Pattern[str], str] = None,
         not_found: RouteFromHarNotFoundPolicy = None,
         update: bool = None,
+        content: HarContentPolicy = None,
+        mode: HarMode = None,
     ) -> None:
         if update:
-            await self._browser_context._record_into_har(har=har, page=self, url=url)
+            await self._browser_context._record_into_har(
+                har=har, page=self, url=url, content=content, mode=mode
+            )
             return
         router = await HarRouter.create(
             local_utils=self._connection.local_utils,
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index b6b0025ed..3d117938a 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -13,7 +13,7 @@
 # limitations under the License.
 
 import pathlib
-from typing import Dict, Optional, Union, cast
+from typing import Any, Dict, List, Optional, Union, cast
 
 from playwright._impl._artifact import Artifact
 from playwright._impl._connection import ChannelOwner, from_nullable_channel
@@ -25,6 +25,8 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        self._include_sources: bool = False
+        self._metadata_collector: List[Dict[str, Any]] = []
 
     async def start(
         self,
@@ -35,12 +37,19 @@ async def start(
         sources: bool = None,
     ) -> None:
         params = locals_to_params(locals())
+        self._include_sources = bool(sources)
         await self._channel.send("tracingStart", params)
-        await self.start_chunk(title)
+        await self._channel.send(
+            "tracingStartChunk", {"title": title} if title else None
+        )
+        self._metadata_collector = []
+        self._connection.start_collecting_call_metadata(self._metadata_collector)
 
     async def start_chunk(self, title: str = None) -> None:
         params = locals_to_params(locals())
         await self._channel.send("tracingStartChunk", params)
+        self._metadata_collector = []
+        self._connection.start_collecting_call_metadata(self._metadata_collector)
 
     async def stop_chunk(self, path: Union[pathlib.Path, str] = None) -> None:
         await self._do_stop_chunk(path)
@@ -50,32 +59,47 @@ async def stop(self, path: Union[pathlib.Path, str] = None) -> None:
         await self._channel.send("tracingStop")
 
     async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> None:
+        if self._metadata_collector:
+            self._connection.stop_collecting_call_metadata(self._metadata_collector)
+        metadata = self._metadata_collector
+        self._metadata_collector = []
+
+        if not file_path:
+            await self._channel.send("tracingStopChunk", {"mode": "discard"})
+            # Not interested in any artifacts
+            return
+
         is_local = not self._connection.is_remote
 
-        mode = "doNotSave"
-        if file_path:
-            if is_local:
-                mode = "compressTraceAndSources"
-            else:
-                mode = "compressTrace"
+        if is_local:
+            result = await self._channel.send_return_as_dict(
+                "tracingStopChunk", {"mode": "entries"}
+            )
+            await self._connection.local_utils.zip(
+                {
+                    "zipFile": str(file_path),
+                    "entries": result["entries"],
+                    "metadata": metadata,
+                    "mode": "write",
+                    "includeSources": self._include_sources,
+                }
+            )
+            return
 
         result = await self._channel.send_return_as_dict(
             "tracingStopChunk",
             {
-                "mode": mode,
+                "mode": "archive",
             },
         )
-        if not file_path:
-            # Not interested in artifacts.
-            return
 
         artifact = cast(
             Optional[Artifact],
             from_nullable_channel(result.get("artifact")),
         )
 
+        # The artifact may be missing if the browser closed while stopping tracing.
         if not artifact:
-            # The artifact may be missing if the browser closed while stopping tracing.
             return
 
         # Save trace to the final local file.
@@ -83,7 +107,13 @@ async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> No
         await artifact.delete()
 
         # Add local sources to the remote trace if necessary.
-        if result.get("sourceEntries", []):
+        if len(metadata) > 0:
             await self._connection.local_utils.zip(
-                str(file_path), result["sourceEntries"]
+                {
+                    "zipFile": str(file_path),
+                    "entries": [],
+                    "metadata": metadata,
+                    "mode": "append",
+                    "includeSources": self._include_sources,
+                }
             )
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index e8b8757ee..7dfcf336d 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -1943,8 +1943,8 @@ async def scroll_into_view_if_needed(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -1985,8 +1985,8 @@ async def hover(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -2052,8 +2052,8 @@ async def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2122,8 +2122,8 @@ async def dblclick(
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2208,8 +2208,8 @@ async def select_option(
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2270,8 +2270,8 @@ async def tap(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2319,8 +2319,8 @@ async def fill(
         value : str
             Value to set for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -2355,8 +2355,8 @@ async def select_text(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -2375,8 +2375,8 @@ async def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -2414,8 +2414,8 @@ async def set_input_files(
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -2484,8 +2484,8 @@ async def type(
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -2536,8 +2536,8 @@ async def press(
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -2583,8 +2583,8 @@ async def set_checked(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2638,8 +2638,8 @@ async def check(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2692,8 +2692,8 @@ async def uncheck(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2777,8 +2777,8 @@ async def screenshot(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
@@ -3001,8 +3001,8 @@ async def wait_for_element_state(
         state : Union["disabled", "editable", "enabled", "hidden", "stable", "visible"]
             A state to wait for, see below for more details.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -3060,8 +3060,8 @@ async def wait_for_selector(
             - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or
               `visibility:hidden`. This is opposite to the `'visible'` option.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3226,8 +3226,8 @@ async def set_files(
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -3837,8 +3837,8 @@ def run(playwright):
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
@@ -3879,8 +3879,8 @@ async def is_checked(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -3913,8 +3913,8 @@ async def is_disabled(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -3947,8 +3947,8 @@ async def is_editable(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -3981,8 +3981,8 @@ async def is_enabled(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -4125,8 +4125,8 @@ async def dispatch_event(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4421,8 +4421,8 @@ async def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -4501,8 +4501,8 @@ async def dblclick(
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -4573,8 +4573,8 @@ async def tap(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -4633,8 +4633,8 @@ async def fill(
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5255,8 +5255,8 @@ async def focus(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5285,8 +5285,8 @@ async def text_content(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -5319,8 +5319,8 @@ async def inner_text(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -5353,8 +5353,8 @@ async def inner_html(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -5390,8 +5390,8 @@ async def get_attribute(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -5443,8 +5443,8 @@ async def hover(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5511,8 +5511,8 @@ async def drag_and_drop(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         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.
@@ -5596,8 +5596,8 @@ async def select_option(
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5651,8 +5651,8 @@ async def input_value(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -5700,8 +5700,8 @@ async def set_input_files(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5760,8 +5760,8 @@ async def type(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5823,8 +5823,8 @@ async def press(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5878,8 +5878,8 @@ async def check(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -5942,8 +5942,8 @@ async def uncheck(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -6057,8 +6057,9 @@ def run(playwright):
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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()`.
+            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()` or
+            `page.set_default_timeout()` methods.
         polling : Union["raf", float, None]
             If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling`
             is a number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to
@@ -6129,8 +6130,8 @@ async def set_checked(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -6189,7 +6190,7 @@ def last(self) -> "FrameLocator":
 
     def locator(
         self,
-        selector: str,
+        selector_or_locator: typing.Union["Locator", str],
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None
@@ -6203,8 +6204,8 @@ def locator(
 
         Parameters
         ----------
-        selector : str
-            A selector to use when resolving DOM element.
+        selector_or_locator : Union[Locator, str]
+            A selector or locator to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -6222,7 +6223,9 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector=selector, has_text=has_text, has=has._impl_obj if has else None
+                selector_or_locator=selector_or_locator,
+                has_text=has_text,
+                has=has._impl_obj if has else None,
             )
         )
 
@@ -8201,8 +8204,8 @@ def run(playwright):
         selector : str
             A selector to query for.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
@@ -8246,8 +8249,8 @@ async def is_checked(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -8280,8 +8283,8 @@ async def is_disabled(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -8314,8 +8317,8 @@ async def is_editable(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -8348,8 +8351,8 @@ async def is_enabled(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -8489,8 +8492,8 @@ async def dispatch_event(
         event_init : Union[Dict, None]
             Optional event-specific initialization properties.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9763,7 +9766,9 @@ async def route_from_har(
         *,
         url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
-        update: typing.Optional[bool] = None
+        update: typing.Optional[bool] = None,
+        content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
+        mode: typing.Optional[Literal["full", "minimal"]] = None
     ) -> None:
         """Page.route_from_har
 
@@ -9790,11 +9795,18 @@ async def route_from_har(
         update : Union[bool, None]
             If specified, updates the given HAR with the actual network information instead of serving from file. The file is
             written to disk when `browser_context.close()` is called.
+        content : Union["attach", "embed", "omit", None]
+        mode : Union["full", "minimal", None]
         """
 
         return mapping.from_maybe_impl(
             await self._impl_obj.route_from_har(
-                har=har, url=url, not_found=not_found, update=update
+                har=har,
+                url=url,
+                not_found=not_found,
+                update=update,
+                content=content,
+                mode=mode,
             )
         )
 
@@ -9820,8 +9832,8 @@ async def screenshot(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
@@ -9973,8 +9985,8 @@ async def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -10053,8 +10065,8 @@ async def dblclick(
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -10125,8 +10137,8 @@ async def tap(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -10185,8 +10197,8 @@ async def fill(
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -10805,8 +10817,8 @@ async def focus(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -10835,8 +10847,8 @@ async def text_content(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -10869,8 +10881,8 @@ async def inner_text(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -10903,8 +10915,8 @@ async def inner_html(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -10940,8 +10952,8 @@ async def get_attribute(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -10993,8 +11005,8 @@ async def hover(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -11085,8 +11097,8 @@ async def drag_and_drop(
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11174,8 +11186,8 @@ async def select_option(
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -11229,8 +11241,8 @@ async def input_value(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -11275,8 +11287,8 @@ async def set_input_files(
             used.
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11335,8 +11347,8 @@ async def type(
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -11426,8 +11438,8 @@ async def press(
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -11484,8 +11496,8 @@ async def check(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -11548,8 +11560,8 @@ async def uncheck(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -11675,8 +11687,9 @@ def run(playwright):
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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()`.
+            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()` or
+            `page.set_default_timeout()` methods.
         polling : Union["raf", float, None]
             If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling`
             is a number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to
@@ -12339,8 +12352,8 @@ async def set_checked(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -13347,7 +13360,9 @@ async def route_from_har(
         *,
         url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
-        update: typing.Optional[bool] = None
+        update: typing.Optional[bool] = None,
+        content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
+        mode: typing.Optional[Literal["full", "minimal"]] = None
     ) -> None:
         """BrowserContext.route_from_har
 
@@ -13374,11 +13389,24 @@ async def route_from_har(
         update : Union[bool, None]
             If specified, updates the given HAR with the actual network information instead of serving from file. The file is
             written to disk when `browser_context.close()` is called.
+        content : Union["attach", "embed", "omit", None]
+            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
+            `attach` is specified, resources are persisted as separate files or entries in the ZIP archive. If `embed` is
+            specified, content is stored inline the HAR file
+        mode : Union["full", "minimal", None]
+            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to
+            `minimal`.
         """
 
         return mapping.from_maybe_impl(
             await self._impl_obj.route_from_har(
-                har=har, url=url, not_found=not_found, update=update
+                har=har,
+                url=url,
+                not_found=not_found,
+                update=update,
+                content=content,
+                mode=mode,
             )
         )
 
@@ -15128,8 +15156,8 @@ async def bounding_box(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -15185,8 +15213,8 @@ async def check(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -15281,8 +15309,8 @@ async def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -15355,8 +15383,8 @@ async def dblclick(
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -15441,8 +15469,8 @@ async def dispatch_event(
         event_init : Union[Dict, None]
             Optional event-specific initialization properties.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15491,8 +15519,8 @@ async def evaluate(
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -15586,8 +15614,8 @@ async def evaluate_handle(
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -15639,8 +15667,8 @@ async def fill(
         value : str
             Value to set for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -15689,8 +15717,8 @@ async def clear(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -15707,7 +15735,7 @@ async def clear(
 
     def locator(
         self,
-        selector: str,
+        selector_or_locator: typing.Union[str, "Locator"],
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None
@@ -15721,8 +15749,8 @@ def locator(
 
         Parameters
         ----------
-        selector : str
-            A selector to use when resolving DOM element.
+        selector_or_locator : Union[Locator, str]
+            A selector or locator to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -15740,7 +15768,9 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector=selector, has_text=has_text, has=has._impl_obj if has else None
+                selector_or_locator=selector_or_locator,
+                has_text=has_text,
+                has=has._impl_obj if has else None,
             )
         )
 
@@ -16287,8 +16317,8 @@ async def element_handle(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16395,8 +16425,8 @@ async def focus(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.focus(timeout=timeout))
@@ -16409,8 +16439,8 @@ async def blur(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.blur(timeout=timeout))
@@ -16420,6 +16450,10 @@ async def all(self) -> typing.List["Locator"]:
 
         When locator points to a list of elements, returns array of locators, pointing to respective elements.
 
+        Note that `locator.all()` does not wait for elements to match the locator, and instead immediately returns
+        whatever is present in the page. To avoid flakiness when elements are loaded dynamically, wait for the loading to
+        finish before calling `locator.all()`.
+
         **Usage**
 
         ```py
@@ -16520,8 +16554,8 @@ async def drag_to(
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         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.
@@ -16557,8 +16591,8 @@ async def get_attribute(
         name : str
             Attribute name to get the value for.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16617,8 +16651,8 @@ async def hover(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -16649,8 +16683,8 @@ async def inner_html(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16667,8 +16701,8 @@ async def inner_text(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16702,8 +16736,8 @@ async def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16732,8 +16766,8 @@ async def is_checked(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16760,8 +16794,8 @@ async def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16790,8 +16824,8 @@ async def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16820,8 +16854,8 @@ async def is_enabled(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16934,8 +16968,8 @@ async def press(
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -16999,8 +17033,8 @@ async def screenshot(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
@@ -17063,8 +17097,8 @@ async def scroll_into_view_if_needed(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -17143,8 +17177,8 @@ async def select_option(
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -17189,8 +17223,8 @@ async def select_text(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -17266,8 +17300,8 @@ async def set_input_files(
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -17320,8 +17354,8 @@ async def tap(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -17354,8 +17388,8 @@ async def text_content(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -17414,8 +17448,8 @@ async def type(
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -17473,8 +17507,8 @@ async def uncheck(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -17570,8 +17604,8 @@ async def wait_for(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
@@ -17633,8 +17667,8 @@ async def set_checked(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index c84abe680..2b0750302 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -1947,8 +1947,8 @@ def scroll_into_view_if_needed(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -1989,8 +1989,8 @@ def hover(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -2058,8 +2058,8 @@ def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2130,8 +2130,8 @@ def dblclick(
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2218,8 +2218,8 @@ def select_option(
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2282,8 +2282,8 @@ def tap(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2333,8 +2333,8 @@ def fill(
         value : str
             Value to set for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -2371,8 +2371,8 @@ def select_text(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -2391,8 +2391,8 @@ def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -2430,8 +2430,8 @@ def set_input_files(
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -2504,8 +2504,8 @@ def type(
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -2558,8 +2558,8 @@ def press(
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -2607,8 +2607,8 @@ def set_checked(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2664,8 +2664,8 @@ def check(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2720,8 +2720,8 @@ def uncheck(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -2807,8 +2807,8 @@ def screenshot(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
@@ -3037,8 +3037,8 @@ def wait_for_element_state(
         state : Union["disabled", "editable", "enabled", "hidden", "stable", "visible"]
             A state to wait for, see below for more details.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -3098,8 +3098,8 @@ def wait_for_selector(
             - `'hidden'` - wait for element to be either detached from DOM, or have an empty bounding box or
               `visibility:hidden`. This is opposite to the `'visible'` option.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -3268,8 +3268,8 @@ def set_files(
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -3889,8 +3889,8 @@ def run(playwright):
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
@@ -3933,8 +3933,8 @@ def is_checked(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -3969,8 +3969,8 @@ def is_disabled(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -4005,8 +4005,8 @@ def is_editable(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -4041,8 +4041,8 @@ def is_enabled(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -4191,8 +4191,8 @@ def dispatch_event(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4499,8 +4499,8 @@ def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -4581,8 +4581,8 @@ def dblclick(
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -4655,8 +4655,8 @@ def tap(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -4717,8 +4717,8 @@ def fill(
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5341,8 +5341,8 @@ def focus(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5371,8 +5371,8 @@ def text_content(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -5407,8 +5407,8 @@ def inner_text(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -5443,8 +5443,8 @@ def inner_html(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -5482,8 +5482,8 @@ def get_attribute(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -5537,8 +5537,8 @@ def hover(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5607,8 +5607,8 @@ def drag_and_drop(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         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.
@@ -5694,8 +5694,8 @@ def select_option(
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5751,8 +5751,8 @@ def input_value(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -5802,8 +5802,8 @@ def set_input_files(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5864,8 +5864,8 @@ def type(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5929,8 +5929,8 @@ def press(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -5986,8 +5986,8 @@ def check(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -6052,8 +6052,8 @@ def uncheck(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -6169,8 +6169,9 @@ def run(playwright):
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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()`.
+            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()` or
+            `page.set_default_timeout()` methods.
         polling : Union["raf", float, None]
             If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling`
             is a number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to
@@ -6243,8 +6244,8 @@ def set_checked(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -6305,7 +6306,7 @@ def last(self) -> "FrameLocator":
 
     def locator(
         self,
-        selector: str,
+        selector_or_locator: typing.Union["Locator", str],
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None
@@ -6319,8 +6320,8 @@ def locator(
 
         Parameters
         ----------
-        selector : str
-            A selector to use when resolving DOM element.
+        selector_or_locator : Union[Locator, str]
+            A selector or locator to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -6338,7 +6339,9 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector=selector, has_text=has_text, has=has._impl_obj if has else None
+                selector_or_locator=selector_or_locator,
+                has_text=has_text,
+                has=has._impl_obj if has else None,
             )
         )
 
@@ -8217,8 +8220,8 @@ def run(playwright):
         selector : str
             A selector to query for.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
@@ -8264,8 +8267,8 @@ def is_checked(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -8300,8 +8303,8 @@ def is_disabled(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -8336,8 +8339,8 @@ def is_editable(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -8372,8 +8375,8 @@ def is_enabled(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -8519,8 +8522,8 @@ def dispatch_event(
         event_init : Union[Dict, None]
             Optional event-specific initialization properties.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9825,7 +9828,9 @@ def route_from_har(
         *,
         url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
-        update: typing.Optional[bool] = None
+        update: typing.Optional[bool] = None,
+        content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
+        mode: typing.Optional[Literal["full", "minimal"]] = None
     ) -> None:
         """Page.route_from_har
 
@@ -9852,12 +9857,19 @@ def route_from_har(
         update : Union[bool, None]
             If specified, updates the given HAR with the actual network information instead of serving from file. The file is
             written to disk when `browser_context.close()` is called.
+        content : Union["attach", "embed", "omit", None]
+        mode : Union["full", "minimal", None]
         """
 
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.route_from_har(
-                    har=har, url=url, not_found=not_found, update=update
+                    har=har,
+                    url=url,
+                    not_found=not_found,
+                    update=update,
+                    content=content,
+                    mode=mode,
                 )
             )
         )
@@ -9884,8 +9896,8 @@ def screenshot(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
@@ -10039,8 +10051,8 @@ def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -10121,8 +10133,8 @@ def dblclick(
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -10195,8 +10207,8 @@ def tap(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -10257,8 +10269,8 @@ def fill(
         value : str
             Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -10879,8 +10891,8 @@ def focus(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -10909,8 +10921,8 @@ def text_content(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -10945,8 +10957,8 @@ def inner_text(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -10981,8 +10993,8 @@ def inner_html(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -11020,8 +11032,8 @@ def get_attribute(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -11075,8 +11087,8 @@ def hover(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -11169,8 +11181,8 @@ def drag_and_drop(
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11260,8 +11272,8 @@ def select_option(
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -11317,8 +11329,8 @@ def input_value(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -11365,8 +11377,8 @@ def set_input_files(
             used.
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11427,8 +11439,8 @@ def type(
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -11520,8 +11532,8 @@ def press(
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -11580,8 +11592,8 @@ def check(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -11646,8 +11658,8 @@ def uncheck(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -11775,8 +11787,9 @@ def run(playwright):
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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()`.
+            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()` or
+            `page.set_default_timeout()` methods.
         polling : Union["raf", float, None]
             If `polling` is `'raf'`, then `expression` is constantly executed in `requestAnimationFrame` callback. If `polling`
             is a number, then it is treated as an interval in milliseconds at which the function would be executed. Defaults to
@@ -12443,8 +12456,8 @@ def set_checked(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -13415,7 +13428,9 @@ def route_from_har(
         *,
         url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
-        update: typing.Optional[bool] = None
+        update: typing.Optional[bool] = None,
+        content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
+        mode: typing.Optional[Literal["full", "minimal"]] = None
     ) -> None:
         """BrowserContext.route_from_har
 
@@ -13442,12 +13457,25 @@ def route_from_har(
         update : Union[bool, None]
             If specified, updates the given HAR with the actual network information instead of serving from file. The file is
             written to disk when `browser_context.close()` is called.
+        content : Union["attach", "embed", "omit", None]
+            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
+            `attach` is specified, resources are persisted as separate files or entries in the ZIP archive. If `embed` is
+            specified, content is stored inline the HAR file
+        mode : Union["full", "minimal", None]
+            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to
+            `minimal`.
         """
 
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.route_from_har(
-                    har=har, url=url, not_found=not_found, update=update
+                    har=har,
+                    url=url,
+                    not_found=not_found,
+                    update=update,
+                    content=content,
+                    mode=mode,
                 )
             )
         )
@@ -15216,8 +15244,8 @@ def bounding_box(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -15273,8 +15301,8 @@ def check(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -15371,8 +15399,8 @@ def click(
         click_count : Union[int, None]
             defaults to 1. See [UIEvent.detail].
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -15447,8 +15475,8 @@ def dblclick(
         button : Union["left", "middle", "right", None]
             Defaults to `left`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -15535,8 +15563,8 @@ def dispatch_event(
         event_init : Union[Dict, None]
             Optional event-specific initialization properties.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15587,8 +15615,8 @@ def evaluate(
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -15686,8 +15714,8 @@ def evaluate_handle(
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -15741,8 +15769,8 @@ def fill(
         value : str
             Value to set for the `<input>`, `<textarea>` or `[contenteditable]` element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -15793,8 +15821,8 @@ def clear(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -15813,7 +15841,7 @@ def clear(
 
     def locator(
         self,
-        selector: str,
+        selector_or_locator: typing.Union[str, "Locator"],
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None
@@ -15827,8 +15855,8 @@ def locator(
 
         Parameters
         ----------
-        selector : str
-            A selector to use when resolving DOM element.
+        selector_or_locator : Union[Locator, str]
+            A selector or locator to use when resolving DOM element.
         has_text : Union[Pattern[str], str, None]
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
@@ -15846,7 +15874,9 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector=selector, has_text=has_text, has=has._impl_obj if has else None
+                selector_or_locator=selector_or_locator,
+                has_text=has_text,
+                has=has._impl_obj if has else None,
             )
         )
 
@@ -16393,8 +16423,8 @@ def element_handle(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16503,8 +16533,8 @@ def focus(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -16519,8 +16549,8 @@ def blur(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.blur(timeout=timeout)))
@@ -16530,6 +16560,10 @@ def all(self) -> typing.List["Locator"]:
 
         When locator points to a list of elements, returns array of locators, pointing to respective elements.
 
+        Note that `locator.all()` does not wait for elements to match the locator, and instead immediately returns
+        whatever is present in the page. To avoid flakiness when elements are loaded dynamically, wait for the loading to
+        finish before calling `locator.all()`.
+
         **Usage**
 
         ```py
@@ -16630,8 +16664,8 @@ def drag_to(
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         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.
@@ -16669,8 +16703,8 @@ def get_attribute(
         name : str
             Attribute name to get the value for.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16729,8 +16763,8 @@ def hover(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -16763,8 +16797,8 @@ def inner_html(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16783,8 +16817,8 @@ def inner_text(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16820,8 +16854,8 @@ def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16850,8 +16884,8 @@ def is_checked(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16880,8 +16914,8 @@ def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16910,8 +16944,8 @@ def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -16940,8 +16974,8 @@ def is_enabled(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -17060,8 +17094,8 @@ def press(
         delay : Union[float, None]
             Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -17127,8 +17161,8 @@ def screenshot(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         type : Union["jpeg", "png", None]
             Specify screenshot type, defaults to `png`.
         path : Union[pathlib.Path, str, None]
@@ -17193,8 +17227,8 @@ def scroll_into_view_if_needed(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -17273,8 +17307,8 @@ def select_option(
         element : Union[ElementHandle, List[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -17321,8 +17355,8 @@ def select_text(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -17398,8 +17432,8 @@ def set_input_files(
         ----------
         files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -17456,8 +17490,8 @@ def tap(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -17492,8 +17526,8 @@ def text_content(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
 
         Returns
         -------
@@ -17552,8 +17586,8 @@ def type(
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         no_wait_after : Union[bool, None]
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
@@ -17613,8 +17647,8 @@ def uncheck(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
@@ -17712,8 +17746,8 @@ def wait_for(
         Parameters
         ----------
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         state : Union["attached", "detached", "hidden", "visible", None]
             Defaults to `'visible'`. Can be either:
             - `'attached'` - wait for element to be present in DOM.
@@ -17775,8 +17809,8 @@ def set_checked(
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
         timeout : Union[float, None]
-            Maximum time in milliseconds, defaults to 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.
+            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.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
diff --git a/scripts/expected_api_mismatch.txt b/scripts/expected_api_mismatch.txt
index 4619a29f5..e42b74650 100644
--- a/scripts/expected_api_mismatch.txt
+++ b/scripts/expected_api_mismatch.txt
@@ -17,4 +17,3 @@ Parameter type mismatch in Page.unroute(handler=): documented as Union[Callable[
 Method not implemented: Error.name
 Method not implemented: Error.stack
 Method not implemented: Error.message
-Method not implemented: PlaywrightAssertions.expect
diff --git a/setup.py b/setup.py
index b3f15d5b1..02f0c589d 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.31.0"
+driver_version = "1.32.0-alpha-mar-15-2023"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_element_handle.py b/tests/async/test_element_handle.py
index d47e6a78c..f5abad03c 100644
--- a/tests/async/test_element_handle.py
+++ b/tests/async/test_element_handle.py
@@ -442,12 +442,12 @@ async def test_fill_input_when_Node_is_removed(page, server):
     assert await page.evaluate("result") == "some value"
 
 
-async def test_select_textarea(page, server, is_firefox):
+async def test_select_textarea(page, server, is_firefox, is_webkit):
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
     await textarea.evaluate('textarea => textarea.value = "some value"')
     await textarea.select_text()
-    if is_firefox:
+    if is_firefox or is_webkit:
         assert await textarea.evaluate("el => el.selectionStart") == 0
         assert await textarea.evaluate("el => el.selectionEnd") == 10
     else:
@@ -457,12 +457,12 @@ async def test_select_textarea(page, server, is_firefox):
         )
 
 
-async def test_select_input(page, server, is_firefox):
+async def test_select_input(page, server, is_firefox, is_webkit):
     await page.goto(server.PREFIX + "/input/textarea.html")
     input = await page.query_selector("input")
     await input.evaluate('input => input.value = "some value"')
     await input.select_text()
-    if is_firefox:
+    if is_firefox or is_webkit:
         assert await input.evaluate("el => el.selectionStart") == 0
         assert await input.evaluate("el => el.selectionEnd") == 10
     else:
diff --git a/tests/async/test_har.py b/tests/async/test_har.py
index d2df88a28..d22e3b8c6 100644
--- a/tests/async/test_har.py
+++ b/tests/async/test_har.py
@@ -538,7 +538,7 @@ async def test_should_round_trip_har_with_post_data(
 
 
 async def test_should_disambiguate_by_header(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     server.set_route(
         "/echo", lambda req: (req.write(req.getHeader("baz").encode()), req.finish())
@@ -580,7 +580,7 @@ async def test_should_disambiguate_by_header(
 
 
 async def test_should_produce_extracted_zip(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     har_path = tmpdir / "har.har"
     context = await browser.new_context(
@@ -607,7 +607,7 @@ async def test_should_produce_extracted_zip(
 
 
 async def test_should_update_har_zip_for_context(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     har_path = tmpdir / "har.zip"
     context = await browser.new_context()
@@ -629,7 +629,7 @@ async def test_should_update_har_zip_for_context(
 
 
 async def test_should_update_har_zip_for_page(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     har_path = tmpdir / "har.zip"
     context = await browser.new_context()
@@ -650,8 +650,29 @@ async def test_should_update_har_zip_for_page(
     )
 
 
+async def test_should_update_har_zip_for_page_with_different_options(
+    browser: Browser, server: Server, tmpdir: Path
+) -> None:
+    har_path = tmpdir / "har.zip"
+    context1 = await browser.new_context()
+    page1 = await context1.new_page()
+    await page1.route_from_har(har_path, update=True, content="embed", mode="full")
+    await page1.goto(server.PREFIX + "/one-style.html")
+    await context1.close()
+
+    context2 = await browser.new_context()
+    page2 = await context2.new_page()
+    await page2.route_from_har(har_path, not_found="abort")
+    await page2.goto(server.PREFIX + "/one-style.html")
+    assert "hello, world!" in await page2.content()
+    await expect(page2.locator("body")).to_have_css(
+        "background-color", "rgb(255, 192, 203)"
+    )
+    await context2.close()
+
+
 async def test_should_update_extracted_har_zip_for_page(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     har_path = tmpdir / "har.har"
     context = await browser.new_context()
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 39d348708..fea33ef75 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -362,7 +362,7 @@ async def test_locators_should_select_textarea(
     textarea = page.locator("textarea")
     await textarea.evaluate("textarea => textarea.value = 'some value'")
     await textarea.select_text()
-    if browser_name == "firefox":
+    if browser_name == "firefox" or browser_name == "webkit":
         assert await textarea.evaluate("el => el.selectionStart") == 0
         assert await textarea.evaluate("el => el.selectionEnd") == 10
     else:
@@ -487,6 +487,73 @@ async def test_locators_wait_for(page: Page) -> None:
     assert await locator.text_content() == "target"
 
 
+async def test_should_wait_for_hidden(page):
+    await page.set_content("<div><span>target</span></div>")
+    locator = page.locator("span")
+    task = locator.wait_for(state="hidden")
+    await page.eval_on_selector("div", "div => div.innerHTML = ''")
+    await task
+
+
+async def test_should_combine_visible_with_other_selectors(page):
+    await page.set_content(
+        """<div>
+        <div class="item" style="display: none">Hidden data0</div>
+        <div class="item">visible data1</div>
+        <div class="item" style="display: none">Hidden data1</div>
+        <div class="item">visible data2</div>
+        <div class="item" style="display: none">Hidden data1</div>
+        <div class="item">visible data3</div>
+        </div>
+    """
+    )
+    locator = page.locator(".item >> visible=true").nth(1)
+    await expect(locator).to_have_text("visible data2")
+    await expect(page.locator(".item >> visible=true >> text=data3")).to_have_text(
+        "visible data3"
+    )
+
+
+async def test_locator_count_should_work_with_deleted_map_in_main_world(page):
+    await page.evaluate("Map = 1")
+    await page.locator("#searchResultTableDiv .x-grid3-row").count()
+    await expect(page.locator("#searchResultTableDiv .x-grid3-row")).to_have_count(0)
+
+
+async def test_locator_locator_and_framelocator_locator_should_accept_locator(page):
+    await page.set_content(
+        """
+        <div><input value=outer></div>
+        <iframe srcdoc="<div><input value=inner></div>"></iframe>
+    """
+    )
+
+    input_locator = page.locator("input")
+    assert await input_locator.input_value() == "outer"
+    assert await page.locator("div").locator(input_locator).input_value() == "outer"
+    assert (
+        await page.frame_locator("iframe").locator(input_locator).input_value()
+        == "inner"
+    )
+    assert (
+        await page.frame_locator("iframe")
+        .locator("div")
+        .locator(input_locator)
+        .input_value()
+        == "inner"
+    )
+
+    div_locator = page.locator("div")
+    assert await div_locator.locator("input").input_value() == "outer"
+    assert (
+        await page.frame_locator("iframe")
+        .locator(div_locator)
+        .locator("input")
+        .input_value()
+        == "inner"
+    )
+
+
 async def route_iframe(page: Page) -> None:
     await page.route(
         "**/empty.html",
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index 565ee2140..e425cbf0d 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -890,9 +890,16 @@ async def test_frame_goto_should_navigate_subframes(page, server):
 async def test_frame_goto_should_reject_when_frame_detaches(page, server, browser_name):
     await page.goto(server.PREFIX + "/frames/one-frame.html")
 
-    await page.route("**/empty.html", lambda route, request: None)
-    navigation_task = asyncio.create_task(page.frames[1].goto(server.EMPTY_PAGE))
-    asyncio.create_task(page.eval_on_selector("iframe", "frame => frame.remove()"))
+    server.set_route("/one-style.css", lambda _: None)
+    wait_for_request_task = asyncio.create_task(
+        server.wait_for_request("/one-style.css")
+    )
+    navigation_task = asyncio.create_task(
+        page.frames[1].goto(server.PREFIX + "/one-style.html")
+    )
+    await wait_for_request_task
+
+    await page.eval_on_selector("iframe", "frame => frame.remove()")
     with pytest.raises(Error) as exc_info:
         await navigation_task
     if browser_name == "chromium":
@@ -934,11 +941,12 @@ async def test_frame_wait_for_nav_should_fail_when_frame_detaches(page, server:
     await page.goto(server.PREFIX + "/frames/one-frame.html")
     frame = page.frames[1]
     server.set_route("/empty.html", lambda _: None)
+    server.set_route("/one-style.css", lambda _: None)
     with pytest.raises(Error) as exc_info:
         async with frame.expect_navigation():
 
             async def after_it():
-                await server.wait_for_request("/empty.html")
+                await server.wait_for_request("/one-style.html")
                 await page.eval_on_selector(
                     "iframe", "frame => setTimeout(() => frame.remove(), 0)"
                 )
@@ -946,7 +954,7 @@ async def after_it():
             await asyncio.gather(
                 page.eval_on_selector(
                     "iframe",
-                    "frame => frame.contentWindow.location.href = '/empty.html'",
+                    "frame => frame.contentWindow.location.href = '/one-style.html'",
                 ),
                 after_it(),
             )
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index 6dd27c7a1..937798a3e 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -115,7 +115,6 @@ async def test_should_collect_trace_with_resources_but_no_js(
         "Route.continue_",
         "Page.goto",
         "Page.close",
-        "Tracing.stop",
     ]
 
     assert len(list(filter(lambda e: e["type"] == "frame-snapshot", events))) >= 1
@@ -162,12 +161,11 @@ async def test_should_collect_two_traces(
         "Page.goto",
         "Page.set_content",
         "Page.click",
-        "Tracing.stop",
     ]
 
     (_, events) = parse_trace(tracing2_path)
     assert events[0]["type"] == "context-options"
-    assert get_actions(events) == ["Page.dblclick", "Page.close", "Tracing.stop"]
+    assert get_actions(events) == ["Page.dblclick", "Page.close"]
 
 
 async def test_should_not_throw_when_stopping_without_start_but_not_exporting(
@@ -202,7 +200,6 @@ async def test_should_work_with_playwright_context_managers(
         "Page.click",
         "Page.expect_popup",
         "Page.evaluate",
-        "Tracing.stop",
     ]
 
 
@@ -223,7 +220,6 @@ async def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
         "Page.goto",
         "Page.wait_for_load_state",
         "Page.wait_for_load_state",
-        "Tracing.stop",
     ]
 
 
@@ -243,11 +239,10 @@ def get_actions(events: List[Any]) -> List[str]:
     action_events = sorted(
         list(
             filter(
-                lambda e: e["type"] == "action"
-                and e["metadata"].get("internal", False) is False,
+                lambda e: e["type"] == "action",
                 events,
             )
         ),
-        key=lambda e: e["metadata"]["startTime"],
+        key=lambda e: e["startTime"],
     )
-    return [e["metadata"]["apiName"] for e in action_events]
+    return [e["apiName"] for e in action_events]
diff --git a/tests/sync/test_element_handle.py b/tests/sync/test_element_handle.py
index 22e7d626b..d5e1055ce 100644
--- a/tests/sync/test_element_handle.py
+++ b/tests/sync/test_element_handle.py
@@ -421,26 +421,30 @@ def test_fill_input_when_Node_is_removed(page: Page, server: Server) -> None:
     assert page.evaluate("result") == "some value"
 
 
-def test_select_textarea(page: Page, server: Server, is_firefox: bool) -> None:
+def test_select_textarea(
+    page: Page, server: Server, is_firefox: bool, is_webkit: bool
+) -> None:
     page.goto(server.PREFIX + "/input/textarea.html")
     textarea = page.query_selector("textarea")
     assert textarea
     textarea.evaluate('textarea => textarea.value = "some value"')
     textarea.select_text()
-    if is_firefox:
+    if is_firefox or is_webkit:
         assert textarea.evaluate("el => el.selectionStart") == 0
         assert textarea.evaluate("el => el.selectionEnd") == 10
     else:
         assert page.evaluate("() => window.getSelection().toString()") == "some value"
 
 
-def test_select_input(page: Page, server: Server, is_firefox: bool) -> None:
+def test_select_input(
+    page: Page, server: Server, is_firefox: bool, is_webkit: bool
+) -> None:
     page.goto(server.PREFIX + "/input/textarea.html")
     input = page.query_selector("input")
     assert input
     input.evaluate('input => input.value = "some value"')
     input.select_text()
-    if is_firefox:
+    if is_firefox or is_webkit:
         assert input.evaluate("el => el.selectionStart") == 0
         assert input.evaluate("el => el.selectionEnd") == 10
     else:
diff --git a/tests/sync/test_har.py b/tests/sync/test_har.py
index 33441826f..4b7d5e0d0 100644
--- a/tests/sync/test_har.py
+++ b/tests/sync/test_har.py
@@ -423,7 +423,7 @@ def test_should_fulfill_from_har_with_content_in_a_file(
 
 
 def test_should_round_trip_har_zip(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     har_path = tmpdir / "har.zip"
     context_1 = browser.new_context(record_har_mode="minimal", record_har_path=har_path)
@@ -440,7 +440,7 @@ def test_should_round_trip_har_zip(
 
 
 def test_should_round_trip_har_with_post_data(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     server.set_route(
         "/echo", lambda req: (req.write(cast(Any, req).post_body), req.finish())
@@ -473,7 +473,7 @@ def test_should_round_trip_har_with_post_data(
 
 
 def test_should_disambiguate_by_header(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     server.set_route(
         "/echo",
@@ -514,7 +514,7 @@ def test_should_disambiguate_by_header(
 
 
 def test_should_produce_extracted_zip(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     har_path = tmpdir / "har.har"
     context = browser.new_context(
@@ -539,7 +539,7 @@ def test_should_produce_extracted_zip(
 
 
 def test_should_update_har_zip_for_context(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     har_path = tmpdir / "har.zip"
     context = browser.new_context()
@@ -559,7 +559,7 @@ def test_should_update_har_zip_for_context(
 
 
 def test_should_update_har_zip_for_page(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     har_path = tmpdir / "har.zip"
     context = browser.new_context()
@@ -578,8 +578,27 @@ def test_should_update_har_zip_for_page(
     expect(page_2.locator("body")).to_have_css("background-color", "rgb(255, 192, 203)")
 
 
+def test_should_update_har_zip_for_page_with_different_options(
+    browser: Browser, server: Server, tmpdir: Path
+) -> None:
+    har_path = tmpdir / "har.zip"
+    context1 = browser.new_context()
+    page1 = context1.new_page()
+    page1.route_from_har(har_path, update=True, content="embed", mode="full")
+    page1.goto(server.PREFIX + "/one-style.html")
+    context1.close()
+
+    context2 = browser.new_context()
+    page2 = context2.new_page()
+    page2.route_from_har(har_path, not_found="abort")
+    page2.goto(server.PREFIX + "/one-style.html")
+    assert "hello, world!" in page2.content()
+    expect(page2.locator("body")).to_have_css("background-color", "rgb(255, 192, 203)")
+    context2.close()
+
+
 def test_should_update_extracted_har_zip_for_page(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     har_path = tmpdir / "har.har"
     context = browser.new_context()
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 1f751a4b1..7c678ace8 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -355,7 +355,7 @@ def test_locators_should_select_textarea(
     textarea = page.locator("textarea")
     textarea.evaluate("textarea => textarea.value = 'some value'")
     textarea.select_text()
-    if browser_name == "firefox":
+    if browser_name == "firefox" or browser_name == "webkit":
         assert textarea.evaluate("el => el.selectionStart") == 0
         assert textarea.evaluate("el => el.selectionEnd") == 10
     else:
@@ -469,6 +469,58 @@ def test_locators_set_checked(page: Page) -> None:
     assert page.evaluate("checkbox.checked") is False
 
 
+def test_should_combine_visible_with_other_selectors(page: Page) -> None:
+    page.set_content(
+        """<div>
+        <div class="item" style="display: none">Hidden data0</div>
+        <div class="item">visible data1</div>
+        <div class="item" style="display: none">Hidden data1</div>
+        <div class="item">visible data2</div>
+        <div class="item" style="display: none">Hidden data1</div>
+        <div class="item">visible data3</div>
+        </div>
+    """
+    )
+    locator = page.locator(".item >> visible=true").nth(1)
+    expect(locator).to_have_text("visible data2")
+    expect(page.locator(".item >> visible=true >> text=data3")).to_have_text(
+        "visible data3"
+    )
+
+
+def test_locator_count_should_work_with_deleted_map_in_main_world(page: Page) -> None:
+    page.evaluate("Map = 1")
+    page.locator("#searchResultTableDiv .x-grid3-row").count()
+    expect(page.locator("#searchResultTableDiv .x-grid3-row")).to_have_count(0)
+
+
+def test_locator_locator_and_framelocator_locator_should_accept_locator(
+    page: Page,
+) -> None:
+    page.set_content(
+        """
+        <div><input value=outer></div>
+        <iframe srcdoc="<div><input value=inner></div>"></iframe>
+    """
+    )
+
+    input_locator = page.locator("input")
+    assert input_locator.input_value() == "outer"
+    assert page.locator("div").locator(input_locator).input_value() == "outer"
+    assert page.frame_locator("iframe").locator(input_locator).input_value() == "inner"
+    assert (
+        page.frame_locator("iframe").locator("div").locator(input_locator).input_value()
+        == "inner"
+    )
+
+    div_locator = page.locator("div")
+    assert div_locator.locator("input").input_value() == "outer"
+    assert (
+        page.frame_locator("iframe").locator(div_locator).locator("input").input_value()
+        == "inner"
+    )
+
+
 def route_iframe(page: Page) -> None:
     page.route(
         "**/empty.html",
@@ -743,11 +795,11 @@ def test_locators_should_focus_and_blur_a_button(page: Page, server: Server) ->
     focused = False
     blurred = False
 
-    async def focus_event() -> None:
+    def focus_event() -> None:
         nonlocal focused
         focused = True
 
-    async def blur_event() -> None:
+    def blur_event() -> None:
         nonlocal blurred
         blurred = True
 
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index b953640c6..049a571c4 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -115,7 +115,6 @@ def test_should_collect_trace_with_resources_but_no_js(
         "Route.continue_",
         "Page.goto",
         "Page.close",
-        "Tracing.stop",
     ]
 
     assert len(list(filter(lambda e: e["type"] == "frame-snapshot", events))) >= 1
@@ -162,12 +161,11 @@ def test_should_collect_two_traces(
         "Page.goto",
         "Page.set_content",
         "Page.click",
-        "Tracing.stop",
     ]
 
     (_, events) = parse_trace(tracing2_path)
     assert events[0]["type"] == "context-options"
-    assert get_actions(events) == ["Page.dblclick", "Page.close", "Tracing.stop"]
+    assert get_actions(events) == ["Page.dblclick", "Page.close"]
 
 
 def test_should_not_throw_when_stopping_without_start_but_not_exporting(
@@ -202,7 +200,6 @@ def test_should_work_with_playwright_context_managers(
         "Page.click",
         "Page.expect_popup",
         "Page.evaluate",
-        "Tracing.stop",
     ]
 
 
@@ -223,7 +220,6 @@ def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
         "Page.goto",
         "Page.wait_for_load_state",
         "Page.wait_for_load_state",
-        "Tracing.stop",
     ]
 
 
@@ -243,11 +239,10 @@ def get_actions(events: List[Any]) -> List[str]:
     action_events = sorted(
         list(
             filter(
-                lambda e: e["type"] == "action"
-                and e["metadata"].get("internal", False) is False,
+                lambda e: e["type"] == "action",
                 events,
             )
         ),
-        key=lambda e: e["metadata"]["startTime"],
+        key=lambda e: e["startTime"],
     )
-    return [e["metadata"]["apiName"] for e in action_events]
+    return [e["apiName"] for e in action_events]

From 890af94d3380c6dfbe9fabeaedea6b92aa232b11 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 16 Mar 2023 17:26:53 +0100
Subject: [PATCH 048/438] fix: get_by_role include_hidden options (#1814)

---
 playwright/_impl/_locator.py         | 16 ++++++++++------
 tests/async/test_selectors_get_by.py | 17 +++++++++++++++++
 2 files changed, 27 insertions(+), 6 deletions(-)

diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 55b1df75a..990d055fd 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -822,6 +822,10 @@ def get_by_text_selector(text: Union[str, Pattern[str]], exact: bool = None) ->
     return "internal:text=" + escape_for_text_selector(text, exact=exact)
 
 
+def bool_to_js_bool(value: bool) -> str:
+    return "true" if value else "false"
+
+
 def get_by_role_selector(
     role: AriaRole,
     checked: bool = None,
@@ -836,15 +840,15 @@ def get_by_role_selector(
 ) -> str:
     props: List[Tuple[str, str]] = []
     if checked is not None:
-        props.append(("checked", str(checked)))
+        props.append(("checked", bool_to_js_bool(checked)))
     if disabled is not None:
-        props.append(("disabled", str(disabled)))
+        props.append(("disabled", bool_to_js_bool(disabled)))
     if selected is not None:
-        props.append(("selected", str(selected)))
+        props.append(("selected", bool_to_js_bool(selected)))
     if expanded is not None:
-        props.append(("expanded", str(expanded)))
+        props.append(("expanded", bool_to_js_bool(expanded)))
     if includeHidden is not None:
-        props.append(("include-hidden", str(includeHidden)))
+        props.append(("include-hidden", bool_to_js_bool(includeHidden)))
     if level is not None:
         props.append(("level", str(level)))
     if name is not None:
@@ -857,6 +861,6 @@ def get_by_role_selector(
             )
         )
     if pressed is not None:
-        props.append(("pressed", str(pressed)))
+        props.append(("pressed", bool_to_js_bool(pressed)))
     props_str = "".join([f"[{t[0]}={t[1]}]" for t in props])
     return f"internal:role={role}{props_str}"
diff --git a/tests/async/test_selectors_get_by.py b/tests/async/test_selectors_get_by.py
index 88cb50947..1a07d1a9a 100644
--- a/tests/async/test_selectors_get_by.py
+++ b/tests/async/test_selectors_get_by.py
@@ -161,3 +161,20 @@ async def test_get_by_role_escaping(
         )
         == []
     )
+
+
+async def test_include_hidden_should_work(
+    page: Page,
+) -> None:
+    await page.set_content("""<button style="display: none">Hidden</button>""")
+    assert (
+        await page.get_by_role("button", name="Hidden").evaluate_all(
+            "els => els.map(e => e.outerHTML)"
+        )
+        == []
+    )
+    assert await page.get_by_role(
+        "button", name="Hidden", include_hidden=True
+    ).evaluate_all("els => els.map(e => e.outerHTML)") == [
+        """<button style="display: none">Hidden</button>""",
+    ]

From f791b880a790cf126ba735d137bfa7c0cfb8264e Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 23 Mar 2023 00:21:04 +0100
Subject: [PATCH 049/438] chore(roll): roll Playwright to
 1.32.0-beta-1679448099000 (#1826)

---
 README.md                               |  4 +-
 playwright/_impl/_browser.py            | 10 +---
 playwright/_impl/_browser_context.py    | 58 +++++++++++++------
 playwright/_impl/_browser_type.py       | 22 ++++---
 playwright/_impl/_connection.py         | 35 +++++++----
 playwright/_impl/_fetch.py              |  5 +-
 playwright/_impl/_local_utils.py        | 22 ++++++-
 playwright/_impl/_locator.py            |  3 +-
 playwright/_impl/_page.py               | 13 +++--
 playwright/_impl/_tracing.py            | 77 +++++++++++++++----------
 playwright/async_api/_generated.py      | 76 ++++++++++++++++--------
 playwright/sync_api/_generated.py       | 74 ++++++++++++++++--------
 setup.py                                |  2 +-
 tests/async/test_browsertype_connect.py |  2 +
 tests/async/test_har.py                 |  4 +-
 tests/async/test_input.py               |  2 +
 tests/async/test_locators.py            | 22 +++++--
 tests/async/test_tracing.py             | 74 +++++++++++++++++++++++-
 tests/sync/test_har.py                  |  4 +-
 tests/sync/test_locators.py             | 22 +++++--
 tests/sync/test_tracing.py              | 74 +++++++++++++++++++++++-
 21 files changed, 448 insertions(+), 157 deletions(-)

diff --git a/README.md b/README.md
index c7b9f0639..eb56e67c9 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 -->112.0.5615.20<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->112.0.5615.29<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->110.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->111.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index e9d0dde1b..24b07adc3 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -125,10 +125,7 @@ async def new_context(
 
         channel = await self._channel.send("newContext", params)
         context = cast(BrowserContext, from_channel(channel))
-        self._contexts.append(context)
-        context._browser = self
-        context._options = params
-        context._set_browser_type(self._browser_type)
+        self._browser_type._did_create_context(context, params, {})
         return context
 
     async def new_page(
@@ -175,11 +172,6 @@ async def new_page(
         context._owner_page = page
         return page
 
-    def _set_browser_type(self, browser_type: "BrowserType") -> None:
-        self._browser_type = browser_type
-        for context in self._contexts:
-            context._set_browser_type(browser_type)
-
     async def close(self) -> None:
         if self._is_closed_or_closing:
             return
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 42d59b7ee..f2787f862 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -14,6 +14,7 @@
 
 import asyncio
 import json
+import sys
 from pathlib import Path
 from types import SimpleNamespace
 from typing import (
@@ -59,7 +60,6 @@
     URLMatcher,
     async_readfile,
     async_writefile,
-    is_safe_close_error,
     locals_to_params,
     prepare_record_har_options,
     to_impl,
@@ -71,7 +71,11 @@
 
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._browser import Browser
-    from playwright._impl._browser_type import BrowserType
+
+if sys.version_info >= (3, 8):  # pragma: no cover
+    from typing import Literal
+else:  # pragma: no cover
+    from typing_extensions import Literal
 
 
 class BrowserContext(ChannelOwner):
@@ -90,11 +94,15 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        # circular import workaround:
+        self._browser: Optional["Browser"] = None
+        if parent.__class__.__name__ == "Browser":
+            self._browser = cast("Browser", parent)
+            self._browser._contexts.append(self)
         self._pages: List[Page] = []
         self._routes: List[RouteHandler] = []
         self._bindings: Dict[str, Any] = {}
         self._timeout_settings = TimeoutSettings(None)
-        self._browser: Optional["Browser"] = None
         self._owner_page: Optional[Page] = None
         self._options: Dict[str, Any] = {}
         self._background_pages: Set[Page] = set()
@@ -172,6 +180,7 @@ def __init__(
                 BrowserContext.Events.RequestFailed: "requestFailed",
             }
         )
+        self._close_was_called = False
 
     def __repr__(self) -> str:
         return f"<BrowserContext browser={self.browser}>"
@@ -226,13 +235,14 @@ def pages(self) -> List[Page]:
     def browser(self) -> Optional["Browser"]:
         return self._browser
 
-    def _set_browser_type(self, browser_type: "BrowserType") -> None:
-        self._browser_type = browser_type
+    def _set_options(self, context_options: Dict, browser_options: Dict) -> None:
+        self._options = context_options
         if self._options.get("recordHar"):
             self._har_recorders[""] = {
                 "path": self._options["recordHar"]["path"],
                 "content": self._options["recordHar"].get("content"),
             }
+        self._tracing._traces_dir = browser_options.get("tracesDir")
 
     async def new_page(self) -> Page:
         if self._owner_page:
@@ -328,15 +338,15 @@ async def _record_into_har(
         har: Union[Path, str],
         page: Optional[Page] = None,
         url: Union[Pattern[str], str] = None,
-        content: HarContentPolicy = None,
-        mode: HarMode = None,
+        update_content: HarContentPolicy = None,
+        update_mode: HarMode = None,
     ) -> None:
         params: Dict[str, Any] = {
             "options": prepare_record_har_options(
                 {
                     "recordHarPath": har,
-                    "recordHarContent": content or "attach",
-                    "recordHarMode": mode or "minimal",
+                    "recordHarContent": update_content or "attach",
+                    "recordHarMode": update_mode or "minimal",
                     "recordHarUrlFilter": url,
                 }
             )
@@ -344,7 +354,10 @@ async def _record_into_har(
         if page:
             params["page"] = page._channel
         har_id = await self._channel.send("harStart", params)
-        self._har_recorders[har_id] = {"path": str(har), "content": content or "attach"}
+        self._har_recorders[har_id] = {
+            "path": str(har),
+            "content": update_content or "attach",
+        }
 
     async def route_from_har(
         self,
@@ -352,12 +365,16 @@ async def route_from_har(
         url: Union[Pattern[str], str] = None,
         not_found: RouteFromHarNotFoundPolicy = None,
         update: bool = None,
-        content: HarContentPolicy = None,
-        mode: HarMode = None,
+        update_content: Literal["attach", "embed"] = None,
+        update_mode: HarMode = None,
     ) -> None:
         if update:
             await self._record_into_har(
-                har=har, page=None, url=url, content=content, mode=mode
+                har=har,
+                page=None,
+                url=url,
+                update_content=update_content,
+                update_mode=update_mode,
             )
             return
         router = await HarRouter.create(
@@ -400,7 +417,11 @@ def _on_close(self) -> None:
         self.emit(BrowserContext.Events.Close, self)
 
     async def close(self) -> None:
-        try:
+        if self._close_was_called:
+            return
+        self._close_was_called = True
+
+        async def _inner_close() -> None:
             for har_id, params in self._har_recorders.items():
                 har = cast(
                     Artifact,
@@ -422,11 +443,10 @@ async def close(self) -> None:
                 else:
                     await har.save_as(params["path"])
                 await har.delete()
-            await self._channel.send("close")
-            await self._closed_future
-        except Exception as e:
-            if not is_safe_close_error(e):
-                raise e
+
+        await self._channel._connection.wrap_api_call(_inner_close, True)
+        await self._channel.send("close")
+        await self._closed_future
 
     async def _pause(self) -> None:
         await self._channel.send("pause")
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index afe69980d..07287d609 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -92,7 +92,7 @@ async def launch(
         browser = cast(
             Browser, from_channel(await self._channel.send("launch", params))
         )
-        browser._set_browser_type(self)
+        self._did_launch_browser(browser)
         return browser
 
     async def launch_persistent_context(
@@ -154,8 +154,7 @@ async def launch_persistent_context(
             BrowserContext,
             from_channel(await self._channel.send("launchPersistentContext", params)),
         )
-        context._options = params
-        context._set_browser_type(self)
+        self._did_create_context(context, params, params)
         return context
 
     async def connect_over_cdp(
@@ -168,15 +167,14 @@ async def connect_over_cdp(
         params = locals_to_params(locals())
         response = await self._channel.send_return_as_dict("connectOverCDP", params)
         browser = cast(Browser, from_channel(response["browser"]))
+        self._did_launch_browser(browser)
 
         default_context = cast(
             Optional[BrowserContext],
             from_nullable_channel(response.get("defaultContext")),
         )
         if default_context:
-            browser._contexts.append(default_context)
-            default_context._browser = browser
-        browser._set_browser_type(self)
+            self._did_create_context(default_context, {}, {})
         return browser
 
     async def connect(
@@ -231,6 +229,7 @@ async def connect(
         pre_launched_browser = playwright._initializer.get("preLaunchedBrowser")
         assert pre_launched_browser
         browser = cast(Browser, from_channel(pre_launched_browser))
+        self._did_launch_browser(browser)
         browser._should_close_connection_on_close = True
 
         def handle_transport_close() -> None:
@@ -243,9 +242,16 @@ def handle_transport_close() -> None:
 
         transport.once("close", handle_transport_close)
 
-        browser._set_browser_type(self)
         return browser
 
+    def _did_create_context(
+        self, context: BrowserContext, context_options: Dict, browser_options: Dict
+    ) -> None:
+        context._set_options(context_options, browser_options)
+
+    def _did_launch_browser(self, browser: Browser) -> None:
+        browser._browser_type = self
+
 
 def normalize_launch_params(params: Dict) -> None:
     if "env" in params:
@@ -261,3 +267,5 @@ def normalize_launch_params(params: Dict) -> None:
         params["executablePath"] = str(Path(params["executablePath"]))
     if "downloadsPath" in params:
         params["downloadsPath"] = str(Path(params["downloadsPath"]))
+    if "tracesDir" in params:
+        params["tracesDir"] = str(Path(params["tracesDir"]))
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 88bf1b5a0..aa57f2157 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -19,7 +19,17 @@
 import sys
 import traceback
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Union, cast
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    List,
+    Mapping,
+    Optional,
+    Union,
+    cast,
+)
 
 from greenlet import greenlet
 from pyee import EventEmitter
@@ -231,7 +241,7 @@ def __init__(
             Optional[ParsedStackTrace]
         ] = contextvars.ContextVar("ApiZone", default=None)
         self._local_utils: Optional["LocalUtils"] = local_utils
-        self._stack_collector: List[List[Dict[str, Any]]] = []
+        self._tracing_count = 0
 
     @property
     def local_utils(self) -> "LocalUtils":
@@ -279,12 +289,11 @@ def call_on_object_with_known_name(
     ) -> None:
         self._waiting_for_object[guid] = callback
 
-    def start_collecting_call_metadata(self, collector: Any) -> None:
-        if collector not in self._stack_collector:
-            self._stack_collector.append(collector)
-
-    def stop_collecting_call_metadata(self, collector: Any) -> None:
-        self._stack_collector.remove(collector)
+    def set_in_tracing(self, is_tracing: bool) -> None:
+        if is_tracing:
+            self._tracing_count += 1
+        else:
+            self._tracing_count -= 1
 
     def _send_message_to_server(
         self, guid: str, method: str, params: Dict
@@ -299,8 +308,6 @@ def _send_message_to_server(
         )
         self._callbacks[id] = callback
         stack_trace_information = cast(ParsedStackTrace, self._api_zone.get())
-        for collector in self._stack_collector:
-            collector.append({"stack": stack_trace_information["frames"], "id": id})
         frames = stack_trace_information.get("frames", [])
         location = (
             {
@@ -325,6 +332,10 @@ def _send_message_to_server(
         }
         self._transport.send(message)
         self._callbacks[id] = callback
+
+        if self._tracing_count > 0 and frames and guid != "localUtils":
+            self.local_utils.add_stack_to_tracing_no_reply(id, frames)
+
         return callback
 
     def dispatch(self, msg: ParsedMessagePayload) -> None:
@@ -521,3 +532,7 @@ def _extract_stack_trace_information_from_stack(
         "frames": parsed_frames,
         "apiName": "" if is_internal else api_name,
     }
+
+
+def filter_none(d: Mapping) -> Dict:
+    return {k: v for k, v in d.items() if v is not None}
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index 1d351c124..997133227 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -29,7 +29,7 @@
     ServerFilePayload,
     StorageState,
 )
-from playwright._impl._connection import ChannelOwner, from_channel
+from playwright._impl._connection import ChannelOwner, filter_none, from_channel
 from playwright._impl._helper import (
     Error,
     NameValue,
@@ -366,9 +366,6 @@ async def _inner_fetch(
             base64.b64encode(post_data_buffer).decode() if post_data_buffer else None
         )
 
-        def filter_none(input: Dict) -> Dict:
-            return {k: v for k, v in input.items() if v is not None}
-
         response = await self._channel.send(
             "fetch",
             filter_none(
diff --git a/playwright/_impl/_local_utils.py b/playwright/_impl/_local_utils.py
index 10303008d..6b97386c4 100644
--- a/playwright/_impl/_local_utils.py
+++ b/playwright/_impl/_local_utils.py
@@ -13,10 +13,10 @@
 # limitations under the License.
 
 import base64
-from typing import Dict, Optional, cast
+from typing import Dict, List, Optional, cast
 
 from playwright._impl._api_structures import HeadersArray
-from playwright._impl._connection import ChannelOwner
+from playwright._impl._connection import ChannelOwner, StackFrame
 from playwright._impl._helper import HarLookupResult, locals_to_params
 
 
@@ -57,3 +57,21 @@ async def har_close(self, harId: str) -> None:
     async def har_unzip(self, zipFile: str, harFile: str) -> None:
         params = locals_to_params(locals())
         await self._channel.send("harUnzip", params)
+
+    async def tracing_started(self, tracesDir: Optional[str], traceName: str) -> str:
+        params = locals_to_params(locals())
+        return await self._channel.send("tracingStarted", params)
+
+    async def trace_discarded(self, stacks_id: str) -> None:
+        return await self._channel.send("traceDiscarded", {"stacks_id": stacks_id})
+
+    def add_stack_to_tracing_no_reply(self, id: int, frames: List[StackFrame]) -> None:
+        self._channel.send_no_reply(
+            "addStackToTracingNoReply",
+            {
+                "callData": {
+                    "stack": frames,
+                    "id": id,
+                }
+            },
+        )
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 990d055fd..7b288170b 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -37,6 +37,7 @@
     FrameExpectResult,
     Position,
 )
+from playwright._impl._connection import filter_none
 from playwright._impl._element_handle import ElementHandle
 from playwright._impl._helper import (
     Error,
@@ -654,7 +655,7 @@ async def _expect(
             {
                 "selector": self._selector,
                 "expression": expression,
-                **({k: v for k, v in options.items() if v is not None}),
+                **(filter_none(options)),
             },
         )
         if result.get("received"):
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 897cfbc14..fdd7571ad 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -59,7 +59,6 @@
     ColorScheme,
     DocumentLoadState,
     ForcedColors,
-    HarContentPolicy,
     HarMode,
     KeyboardModifier,
     MouseButton,
@@ -619,12 +618,16 @@ async def route_from_har(
         url: Union[Pattern[str], str] = None,
         not_found: RouteFromHarNotFoundPolicy = None,
         update: bool = None,
-        content: HarContentPolicy = None,
-        mode: HarMode = None,
+        update_content: Literal["attach", "embed"] = None,
+        update_mode: HarMode = None,
     ) -> None:
         if update:
             await self._browser_context._record_into_har(
-                har=har, page=self, url=url, content=content, mode=mode
+                har=har,
+                page=self,
+                url=url,
+                update_content=update_content,
+                update_mode=update_mode,
             )
             return
         router = await HarRouter.create(
@@ -686,7 +689,7 @@ async def close(self, runBeforeUnload: bool = None) -> None:
             if self._owned_context:
                 await self._owned_context.close()
         except Exception as e:
-            if not is_safe_close_error(e):
+            if not is_safe_close_error(e) and not runBeforeUnload:
                 raise e
 
     def is_closed(self) -> bool:
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index 3d117938a..509bbe336 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -13,10 +13,14 @@
 # limitations under the License.
 
 import pathlib
-from typing import Any, Dict, List, Optional, Union, cast
+from typing import Dict, Optional, Union, cast
 
 from playwright._impl._artifact import Artifact
-from playwright._impl._connection import ChannelOwner, from_nullable_channel
+from playwright._impl._connection import (
+    ChannelOwner,
+    filter_none,
+    from_nullable_channel,
+)
 from playwright._impl._helper import locals_to_params
 
 
@@ -26,7 +30,9 @@ def __init__(
     ) -> None:
         super().__init__(parent, type, guid, initializer)
         self._include_sources: bool = False
-        self._metadata_collector: List[Dict[str, Any]] = []
+        self._stacks_id: Optional[str] = None
+        self._is_tracing: bool = False
+        self._traces_dir: Optional[str] = None
 
     async def start(
         self,
@@ -38,18 +44,28 @@ async def start(
     ) -> None:
         params = locals_to_params(locals())
         self._include_sources = bool(sources)
-        await self._channel.send("tracingStart", params)
-        await self._channel.send(
-            "tracingStartChunk", {"title": title} if title else None
-        )
-        self._metadata_collector = []
-        self._connection.start_collecting_call_metadata(self._metadata_collector)
 
-    async def start_chunk(self, title: str = None) -> None:
+        async def _inner_start() -> str:
+            await self._channel.send("tracingStart", params)
+            return await self._channel.send(
+                "tracingStartChunk", filter_none({"title": title, "name": name})
+            )
+
+        trace_name = await self._connection.wrap_api_call(_inner_start)
+        await self._start_collecting_stacks(trace_name)
+
+    async def start_chunk(self, title: str = None, name: str = None) -> None:
         params = locals_to_params(locals())
-        await self._channel.send("tracingStartChunk", params)
-        self._metadata_collector = []
-        self._connection.start_collecting_call_metadata(self._metadata_collector)
+        trace_name = await self._channel.send("tracingStartChunk", params)
+        await self._start_collecting_stacks(trace_name)
+
+    async def _start_collecting_stacks(self, trace_name: str) -> None:
+        if not self._is_tracing:
+            self._is_tracing = True
+            self._connection.set_in_tracing(True)
+        self._stacks_id = await self._connection.local_utils.tracing_started(
+            self._traces_dir, trace_name
+        )
 
     async def stop_chunk(self, path: Union[pathlib.Path, str] = None) -> None:
         await self._do_stop_chunk(path)
@@ -59,14 +75,15 @@ async def stop(self, path: Union[pathlib.Path, str] = None) -> None:
         await self._channel.send("tracingStop")
 
     async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> None:
-        if self._metadata_collector:
-            self._connection.stop_collecting_call_metadata(self._metadata_collector)
-        metadata = self._metadata_collector
-        self._metadata_collector = []
+        if self._is_tracing:
+            self._is_tracing = False
+            self._connection.set_in_tracing(False)
 
         if not file_path:
-            await self._channel.send("tracingStopChunk", {"mode": "discard"})
             # Not interested in any artifacts
+            await self._channel.send("tracingStopChunk", {"mode": "discard"})
+            if self._stacks_id:
+                await self._connection.local_utils.trace_discarded(self._stacks_id)
             return
 
         is_local = not self._connection.is_remote
@@ -79,7 +96,7 @@ async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> No
                 {
                     "zipFile": str(file_path),
                     "entries": result["entries"],
-                    "metadata": metadata,
+                    "stacksId": self._stacks_id,
                     "mode": "write",
                     "includeSources": self._include_sources,
                 }
@@ -100,20 +117,20 @@ async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> No
 
         # The artifact may be missing if the browser closed while stopping tracing.
         if not artifact:
+            if self._stacks_id:
+                await self._connection.local_utils.trace_discarded(self._stacks_id)
             return
 
         # Save trace to the final local file.
         await artifact.save_as(file_path)
         await artifact.delete()
 
-        # Add local sources to the remote trace if necessary.
-        if len(metadata) > 0:
-            await self._connection.local_utils.zip(
-                {
-                    "zipFile": str(file_path),
-                    "entries": [],
-                    "metadata": metadata,
-                    "mode": "append",
-                    "includeSources": self._include_sources,
-                }
-            )
+        await self._connection.local_utils.zip(
+            {
+                "zipFile": str(file_path),
+                "entries": [],
+                "stacksId": self._stacks_id,
+                "mode": "append",
+                "includeSources": self._include_sources,
+            }
+        )
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 7dfcf336d..50631e826 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -4748,22 +4748,26 @@ def get_by_label(
     ) -> "Locator":
         """Frame.get_by_label
 
-        Allows locating input elements by the text of the associated label.
+        Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
+        `aria-label` attribute.
 
         **Usage**
 
-        For example, this method will find the input by label text \"Password\" in the following DOM:
+        For example, this method will find inputs by label \"Username\" and \"Password\" in the following DOM:
 
         ```html
+        <input aria-label=\"Username\">
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
         ```py
+        await page.get_by_label(\"Username\").fill(\"john\")
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
         ```py
+        page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
@@ -6278,22 +6282,26 @@ def get_by_label(
     ) -> "Locator":
         """FrameLocator.get_by_label
 
-        Allows locating input elements by the text of the associated label.
+        Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
+        `aria-label` attribute.
 
         **Usage**
 
-        For example, this method will find the input by label text \"Password\" in the following DOM:
+        For example, this method will find inputs by label \"Username\" and \"Password\" in the following DOM:
 
         ```html
+        <input aria-label=\"Username\">
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
         ```py
+        await page.get_by_label(\"Username\").fill(\"john\")
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
         ```py
+        page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
@@ -9767,8 +9775,8 @@ async def route_from_har(
         url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
-        content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
-        mode: typing.Optional[Literal["full", "minimal"]] = None
+        update_content: typing.Optional[Literal["attach", "embed"]] = None,
+        update_mode: typing.Optional[Literal["full", "minimal"]] = None
     ) -> None:
         """Page.route_from_har
 
@@ -9795,8 +9803,12 @@ async def route_from_har(
         update : Union[bool, None]
             If specified, updates the given HAR with the actual network information instead of serving from file. The file is
             written to disk when `browser_context.close()` is called.
-        content : Union["attach", "embed", "omit", None]
-        mode : Union["full", "minimal", None]
+        update_content : Union["attach", "embed", None]
+            Optional setting to control resource content management. If `attach` is specified, resources are persisted as
+            separate files or entries in the ZIP archive. If `embed` is specified, content is stored inline the HAR file.
+        update_mode : Union["full", "minimal", None]
+            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         """
 
         return mapping.from_maybe_impl(
@@ -9805,8 +9817,8 @@ async def route_from_har(
                 url=url,
                 not_found=not_found,
                 update=update,
-                content=content,
-                mode=mode,
+                update_content=update_content,
+                update_mode=update_mode,
             )
         )
 
@@ -10310,22 +10322,26 @@ def get_by_label(
     ) -> "Locator":
         """Page.get_by_label
 
-        Allows locating input elements by the text of the associated label.
+        Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
+        `aria-label` attribute.
 
         **Usage**
 
-        For example, this method will find the input by label text \"Password\" in the following DOM:
+        For example, this method will find inputs by label \"Username\" and \"Password\" in the following DOM:
 
         ```html
+        <input aria-label=\"Username\">
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
         ```py
+        await page.get_by_label(\"Username\").fill(\"john\")
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
         ```py
+        page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
@@ -13361,8 +13377,8 @@ async def route_from_har(
         url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
-        content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
-        mode: typing.Optional[Literal["full", "minimal"]] = None
+        update_content: typing.Optional[Literal["attach", "embed"]] = None,
+        update_mode: typing.Optional[Literal["full", "minimal"]] = None
     ) -> None:
         """BrowserContext.route_from_har
 
@@ -13389,11 +13405,10 @@ async def route_from_har(
         update : Union[bool, None]
             If specified, updates the given HAR with the actual network information instead of serving from file. The file is
             written to disk when `browser_context.close()` is called.
-        content : Union["attach", "embed", "omit", None]
-            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
-            `attach` is specified, resources are persisted as separate files or entries in the ZIP archive. If `embed` is
-            specified, content is stored inline the HAR file
-        mode : Union["full", "minimal", None]
+        update_content : Union["attach", "embed", None]
+            Optional setting to control resource content management. If `attach` is specified, resources are persisted as
+            separate files or entries in the ZIP archive. If `embed` is specified, content is stored inline the HAR file.
+        update_mode : Union["full", "minimal", None]
             When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
             cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to
             `minimal`.
@@ -13405,8 +13420,8 @@ async def route_from_har(
                 url=url,
                 not_found=not_found,
                 update=update,
-                content=content,
-                mode=mode,
+                update_content=update_content,
+                update_mode=update_mode,
             )
         )
 
@@ -14990,7 +15005,9 @@ async def start(
             )
         )
 
-    async def start_chunk(self, *, title: typing.Optional[str] = None) -> None:
+    async def start_chunk(
+        self, *, title: typing.Optional[str] = None, name: typing.Optional[str] = None
+    ) -> None:
         """Tracing.start_chunk
 
         Start a new trace chunk. If you'd like to record multiple traces on the same `BrowserContext`, use
@@ -15035,9 +15052,14 @@ async def start_chunk(self, *, title: typing.Optional[str] = None) -> None:
         ----------
         title : Union[str, None]
             Trace name to be shown in the Trace Viewer.
+        name : Union[str, None]
+            If specified, the trace is going to be saved into the file with the given name inside the `tracesDir` folder
+            specified in `browser_type.launch()`.
         """
 
-        return mapping.from_maybe_impl(await self._impl_obj.start_chunk(title=title))
+        return mapping.from_maybe_impl(
+            await self._impl_obj.start_chunk(title=title, name=name)
+        )
 
     async def stop_chunk(
         self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
@@ -15823,22 +15845,26 @@ def get_by_label(
     ) -> "Locator":
         """Locator.get_by_label
 
-        Allows locating input elements by the text of the associated label.
+        Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
+        `aria-label` attribute.
 
         **Usage**
 
-        For example, this method will find the input by label text \"Password\" in the following DOM:
+        For example, this method will find inputs by label \"Username\" and \"Password\" in the following DOM:
 
         ```html
+        <input aria-label=\"Username\">
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
         ```py
+        await page.get_by_label(\"Username\").fill(\"john\")
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
         ```py
+        page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 2b0750302..f0cd1b0f9 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -4834,22 +4834,26 @@ def get_by_label(
     ) -> "Locator":
         """Frame.get_by_label
 
-        Allows locating input elements by the text of the associated label.
+        Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
+        `aria-label` attribute.
 
         **Usage**
 
-        For example, this method will find the input by label text \"Password\" in the following DOM:
+        For example, this method will find inputs by label \"Username\" and \"Password\" in the following DOM:
 
         ```html
+        <input aria-label=\"Username\">
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
         ```py
+        await page.get_by_label(\"Username\").fill(\"john\")
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
         ```py
+        page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
@@ -6394,22 +6398,26 @@ def get_by_label(
     ) -> "Locator":
         """FrameLocator.get_by_label
 
-        Allows locating input elements by the text of the associated label.
+        Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
+        `aria-label` attribute.
 
         **Usage**
 
-        For example, this method will find the input by label text \"Password\" in the following DOM:
+        For example, this method will find inputs by label \"Username\" and \"Password\" in the following DOM:
 
         ```html
+        <input aria-label=\"Username\">
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
         ```py
+        await page.get_by_label(\"Username\").fill(\"john\")
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
         ```py
+        page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
@@ -9829,8 +9837,8 @@ def route_from_har(
         url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
-        content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
-        mode: typing.Optional[Literal["full", "minimal"]] = None
+        update_content: typing.Optional[Literal["attach", "embed"]] = None,
+        update_mode: typing.Optional[Literal["full", "minimal"]] = None
     ) -> None:
         """Page.route_from_har
 
@@ -9857,8 +9865,12 @@ def route_from_har(
         update : Union[bool, None]
             If specified, updates the given HAR with the actual network information instead of serving from file. The file is
             written to disk when `browser_context.close()` is called.
-        content : Union["attach", "embed", "omit", None]
-        mode : Union["full", "minimal", None]
+        update_content : Union["attach", "embed", None]
+            Optional setting to control resource content management. If `attach` is specified, resources are persisted as
+            separate files or entries in the ZIP archive. If `embed` is specified, content is stored inline the HAR file.
+        update_mode : Union["full", "minimal", None]
+            When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
         """
 
         return mapping.from_maybe_impl(
@@ -9868,8 +9880,8 @@ def route_from_har(
                     url=url,
                     not_found=not_found,
                     update=update,
-                    content=content,
-                    mode=mode,
+                    update_content=update_content,
+                    update_mode=update_mode,
                 )
             )
         )
@@ -10384,22 +10396,26 @@ def get_by_label(
     ) -> "Locator":
         """Page.get_by_label
 
-        Allows locating input elements by the text of the associated label.
+        Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
+        `aria-label` attribute.
 
         **Usage**
 
-        For example, this method will find the input by label text \"Password\" in the following DOM:
+        For example, this method will find inputs by label \"Username\" and \"Password\" in the following DOM:
 
         ```html
+        <input aria-label=\"Username\">
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
         ```py
+        await page.get_by_label(\"Username\").fill(\"john\")
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
         ```py
+        page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
@@ -13429,8 +13445,8 @@ def route_from_har(
         url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
-        content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
-        mode: typing.Optional[Literal["full", "minimal"]] = None
+        update_content: typing.Optional[Literal["attach", "embed"]] = None,
+        update_mode: typing.Optional[Literal["full", "minimal"]] = None
     ) -> None:
         """BrowserContext.route_from_har
 
@@ -13457,11 +13473,10 @@ def route_from_har(
         update : Union[bool, None]
             If specified, updates the given HAR with the actual network information instead of serving from file. The file is
             written to disk when `browser_context.close()` is called.
-        content : Union["attach", "embed", "omit", None]
-            Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
-            `attach` is specified, resources are persisted as separate files or entries in the ZIP archive. If `embed` is
-            specified, content is stored inline the HAR file
-        mode : Union["full", "minimal", None]
+        update_content : Union["attach", "embed", None]
+            Optional setting to control resource content management. If `attach` is specified, resources are persisted as
+            separate files or entries in the ZIP archive. If `embed` is specified, content is stored inline the HAR file.
+        update_mode : Union["full", "minimal", None]
             When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
             cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to
             `minimal`.
@@ -13474,8 +13489,8 @@ def route_from_har(
                     url=url,
                     not_found=not_found,
                     update=update,
-                    content=content,
-                    mode=mode,
+                    update_content=update_content,
+                    update_mode=update_mode,
                 )
             )
         )
@@ -15076,7 +15091,9 @@ def start(
             )
         )
 
-    def start_chunk(self, *, title: typing.Optional[str] = None) -> None:
+    def start_chunk(
+        self, *, title: typing.Optional[str] = None, name: typing.Optional[str] = None
+    ) -> None:
         """Tracing.start_chunk
 
         Start a new trace chunk. If you'd like to record multiple traces on the same `BrowserContext`, use
@@ -15121,10 +15138,13 @@ def start_chunk(self, *, title: typing.Optional[str] = None) -> None:
         ----------
         title : Union[str, None]
             Trace name to be shown in the Trace Viewer.
+        name : Union[str, None]
+            If specified, the trace is going to be saved into the file with the given name inside the `tracesDir` folder
+            specified in `browser_type.launch()`.
         """
 
         return mapping.from_maybe_impl(
-            self._sync(self._impl_obj.start_chunk(title=title))
+            self._sync(self._impl_obj.start_chunk(title=title, name=name))
         )
 
     def stop_chunk(
@@ -15929,22 +15949,26 @@ def get_by_label(
     ) -> "Locator":
         """Locator.get_by_label
 
-        Allows locating input elements by the text of the associated label.
+        Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
+        `aria-label` attribute.
 
         **Usage**
 
-        For example, this method will find the input by label text \"Password\" in the following DOM:
+        For example, this method will find inputs by label \"Username\" and \"Password\" in the following DOM:
 
         ```html
+        <input aria-label=\"Username\">
         <label for=\"password-input\">Password:</label>
         <input id=\"password-input\">
         ```
 
         ```py
+        await page.get_by_label(\"Username\").fill(\"john\")
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
         ```py
+        page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
diff --git a/setup.py b/setup.py
index 02f0c589d..94d7783b2 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.32.0-alpha-mar-15-2023"
+driver_version = "1.32.0-beta-1679448099000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index 33e9184aa..cc152abbf 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -17,6 +17,7 @@
 from typing import Callable
 
 import pytest
+from flaky import flaky
 
 from playwright.async_api import BrowserType, Error, Playwright, Route
 from tests.conftest import RemoteServer
@@ -245,6 +246,7 @@ async def handle_request(route: Route) -> None:
     remote.kill()
 
 
+@flaky
 async def test_should_upload_large_file(
     browser_type: BrowserType,
     launch_server: Callable[[], RemoteServer],
diff --git a/tests/async/test_har.py b/tests/async/test_har.py
index d22e3b8c6..ce0b228c4 100644
--- a/tests/async/test_har.py
+++ b/tests/async/test_har.py
@@ -656,7 +656,9 @@ async def test_should_update_har_zip_for_page_with_different_options(
     har_path = tmpdir / "har.zip"
     context1 = await browser.new_context()
     page1 = await context1.new_page()
-    await page1.route_from_har(har_path, update=True, content="embed", mode="full")
+    await page1.route_from_har(
+        har_path, update=True, update_content="embed", update_mode="full"
+    )
     await page1.goto(server.PREFIX + "/one-style.html")
     await context1.close()
 
diff --git a/tests/async/test_input.py b/tests/async/test_input.py
index f93e44fc5..10248fa60 100644
--- a/tests/async/test_input.py
+++ b/tests/async/test_input.py
@@ -18,6 +18,7 @@
 import sys
 
 import pytest
+from flaky import flaky
 
 from playwright._impl._path_utils import get_file_dirname
 from playwright.async_api import Page
@@ -306,6 +307,7 @@ async def _listen_for_wheel_events(page: Page, selector: str) -> None:
     )
 
 
+@flaky
 async def test_should_upload_large_file(page, server, tmp_path):
     await page.goto(server.PREFIX + "/input/fileupload.html")
     large_file_path = tmp_path / "200MB.zip"
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index fea33ef75..e598b3b89 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -782,15 +782,19 @@ async def test_locator_should_support_has_locator(page: Page, server: Server) ->
     await page.set_content("<div><span>hello</span></div><div><span>world</span></div>")
     await expect(page.locator("div", has=page.locator("text=world"))).to_have_count(1)
     assert (
-        await page.locator("div", has=page.locator("text=world")).evaluate(
-            "e => e.outerHTML"
+        _remove_highlight(
+            await page.locator("div", has=page.locator("text=world")).evaluate(
+                "e => e.outerHTML"
+            )
         )
         == "<div><span>world</span></div>"
     )
     await expect(page.locator("div", has=page.locator('text="hello"'))).to_have_count(1)
     assert (
-        await page.locator("div", has=page.locator('text="hello"')).evaluate(
-            "e => e.outerHTML"
+        _remove_highlight(
+            await page.locator("div", has=page.locator('text="hello"')).evaluate(
+                "e => e.outerHTML"
+            )
         )
         == "<div><span>hello</span></div>"
     )
@@ -800,8 +804,10 @@ async def test_locator_should_support_has_locator(page: Page, server: Server) ->
         page.locator("div", has=page.locator("span", has_text="wor"))
     ).to_have_count(1)
     assert (
-        await page.locator("div", has=page.locator("span", has_text="wor")).evaluate(
-            "e => e.outerHTML"
+        _remove_highlight(
+            await page.locator(
+                "div", has=page.locator("span", has_text="wor")
+            ).evaluate("e => e.outerHTML")
         )
         == "<div><span>world</span></div>"
     )
@@ -814,6 +820,10 @@ async def test_locator_should_support_has_locator(page: Page, server: Server) ->
     ).to_have_count(1)
 
 
+def _remove_highlight(markup: str) -> str:
+    return re.sub(r"\s__playwright_target__=\"[^\"]+\"", "", markup)
+
+
 async def test_locator_should_enforce_same_frame_for_has_locator(
     page: Page, server: Server
 ) -> None:
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index 937798a3e..fe436c654 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -13,11 +13,12 @@
 # limitations under the License.
 
 import json
+import re
 import zipfile
 from pathlib import Path
 from typing import Any, Dict, List, Tuple
 
-from playwright.async_api import Browser, BrowserContext, Page
+from playwright.async_api import Browser, BrowserContext, BrowserType, Page
 from tests.server import Server
 
 
@@ -223,15 +224,84 @@ async def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
     ]
 
 
+async def test_should_respect_traces_dir_and_name(
+    browser_type: BrowserType,
+    server: Server,
+    tmpdir: Path,
+    launch_arguments: Dict[str, str],
+) -> None:
+    traces_dir = tmpdir / "traces"
+    browser = await browser_type.launch(traces_dir=traces_dir, **launch_arguments)
+    context = await browser.new_context()
+    page = await context.new_page()
+
+    await context.tracing.start(name="name1", snapshots=True)
+    await page.goto(server.PREFIX + "/one-style.html")
+    await context.tracing.stop_chunk(path=tmpdir / "trace1.zip")
+    assert (traces_dir / "name1.trace").exists()
+    assert (traces_dir / "name1.network").exists()
+
+    await context.tracing.start_chunk(name="name2")
+    await page.goto(server.PREFIX + "/har.html")
+    await context.tracing.stop(path=tmpdir / "trace2.zip")
+    assert (traces_dir / "name2.trace").exists()
+    assert (traces_dir / "name2.network").exists()
+
+    await browser.close()
+
+    def resource_names(resources: Dict[str, bytes]) -> List[str]:
+        return sorted(
+            [
+                re.sub(r"^resources/.*\.(html|css)$", r"resources/XXX.\g<1>", file)
+                for file in resources.keys()
+            ]
+        )
+
+    (resources, events) = parse_trace(tmpdir / "trace1.zip")
+    assert get_actions(events) == ["Page.goto"]
+    assert resource_names(resources) == [
+        "resources/XXX.css",
+        "resources/XXX.html",
+        "trace.network",
+        "trace.stacks",
+        "trace.trace",
+    ]
+
+    (resources, events) = parse_trace(tmpdir / "trace2.zip")
+    assert get_actions(events) == ["Page.goto"]
+    assert resource_names(resources) == [
+        "resources/XXX.css",
+        "resources/XXX.html",
+        "resources/XXX.html",
+        "trace.network",
+        "trace.stacks",
+        "trace.trace",
+    ]
+
+
 def parse_trace(path: Path) -> Tuple[Dict[str, bytes], List[Any]]:
     resources: Dict[str, bytes] = {}
     with zipfile.ZipFile(path, "r") as zip:
         for name in zip.namelist():
             resources[name] = zip.read(name)
+    action_map: Dict[str, Any] = {}
     events: List[Any] = []
     for name in ["trace.trace", "trace.network"]:
         for line in resources[name].decode().splitlines():
-            events.append(json.loads(line))
+            if not line:
+                continue
+            event = json.loads(line)
+            if event["type"] == "before":
+                event["type"] = "action"
+                action_map[event["callId"]] = event
+                events.append(event)
+            elif event["type"] == "input":
+                pass
+            elif event["type"] == "after":
+                existing = action_map[event["callId"]]
+                existing["error"] = event.get("error", None)
+            else:
+                events.append(event)
     return (resources, events)
 
 
diff --git a/tests/sync/test_har.py b/tests/sync/test_har.py
index 4b7d5e0d0..0644d3856 100644
--- a/tests/sync/test_har.py
+++ b/tests/sync/test_har.py
@@ -584,7 +584,9 @@ def test_should_update_har_zip_for_page_with_different_options(
     har_path = tmpdir / "har.zip"
     context1 = browser.new_context()
     page1 = context1.new_page()
-    page1.route_from_har(har_path, update=True, content="embed", mode="full")
+    page1.route_from_har(
+        har_path, update=True, update_content="embed", update_mode="full"
+    )
     page1.goto(server.PREFIX + "/one-style.html")
     context1.close()
 
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 7c678ace8..b2604e164 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -702,13 +702,19 @@ def test_locator_should_support_has_locator(page: Page, server: Server) -> None:
     page.set_content("<div><span>hello</span></div><div><span>world</span></div>")
     expect(page.locator("div", has=page.locator("text=world"))).to_have_count(1)
     assert (
-        page.locator("div", has=page.locator("text=world")).evaluate("e => e.outerHTML")
+        _remove_highlight(
+            page.locator("div", has=page.locator("text=world")).evaluate(
+                "e => e.outerHTML"
+            )
+        )
         == "<div><span>world</span></div>"
     )
     expect(page.locator("div", has=page.locator('text="hello"'))).to_have_count(1)
     assert (
-        page.locator("div", has=page.locator('text="hello"')).evaluate(
-            "e => e.outerHTML"
+        _remove_highlight(
+            page.locator("div", has=page.locator('text="hello"')).evaluate(
+                "e => e.outerHTML"
+            )
         )
         == "<div><span>hello</span></div>"
     )
@@ -718,8 +724,10 @@ def test_locator_should_support_has_locator(page: Page, server: Server) -> None:
         1
     )
     assert (
-        page.locator("div", has=page.locator("span", has_text="wor")).evaluate(
-            "e => e.outerHTML"
+        _remove_highlight(
+            page.locator("div", has=page.locator("span", has_text="wor")).evaluate(
+                "e => e.outerHTML"
+            )
         )
         == "<div><span>world</span></div>"
     )
@@ -732,6 +740,10 @@ def test_locator_should_support_has_locator(page: Page, server: Server) -> None:
     ).to_have_count(1)
 
 
+def _remove_highlight(markup: str) -> str:
+    return re.sub(r"\s__playwright_target__=\"[^\"]+\"", "", markup)
+
+
 def test_locator_should_enforce_same_frame_for_has_locator(
     page: Page, server: Server
 ) -> None:
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index 049a571c4..5c5084240 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -13,11 +13,12 @@
 # limitations under the License.
 
 import json
+import re
 import zipfile
 from pathlib import Path
 from typing import Any, Dict, List, Tuple
 
-from playwright.sync_api import Browser, BrowserContext, Page
+from playwright.sync_api import Browser, BrowserContext, BrowserType, Page
 from tests.server import Server
 
 
@@ -223,15 +224,84 @@ def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
     ]
 
 
+def test_should_respect_traces_dir_and_name(
+    browser_type: BrowserType,
+    server: Server,
+    tmpdir: Path,
+    launch_arguments: Any,
+) -> None:
+    traces_dir = tmpdir / "traces"
+    browser = browser_type.launch(traces_dir=traces_dir, **launch_arguments)
+    context = browser.new_context()
+    page = context.new_page()
+
+    context.tracing.start(name="name1", snapshots=True)
+    page.goto(server.PREFIX + "/one-style.html")
+    context.tracing.stop_chunk(path=tmpdir / "trace1.zip")
+    assert (traces_dir / "name1.trace").exists()
+    assert (traces_dir / "name1.network").exists()
+
+    context.tracing.start_chunk(name="name2")
+    page.goto(server.PREFIX + "/har.html")
+    context.tracing.stop(path=tmpdir / "trace2.zip")
+    assert (traces_dir / "name2.trace").exists()
+    assert (traces_dir / "name2.network").exists()
+
+    browser.close()
+
+    def resource_names(resources: Dict[str, bytes]) -> List[str]:
+        return sorted(
+            [
+                re.sub(r"^resources/.*\.(html|css)$", r"resources/XXX.\g<1>", file)
+                for file in resources.keys()
+            ]
+        )
+
+    (resources, events) = parse_trace(tmpdir / "trace1.zip")
+    assert get_actions(events) == ["Page.goto"]
+    assert resource_names(resources) == [
+        "resources/XXX.css",
+        "resources/XXX.html",
+        "trace.network",
+        "trace.stacks",
+        "trace.trace",
+    ]
+
+    (resources, events) = parse_trace(tmpdir / "trace2.zip")
+    assert get_actions(events) == ["Page.goto"]
+    assert resource_names(resources) == [
+        "resources/XXX.css",
+        "resources/XXX.html",
+        "resources/XXX.html",
+        "trace.network",
+        "trace.stacks",
+        "trace.trace",
+    ]
+
+
 def parse_trace(path: Path) -> Tuple[Dict[str, bytes], List[Any]]:
     resources: Dict[str, bytes] = {}
     with zipfile.ZipFile(path, "r") as zip:
         for name in zip.namelist():
             resources[name] = zip.read(name)
+    action_map: Dict[str, Any] = {}
     events: List[Any] = []
     for name in ["trace.trace", "trace.network"]:
         for line in resources[name].decode().splitlines():
-            events.append(json.loads(line))
+            if not line:
+                continue
+            event = json.loads(line)
+            if event["type"] == "before":
+                event["type"] = "action"
+                action_map[event["callId"]] = event
+                events.append(event)
+            elif event["type"] == "input":
+                pass
+            elif event["type"] == "after":
+                existing = action_map[event["callId"]]
+                existing["error"] = event.get("error", None)
+            else:
+                events.append(event)
     return (resources, events)
 
 

From 481ade1172bfd3f44a87d17dbfb0a85ddc94803f Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 27 Mar 2023 22:18:30 +0200
Subject: [PATCH 050/438] test: fetch with None in json payload (#1830)

test: fetch with none json payload
---
 tests/async/test_fetch_global.py | 11 +++++++++++
 tests/server.py                  |  4 +++-
 tests/sync/test_fetch_global.py  | 11 +++++++++++
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index 6a915fc49..2b6242e2a 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -325,3 +325,14 @@ async def test_should_throw_an_error_when_max_redirects_is_less_than_0(
                 server.PREFIX + "/a/redirect1", method=method, max_redirects=-1
             )
         assert "'max_redirects' must be greater than or equal to '0'" in str(exc_info)
+
+
+async def test_should_serialize_null_values_in_json(
+    playwright: Playwright, server: Server
+) -> None:
+    request = await playwright.request.new_context()
+    server.set_route("/echo", lambda req: (req.write(req.post_body), req.finish()))
+    response = await request.post(server.PREFIX + "/echo", data={"foo": None})
+    assert response.status == 200
+    assert await response.text() == '{"foo":null}'
+    await request.dispose()
diff --git a/tests/server.py b/tests/server.py
index 9b486af3c..2bd3e672a 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -196,7 +196,9 @@ def reset(self) -> None:
         self.gzip_routes.clear()
         self.routes.clear()
 
-    def set_route(self, path: str, callback: Callable[[http.Request], Any]) -> None:
+    def set_route(
+        self, path: str, callback: Callable[[HttpRequestWithPostBody], Any]
+    ) -> None:
         self.routes[path] = callback
 
     def enable_gzip(self, path: str) -> None:
diff --git a/tests/sync/test_fetch_global.py b/tests/sync/test_fetch_global.py
index fc30cc00c..a45c207da 100644
--- a/tests/sync/test_fetch_global.py
+++ b/tests/sync/test_fetch_global.py
@@ -235,3 +235,14 @@ def test_should_throw_an_error_when_max_redirects_is_less_than_0(
                 server.PREFIX + "/a/redirect1", method=method, max_redirects=-1
             )
         assert "'max_redirects' must be greater than or equal to '0'" in str(exc_info)
+
+
+def test_should_serialize_null_values_in_json(
+    playwright: Playwright, server: Server
+) -> None:
+    request = playwright.request.new_context()
+    server.set_route("/echo", lambda req: (req.write(req.post_body), req.finish()))
+    response = request.post(server.PREFIX + "/echo", data={"foo": None})
+    assert response.status == 200
+    assert response.text() == '{"foo":null}'
+    request.dispose()

From 7e2ac749b07ef3e943b9ac3f3e0e3eec121b9237 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 27 Mar 2023 22:21:14 +0200
Subject: [PATCH 051/438] chore(roll): roll to Playwright 1.32.1 driver (#1834)

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

diff --git a/setup.py b/setup.py
index 94d7783b2..5b06b1bed 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.32.0-beta-1679448099000"
+driver_version = "1.32.1"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 56a40a5eecc1b8622f3696862d0981ade29cbb52 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 29 Mar 2023 00:37:41 +0200
Subject: [PATCH 052/438] fix: discard trace without path (#1836)

---
 playwright/_impl/_local_utils.py | 2 +-
 tests/async/test_tracing.py      | 7 +++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_local_utils.py b/playwright/_impl/_local_utils.py
index 6b97386c4..af0683ed2 100644
--- a/playwright/_impl/_local_utils.py
+++ b/playwright/_impl/_local_utils.py
@@ -63,7 +63,7 @@ async def tracing_started(self, tracesDir: Optional[str], traceName: str) -> str
         return await self._channel.send("tracingStarted", params)
 
     async def trace_discarded(self, stacks_id: str) -> None:
-        return await self._channel.send("traceDiscarded", {"stacks_id": stacks_id})
+        return await self._channel.send("traceDiscarded", {"stacksId": stacks_id})
 
     def add_stack_to_tracing_no_reply(self, id: int, frames: List[StackFrame]) -> None:
         self._channel.send_no_reply(
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index fe436c654..13f510591 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -33,6 +33,13 @@ async def test_browser_context_output_trace(
     assert Path(tmp_path / "trace.zip").exists()
 
 
+async def test_start_stop(browser: Browser):
+    context = await browser.new_context()
+    await context.tracing.start()
+    await context.tracing.stop()
+    await context.close()
+
+
 async def test_browser_context_should_not_throw_when_stopping_without_start_but_not_exporting(
     context: BrowserContext, server: Server, tmp_path: Path
 ):

From 525dbce3e6c576b3418c46d2eee6160ba62817b3 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 12 Apr 2023 20:20:52 +0200
Subject: [PATCH 053/438] chore(roll): roll Playwright to
 1.33.0-alpha-apr-12-2023 (#1859)

---
 README.md                           |   2 +-
 playwright/_impl/_api_structures.py |   3 +-
 playwright/_impl/_assertions.py     |  23 +++
 playwright/_impl/_browser_type.py   |  20 +-
 playwright/_impl/_frame.py          |  11 +-
 playwright/_impl/_locator.py        |  35 ++++
 playwright/_impl/_network.py        |  15 +-
 playwright/_impl/_page.py           |  10 +-
 playwright/async_api/_generated.py  | 265 +++++++++++++++++++++------
 playwright/sync_api/_generated.py   | 273 ++++++++++++++++++++++------
 scripts/documentation_provider.py   |   2 +
 setup.py                            |   2 +-
 tests/async/test_assertions.py      | 102 +++++++++++
 tests/async/test_browsercontext.py  |  81 +++++++++
 tests/async/test_fetch_global.py    |  76 ++++++++
 tests/async/test_locators.py        |  84 +++++++--
 tests/async/test_navigation.py      |   3 +
 tests/sync/test_assertions.py       |  78 ++++++++
 tests/sync/test_fetch_global.py     |  77 ++++++++
 tests/sync/test_locators.py         | 107 +++++++++--
 20 files changed, 1117 insertions(+), 152 deletions(-)

diff --git a/README.md b/README.md
index eb56e67c9..dc9bf37d1 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->112.0.5615.29<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->113.0.5672.24<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->111.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index b701555da..a3240ee5c 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -64,9 +64,10 @@ class Geolocation(TypedDict, total=False):
     accuracy: Optional[float]
 
 
-class HttpCredentials(TypedDict):
+class HttpCredentials(TypedDict, total=False):
     username: str
     password: str
+    origin: Optional[str]
 
 
 class LocalStorageEntry(TypedDict):
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 975bf2801..aa3648769 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -464,6 +464,21 @@ async def not_to_have_text(
         __tracebackhide__ = True
         await self._not.to_have_text(expected, use_inner_text, timeout, ignore_case)
 
+    async def to_be_attached(
+        self,
+        attached: bool = None,
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        await self._expect_impl(
+            "to.be.attached"
+            if (attached is None or attached is True)
+            else "to.be.detached",
+            FrameExpectOptions(timeout=timeout),
+            None,
+            "Locator expected to be attached",
+        )
+
     async def to_be_checked(
         self,
         timeout: float = None,
@@ -479,6 +494,14 @@ async def to_be_checked(
             "Locator expected to be checked",
         )
 
+    async def not_to_be_attached(
+        self,
+        attached: bool = None,
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        await self._not.to_be_attached(attached=attached, timeout=timeout)
+
     async def not_to_be_checked(
         self,
         timeout: float = None,
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 07287d609..119a1f8c9 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -191,15 +191,17 @@ async def connect(
 
         headers = {**(headers if headers else {}), "x-playwright-browser": self.name}
         local_utils = self._connection.local_utils
-        pipe_channel = await local_utils._channel.send(
-            "connect",
-            {
-                "wsEndpoint": ws_endpoint,
-                "headers": headers,
-                "slowMo": slow_mo,
-                "timeout": timeout,
-            },
-        )
+        pipe_channel = (
+            await local_utils._channel.send_return_as_dict(
+                "connect",
+                {
+                    "wsEndpoint": ws_endpoint,
+                    "headers": headers,
+                    "slowMo": slow_mo,
+                    "timeout": timeout,
+                },
+            )
+        )["pipe"]
         transport = JsonPipeTransport(self._connection._loop, pipe_channel)
 
         connection = Connection(
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 573a56a72..9cd12a1d2 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -531,9 +531,18 @@ def locator(
         self,
         selector: str,
         has_text: Union[str, Pattern[str]] = None,
+        has_not_text: Union[str, Pattern[str]] = None,
         has: Locator = None,
+        has_not: Locator = None,
     ) -> Locator:
-        return Locator(self, selector, has_text=has_text, has=has)
+        return Locator(
+            self,
+            selector,
+            has_text=has_text,
+            has_not_text=has_not_text,
+            has=has,
+            has_not=has_not,
+        )
 
     def get_by_alt_text(
         self, text: Union[str, Pattern[str]], exact: bool = None
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 7b288170b..ee39754d4 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -73,7 +73,9 @@ def __init__(
         frame: "Frame",
         selector: str,
         has_text: Union[str, Pattern[str]] = None,
+        has_not_text: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
+        has_not: "Locator" = None,
     ) -> None:
         self._frame = frame
         self._selector = selector
@@ -90,6 +92,15 @@ def __init__(
                 has._selector, ensure_ascii=False
             )
 
+        if has_not_text:
+            self._selector += f" >> internal:has-not-text={escape_for_text_selector(has_not_text, exact=False)}"
+
+        if has_not:
+            locator = has_not
+            if locator._frame != frame:
+                raise Error('Inner "has_not" locator must belong to the same frame.')
+            self._selector += " >> internal:has-not=" + json.dumps(locator._selector)
+
     def __repr__(self) -> str:
         return f"<Locator frame={self._frame!r} selector={self._selector!r}>"
 
@@ -211,13 +222,17 @@ def locator(
         self,
         selector_or_locator: Union[str, "Locator"],
         has_text: Union[str, Pattern[str]] = None,
+        has_not_text: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
+        has_not: "Locator" = None,
     ) -> "Locator":
         if isinstance(selector_or_locator, str):
             return Locator(
                 self._frame,
                 f"{self._selector} >> {selector_or_locator}",
                 has_text=has_text,
+                has_not_text=has_not_text,
+                has_not=has_not,
                 has=has,
             )
         selector_or_locator = to_impl(selector_or_locator)
@@ -227,6 +242,8 @@ def locator(
             self._frame,
             f"{self._selector} >> {selector_or_locator._selector}",
             has_text=has_text,
+            has_not_text=has_not_text,
+            has_not=has_not,
             has=has,
         )
 
@@ -317,13 +334,25 @@ def nth(self, index: int) -> "Locator":
     def filter(
         self,
         has_text: Union[str, Pattern[str]] = None,
+        has_not_text: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
+        has_not: "Locator" = None,
     ) -> "Locator":
         return Locator(
             self._frame,
             self._selector,
             has_text=has_text,
+            has_not_text=has_not_text,
             has=has,
+            has_not=has_not,
+        )
+
+    def or_(self, locator: "Locator") -> "Locator":
+        if locator._frame != self._frame:
+            raise Error("Locators must belong to the same frame.")
+        return Locator(
+            self._frame,
+            self._selector + " >> internal:or=" + json.dumps(locator._selector),
         )
 
     async def focus(self, timeout: float = None) -> None:
@@ -677,14 +706,18 @@ def locator(
         self,
         selector_or_locator: Union["Locator", str],
         has_text: Union[str, Pattern[str]] = None,
+        has_not_text: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
+        has_not: "Locator" = None,
     ) -> Locator:
         if isinstance(selector_or_locator, str):
             return Locator(
                 self._frame,
                 f"{self._frame_selector} >> internal:control=enter-frame >> {selector_or_locator}",
                 has_text=has_text,
+                has_not_text=has_not_text,
                 has=has,
+                has_not=has_not,
             )
         selector_or_locator = to_impl(selector_or_locator)
         if selector_or_locator._frame != self._frame:
@@ -693,7 +726,9 @@ def locator(
             self._frame,
             f"{self._frame_selector} >> internal:control=enter-frame >> {selector_or_locator._selector}",
             has_text=has_text,
+            has_not_text=has_not_text,
             has=has,
+            has_not=has_not,
         )
 
     def get_by_alt_text(
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index bdc960647..fef8f5bc5 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -38,6 +38,7 @@
     from typing import TypedDict
 else:  # pragma: no cover
     from typing_extensions import TypedDict
+
 from urllib import parse
 
 from playwright._impl._api_structures import (
@@ -51,6 +52,7 @@
 from playwright._impl._api_types import Error
 from playwright._impl._connection import (
     ChannelOwner,
+    filter_none,
     from_channel,
     from_nullable_channel,
 )
@@ -278,7 +280,15 @@ def request(self) -> Request:
     async def abort(self, errorCode: str = None) -> None:
         self._check_not_handled()
         await self._race_with_page_close(
-            self._channel.send("abort", locals_to_params(locals()))
+            self._channel.send(
+                "abort",
+                filter_none(
+                    {
+                        "errorCode": errorCode,
+                        "requestUrl": self.request._initializer["url"],
+                    }
+                ),
+            )
         )
         self._report_handled(True)
 
@@ -344,6 +354,8 @@ async def fulfill(
         if length and "content-length" not in headers:
             headers["content-length"] = str(length)
         params["headers"] = serialize_headers(headers)
+        params["requestUrl"] = self.request._initializer["url"]
+
         await self._race_with_page_close(self._channel.send("fulfill", params))
         self._report_handled(True)
 
@@ -402,6 +414,7 @@ async def continue_route() -> None:
 
                 if "headers" in params:
                     params["headers"] = serialize_headers(params["headers"])
+                params["requestUrl"] = self.request._initializer["url"]
                 await self._connection.wrap_api_call(
                     lambda: self._race_with_page_close(
                         self._channel.send(
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index fdd7571ad..2414df934 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -754,9 +754,17 @@ def locator(
         self,
         selector: str,
         has_text: Union[str, Pattern[str]] = None,
+        has_not_text: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
+        has_not: "Locator" = None,
     ) -> "Locator":
-        return self._main_frame.locator(selector, has_text=has_text, has=has)
+        return self._main_frame.locator(
+            selector,
+            has_text=has_text,
+            has_not_text=has_not_text,
+            has=has,
+            has_not=has_not,
+        )
 
     def get_by_alt_text(
         self, text: Union[str, Pattern[str]], exact: bool = None
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 50631e826..e5268b1bb 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -1021,7 +1021,7 @@ def on(
         self,
         event: Literal["framereceived"],
         f: typing.Callable[
-            ["typing.Dict"], "typing.Union[typing.Awaitable[None], None]"
+            ["typing.Union[bytes, str]"], "typing.Union[typing.Awaitable[None], None]"
         ],
     ) -> None:
         """
@@ -1032,7 +1032,7 @@ def on(
         self,
         event: Literal["framesent"],
         f: typing.Callable[
-            ["typing.Dict"], "typing.Union[typing.Awaitable[None], None]"
+            ["typing.Union[bytes, str]"], "typing.Union[typing.Awaitable[None], None]"
         ],
     ) -> None:
         """
@@ -1068,7 +1068,7 @@ def once(
         self,
         event: Literal["framereceived"],
         f: typing.Callable[
-            ["typing.Dict"], "typing.Union[typing.Awaitable[None], None]"
+            ["typing.Union[bytes, str]"], "typing.Union[typing.Awaitable[None], None]"
         ],
     ) -> None:
         """
@@ -1079,7 +1079,7 @@ def once(
         self,
         event: Literal["framesent"],
         f: typing.Callable[
-            ["typing.Dict"], "typing.Union[typing.Awaitable[None], None]"
+            ["typing.Union[bytes, str]"], "typing.Union[typing.Awaitable[None], None]"
         ],
     ) -> None:
         """
@@ -3353,8 +3353,8 @@ async def goto(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         referer : Union[str, None]
@@ -3419,8 +3419,8 @@ def expect_navigation(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         timeout : Union[float, None]
@@ -3475,8 +3475,8 @@ async def wait_for_url(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         timeout : Union[float, None]
@@ -3527,7 +3527,8 @@ async def wait_for_load_state(
             document, the method resolves immediately. Can be one of:
             - `'load'` - wait for the `load` event to be fired.
             - `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired.
-            - `'networkidle'` - wait until there are no network connections for at least `500` ms.
+            - `'networkidle'` - **DISCOURAGED** wait until there are no network connections for at least `500` ms. Don't use
+              this method for testing, rely on web assertions to assess readiness instead.
         timeout : Union[float, None]
             Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
             be changed by using the `browser_context.set_default_navigation_timeout()`,
@@ -4278,8 +4279,8 @@ async def set_content(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         """
@@ -4662,7 +4663,9 @@ def locator(
         selector: str,
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None,
+        has_not: typing.Optional["Locator"] = None
     ) -> "Locator":
         """Frame.locator
 
@@ -4682,10 +4685,18 @@ def locator(
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
+        has_not_text : Union[Pattern[str], str, None]
+            Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
+            When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
             Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
             one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        has_not : Union[Locator, None]
+            Matches elements that do not contain an element that matches an inner locator. Inner locator is queried against the
+            outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
+
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
         Returns
@@ -4695,7 +4706,11 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector=selector, has_text=has_text, has=has._impl_obj if has else None
+                selector=selector,
+                has_text=has_text,
+                has_not_text=has_not_text,
+                has=has._impl_obj if has else None,
+                has_not=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -6197,7 +6212,9 @@ def locator(
         selector_or_locator: typing.Union["Locator", str],
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None,
+        has_not: typing.Optional["Locator"] = None
     ) -> "Locator":
         """FrameLocator.locator
 
@@ -6214,10 +6231,18 @@ def locator(
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
+        has_not_text : Union[Pattern[str], str, None]
+            Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
+            When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
             Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
             one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        has_not : Union[Locator, None]
+            Matches elements that do not contain an element that matches an inner locator. Inner locator is queried against the
+            outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
+
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
         Returns
@@ -6229,7 +6254,9 @@ def locator(
             self._impl_obj.locator(
                 selector_or_locator=selector_or_locator,
                 has_text=has_text,
+                has_not_text=has_not_text,
                 has=has._impl_obj if has else None,
+                has_not=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -9097,8 +9124,8 @@ async def set_content(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         """
@@ -9156,8 +9183,8 @@ async def goto(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         referer : Union[str, None]
@@ -9200,8 +9227,8 @@ async def reload(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
 
@@ -9267,7 +9294,8 @@ async def wait_for_load_state(
             document, the method resolves immediately. Can be one of:
             - `'load'` - wait for the `load` event to be fired.
             - `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired.
-            - `'networkidle'` - wait until there are no network connections for at least `500` ms.
+            - `'networkidle'` - **DISCOURAGED** wait until there are no network connections for at least `500` ms. Don't use
+              this method for testing, rely on web assertions to assess readiness instead.
         timeout : Union[float, None]
             Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
             be changed by using the `browser_context.set_default_navigation_timeout()`,
@@ -9314,8 +9342,8 @@ async def wait_for_url(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         timeout : Union[float, None]
@@ -9393,8 +9421,8 @@ async def go_back(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
 
@@ -9433,8 +9461,8 @@ async def go_forward(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
 
@@ -10238,7 +10266,9 @@ def locator(
         selector: str,
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None,
+        has_not: typing.Optional["Locator"] = None
     ) -> "Locator":
         """Page.locator
 
@@ -10256,10 +10286,18 @@ def locator(
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
+        has_not_text : Union[Pattern[str], str, None]
+            Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
+            When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
             Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
             one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        has_not : Union[Locator, None]
+            Matches elements that do not contain an element that matches an inner locator. Inner locator is queried against the
+            outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
+
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
         Returns
@@ -10269,7 +10307,11 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector=selector, has_text=has_text, has=has._impl_obj if has else None
+                selector=selector,
+                has_text=has_text,
+                has_not_text=has_not_text,
+                has=has._impl_obj if has else None,
+                has_not=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -12064,8 +12106,8 @@ def expect_navigation(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         timeout : Union[float, None]
@@ -13835,8 +13877,9 @@ async def new_context(
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`.
-        http_credentials : Union[{username: str, password: str}, None]
-            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication).
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
+            origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
@@ -14041,8 +14084,9 @@ async def new_page(
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`.
-        http_credentials : Union[{username: str, password: str}, None]
-            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication).
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
+            origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
@@ -14578,8 +14622,9 @@ async def launch_persistent_context(
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`.
-        http_credentials : Union[{username: str, password: str}, None]
-            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication).
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
+            origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
@@ -15760,7 +15805,9 @@ def locator(
         selector_or_locator: typing.Union[str, "Locator"],
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None,
+        has_not: typing.Optional["Locator"] = None
     ) -> "Locator":
         """Locator.locator
 
@@ -15777,10 +15824,18 @@ def locator(
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
+        has_not_text : Union[Pattern[str], str, None]
+            Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
+            When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
             Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
             one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        has_not : Union[Locator, None]
+            Matches elements that do not contain an element that matches an inner locator. Inner locator is queried against the
+            outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
+
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
         Returns
@@ -15792,7 +15847,9 @@ def locator(
             self._impl_obj.locator(
                 selector_or_locator=selector_or_locator,
                 has_text=has_text,
+                has_not_text=has_not_text,
                 has=has._impl_obj if has else None,
+                has_not=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -16395,7 +16452,9 @@ def filter(
         self,
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None,
+        has_not: typing.Optional["Locator"] = None
     ) -> "Locator":
         """Locator.filter
 
@@ -16428,10 +16487,18 @@ def filter(
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
+        has_not_text : Union[Pattern[str], str, None]
+            Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
+            When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
             Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
             one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        has_not : Union[Locator, None]
+            Matches elements that do not contain an element that matches an inner locator. Inner locator is queried against the
+            outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
+
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
         Returns
@@ -16440,9 +16507,54 @@ def filter(
         """
 
         return mapping.from_impl(
-            self._impl_obj.filter(has_text=has_text, has=has._impl_obj if has else None)
+            self._impl_obj.filter(
+                has_text=has_text,
+                has_not_text=has_not_text,
+                has=has._impl_obj if has else None,
+                has_not=has_not._impl_obj if has_not else None,
+            )
         )
 
+    def or_(self, locator: "Locator") -> "Locator":
+        """Locator.or_
+
+        Creates a locator that matches either of the two locators.
+
+        **Usage**
+
+        Consider a scenario where you'd like to click on a \"New email\" button, but sometimes a security settings dialog
+        shows up instead. In this case, you can wait for either a \"New email\" button, or a dialog and act accordingly.
+
+        ```py
+        new_email = page.get_by_role(\"button\", name=\"New\")
+        dialog = page.get_by_text(\"Confirm security settings\")
+        await expect(new_email.or_(dialog)).to_be_visible()
+        if (await dialog.is_visible())
+          await page.get_by_role(\"button\", name=\"Dismiss\").click()
+        await new_email.click()
+        ```
+
+        ```py
+        new_email = page.get_by_role(\"button\", name=\"New\")
+        dialog = page.get_by_text(\"Confirm security settings\")
+        expect(new_email.or_(dialog)).to_be_visible()
+        if (dialog.is_visible())
+          page.get_by_role(\"button\", name=\"Dismiss\").click()
+        new_email.click()
+        ```
+
+        Parameters
+        ----------
+        locator : Locator
+            Alternative locator to match.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.or_(locator=locator._impl_obj))
+
     async def focus(self, *, timeout: typing.Optional[float] = None) -> None:
         """Locator.focus
 
@@ -18550,8 +18662,9 @@ async def new_context(
               `http://localhost:3000/bar.html`
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
-        http_credentials : Union[{username: str, password: str}, None]
-            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication).
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
+            origin is specified, the username and password are sent to any servers upon unauthorized responses.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
@@ -19616,6 +19729,38 @@ async def not_to_have_text(
             )
         )
 
+    async def to_be_attached(
+        self,
+        *,
+        attached: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_be_attached
+
+        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/actionability#attached) DOM node.
+
+        **Usage**
+
+        ```py
+        await expect(page.get_by_text(\"Hidden text\")).to_be_attached()
+        ```
+
+        ```py
+        expect(page.get_by_text(\"Hidden text\")).to_be_attached()
+        ```
+
+        Parameters
+        ----------
+        attached : Union[bool, None]
+        timeout : Union[float, None]
+            Time to retry the assertion for.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.to_be_attached(attached=attached, timeout=timeout)
+        )
+
     async def to_be_checked(
         self,
         *,
@@ -19654,6 +19799,28 @@ async def to_be_checked(
             await self._impl_obj.to_be_checked(timeout=timeout, checked=checked)
         )
 
+    async def not_to_be_attached(
+        self,
+        *,
+        attached: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_be_attached
+
+        The opposite of `locator_assertions.to_be_attached()`.
+
+        Parameters
+        ----------
+        attached : Union[bool, None]
+        timeout : Union[float, None]
+            Time to retry the assertion for.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.not_to_be_attached(attached=attached, timeout=timeout)
+        )
+
     async def not_to_be_checked(
         self, *, timeout: typing.Optional[float] = None
     ) -> None:
@@ -19957,17 +20124,11 @@ async def to_be_visible(
         **Usage**
 
         ```py
-        from playwright.async_api import expect
-
-        locator = page.locator('.my-element')
-        await expect(locator).to_be_visible()
+        await expect(page.get_by_text(\"Welcome\")).to_be_visible()
         ```
 
         ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator('.my-element')
-        expect(locator).to_be_visible()
+        expect(page.get_by_text(\"Welcome\")).to_be_visible()
         ```
 
         Parameters
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index f0cd1b0f9..72caeb1cc 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -1034,14 +1034,16 @@ def on(
     def on(
         self,
         event: Literal["framereceived"],
-        f: typing.Callable[["typing.Dict"], "None"],
+        f: typing.Callable[["typing.Union[bytes, str]"], "None"],
     ) -> None:
         """
         Fired when the websocket receives a frame."""
 
     @typing.overload
     def on(
-        self, event: Literal["framesent"], f: typing.Callable[["typing.Dict"], "None"]
+        self,
+        event: Literal["framesent"],
+        f: typing.Callable[["typing.Union[bytes, str]"], "None"],
     ) -> None:
         """
         Fired when the websocket sends a frame."""
@@ -1067,14 +1069,16 @@ def once(
     def once(
         self,
         event: Literal["framereceived"],
-        f: typing.Callable[["typing.Dict"], "None"],
+        f: typing.Callable[["typing.Union[bytes, str]"], "None"],
     ) -> None:
         """
         Fired when the websocket receives a frame."""
 
     @typing.overload
     def once(
-        self, event: Literal["framesent"], f: typing.Callable[["typing.Dict"], "None"]
+        self,
+        event: Literal["framesent"],
+        f: typing.Callable[["typing.Union[bytes, str]"], "None"],
     ) -> None:
         """
         Fired when the websocket sends a frame."""
@@ -3399,8 +3403,8 @@ def goto(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         referer : Union[str, None]
@@ -3467,8 +3471,8 @@ def expect_navigation(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         timeout : Union[float, None]
@@ -3523,8 +3527,8 @@ def wait_for_url(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         timeout : Union[float, None]
@@ -3577,7 +3581,8 @@ def wait_for_load_state(
             document, the method resolves immediately. Can be one of:
             - `'load'` - wait for the `load` event to be fired.
             - `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired.
-            - `'networkidle'` - wait until there are no network connections for at least `500` ms.
+            - `'networkidle'` - **DISCOURAGED** wait until there are no network connections for at least `500` ms. Don't use
+              this method for testing, rely on web assertions to assess readiness instead.
         timeout : Union[float, None]
             Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
             be changed by using the `browser_context.set_default_navigation_timeout()`,
@@ -4350,8 +4355,8 @@ def set_content(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         """
@@ -4748,7 +4753,9 @@ def locator(
         selector: str,
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None,
+        has_not: typing.Optional["Locator"] = None
     ) -> "Locator":
         """Frame.locator
 
@@ -4768,10 +4775,18 @@ def locator(
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
+        has_not_text : Union[Pattern[str], str, None]
+            Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
+            When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
             Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
             one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        has_not : Union[Locator, None]
+            Matches elements that do not contain an element that matches an inner locator. Inner locator is queried against the
+            outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
+
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
         Returns
@@ -4781,7 +4796,11 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector=selector, has_text=has_text, has=has._impl_obj if has else None
+                selector=selector,
+                has_text=has_text,
+                has_not_text=has_not_text,
+                has=has._impl_obj if has else None,
+                has_not=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -6313,7 +6332,9 @@ def locator(
         selector_or_locator: typing.Union["Locator", str],
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None,
+        has_not: typing.Optional["Locator"] = None
     ) -> "Locator":
         """FrameLocator.locator
 
@@ -6330,10 +6351,18 @@ def locator(
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
+        has_not_text : Union[Pattern[str], str, None]
+            Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
+            When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
             Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
             one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        has_not : Union[Locator, None]
+            Matches elements that do not contain an element that matches an inner locator. Inner locator is queried against the
+            outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
+
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
         Returns
@@ -6345,7 +6374,9 @@ def locator(
             self._impl_obj.locator(
                 selector_or_locator=selector_or_locator,
                 has_text=has_text,
+                has_not_text=has_not_text,
                 has=has._impl_obj if has else None,
+                has_not=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -9143,8 +9174,8 @@ def set_content(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         """
@@ -9204,8 +9235,8 @@ def goto(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         referer : Union[str, None]
@@ -9250,8 +9281,8 @@ def reload(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
 
@@ -9317,7 +9348,8 @@ def wait_for_load_state(
             document, the method resolves immediately. Can be one of:
             - `'load'` - wait for the `load` event to be fired.
             - `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired.
-            - `'networkidle'` - wait until there are no network connections for at least `500` ms.
+            - `'networkidle'` - **DISCOURAGED** wait until there are no network connections for at least `500` ms. Don't use
+              this method for testing, rely on web assertions to assess readiness instead.
         timeout : Union[float, None]
             Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can
             be changed by using the `browser_context.set_default_navigation_timeout()`,
@@ -9364,8 +9396,8 @@ def wait_for_url(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         timeout : Union[float, None]
@@ -9449,8 +9481,8 @@ def go_back(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
 
@@ -9489,8 +9521,8 @@ def go_forward(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
 
@@ -10312,7 +10344,9 @@ def locator(
         selector: str,
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None,
+        has_not: typing.Optional["Locator"] = None
     ) -> "Locator":
         """Page.locator
 
@@ -10330,10 +10364,18 @@ def locator(
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
+        has_not_text : Union[Pattern[str], str, None]
+            Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
+            When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
             Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
             one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        has_not : Union[Locator, None]
+            Matches elements that do not contain an element that matches an inner locator. Inner locator is queried against the
+            outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
+
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
         Returns
@@ -10343,7 +10385,11 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector=selector, has_text=has_text, has=has._impl_obj if has else None
+                selector=selector,
+                has_text=has_text,
+                has_not_text=has_not_text,
+                has=has._impl_obj if has else None,
+                has_not=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -12168,8 +12214,8 @@ def expect_navigation(
             When to consider operation succeeded, defaults to `load`. Events can be either:
             - `'domcontentloaded'` - consider operation to be finished when the `DOMContentLoaded` event is fired.
             - `'load'` - consider operation to be finished when the `load` event is fired.
-            - `'networkidle'` - consider operation to be finished when there are no network connections for at least `500`
-              ms.
+            - `'networkidle'` - **DISCOURAGED** consider operation to be finished when there are no network connections for
+              at least `500` ms. Don't use this method for testing, rely on web assertions to assess readiness instead.
             - `'commit'` - consider operation to be finished when network response is received and the document started
               loading.
         timeout : Union[float, None]
@@ -13905,8 +13951,9 @@ def new_context(
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`.
-        http_credentials : Union[{username: str, password: str}, None]
-            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication).
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
+            origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
@@ -14113,8 +14160,9 @@ def new_page(
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`.
-        http_credentials : Union[{username: str, password: str}, None]
-            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication).
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
+            origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
@@ -14656,8 +14704,9 @@ def launch_persistent_context(
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`.
-        http_credentials : Union[{username: str, password: str}, None]
-            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication).
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
+            origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
             Specify device scale factor (can be thought of as dpr). Defaults to `1`.
         is_mobile : Union[bool, None]
@@ -15864,7 +15913,9 @@ def locator(
         selector_or_locator: typing.Union[str, "Locator"],
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None,
+        has_not: typing.Optional["Locator"] = None
     ) -> "Locator":
         """Locator.locator
 
@@ -15881,10 +15932,18 @@ def locator(
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
+        has_not_text : Union[Pattern[str], str, None]
+            Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
+            When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
             Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
             one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        has_not : Union[Locator, None]
+            Matches elements that do not contain an element that matches an inner locator. Inner locator is queried against the
+            outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
+
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
         Returns
@@ -15896,7 +15955,9 @@ def locator(
             self._impl_obj.locator(
                 selector_or_locator=selector_or_locator,
                 has_text=has_text,
+                has_not_text=has_not_text,
                 has=has._impl_obj if has else None,
+                has_not=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -16501,7 +16562,9 @@ def filter(
         self,
         *,
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has: typing.Optional["Locator"] = None
+        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has: typing.Optional["Locator"] = None,
+        has_not: typing.Optional["Locator"] = None
     ) -> "Locator":
         """Locator.filter
 
@@ -16534,10 +16597,18 @@ def filter(
             Matches elements containing specified text somewhere inside, possibly in a child or a descendant element. When
             passed a [string], matching is case-insensitive and searches for a substring. For example, `"Playwright"` matches
             `<article><div>Playwright</div></article>`.
+        has_not_text : Union[Pattern[str], str, None]
+            Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
+            When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
             Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
             one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
 
+            Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        has_not : Union[Locator, None]
+            Matches elements that do not contain an element that matches an inner locator. Inner locator is queried against the
+            outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
+
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
 
         Returns
@@ -16546,9 +16617,54 @@ def filter(
         """
 
         return mapping.from_impl(
-            self._impl_obj.filter(has_text=has_text, has=has._impl_obj if has else None)
+            self._impl_obj.filter(
+                has_text=has_text,
+                has_not_text=has_not_text,
+                has=has._impl_obj if has else None,
+                has_not=has_not._impl_obj if has_not else None,
+            )
         )
 
+    def or_(self, locator: "Locator") -> "Locator":
+        """Locator.or_
+
+        Creates a locator that matches either of the two locators.
+
+        **Usage**
+
+        Consider a scenario where you'd like to click on a \"New email\" button, but sometimes a security settings dialog
+        shows up instead. In this case, you can wait for either a \"New email\" button, or a dialog and act accordingly.
+
+        ```py
+        new_email = page.get_by_role(\"button\", name=\"New\")
+        dialog = page.get_by_text(\"Confirm security settings\")
+        await expect(new_email.or_(dialog)).to_be_visible()
+        if (await dialog.is_visible())
+          await page.get_by_role(\"button\", name=\"Dismiss\").click()
+        await new_email.click()
+        ```
+
+        ```py
+        new_email = page.get_by_role(\"button\", name=\"New\")
+        dialog = page.get_by_text(\"Confirm security settings\")
+        expect(new_email.or_(dialog)).to_be_visible()
+        if (dialog.is_visible())
+          page.get_by_role(\"button\", name=\"Dismiss\").click()
+        new_email.click()
+        ```
+
+        Parameters
+        ----------
+        locator : Locator
+            Alternative locator to match.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.or_(locator=locator._impl_obj))
+
     def focus(self, *, timeout: typing.Optional[float] = None) -> None:
         """Locator.focus
 
@@ -18706,8 +18822,9 @@ def new_context(
               `http://localhost:3000/bar.html`
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
-        http_credentials : Union[{username: str, password: str}, None]
-            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication).
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+            Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
+            origin is specified, the username and password are sent to any servers upon unauthorized responses.
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
@@ -19808,6 +19925,40 @@ def not_to_have_text(
             )
         )
 
+    def to_be_attached(
+        self,
+        *,
+        attached: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_be_attached
+
+        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/actionability#attached) DOM node.
+
+        **Usage**
+
+        ```py
+        await expect(page.get_by_text(\"Hidden text\")).to_be_attached()
+        ```
+
+        ```py
+        expect(page.get_by_text(\"Hidden text\")).to_be_attached()
+        ```
+
+        Parameters
+        ----------
+        attached : Union[bool, None]
+        timeout : Union[float, None]
+            Time to retry the assertion for.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.to_be_attached(attached=attached, timeout=timeout)
+            )
+        )
+
     def to_be_checked(
         self,
         *,
@@ -19846,6 +19997,30 @@ def to_be_checked(
             self._sync(self._impl_obj.to_be_checked(timeout=timeout, checked=checked))
         )
 
+    def not_to_be_attached(
+        self,
+        *,
+        attached: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_be_attached
+
+        The opposite of `locator_assertions.to_be_attached()`.
+
+        Parameters
+        ----------
+        attached : Union[bool, None]
+        timeout : Union[float, None]
+            Time to retry the assertion for.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.not_to_be_attached(attached=attached, timeout=timeout)
+            )
+        )
+
     def not_to_be_checked(self, *, timeout: typing.Optional[float] = None) -> None:
         """LocatorAssertions.not_to_be_checked
 
@@ -20151,17 +20326,11 @@ def to_be_visible(
         **Usage**
 
         ```py
-        from playwright.async_api import expect
-
-        locator = page.locator('.my-element')
-        await expect(locator).to_be_visible()
+        await expect(page.get_by_text(\"Welcome\")).to_be_visible()
         ```
 
         ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator('.my-element')
-        expect(locator).to_be_visible()
+        expect(page.get_by_text(\"Welcome\")).to_be_visible()
         ```
 
         Parameters
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 0b3f0dc92..5ca03551a 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -216,6 +216,8 @@ def print_events(self, class_name: str) -> 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 = ""
diff --git a/setup.py b/setup.py
index 5b06b1bed..d14d03c08 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.32.1"
+driver_version = "1.33.0-alpha-apr-12-2023"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index b2eb6a850..3014610fd 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import asyncio
 import re
 from datetime import datetime
 
@@ -688,3 +689,104 @@ async def test_should_print_expected_value_with_custom_message(
         )
     assert "custom-message" in str(excinfo.value)
     assert "Expected value" not in str(excinfo.value)
+
+
+async def test_should_be_attached_default(page: Page) -> None:
+    await page.set_content("<input></input>")
+    locator = page.locator("input")
+    await expect(locator).to_be_attached()
+
+
+async def test_should_be_attached_with_hidden_element(page: Page) -> None:
+    await page.set_content('<button style="display:none">hello</button>')
+    locator = page.locator("button")
+    await expect(locator).to_be_attached()
+
+
+async def test_should_be_attached_with_not(page: Page) -> None:
+    await page.set_content("<button>hello</button>")
+    locator = page.locator("input")
+    await expect(locator).not_to_be_attached()
+
+
+async def test_should_be_attached_with_attached_true(page: Page) -> None:
+    await page.set_content("<button>hello</button>")
+    locator = page.locator("button")
+    await expect(locator).to_be_attached(attached=True)
+
+
+async def test_should_be_attached_with_attached_false(page: Page) -> None:
+    await page.set_content("<button>hello</button>")
+    locator = page.locator("input")
+    await expect(locator).to_be_attached(attached=False)
+
+
+async def test_should_be_attached_with_not_and_attached_false(page: Page) -> None:
+    await page.set_content("<button>hello</button>")
+    locator = page.locator("button")
+    await expect(locator).not_to_be_attached(attached=False)
+
+
+async def test_should_be_attached_eventually(page: Page) -> None:
+    await page.set_content("<div></div>")
+    locator = page.locator("span")
+    await page.locator("div").evaluate(
+        "(e) => setTimeout(() => e.innerHTML = '<span>hello</span>', 1000)"
+    )
+    await expect(locator).to_be_attached()
+
+
+async def test_should_be_attached_eventually_with_not(page: Page) -> None:
+    await page.set_content("<div><span>Hello</span></div>")
+    locator = page.locator("span")
+    await page.locator("div").evaluate(
+        "(e) => setTimeout(() => e.textContent = '', 1000)"
+    )
+    await expect(locator).not_to_be_attached()
+
+
+async def test_should_be_attached_fail(page: Page) -> None:
+    await page.set_content("<button>Hello</button>")
+    locator = page.locator("input")
+    with pytest.raises(AssertionError) as exc_info:
+        await expect(locator).to_be_attached(timeout=1000)
+    assert "locator resolved to" not in exc_info.value.args[0]
+
+
+async def test_should_be_attached_fail_with_not(page: Page) -> None:
+    await page.set_content("<input></input>")
+    locator = page.locator("input")
+    with pytest.raises(AssertionError) as exc_info:
+        await expect(locator).not_to_be_attached(timeout=1000)
+    assert "locator resolved to <input/>" in exc_info.value.args[0]
+
+
+async def test_should_be_attached_with_impossible_timeout(page: Page) -> None:
+    await page.set_content("<div id=node>Text content</div>")
+    await expect(page.locator("#node")).to_be_attached(timeout=1)
+
+
+async def test_should_be_attached_with_impossible_timeout_not(page: Page) -> None:
+    await page.set_content("<div id=node>Text content</div>")
+    await expect(page.locator("no-such-thing")).not_to_be_attached(timeout=1)
+
+
+async def test_should_be_attached_with_frame_locator(page: Page) -> None:
+    await page.set_content("<div></div>")
+    locator = page.frame_locator("iframe").locator("input")
+    task = asyncio.create_task(expect(locator).to_be_attached())
+    await page.wait_for_timeout(1000)
+    assert not task.done()
+    await page.set_content('<iframe srcdoc="<input>"></iframe>')
+    await task
+    assert task.done()
+
+
+async def test_should_be_attached_over_navigation(page: Page, server: Server) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    task = asyncio.create_task(expect(page.locator("input")).to_be_attached())
+    await page.wait_for_timeout(1000)
+    assert not task.done()
+    await page.goto(server.PREFIX + "/input/checkbox.html")
+    await task
+    assert task.done()
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index 0c98f8551..5966e3e79 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import asyncio
+from urllib.parse import urlparse
 
 import pytest
 
@@ -576,6 +577,86 @@ async def test_auth_should_return_resource_body(browser, server):
     await context.close()
 
 
+async def test_should_work_with_correct_credentials_and_matching_origin(
+    browser, server
+):
+    server.set_auth("/empty.html", "user", "pass")
+    context = await browser.new_context(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX,
+        }
+    )
+    page = await context.new_page()
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response.status == 200
+    await context.close()
+
+
+async def test_should_work_with_correct_credentials_and_matching_origin_case_insensitive(
+    browser, server
+):
+    server.set_auth("/empty.html", "user", "pass")
+    context = await browser.new_context(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX.upper(),
+        }
+    )
+    page = await context.new_page()
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response.status == 200
+    await context.close()
+
+
+async def test_should_fail_with_correct_credentials_and_mismatching_scheme(
+    browser, server
+):
+    server.set_auth("/empty.html", "user", "pass")
+    context = await browser.new_context(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX.replace("http://", "https://"),
+        }
+    )
+    page = await context.new_page()
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response.status == 401
+    await context.close()
+
+
+async def test_should_fail_with_correct_credentials_and_mismatching_hostname(
+    browser, server
+):
+    server.set_auth("/empty.html", "user", "pass")
+    hostname = urlparse(server.PREFIX).hostname
+    origin = server.PREFIX.replace(hostname, "mismatching-hostname")
+    context = await browser.new_context(
+        http_credentials={"username": "user", "password": "pass", "origin": origin}
+    )
+    page = await context.new_page()
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response.status == 401
+    await context.close()
+
+
+async def test_should_fail_with_correct_credentials_and_mismatching_port(
+    browser, server
+):
+    server.set_auth("/empty.html", "user", "pass")
+    origin = server.PREFIX.replace(str(server.PORT), str(server.PORT + 1))
+    context = await browser.new_context(
+        http_credentials={"username": "user", "password": "pass", "origin": origin}
+    )
+    page = await context.new_page()
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response.status == 401
+    await context.close()
+
+
 async def test_offline_should_work_with_initial_option(browser, server):
     context = await browser.new_context(offline=True)
     page = await context.new_page()
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index 2b6242e2a..d5eec7d9d 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -17,6 +17,7 @@
 import sys
 from pathlib import Path
 from typing import Any
+from urllib.parse import urlparse
 
 import pytest
 
@@ -125,6 +126,81 @@ async def test_should_return_error_with_wrong_credentials(
     assert response.ok is False
 
 
+async def test_should_work_with_correct_credentials_and_matching_origin(
+    playwright: Playwright, server: Server
+):
+    server.set_auth("/empty.html", "user", "pass")
+    request = await playwright.request.new_context(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX,
+        }
+    )
+    response = await request.get(server.EMPTY_PAGE)
+    assert response.status == 200
+    await response.dispose()
+
+
+async def test_should_work_with_correct_credentials_and_matching_origin_case_insensitive(
+    playwright: Playwright, server: Server
+):
+    server.set_auth("/empty.html", "user", "pass")
+    request = await playwright.request.new_context(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX.upper(),
+        }
+    )
+    response = await request.get(server.EMPTY_PAGE)
+    assert response.status == 200
+    await response.dispose()
+
+
+async def test_should_return_error_with_correct_credentials_and_mismatching_scheme(
+    playwright: Playwright, server: Server
+):
+    server.set_auth("/empty.html", "user", "pass")
+    request = await playwright.request.new_context(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX.replace("http://", "https://"),
+        }
+    )
+    response = await request.get(server.EMPTY_PAGE)
+    assert response.status == 401
+    await response.dispose()
+
+
+async def test_should_return_error_with_correct_credentials_and_mismatching_hostname(
+    playwright: Playwright, server: Server
+):
+    server.set_auth("/empty.html", "user", "pass")
+    hostname = urlparse(server.PREFIX).hostname
+    origin = server.PREFIX.replace(hostname, "mismatching-hostname")
+    request = await playwright.request.new_context(
+        http_credentials={"username": "user", "password": "pass", "origin": origin}
+    )
+    response = await request.get(server.EMPTY_PAGE)
+    assert response.status == 401
+    await response.dispose()
+
+
+async def test_should_return_error_with_correct_credentials_and_mismatching_port(
+    playwright: Playwright, server: Server
+):
+    server.set_auth("/empty.html", "user", "pass")
+    origin = server.PREFIX.replace(str(server.PORT), str(server.PORT + 1))
+    request = await playwright.request.new_context(
+        http_credentials={"username": "user", "password": "pass", "origin": origin}
+    )
+    response = await request.get(server.EMPTY_PAGE)
+    assert response.status == 401
+    await response.dispose()
+
+
 async def test_should_support_global_ignore_https_errors_option(
     playwright: Playwright, https_server: Server
 ):
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index e598b3b89..57be74c90 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -782,19 +782,15 @@ async def test_locator_should_support_has_locator(page: Page, server: Server) ->
     await page.set_content("<div><span>hello</span></div><div><span>world</span></div>")
     await expect(page.locator("div", has=page.locator("text=world"))).to_have_count(1)
     assert (
-        _remove_highlight(
-            await page.locator("div", has=page.locator("text=world")).evaluate(
-                "e => e.outerHTML"
-            )
+        await page.locator("div", has=page.locator("text=world")).evaluate(
+            "e => e.outerHTML"
         )
         == "<div><span>world</span></div>"
     )
     await expect(page.locator("div", has=page.locator('text="hello"'))).to_have_count(1)
     assert (
-        _remove_highlight(
-            await page.locator("div", has=page.locator('text="hello"')).evaluate(
-                "e => e.outerHTML"
-            )
+        await page.locator("div", has=page.locator('text="hello"')).evaluate(
+            "e => e.outerHTML"
         )
         == "<div><span>hello</span></div>"
     )
@@ -804,10 +800,8 @@ async def test_locator_should_support_has_locator(page: Page, server: Server) ->
         page.locator("div", has=page.locator("span", has_text="wor"))
     ).to_have_count(1)
     assert (
-        _remove_highlight(
-            await page.locator(
-                "div", has=page.locator("span", has_text="wor")
-            ).evaluate("e => e.outerHTML")
+        await page.locator("div", has=page.locator("span", has_text="wor")).evaluate(
+            "e => e.outerHTML"
         )
         == "<div><span>world</span></div>"
     )
@@ -820,10 +814,6 @@ async def test_locator_should_support_has_locator(page: Page, server: Server) ->
     ).to_have_count(1)
 
 
-def _remove_highlight(markup: str) -> str:
-    return re.sub(r"\s__playwright_target__=\"[^\"]+\"", "", markup)
-
-
 async def test_locator_should_enforce_same_frame_for_has_locator(
     page: Page, server: Server
 ) -> None:
@@ -836,6 +826,26 @@ async def test_locator_should_enforce_same_frame_for_has_locator(
     )
 
 
+async def test_locator_should_support_locator_or(page: Page, server: Server) -> None:
+    await page.set_content("<div>hello</div><span>world</span>")
+    await expect(page.locator("div").or_(page.locator("span"))).to_have_count(2)
+    await expect(page.locator("div").or_(page.locator("span"))).to_have_text(
+        ["hello", "world"]
+    )
+    await expect(
+        page.locator("span").or_(page.locator("article")).or_(page.locator("div"))
+    ).to_have_text(["hello", "world"])
+    await expect(page.locator("article").or_(page.locator("someting"))).to_have_count(0)
+    await expect(page.locator("article").or_(page.locator("div"))).to_have_text("hello")
+    await expect(page.locator("article").or_(page.locator("span"))).to_have_text(
+        "world"
+    )
+    await expect(page.locator("div").or_(page.locator("article"))).to_have_text("hello")
+    await expect(page.locator("span").or_(page.locator("article"))).to_have_text(
+        "world"
+    )
+
+
 async def test_locator_highlight_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/grid.html")
     await page.locator(".box").nth(3).highlight()
@@ -897,6 +907,48 @@ async def test_should_filter_by_regex_with_special_symbols(page):
     ).to_have_class("test")
 
 
+async def test_should_support_locator_filter(page: Page) -> None:
+    await page.set_content(
+        "<section><div><span>hello</span></div><div><span>world</span></div></section>"
+    )
+
+    await expect(page.locator("div").filter(has_text="hello")).to_have_count(1)
+    await expect(
+        page.locator("div", has_text="hello").filter(has_text="hello")
+    ).to_have_count(1)
+    await expect(
+        page.locator("div", has_text="hello").filter(has_text="world")
+    ).to_have_count(0)
+    await expect(
+        page.locator("section", has_text="hello").filter(has_text="world")
+    ).to_have_count(1)
+    await expect(
+        page.locator("div").filter(has_text="hello").locator("span")
+    ).to_have_count(1)
+    await expect(
+        page.locator("div").filter(has=page.locator("span", has_text="world"))
+    ).to_have_count(1)
+    await expect(page.locator("div").filter(has=page.locator("span"))).to_have_count(2)
+    await expect(
+        page.locator("div").filter(
+            has=page.locator("span"),
+            has_text="world",
+        )
+    ).to_have_count(1)
+    await expect(
+        page.locator("div").filter(has_not=page.locator("span", has_text="world"))
+    ).to_have_count(1)
+    await expect(
+        page.locator("div").filter(has_not=page.locator("section"))
+    ).to_have_count(2)
+    await expect(
+        page.locator("div").filter(has_not=page.locator("span"))
+    ).to_have_count(0)
+
+    await expect(page.locator("div").filter(has_not_text="hello")).to_have_count(1)
+    await expect(page.locator("div").filter(has_not_text="foo")).to_have_count(2)
+
+
 async def test_locators_has_does_not_encode_unicode(page: Page, server: Server):
     await page.goto(server.EMPTY_PAGE)
     locators = [
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index e425cbf0d..f3cf4b0d0 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -542,6 +542,9 @@ async def test_wait_for_nav_should_work_with_dom_history_back_forward(page, serv
     assert page.url == server.PREFIX + "/second.html"
 
 
+@pytest.mark.skip_browser(
+    "webkit"
+)  # WebKit issues load event in some cases, but not always
 async def test_wait_for_nav_should_work_when_subframe_issues_window_stop(
     page, server, is_webkit
 ):
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 768c46d7d..d9cc3b43e 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -774,3 +774,81 @@ def test_should_print_expected_value_with_custom_message(
         expect(page.get_by_text("hello"), "custom-message").to_be_visible(timeout=100)
     assert "custom-message" in str(excinfo.value)
     assert "Expected value" not in str(excinfo.value)
+
+
+def test_should_be_attached_default(page: Page) -> None:
+    page.set_content("<input></input>")
+    locator = page.locator("input")
+    expect(locator).to_be_attached()
+
+
+def test_should_be_attached_with_hidden_element(page: Page) -> None:
+    page.set_content('<button style="display:none">hello</button>')
+    locator = page.locator("button")
+    expect(locator).to_be_attached()
+
+
+def test_should_be_attached_with_not(page: Page) -> None:
+    page.set_content("<button>hello</button>")
+    locator = page.locator("input")
+    expect(locator).not_to_be_attached()
+
+
+def test_should_be_attached_with_attached_true(page: Page) -> None:
+    page.set_content("<button>hello</button>")
+    locator = page.locator("button")
+    expect(locator).to_be_attached(attached=True)
+
+
+def test_should_be_attached_with_attached_false(page: Page) -> None:
+    page.set_content("<button>hello</button>")
+    locator = page.locator("input")
+    expect(locator).to_be_attached(attached=False)
+
+
+def test_should_be_attached_with_not_and_attached_false(page: Page) -> None:
+    page.set_content("<button>hello</button>")
+    locator = page.locator("button")
+    expect(locator).not_to_be_attached(attached=False)
+
+
+def test_should_be_attached_eventually(page: Page) -> None:
+    page.set_content("<div></div>")
+    locator = page.locator("span")
+    page.locator("div").evaluate(
+        "(e) => setTimeout(() => e.innerHTML = '<span>hello</span>', 1000)"
+    )
+    expect(locator).to_be_attached()
+
+
+def test_should_be_attached_eventually_with_not(page: Page) -> None:
+    page.set_content("<div><span>Hello</span></div>")
+    locator = page.locator("span")
+    page.locator("div").evaluate("(e) => setTimeout(() => e.textContent = '', 1000)")
+    expect(locator).not_to_be_attached()
+
+
+def test_should_be_attached_fail(page: Page) -> None:
+    page.set_content("<button>Hello</button>")
+    locator = page.locator("input")
+    with pytest.raises(AssertionError) as exc_info:
+        expect(locator).to_be_attached(timeout=1000)
+    assert "locator resolved to" not in exc_info.value.args[0]
+
+
+def test_should_be_attached_fail_with_not(page: Page) -> None:
+    page.set_content("<input></input>")
+    locator = page.locator("input")
+    with pytest.raises(AssertionError) as exc_info:
+        expect(locator).not_to_be_attached(timeout=1000)
+    assert "locator resolved to <input/>" in exc_info.value.args[0]
+
+
+def test_should_be_attached_with_impossible_timeout(page: Page) -> None:
+    page.set_content("<div id=node>Text content</div>")
+    expect(page.locator("#node")).to_be_attached(timeout=1)
+
+
+def test_should_be_attached_with_impossible_timeout_not(page: Page) -> None:
+    page.set_content("<div id=node>Text content</div>")
+    expect(page.locator("no-such-thing")).not_to_be_attached(timeout=1)
diff --git a/tests/sync/test_fetch_global.py b/tests/sync/test_fetch_global.py
index a45c207da..300465aec 100644
--- a/tests/sync/test_fetch_global.py
+++ b/tests/sync/test_fetch_global.py
@@ -14,6 +14,7 @@
 
 import json
 from pathlib import Path
+from urllib.parse import urlparse
 
 import pytest
 
@@ -115,6 +116,82 @@ def test_should_return_error_with_wrong_credentials(
     assert response.ok is False
 
 
+def test_should_work_with_correct_credentials_and_matching_origin(
+    playwright: Playwright, server: Server
+) -> None:
+    server.set_auth("/empty.html", "user", "pass")
+    request = playwright.request.new_context(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX,
+        }
+    )
+    response = request.get(server.EMPTY_PAGE)
+    assert response.status == 200
+    response.dispose()
+
+
+def test_should_work_with_correct_credentials_and_matching_origin_case_insensitive(
+    playwright: Playwright, server: Server
+) -> None:
+    server.set_auth("/empty.html", "user", "pass")
+    request = playwright.request.new_context(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX.upper(),
+        }
+    )
+    response = request.get(server.EMPTY_PAGE)
+    assert response.status == 200
+    response.dispose()
+
+
+def test_should_return_error_with_correct_credentials_and_mismatching_scheme(
+    playwright: Playwright, server: Server
+) -> None:
+    server.set_auth("/empty.html", "user", "pass")
+    request = playwright.request.new_context(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX.replace("http://", "https://"),
+        }
+    )
+    response = request.get(server.EMPTY_PAGE)
+    assert response.status == 401
+    response.dispose()
+
+
+def test_should_return_error_with_correct_credentials_and_mismatching_hostname(
+    playwright: Playwright, server: Server
+) -> None:
+    server.set_auth("/empty.html", "user", "pass")
+    hostname = urlparse(server.PREFIX).hostname
+    assert hostname
+    origin = server.PREFIX.replace(hostname, "mismatching-hostname")
+    request = playwright.request.new_context(
+        http_credentials={"username": "user", "password": "pass", "origin": origin}
+    )
+    response = request.get(server.EMPTY_PAGE)
+    assert response.status == 401
+    response.dispose()
+
+
+def test_should_return_error_with_correct_credentials_and_mismatching_port(
+    playwright: Playwright, server: Server
+) -> None:
+    server.set_auth("/empty.html", "user", "pass")
+    origin = server.PREFIX.replace(str(server.PORT), str(server.PORT + 1))
+    request = playwright.request.new_context(
+        http_credentials={"username": "user", "password": "pass", "origin": origin}
+    )
+    response = request.get(server.EMPTY_PAGE)
+    assert response.status == 401
+    response.dispose()
+
+
 def test_should_support_global_ignore_https_errors_option(
     playwright: Playwright, https_server: Server
 ) -> None:
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index b2604e164..1055dfd37 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -702,19 +702,13 @@ def test_locator_should_support_has_locator(page: Page, server: Server) -> None:
     page.set_content("<div><span>hello</span></div><div><span>world</span></div>")
     expect(page.locator("div", has=page.locator("text=world"))).to_have_count(1)
     assert (
-        _remove_highlight(
-            page.locator("div", has=page.locator("text=world")).evaluate(
-                "e => e.outerHTML"
-            )
-        )
+        page.locator("div", has=page.locator("text=world")).evaluate("e => e.outerHTML")
         == "<div><span>world</span></div>"
     )
     expect(page.locator("div", has=page.locator('text="hello"'))).to_have_count(1)
     assert (
-        _remove_highlight(
-            page.locator("div", has=page.locator('text="hello"')).evaluate(
-                "e => e.outerHTML"
-            )
+        page.locator("div", has=page.locator('text="hello"')).evaluate(
+            "e => e.outerHTML"
         )
         == "<div><span>hello</span></div>"
     )
@@ -724,10 +718,8 @@ def test_locator_should_support_has_locator(page: Page, server: Server) -> None:
         1
     )
     assert (
-        _remove_highlight(
-            page.locator("div", has=page.locator("span", has_text="wor")).evaluate(
-                "e => e.outerHTML"
-            )
+        page.locator("div", has=page.locator("span", has_text="wor")).evaluate(
+            "e => e.outerHTML"
         )
         == "<div><span>world</span></div>"
     )
@@ -740,10 +732,6 @@ def test_locator_should_support_has_locator(page: Page, server: Server) -> None:
     ).to_have_count(1)
 
 
-def _remove_highlight(markup: str) -> str:
-    return re.sub(r"\s__playwright_target__=\"[^\"]+\"", "", markup)
-
-
 def test_locator_should_enforce_same_frame_for_has_locator(
     page: Page, server: Server
 ) -> None:
@@ -756,6 +744,83 @@ def test_locator_should_enforce_same_frame_for_has_locator(
     )
 
 
+def test_locator_should_support_locator_or(page: Page, server: Server) -> None:
+    page.set_content("<div>hello</div><span>world</span>")
+    expect(page.locator("div").or_(page.locator("span"))).to_have_count(2)
+    expect(page.locator("div").or_(page.locator("span"))).to_have_text(
+        ["hello", "world"]
+    )
+    expect(
+        page.locator("span").or_(page.locator("article")).or_(page.locator("div"))
+    ).to_have_text(["hello", "world"])
+    expect(page.locator("article").or_(page.locator("someting"))).to_have_count(0)
+    expect(page.locator("article").or_(page.locator("div"))).to_have_text("hello")
+    expect(page.locator("article").or_(page.locator("span"))).to_have_text("world")
+    expect(page.locator("div").or_(page.locator("article"))).to_have_text("hello")
+    expect(page.locator("span").or_(page.locator("article"))).to_have_text("world")
+
+
+def test_locator_highlight_should_work(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/grid.html")
+    page.locator(".box").nth(3).highlight()
+    assert page.locator("x-pw-glass").is_visible()
+
+
+def test_should_support_locator_that(page: Page) -> None:
+    page.set_content(
+        "<section><div><span>hello</span></div><div><span>world</span></div></section>"
+    )
+
+    expect(page.locator("div").filter(has_text="hello")).to_have_count(1)
+    expect(
+        page.locator("div", has_text="hello").filter(has_text="hello")
+    ).to_have_count(1)
+    expect(
+        page.locator("div", has_text="hello").filter(has_text="world")
+    ).to_have_count(0)
+    expect(
+        page.locator("section", has_text="hello").filter(has_text="world")
+    ).to_have_count(1)
+    expect(page.locator("div").filter(has_text="hello").locator("span")).to_have_count(
+        1
+    )
+    expect(
+        page.locator("div").filter(has=page.locator("span", has_text="world"))
+    ).to_have_count(1)
+    expect(page.locator("div").filter(has=page.locator("span"))).to_have_count(2)
+    expect(
+        page.locator("div").filter(
+            has=page.locator("span"),
+            has_text="world",
+        )
+    ).to_have_count(1)
+
+
+def test_should_filter_by_case_insensitive_regex_in_a_child(page: Page) -> None:
+    page.set_content('<div class="test"><h5>Title Text</h5></div>')
+    expect(
+        page.locator("div", has_text=re.compile(r"^title text$", re.I))
+    ).to_have_text("Title Text")
+
+
+def test_should_filter_by_case_insensitive_regex_in_multiple_children(
+    page: Page,
+) -> None:
+    page.set_content('<div class="test"><h5>Title</h5> <h2><i>Text</i></h2></div>')
+    expect(
+        page.locator("div", has_text=re.compile(r"^title text$", re.I))
+    ).to_have_class("test")
+
+
+def test_should_filter_by_regex_with_special_symbols(page: Page) -> None:
+    page.set_content(
+        '<div class="test"><h5>First/"and"</h5><h2><i>Second\\</i></h2></div>'
+    )
+    expect(
+        page.locator("div", has_text=re.compile(r'^first\/".*"second\\$', re.S | re.I))
+    ).to_have_class("test")
+
+
 def test_should_support_locator_filter(page: Page) -> None:
     page.set_content(
         "<section><div><span>hello</span></div><div><span>world</span></div></section>"
@@ -784,6 +849,14 @@ def test_should_support_locator_filter(page: Page) -> None:
             has_text="world",
         )
     ).to_have_count(1)
+    expect(
+        page.locator("div").filter(has_not=page.locator("span", has_text="world"))
+    ).to_have_count(1)
+    expect(page.locator("div").filter(has_not=page.locator("section"))).to_have_count(2)
+    expect(page.locator("div").filter(has_not=page.locator("span"))).to_have_count(0)
+
+    expect(page.locator("div").filter(has_not_text="hello")).to_have_count(1)
+    expect(page.locator("div").filter(has_not_text="foo")).to_have_count(2)
 
 
 def test_locators_has_does_not_encode_unicode(page: Page, server: Server) -> None:

From 47caa7c1d01b2eef6617a5d24513f8c07449a765 Mon Sep 17 00:00:00 2001
From: m9810223 <39259397+m9810223@users.noreply.github.com>
Date: Tue, 18 Apr 2023 17:03:12 +0800
Subject: [PATCH 054/438] fix: mark `Playwright.stop` async (#1862)

---
 playwright/_impl/_playwright.py    | 2 +-
 playwright/async_api/_generated.py | 4 ++--
 playwright/sync_api/_generated.py  | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/playwright/_impl/_playwright.py b/playwright/_impl/_playwright.py
index 746b2e830..d3edfacc1 100644
--- a/playwright/_impl/_playwright.py
+++ b/playwright/_impl/_playwright.py
@@ -70,7 +70,7 @@ def _set_selectors(self, selectors: Selectors) -> None:
         self.selectors = selectors
         self.selectors._add_channel(selectors_owner)
 
-    def stop(self) -> None:
+    async def stop(self) -> None:
         pass
 
 
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index e5268b1bb..c4a7442f6 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -14966,7 +14966,7 @@ def request(self) -> "APIRequest":
     def __getitem__(self, value: str) -> "BrowserType":
         return mapping.from_impl(self._impl_obj.__getitem__(value=value))
 
-    def stop(self) -> None:
+    async def stop(self) -> None:
         """Playwright.stop
 
         Terminates this instance of Playwright in case it was created bypassing the Python context manager. This is useful
@@ -14987,7 +14987,7 @@ def stop(self) -> None:
         ```
         """
 
-        return mapping.from_maybe_impl(self._impl_obj.stop())
+        return mapping.from_maybe_impl(await self._impl_obj.stop())
 
 
 mapping.register(PlaywrightImpl, Playwright)
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 72caeb1cc..6ff85ed77 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -15075,7 +15075,7 @@ def stop(self) -> None:
         ```
         """
 
-        return mapping.from_maybe_impl(self._impl_obj.stop())
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.stop()))
 
 
 mapping.register(PlaywrightImpl, Playwright)

From f4a68cd4ef00df2f7fa98cab46296fd91f9f8fde Mon Sep 17 00:00:00 2001
From: m9810223 <39259397+m9810223@users.noreply.github.com>
Date: Sat, 22 Apr 2023 02:27:13 +0800
Subject: [PATCH 055/438] fix: remove duplicated keyword argument `timeout`
 (#1870)

Co-authored-by: Max Schmitt <max@schmitt.mx>
---
 playwright/_impl/_locator.py | 8 +++++---
 tests/sync/test_locators.py  | 4 ++++
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index ee39754d4..a39139f74 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -197,7 +197,7 @@ async def evaluate_handle(
         self, expression: str, arg: Serializable = None, timeout: float = None
     ) -> "JSHandle":
         return await self._with_element(
-            lambda h, o: h.evaluate_handle(expression, arg), timeout
+            lambda h, _: h.evaluate_handle(expression, arg), timeout
         )
 
     async def fill(
@@ -518,7 +518,9 @@ async def screenshot(
     ) -> bytes:
         params = locals_to_params(locals())
         return await self._with_element(
-            lambda h, timeout: h.screenshot(timeout=timeout, **params)
+            lambda h, timeout: h.screenshot(
+                **{**params, "timeout": timeout},  # type: ignore
+            ),
         )
 
     async def scroll_into_view_if_needed(
@@ -550,7 +552,7 @@ async def select_option(
     async def select_text(self, force: bool = None, timeout: float = None) -> None:
         params = locals_to_params(locals())
         return await self._with_element(
-            lambda h, timeout: h.select_text(timeout=timeout, **params), timeout
+            lambda h, timeout: h.select_text(**{**params, "timeout": timeout}), timeout  # type: ignore
         )
 
     async def set_input_files(
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 1055dfd37..8c00368d9 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -355,6 +355,7 @@ def test_locators_should_select_textarea(
     textarea = page.locator("textarea")
     textarea.evaluate("textarea => textarea.value = 'some value'")
     textarea.select_text()
+    textarea.select_text(timeout=1_000)
     if browser_name == "firefox" or browser_name == "webkit":
         assert textarea.evaluate("el => el.selectionStart") == 0
         assert textarea.evaluate("el => el.selectionEnd") == 10
@@ -381,6 +382,9 @@ def test_locators_should_screenshot(
     page.evaluate("window.scrollBy(50, 100)")
     element = page.locator(".box:nth-of-type(3)")
     assert_to_be_golden(element.screenshot(), "screenshot-element-bounding-box.png")
+    assert_to_be_golden(
+        element.screenshot(timeout=1_000), "screenshot-element-bounding-box.png"
+    )
 
 
 def test_locators_should_return_bounding_box(page: Page, server: Server) -> None:

From a3ccf4a80de95d4a0f2a54f53fb616ea41b97939 Mon Sep 17 00:00:00 2001
From: m9810223 <39259397+m9810223@users.noreply.github.com>
Date: Tue, 25 Apr 2023 15:50:00 +0800
Subject: [PATCH 056/438] chore: use ChainMap for dict override (#1877)

---
 playwright/_impl/_locator.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index a39139f74..f5df9ca6b 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -15,6 +15,7 @@
 import json
 import pathlib
 import sys
+from collections import ChainMap
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -519,7 +520,7 @@ async def screenshot(
         params = locals_to_params(locals())
         return await self._with_element(
             lambda h, timeout: h.screenshot(
-                **{**params, "timeout": timeout},  # type: ignore
+                **ChainMap({"timeout": timeout}, params),
             ),
         )
 
@@ -552,7 +553,10 @@ async def select_option(
     async def select_text(self, force: bool = None, timeout: float = None) -> None:
         params = locals_to_params(locals())
         return await self._with_element(
-            lambda h, timeout: h.select_text(**{**params, "timeout": timeout}), timeout  # type: ignore
+            lambda h, timeout: h.select_text(
+                **ChainMap({"timeout": timeout}, params),
+            ),
+            timeout,
         )
 
     async def set_input_files(

From d841631e47aeb93ea73649391116e929bd183465 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 25 Apr 2023 10:11:22 +0200
Subject: [PATCH 057/438] chore: bump to greenlet 2.0.2 (#1878)

---
 meta.yaml | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/meta.yaml b/meta.yaml
index de7cc29d9..7fcb47cbb 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -23,7 +23,7 @@ requirements:
     - setuptools_scm
   run:
     - python
-    - greenlet ==2.0.1
+    - greenlet ==2.0.2
     - pyee ==9.0.4
     - typing_extensions # [py<39]
 test:
diff --git a/setup.py b/setup.py
index d14d03c08..a835b0e66 100644
--- a/setup.py
+++ b/setup.py
@@ -212,7 +212,7 @@ def _download_and_extract_local_driver(
     packages=["playwright"],
     include_package_data=True,
     install_requires=[
-        "greenlet==2.0.1",
+        "greenlet==2.0.2",
         "pyee==9.0.4",
         "typing-extensions;python_version<='3.8'",
     ],

From f3817af4a4169990610d8e0e4c9e0c48cace08cd Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 27 Apr 2023 12:40:49 +0200
Subject: [PATCH 058/438] Revert "chore: bump to greenlet 2.0.2 (#1878)"

This reverts commit d841631e47aeb93ea73649391116e929bd183465.
---
 meta.yaml | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/meta.yaml b/meta.yaml
index 7fcb47cbb..de7cc29d9 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -23,7 +23,7 @@ requirements:
     - setuptools_scm
   run:
     - python
-    - greenlet ==2.0.2
+    - greenlet ==2.0.1
     - pyee ==9.0.4
     - typing_extensions # [py<39]
 test:
diff --git a/setup.py b/setup.py
index a835b0e66..d14d03c08 100644
--- a/setup.py
+++ b/setup.py
@@ -212,7 +212,7 @@ def _download_and_extract_local_driver(
     packages=["playwright"],
     include_package_data=True,
     install_requires=[
-        "greenlet==2.0.2",
+        "greenlet==2.0.1",
         "pyee==9.0.4",
         "typing-extensions;python_version<='3.8'",
     ],

From 827d79a048b09e9f1c3988db1d29ab14655d6caa Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 27 Apr 2023 15:52:58 +0200
Subject: [PATCH 059/438] chore(roll): roll Playwright to
 1.33.0-beta-1682447195000 (#1880)

---
 README.md                                  |  4 +-
 playwright/_impl/_network.py               |  9 ++-
 playwright/_impl/_stream.py                |  2 +-
 playwright/async_api/_generated.py         | 83 ++++++++++++++--------
 playwright/sync_api/_generated.py          | 83 ++++++++++++++--------
 setup.py                                   |  2 +-
 tests/async/test_click.py                  | 28 +++++---
 tests/async/test_navigation.py             |  4 +-
 tests/async/test_page_request_intercept.py | 23 ++++++
 tests/async/test_worker.py                 |  6 ++
 tests/sync/test_page_request_intercept.py  | 27 ++++++-
 11 files changed, 197 insertions(+), 74 deletions(-)

diff --git a/README.md b/README.md
index dc9bf37d1..224349861 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 -->113.0.5672.24<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->113.0.5672.53<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->111.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->112.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index fef8f5bc5..112e4735e 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -366,10 +366,17 @@ async def fetch(
         headers: Dict[str, str] = None,
         postData: Union[Any, str, bytes] = None,
         maxRedirects: int = None,
+        timeout: float = None,
     ) -> "APIResponse":
         page = self.request.frame._page
         return await page.context.request._inner_fetch(
-            self.request, url, method, headers, postData, maxRedirects=maxRedirects
+            self.request,
+            url,
+            method,
+            headers,
+            postData,
+            maxRedirects=maxRedirects,
+            timeout=timeout,
         )
 
     async def fallback(
diff --git a/playwright/_impl/_stream.py b/playwright/_impl/_stream.py
index 2ed352192..762b282c8 100644
--- a/playwright/_impl/_stream.py
+++ b/playwright/_impl/_stream.py
@@ -28,7 +28,7 @@ def __init__(
     async def save_as(self, path: Union[str, Path]) -> None:
         file = await self._loop.run_in_executor(None, lambda: open(path, "wb"))
         while True:
-            binary = await self._channel.send("read")
+            binary = await self._channel.send("read", {"size": 1024 * 1024})
             if not binary:
                 break
             await self._loop.run_in_executor(
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index c4a7442f6..c09b1fe53 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -744,7 +744,8 @@ async def fetch(
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
         post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        timeout: typing.Optional[float] = None
     ) -> "APIResponse":
         """Route.fetch
 
@@ -794,6 +795,8 @@ def handle(route):
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        timeout : Union[float, None]
+            Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
 
         Returns
         -------
@@ -807,6 +810,7 @@ def handle(route):
                 headers=mapping.to_impl(headers),
                 postData=mapping.to_impl(post_data),
                 maxRedirects=max_redirects,
+                timeout=timeout,
             )
         )
 
@@ -13848,7 +13852,7 @@ async def new_context(
         ----------
         viewport : Union[{width: int, height: int}, None]
             Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
-            viewport.
+            viewport. Learn more about [viewport emulation](../emulation.md#viewport).
         screen : Union[{width: int, height: int}, None]
             Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
             `viewport` is set.
@@ -13857,14 +13861,16 @@ async def new_context(
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         java_script_enabled : Union[bool, None]
-            Whether or not to enable JavaScript in the context. Defaults to `true`.
+            Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
+            [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
             Toggles bypassing page's Content-Security-Policy.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules.
+            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
+            our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
@@ -13876,17 +13882,21 @@ async def new_context(
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
-            Whether to emulate network being offline. Defaults to `false`.
+            Whether to emulate network being offline. Defaults to `false`. Learn more about
+            [network emulation](../emulation.md#offline).
         http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
-            Specify device scale factor (can be thought of as dpr). Defaults to `1`.
+            Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about
+            [emulating devices with device scale factor](../emulation.md#devices).
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
-            supported in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
+            so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
+            about [mobile emulation](../emulation.md#isMobile).
         has_touch : Union[bool, None]
-            Specifies if viewport supports touch events. Defaults to false.
+            Specifies if viewport supports touch events. Defaults to false. Learn more about
+            [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -13921,6 +13931,8 @@ async def new_context(
             800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
             will be scaled down if necessary to fit the specified size.
         storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
+            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()`. Either a path to the file with saved storage, or
             an object with the following fields:
@@ -14055,7 +14067,7 @@ async def new_page(
         ----------
         viewport : Union[{width: int, height: int}, None]
             Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
-            viewport.
+            viewport. Learn more about [viewport emulation](../emulation.md#viewport).
         screen : Union[{width: int, height: int}, None]
             Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
             `viewport` is set.
@@ -14064,14 +14076,16 @@ async def new_page(
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         java_script_enabled : Union[bool, None]
-            Whether or not to enable JavaScript in the context. Defaults to `true`.
+            Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
+            [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
             Toggles bypassing page's Content-Security-Policy.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules.
+            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
+            our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
@@ -14083,17 +14097,21 @@ async def new_page(
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
-            Whether to emulate network being offline. Defaults to `false`.
+            Whether to emulate network being offline. Defaults to `false`. Learn more about
+            [network emulation](../emulation.md#offline).
         http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
-            Specify device scale factor (can be thought of as dpr). Defaults to `1`.
+            Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about
+            [emulating devices with device scale factor](../emulation.md#devices).
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
-            supported in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
+            so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
+            about [mobile emulation](../emulation.md#isMobile).
         has_touch : Union[bool, None]
-            Specifies if viewport supports touch events. Defaults to false.
+            Specifies if viewport supports touch events. Defaults to false. Learn more about
+            [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -14128,6 +14146,8 @@ async def new_page(
             800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
             will be scaled down if necessary to fit the specified size.
         storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
+            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()`. Either a path to the file with saved storage, or
             an object with the following fields:
@@ -14593,7 +14613,7 @@ async def launch_persistent_context(
             on.
         viewport : Union[{width: int, height: int}, None]
             Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
-            viewport.
+            viewport. Learn more about [viewport emulation](../emulation.md#viewport).
         screen : Union[{width: int, height: int}, None]
             Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
             `viewport` is set.
@@ -14602,14 +14622,16 @@ async def launch_persistent_context(
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         java_script_enabled : Union[bool, None]
-            Whether or not to enable JavaScript in the context. Defaults to `true`.
+            Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
+            [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
             Toggles bypassing page's Content-Security-Policy.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules.
+            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
+            our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
@@ -14621,17 +14643,21 @@ async def launch_persistent_context(
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
-            Whether to emulate network being offline. Defaults to `false`.
+            Whether to emulate network being offline. Defaults to `false`. Learn more about
+            [network emulation](../emulation.md#offline).
         http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
-            Specify device scale factor (can be thought of as dpr). Defaults to `1`.
+            Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about
+            [emulating devices with device scale factor](../emulation.md#devices).
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
-            supported in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
+            so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
+            about [mobile emulation](../emulation.md#isMobile).
         has_touch : Union[bool, None]
-            Specifies if viewport supports touch events. Defaults to false.
+            Specifies if viewport supports touch events. Defaults to false. Learn more about
+            [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -16588,9 +16614,10 @@ async def all(self) -> typing.List["Locator"]:
 
         When locator points to a list of elements, returns array of locators, pointing to respective elements.
 
-        Note that `locator.all()` does not wait for elements to match the locator, and instead immediately returns
-        whatever is present in the page. To avoid flakiness when elements are loaded dynamically, wait for the loading to
-        finish before calling `locator.all()`.
+        **NOTE** `locator.all()` does not wait for elements to match the locator, and instead immediately returns
+        whatever is present in the page.  When the list of elements changes dynamically, `locator.all()` will
+        produce unpredictable and flaky results.  When the list of elements is stable, but loaded dynamically, wait for the
+        full list to finish loading before calling `locator.all()`.
 
         **Usage**
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 6ff85ed77..a03ee987b 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -754,7 +754,8 @@ def fetch(
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
         post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        timeout: typing.Optional[float] = None
     ) -> "APIResponse":
         """Route.fetch
 
@@ -804,6 +805,8 @@ def handle(route):
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        timeout : Union[float, None]
+            Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
 
         Returns
         -------
@@ -818,6 +821,7 @@ def handle(route):
                     headers=mapping.to_impl(headers),
                     postData=mapping.to_impl(post_data),
                     maxRedirects=max_redirects,
+                    timeout=timeout,
                 )
             )
         )
@@ -13922,7 +13926,7 @@ def new_context(
         ----------
         viewport : Union[{width: int, height: int}, None]
             Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
-            viewport.
+            viewport. Learn more about [viewport emulation](../emulation.md#viewport).
         screen : Union[{width: int, height: int}, None]
             Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
             `viewport` is set.
@@ -13931,14 +13935,16 @@ def new_context(
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         java_script_enabled : Union[bool, None]
-            Whether or not to enable JavaScript in the context. Defaults to `true`.
+            Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
+            [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
             Toggles bypassing page's Content-Security-Policy.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules.
+            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
+            our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
@@ -13950,17 +13956,21 @@ def new_context(
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
-            Whether to emulate network being offline. Defaults to `false`.
+            Whether to emulate network being offline. Defaults to `false`. Learn more about
+            [network emulation](../emulation.md#offline).
         http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
-            Specify device scale factor (can be thought of as dpr). Defaults to `1`.
+            Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about
+            [emulating devices with device scale factor](../emulation.md#devices).
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
-            supported in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
+            so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
+            about [mobile emulation](../emulation.md#isMobile).
         has_touch : Union[bool, None]
-            Specifies if viewport supports touch events. Defaults to false.
+            Specifies if viewport supports touch events. Defaults to false. Learn more about
+            [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -13995,6 +14005,8 @@ def new_context(
             800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
             will be scaled down if necessary to fit the specified size.
         storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
+            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()`. Either a path to the file with saved storage, or
             an object with the following fields:
@@ -14131,7 +14143,7 @@ def new_page(
         ----------
         viewport : Union[{width: int, height: int}, None]
             Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
-            viewport.
+            viewport. Learn more about [viewport emulation](../emulation.md#viewport).
         screen : Union[{width: int, height: int}, None]
             Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
             `viewport` is set.
@@ -14140,14 +14152,16 @@ def new_page(
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         java_script_enabled : Union[bool, None]
-            Whether or not to enable JavaScript in the context. Defaults to `true`.
+            Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
+            [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
             Toggles bypassing page's Content-Security-Policy.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules.
+            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
+            our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
@@ -14159,17 +14173,21 @@ def new_page(
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
-            Whether to emulate network being offline. Defaults to `false`.
+            Whether to emulate network being offline. Defaults to `false`. Learn more about
+            [network emulation](../emulation.md#offline).
         http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
-            Specify device scale factor (can be thought of as dpr). Defaults to `1`.
+            Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about
+            [emulating devices with device scale factor](../emulation.md#devices).
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
-            supported in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
+            so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
+            about [mobile emulation](../emulation.md#isMobile).
         has_touch : Union[bool, None]
-            Specifies if viewport supports touch events. Defaults to false.
+            Specifies if viewport supports touch events. Defaults to false. Learn more about
+            [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -14204,6 +14222,8 @@ def new_page(
             800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
             will be scaled down if necessary to fit the specified size.
         storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
+            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()`. Either a path to the file with saved storage, or
             an object with the following fields:
@@ -14675,7 +14695,7 @@ def launch_persistent_context(
             on.
         viewport : Union[{width: int, height: int}, None]
             Sets a consistent viewport for each page. Defaults to an 1280x720 viewport. `no_viewport` disables the fixed
-            viewport.
+            viewport. Learn more about [viewport emulation](../emulation.md#viewport).
         screen : Union[{width: int, height: int}, None]
             Emulates consistent window screen size available inside web page via `window.screen`. Is only used when the
             `viewport` is set.
@@ -14684,14 +14704,16 @@ def launch_persistent_context(
         ignore_https_errors : Union[bool, None]
             Whether to ignore HTTPS errors when sending network requests. Defaults to `false`.
         java_script_enabled : Union[bool, None]
-            Whether or not to enable JavaScript in the context. Defaults to `true`.
+            Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
+            [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
             Toggles bypassing page's Content-Security-Policy.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules.
+            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
+            our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
@@ -14703,17 +14725,21 @@ def launch_persistent_context(
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request.
         offline : Union[bool, None]
-            Whether to emulate network being offline. Defaults to `false`.
+            Whether to emulate network being offline. Defaults to `false`. Learn more about
+            [network emulation](../emulation.md#offline).
         http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
-            Specify device scale factor (can be thought of as dpr). Defaults to `1`.
+            Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about
+            [emulating devices with device scale factor](../emulation.md#devices).
         is_mobile : Union[bool, None]
-            Whether the `meta viewport` tag is taken into account and touch events are enabled. Defaults to `false`. Not
-            supported in Firefox.
+            Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
+            so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
+            about [mobile emulation](../emulation.md#isMobile).
         has_touch : Union[bool, None]
-            Specifies if viewport supports touch events. Defaults to false.
+            Specifies if viewport supports touch events. Defaults to false. Learn more about
+            [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
             Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -16700,9 +16726,10 @@ def all(self) -> typing.List["Locator"]:
 
         When locator points to a list of elements, returns array of locators, pointing to respective elements.
 
-        Note that `locator.all()` does not wait for elements to match the locator, and instead immediately returns
-        whatever is present in the page. To avoid flakiness when elements are loaded dynamically, wait for the loading to
-        finish before calling `locator.all()`.
+        **NOTE** `locator.all()` does not wait for elements to match the locator, and instead immediately returns
+        whatever is present in the page.  When the list of elements changes dynamically, `locator.all()` will
+        produce unpredictable and flaky results.  When the list of elements is stable, but loaded dynamically, wait for the
+        full list to finish loading before calling `locator.all()`.
 
         **Usage**
 
diff --git a/setup.py b/setup.py
index d14d03c08..91867b389 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.33.0-alpha-apr-12-2023"
+driver_version = "1.33.0-beta-1682447195000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_click.py b/tests/async/test_click.py
index 76d06a80f..19a8dae6d 100644
--- a/tests/async/test_click.py
+++ b/tests/async/test_click.py
@@ -482,15 +482,15 @@ async def test_click_the_button_with_offset_with_page_scale(
 
     await page.click("button", position={"x": 20, "y": 10})
     assert await page.evaluate("result") == "Clicked"
-    expected = {"x": 28, "y": 18}
-    if is_webkit:
-        # WebKit rounds up during css -> dip -> css conversion.
-        expected = {"x": 26, "y": 17}
-    elif is_chromium:
-        # Chromium rounds down during css -> dip -> css conversion.
-        expected = {"x": 27, "y": 18}
-    assert await page.evaluate("pageX") == expected["x"]
-    assert await page.evaluate("pageY") == expected["y"]
+
+    def _assert_close_to(expected: int, actual: int) -> None:
+        if abs(expected - actual) > 2:
+            raise AssertionError(f"Expected: {expected}, received: {actual}")
+
+    # Expect 20;10 + 8px of border in each direction. Allow some delta as different
+    # browsers round up or down differently during css -> dip -> css conversion.
+    _assert_close_to(28, await page.evaluate("pageX"))
+    _assert_close_to(18, await page.evaluate("pageY"))
     await context.close()
 
 
@@ -676,7 +676,15 @@ async def click():
 
 async def test_wait_for_select_to_be_enabled(page, server):
     await page.set_content(
-        '<select onclick="javascript:window.__CLICKED=true;" disabled><option selected>Hello</option></select>'
+        """
+        <select disabled><option selected>Hello</option></select>
+        <script>
+        document.querySelector('select').addEventListener('mousedown', event => {
+            window.__CLICKED=true;
+            event.preventDefault();
+        });
+        </script>
+    """
     )
     done = []
 
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index f3cf4b0d0..bf41f6938 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -918,9 +918,9 @@ async def test_frame_goto_should_continue_after_client_redirect(page, server):
     url = server.PREFIX + "/frames/child-redirect.html"
 
     with pytest.raises(Error) as exc_info:
-        await page.goto(url, timeout=2500, wait_until="networkidle")
+        await page.goto(url, timeout=5000, wait_until="networkidle")
 
-    assert "Timeout 2500ms exceeded." in exc_info.value.message
+    assert "Timeout 5000ms exceeded." in exc_info.value.message
     assert (
         f'navigating to "{url}", waiting until "networkidle"' in exc_info.value.message
     )
diff --git a/tests/async/test_page_request_intercept.py b/tests/async/test_page_request_intercept.py
index bda57cf44..09e6f56ce 100644
--- a/tests/async/test_page_request_intercept.py
+++ b/tests/async/test_page_request_intercept.py
@@ -14,10 +14,33 @@
 
 import asyncio
 
+import pytest
+
 from playwright.async_api import Page, Route
 from tests.server import Server
 
 
+async def test_should_support_timeout_option_in_route_fetch(server: Server, page: Page):
+    server.set_route(
+        "/slow",
+        lambda request: (
+            request.responseHeaders.addRawHeader("Content-Length", "4096"),
+            request.responseHeaders.addRawHeader("Content-Type", "text/html"),
+            request.write(b""),
+        ),
+    )
+
+    async def handle(route: Route):
+        with pytest.raises(Exception) as error:
+            await route.fetch(timeout=1000)
+        assert "Request timed out after 1000ms" in error.value.message
+
+    await page.route("**/*", lambda route: handle(route))
+    with pytest.raises(Exception) as error:
+        await page.goto(server.PREFIX + "/slow", timeout=2000)
+    assert "Timeout 2000ms exceeded" in error.value.message
+
+
 async def test_should_not_follow_redirects_when_max_redirects_is_set_to_0_in_route_fetch(
     server: Server, page: Page
 ):
diff --git a/tests/async/test_worker.py b/tests/async/test_worker.py
index fb6d62b18..399df4407 100644
--- a/tests/async/test_worker.py
+++ b/tests/async/test_worker.py
@@ -137,6 +137,9 @@ async def test_workers_should_clear_upon_cross_process_navigation(server, page):
     assert len(page.workers) == 0
 
 
+@pytest.mark.skip_browser(
+    "firefox"
+)  # https://github.com/microsoft/playwright/issues/21760
 async def test_workers_should_report_network_activity(page, server):
     async with page.expect_worker() as worker_info:
         await page.goto(server.PREFIX + "/worker/worker.html")
@@ -155,6 +158,9 @@ async def test_workers_should_report_network_activity(page, server):
     assert response.ok
 
 
+@pytest.mark.skip_browser(
+    "firefox"
+)  # https://github.com/microsoft/playwright/issues/21760
 async def test_workers_should_report_network_activity_on_worker_creation(page, server):
     # Chromium needs waitForDebugger enabled for this one.
     await page.goto(server.EMPTY_PAGE)
diff --git a/tests/sync/test_page_request_intercept.py b/tests/sync/test_page_request_intercept.py
index 0face7efe..f44a30deb 100644
--- a/tests/sync/test_page_request_intercept.py
+++ b/tests/sync/test_page_request_intercept.py
@@ -12,10 +12,35 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from playwright.sync_api import Page, Route
+import pytest
+
+from playwright.sync_api import Error, Page, Route
 from tests.server import Server
 
 
+def test_should_support_timeout_option_in_route_fetch(
+    server: Server, page: Page
+) -> None:
+    server.set_route(
+        "/slow",
+        lambda request: (
+            request.responseHeaders.addRawHeader("Content-Length", "4096"),
+            request.responseHeaders.addRawHeader("Content-Type", "text/html"),
+            request.write(b""),
+        ),
+    )
+
+    def handle(route: Route) -> None:
+        with pytest.raises(Error) as error:
+            route.fetch(timeout=1000)
+        assert "Request timed out after 1000ms" in error.value.message
+
+    page.route("**/*", lambda route: handle(route))
+    with pytest.raises(Error) as error:
+        page.goto(server.PREFIX + "/slow", timeout=2000)
+    assert "Timeout 2000ms exceeded" in error.value.message
+
+
 def test_should_intercept_with_url_override(server: Server, page: Page) -> None:
     def handle(route: Route) -> None:
         response = route.fetch(url=server.PREFIX + "/one-style.html")

From b9b8fed2454bcfb0d5ae6571e22ef657862f7ac5 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 27 Apr 2023 18:28:05 +0200
Subject: [PATCH 060/438] devops: have Jammy as Docker default (#1884)

---
 utils/docker/publish_docker.sh | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/utils/docker/publish_docker.sh b/utils/docker/publish_docker.sh
index fbda708a6..23208e01b 100755
--- a/utils/docker/publish_docker.sh
+++ b/utils/docker/publish_docker.sh
@@ -32,23 +32,23 @@ if [[ -z "${GITHUB_SHA}" ]]; then
 fi
 
 FOCAL_TAGS=(
-  "next"
-  "sha-${GITHUB_SHA}"
   "next-focal"
 )
 if [[ "$RELEASE_CHANNEL" == "stable" ]]; then
-  FOCAL_TAGS+=("latest")
   FOCAL_TAGS+=("focal")
   FOCAL_TAGS+=("v${PW_VERSION}-focal")
-  FOCAL_TAGS+=("v${PW_VERSION}")
 fi
 
 JAMMY_TAGS=(
+  "next"
   "next-jammy"
+  "sha-${GITHUB_SHA}"
 )
 if [[ "$RELEASE_CHANNEL" == "stable" ]]; then
+  JAMMY_TAGS+=("latest")
   JAMMY_TAGS+=("jammy")
   JAMMY_TAGS+=("v${PW_VERSION}-jammy")
+  JAMMY_TAGS+=("v${PW_VERSION}")
 fi
 
 tag_and_push() {

From 12165ce32eaf73a4eff7e9ac1f594f63c21f7bff Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 2 May 2023 17:37:01 +0200
Subject: [PATCH 061/438] fix: inherit context timeout correctly (#1889)

---
 playwright/_impl/_helper.py |  4 ++--
 tests/async/test_page.py    | 15 ++++++++++++++-
 tests/sync/test_sync.py     | 13 +++++++++++++
 3 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 065ce101b..88a10589d 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -177,8 +177,8 @@ class HarLookupResult(TypedDict, total=False):
 class TimeoutSettings:
     def __init__(self, parent: Optional["TimeoutSettings"]) -> None:
         self._parent = parent
-        self._timeout = 30000.0
-        self._navigation_timeout = 30000.0
+        self._timeout: Optional[float] = None
+        self._navigation_timeout: Optional[float] = None
 
     def set_timeout(self, timeout: float) -> None:
         self._timeout = timeout
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 54abccb9d..8673abfda 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -18,7 +18,7 @@
 
 import pytest
 
-from playwright.async_api import Error, Page, Route, TimeoutError
+from playwright.async_api import BrowserContext, Error, Page, Route, TimeoutError
 from tests.server import Server
 
 
@@ -331,6 +331,19 @@ async def test_wait_for_response_should_work_with_no_timeout(page, server):
     assert response.url == server.PREFIX + "/digits/2.png"
 
 
+async def test_wait_for_response_should_use_context_timeout(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+
+    context.set_default_timeout(1_000)
+    with pytest.raises(Error) as exc_info:
+        async with page.expect_response("https://playwright.dev"):
+            pass
+    assert exc_info.type is TimeoutError
+    assert "Timeout 1000ms exceeded" in exc_info.value.message
+
+
 async def test_expose_binding(page):
     binding_source = []
 
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index 6ab859038..375e4ff2a 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -277,3 +277,16 @@ def test_expect_response_should_work(page: Page, server: Server) -> None:
     assert resp.value.status == 200
     assert resp.value.ok
     assert resp.value.request
+
+
+def test_expect_response_should_use_context_timeout(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    page.goto(server.EMPTY_PAGE)
+
+    context.set_default_timeout(1_000)
+    with pytest.raises(Error) as exc_info:
+        with page.expect_response("https://playwright.dev"):
+            pass
+    assert exc_info.type is TimeoutError
+    assert "Timeout 1000ms exceeded" in exc_info.value.message

From ebfc27e29b12895b467a00c51837757a4c844fac Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 3 May 2023 09:16:40 +0200
Subject: [PATCH 062/438] chore(roll): roll to Playwright v1.33 (#1892)

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

diff --git a/setup.py b/setup.py
index 91867b389..b2ab3b9b7 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.33.0-beta-1682447195000"
+driver_version = "1.33.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 4d79dfc1192e0f823da68730c8a464b6372481ae Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 4 May 2023 19:56:45 +0200
Subject: [PATCH 063/438] chore: allow to call Playwright.stop() multiple times
 (#1896)

---
 playwright/async_api/_context_manager.py |  4 ++++
 playwright/sync_api/_context_manager.py  |  4 ++++
 tests/async/test_asyncio.py              |  6 ++++++
 tests/sync/test_sync.py                  | 14 ++++++++++++++
 4 files changed, 28 insertions(+)

diff --git a/playwright/async_api/_context_manager.py b/playwright/async_api/_context_manager.py
index b5bdbbbb3..2876d85e5 100644
--- a/playwright/async_api/_context_manager.py
+++ b/playwright/async_api/_context_manager.py
@@ -25,6 +25,7 @@
 class PlaywrightContextManager:
     def __init__(self) -> None:
         self._connection: Connection
+        self._exit_was_called = False
 
     async def __aenter__(self) -> AsyncPlaywright:
         loop = asyncio.get_running_loop()
@@ -51,4 +52,7 @@ async def start(self) -> AsyncPlaywright:
         return await self.__aenter__()
 
     async def __aexit__(self, *args: Any) -> None:
+        if self._exit_was_called:
+            return
+        self._exit_was_called = True
         await self._connection.stop_async()
diff --git a/playwright/sync_api/_context_manager.py b/playwright/sync_api/_context_manager.py
index 3b5c6d8b4..4249a1fa1 100644
--- a/playwright/sync_api/_context_manager.py
+++ b/playwright/sync_api/_context_manager.py
@@ -36,6 +36,7 @@ def __init__(self) -> None:
         self._loop: asyncio.AbstractEventLoop
         self._own_loop = False
         self._watcher: Optional[AbstractChildWatcher] = None
+        self._exit_was_called = False
 
     def __enter__(self) -> SyncPlaywright:
         try:
@@ -98,6 +99,9 @@ def start(self) -> SyncPlaywright:
         return self.__enter__()
 
     def __exit__(self, *args: Any) -> None:
+        if self._exit_was_called:
+            return
+        self._exit_was_called = True
         self._connection.stop_sync()
         if self._watcher:
             self._watcher.close()
diff --git a/tests/async/test_asyncio.py b/tests/async/test_asyncio.py
index 26d376c8c..7808aae48 100644
--- a/tests/async/test_asyncio.py
+++ b/tests/async/test_asyncio.py
@@ -48,3 +48,9 @@ def exception_handlerdler(loop, context) -> None:
     assert handler_exception is None
 
     asyncio.get_running_loop().set_exception_handler(None)
+
+
+async def test_async_playwright_stop_multiple_times() -> None:
+    playwright = await async_playwright().start()
+    await playwright.stop()
+    await playwright.stop()
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index 375e4ff2a..e1555d611 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import multiprocessing
 import os
 
 import pytest
@@ -290,3 +291,16 @@ def test_expect_response_should_use_context_timeout(
             pass
     assert exc_info.type is TimeoutError
     assert "Timeout 1000ms exceeded" in exc_info.value.message
+
+
+def _test_sync_playwright_stop_multiple_times() -> None:
+    playwright = sync_playwright().start()
+    playwright.stop()
+    playwright.stop()
+
+
+def test_sync_playwright_stop_multiple_times() -> None:
+    p = multiprocessing.Process(target=_test_sync_playwright_stop_multiple_times)
+    p.start()
+    p.join()
+    assert p.exitcode == 0

From 19cf427d68a7f21a41f1fc6dec556741a0b33c99 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 4 May 2023 23:13:57 +0200
Subject: [PATCH 064/438] chore: print pretty exception after playwright.stop()
 (#1899)

---
 playwright/_impl/_sync_base.py |  5 +++++
 tests/sync/test_sync.py        | 29 +++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/playwright/_impl/_sync_base.py b/playwright/_impl/_sync_base.py
index 72385719e..a26f2fb65 100644
--- a/playwright/_impl/_sync_base.py
+++ b/playwright/_impl/_sync_base.py
@@ -32,6 +32,7 @@
 
 import greenlet
 
+from playwright._impl._helper import Error
 from playwright._impl._impl_to_api_mapping import ImplToApiMapping, ImplWrapper
 
 mapping = ImplToApiMapping()
@@ -92,6 +93,10 @@ def _sync(
         coro: Union[Coroutine[Any, Any, Any], Generator[Any, Any, Any]],
     ) -> Any:
         __tracebackhide__ = True
+        if self._loop.is_closed():
+            coro.close()
+            raise Error("Event loop is closed! Is Playwright already stopped?")
+
         g_self = greenlet.getcurrent()
         task: asyncio.tasks.Task[Any] = self._loop.create_task(coro)
         setattr(task, "__pw_stack__", inspect.stack())
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index e1555d611..11f6aab08 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -14,6 +14,7 @@
 
 import multiprocessing
 import os
+from typing import Any, Dict
 
 import pytest
 
@@ -304,3 +305,31 @@ def test_sync_playwright_stop_multiple_times() -> None:
     p.start()
     p.join()
     assert p.exitcode == 0
+
+
+def _test_call_sync_method_after_playwright_close_with_own_loop(
+    browser_name: str,
+    launch_arguments: Dict[str, Any],
+    empty_page: str,
+) -> None:
+    playwright = sync_playwright().start()
+    browser = playwright[browser_name].launch(**launch_arguments)
+    context = browser.new_context()
+    page = context.new_page()
+    page.goto(empty_page)
+    playwright.stop()
+    with pytest.raises(Error) as exc:
+        page.evaluate("1+1")
+    assert "Event loop is closed! Is Playwright already stopped?" in str(exc.value)
+
+
+def test_call_sync_method_after_playwright_close_with_own_loop(
+    server: Server, browser_name: str, launch_arguments: Dict[str, Any]
+) -> None:
+    p = multiprocessing.Process(
+        target=_test_call_sync_method_after_playwright_close_with_own_loop,
+        args=[browser_name, launch_arguments, server.EMPTY_PAGE],
+    )
+    p.start()
+    p.join()
+    assert p.exitcode == 0

From b913f4830f065883419e6840e3f5be089c47cb08 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 8 May 2023 18:21:19 +0200
Subject: [PATCH 065/438] fix: cancel protocol calls on connection / driver
 close (#1897)

---
 playwright/_impl/_browser.py            |  3 ++-
 playwright/_impl/_browser_type.py       |  7 ++++---
 playwright/_impl/_connection.py         | 21 +++++++++++++++----
 playwright/_impl/_helper.py             |  8 ++++++--
 playwright/_impl/_json_pipe.py          | 27 +++++++++++--------------
 tests/async/test_asyncio.py             | 13 ++++++++++++
 tests/async/test_browsertype_connect.py |  4 ++--
 tests/sync/test_browsertype_connect.py  |  2 +-
 8 files changed, 57 insertions(+), 28 deletions(-)

diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index 24b07adc3..4266098cc 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -29,6 +29,7 @@
 from playwright._impl._cdp_session import CDPSession
 from playwright._impl._connection import ChannelOwner, from_channel
 from playwright._impl._helper import (
+    BROWSER_CLOSED_ERROR,
     ColorScheme,
     ForcedColors,
     HarContentPolicy,
@@ -182,7 +183,7 @@ async def close(self) -> None:
             if not is_safe_close_error(e):
                 raise e
         if self._should_close_connection_on_close:
-            await self._connection.stop_async()
+            await self._connection.stop_async(BROWSER_CLOSED_ERROR)
 
     @property
     def version(self) -> str:
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 119a1f8c9..50c1746fa 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -33,6 +33,7 @@
     from_nullable_channel,
 )
 from playwright._impl._helper import (
+    BROWSER_CLOSED_ERROR,
     ColorScheme,
     Env,
     ForcedColors,
@@ -218,7 +219,7 @@ async def connect(
 
         timeout_future = throw_on_timeout(timeout, Error("Connection timed out"))
         done, pending = await asyncio.wait(
-            {transport.on_error_future, playwright_future, timeout_future},
+            {playwright_future, timeout_future},
             return_when=asyncio.FIRST_COMPLETED,
         )
         if not playwright_future.done():
@@ -234,13 +235,13 @@ async def connect(
         self._did_launch_browser(browser)
         browser._should_close_connection_on_close = True
 
-        def handle_transport_close() -> None:
+        def handle_transport_close(transport_exception: str) -> None:
             for context in browser.contexts:
                 for page in context.pages:
                     page._on_close()
                 context._on_close()
             browser._on_close()
-            connection.cleanup()
+            connection.cleanup(transport_exception or BROWSER_CLOSED_ERROR)
 
         transport.once("close", handle_transport_close)
 
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index aa57f2157..10a3fe6b3 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -36,7 +36,7 @@
 from pyee.asyncio import AsyncIOEventEmitter
 
 import playwright
-from playwright._impl._helper import ParsedMessagePayload, parse_error
+from playwright._impl._helper import Error, ParsedMessagePayload, parse_error
 from playwright._impl._transport import Transport
 
 if TYPE_CHECKING:
@@ -242,6 +242,7 @@ def __init__(
         ] = contextvars.ContextVar("ApiZone", default=None)
         self._local_utils: Optional["LocalUtils"] = local_utils
         self._tracing_count = 0
+        self._closed_error_message: Optional[str] = None
 
     @property
     def local_utils(self) -> "LocalUtils":
@@ -272,16 +273,24 @@ def stop_sync(self) -> None:
         self._loop.run_until_complete(self._transport.wait_until_stopped())
         self.cleanup()
 
-    async def stop_async(self) -> None:
+    async def stop_async(self, error_message: str = None) -> None:
         self._transport.request_stop()
         await self._transport.wait_until_stopped()
-        self.cleanup()
+        self.cleanup(error_message)
 
-    def cleanup(self) -> None:
+    def cleanup(self, error_message: str = None) -> None:
+        if not error_message:
+            error_message = "Connection closed"
+        self._closed_error_message = error_message
         if self._init_task and not self._init_task.done():
             self._init_task.cancel()
         for ws_connection in self._child_ws_connections:
             ws_connection._transport.dispose()
+        for callback in self._callbacks.values():
+            callback.future.set_exception(Error(error_message))
+            # Prevent 'Task exception was never retrieved'
+            callback.future.exception()
+        self._callbacks.clear()
         self.emit("close")
 
     def call_on_object_with_known_name(
@@ -298,6 +307,8 @@ def set_in_tracing(self, is_tracing: bool) -> None:
     def _send_message_to_server(
         self, guid: str, method: str, params: Dict
     ) -> ProtocolCallback:
+        if self._closed_error_message:
+            raise Error(self._closed_error_message)
         self._last_id += 1
         id = self._last_id
         callback = ProtocolCallback(self._loop)
@@ -339,6 +350,8 @@ def _send_message_to_server(
         return callback
 
     def dispatch(self, msg: ParsedMessagePayload) -> None:
+        if self._closed_error_message:
+            return
         id = msg.get("id")
         if id:
             callback = self._callbacks.pop(id)
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 88a10589d..c87c092da 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -314,10 +314,14 @@ def prepare_interception_patterns(
         return patterns
 
 
+BROWSER_CLOSED_ERROR = "Browser has been closed"
+BROWSER_OR_CONTEXT_CLOSED_ERROR = "Target page, context or browser has been closed"
+
+
 def is_safe_close_error(error: Exception) -> bool:
     message = str(error)
-    return message.endswith("Browser has been closed") or message.endswith(
-        "Target page, context or browser has been closed"
+    return message.endswith(BROWSER_CLOSED_ERROR) or message.endswith(
+        BROWSER_OR_CONTEXT_CLOSED_ERROR
     )
 
 
diff --git a/playwright/_impl/_json_pipe.py b/playwright/_impl/_json_pipe.py
index b4452c700..86592841d 100644
--- a/playwright/_impl/_json_pipe.py
+++ b/playwright/_impl/_json_pipe.py
@@ -17,9 +17,8 @@
 
 from pyee.asyncio import AsyncIOEventEmitter
 
-from playwright._impl._api_types import Error
 from playwright._impl._connection import Channel
-from playwright._impl._helper import ParsedMessagePayload, parse_error
+from playwright._impl._helper import ParsedMessagePayload
 from playwright._impl._transport import Transport
 
 
@@ -37,7 +36,7 @@ def __init__(
 
     def request_stop(self) -> None:
         self._stop_requested = True
-        self._loop.create_task(self._pipe_channel.send("close", {}))
+        self._pipe_channel.send_no_reply("close", {})
 
     def dispose(self) -> None:
         self.on_error_future.cancel()
@@ -49,17 +48,17 @@ async def wait_until_stopped(self) -> None:
     async def connect(self) -> None:
         self._stopped_future: asyncio.Future = asyncio.Future()
 
+        close_error: Optional[str] = None
+
         def handle_message(message: Dict) -> None:
-            if not self._stop_requested:
+            try:
                 self.on_message(cast(ParsedMessagePayload, message))
+            except Exception as e:
+                nonlocal close_error
+                close_error = str(e)
 
-        def handle_closed(error: Optional[Dict]) -> None:
-            self.emit("close")
-            self.on_error_future.set_exception(
-                parse_error(error["error"])
-                if error
-                else Error("Playwright connection closed")
-            )
+        def handle_closed() -> None:
+            self.emit("close", close_error)
             self._stopped_future.set_result(None)
 
         self._pipe_channel.on(
@@ -68,13 +67,11 @@ def handle_closed(error: Optional[Dict]) -> None:
         )
         self._pipe_channel.on(
             "closed",
-            lambda params: handle_closed(params.get("error")),
+            lambda _: handle_closed(),
         )
 
     async def run(self) -> None:
         await self._stopped_future
 
     def send(self, message: Dict) -> None:
-        if self._stop_requested:
-            raise Error("Playwright connection closed")
-        self._loop.create_task(self._pipe_channel.send("send", {"message": message}))
+        self._pipe_channel.send_no_reply("send", {"message": message})
diff --git a/tests/async/test_asyncio.py b/tests/async/test_asyncio.py
index 7808aae48..4d6174d1b 100644
--- a/tests/async/test_asyncio.py
+++ b/tests/async/test_asyncio.py
@@ -19,6 +19,8 @@
 
 from playwright.async_api import async_playwright
 
+from ..server import Server
+
 
 async def test_should_cancel_underlying_protocol_calls(
     browser_name: str, launch_arguments: Dict
@@ -54,3 +56,14 @@ async def test_async_playwright_stop_multiple_times() -> None:
     playwright = await async_playwright().start()
     await playwright.stop()
     await playwright.stop()
+
+
+async def test_cancel_pending_protocol_call_on_playwright_stop(server: Server) -> None:
+    server.set_route("/hang", lambda _: None)
+    playwright = await async_playwright().start()
+    api_request_context = await playwright.request.new_context()
+    pending_task = asyncio.create_task(api_request_context.get(server.PREFIX + "/hang"))
+    await playwright.stop()
+    with pytest.raises(Exception) as exc_info:
+        await pending_task
+    assert "Connection closed" in str(exc_info.value)
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index cc152abbf..1bbadeae1 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -145,7 +145,7 @@ async def test_browser_type_connect_should_throw_when_used_after_is_connected_re
 
     with pytest.raises(Error) as exc_info:
         await page.evaluate("1 + 1")
-    assert "Playwright connection closed" == exc_info.value.message
+    assert "has been closed" in exc_info.value.message
     assert browser.is_connected() is False
 
 
@@ -159,7 +159,7 @@ async def test_browser_type_connect_should_reject_navigation_when_browser_closes
 
     with pytest.raises(Error) as exc_info:
         await page.goto(server.PREFIX + "/one-style.html")
-    assert "Playwright connection closed" in exc_info.value.message
+    assert "has been closed" in exc_info.value.message
 
 
 async def test_should_not_allow_getting_the_path(
diff --git a/tests/sync/test_browsertype_connect.py b/tests/sync/test_browsertype_connect.py
index 8d512db31..26ee44227 100644
--- a/tests/sync/test_browsertype_connect.py
+++ b/tests/sync/test_browsertype_connect.py
@@ -140,7 +140,7 @@ def test_browser_type_connect_should_throw_when_used_after_is_connected_returns_
 
     with pytest.raises(Error) as exc_info:
         page.evaluate("1 + 1")
-    assert "Playwright connection closed" == exc_info.value.message
+    assert "has been closed" in exc_info.value.message
     assert browser.is_connected() is False
 
 

From 7405d655bfcdfaa6819e0ec4e2a4ebebf9d0aefe Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 9 May 2023 21:34:30 +0200
Subject: [PATCH 066/438] chore: do not continue with no_reply messages (#1905)

---
 playwright/_impl/_connection.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 10a3fe6b3..a0762f339 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -68,9 +68,10 @@ async def send_return_as_dict(self, method: str, params: Dict = None) -> Any:
         )
 
     def send_no_reply(self, method: str, params: Dict = None) -> None:
+        # No reply messages are used to e.g. waitForEventInfo(after).
         self._connection.wrap_api_call_sync(
             lambda: self._connection._send_message_to_server(
-                self._guid, method, {} if params is None else params
+                self._guid, method, {} if params is None else params, True
             )
         )
 
@@ -178,6 +179,7 @@ def remove_listener(self, event: str, f: Any) -> None:
 class ProtocolCallback:
     def __init__(self, loop: asyncio.AbstractEventLoop) -> None:
         self.stack_trace: traceback.StackSummary
+        self.no_reply: bool
         self.future = loop.create_future()
         # The outer task can get cancelled by the user, this forwards the cancellation to the inner task.
         current_task = asyncio.current_task()
@@ -305,7 +307,7 @@ def set_in_tracing(self, is_tracing: bool) -> None:
             self._tracing_count -= 1
 
     def _send_message_to_server(
-        self, guid: str, method: str, params: Dict
+        self, guid: str, method: str, params: Dict, no_reply: bool = False
     ) -> ProtocolCallback:
         if self._closed_error_message:
             raise Error(self._closed_error_message)
@@ -317,6 +319,7 @@ def _send_message_to_server(
             traceback.StackSummary,
             getattr(task, "__pw_stack_trace__", traceback.extract_stack()),
         )
+        callback.no_reply = no_reply
         self._callbacks[id] = callback
         stack_trace_information = cast(ParsedStackTrace, self._api_zone.get())
         frames = stack_trace_information.get("frames", [])
@@ -357,6 +360,10 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
             callback = self._callbacks.pop(id)
             if callback.future.cancelled():
                 return
+            # No reply messages are used to e.g. waitForEventInfo(after) which returns exceptions on page close.
+            # To prevent 'Future exception was never retrieved' we just ignore such messages.
+            if callback.no_reply:
+                return
             error = msg.get("error")
             if error:
                 parsed_error = parse_error(error["error"])  # type: ignore

From 3058517352bcb82ccc8a83351878a9c30ab25854 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 9 May 2023 22:11:15 +0200
Subject: [PATCH 067/438] chore: follow-ups for #1897 connection changes
 (#1906)

---
 playwright/_impl/_browser_type.py |  6 +++---
 playwright/_impl/_connection.py   |  2 --
 playwright/_impl/_json_pipe.py    | 18 ++++++++----------
 3 files changed, 11 insertions(+), 15 deletions(-)

diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 50c1746fa..494cc2297 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -219,7 +219,7 @@ async def connect(
 
         timeout_future = throw_on_timeout(timeout, Error("Connection timed out"))
         done, pending = await asyncio.wait(
-            {playwright_future, timeout_future},
+            {transport.on_error_future, playwright_future, timeout_future},
             return_when=asyncio.FIRST_COMPLETED,
         )
         if not playwright_future.done():
@@ -235,13 +235,13 @@ async def connect(
         self._did_launch_browser(browser)
         browser._should_close_connection_on_close = True
 
-        def handle_transport_close(transport_exception: str) -> None:
+        def handle_transport_close() -> None:
             for context in browser.contexts:
                 for page in context.pages:
                     page._on_close()
                 context._on_close()
             browser._on_close()
-            connection.cleanup(transport_exception or BROWSER_CLOSED_ERROR)
+            connection.cleanup(BROWSER_CLOSED_ERROR)
 
         transport.once("close", handle_transport_close)
 
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index a0762f339..1b693ff62 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -290,8 +290,6 @@ def cleanup(self, error_message: str = None) -> None:
             ws_connection._transport.dispose()
         for callback in self._callbacks.values():
             callback.future.set_exception(Error(error_message))
-            # Prevent 'Task exception was never retrieved'
-            callback.future.exception()
         self._callbacks.clear()
         self.emit("close")
 
diff --git a/playwright/_impl/_json_pipe.py b/playwright/_impl/_json_pipe.py
index 86592841d..12d3a886f 100644
--- a/playwright/_impl/_json_pipe.py
+++ b/playwright/_impl/_json_pipe.py
@@ -13,12 +13,12 @@
 # limitations under the License.
 
 import asyncio
-from typing import Dict, Optional, cast
+from typing import Dict, cast
 
 from pyee.asyncio import AsyncIOEventEmitter
 
 from playwright._impl._connection import Channel
-from playwright._impl._helper import ParsedMessagePayload
+from playwright._impl._helper import Error, ParsedMessagePayload
 from playwright._impl._transport import Transport
 
 
@@ -48,17 +48,13 @@ async def wait_until_stopped(self) -> None:
     async def connect(self) -> None:
         self._stopped_future: asyncio.Future = asyncio.Future()
 
-        close_error: Optional[str] = None
-
         def handle_message(message: Dict) -> None:
-            try:
-                self.on_message(cast(ParsedMessagePayload, message))
-            except Exception as e:
-                nonlocal close_error
-                close_error = str(e)
+            if self._stop_requested:
+                return
+            self.on_message(cast(ParsedMessagePayload, message))
 
         def handle_closed() -> None:
-            self.emit("close", close_error)
+            self.emit("close")
             self._stopped_future.set_result(None)
 
         self._pipe_channel.on(
@@ -74,4 +70,6 @@ async def run(self) -> None:
         await self._stopped_future
 
     def send(self, message: Dict) -> None:
+        if self._stop_requested:
+            raise Error("Playwright connection closed")
         self._pipe_channel.send_no_reply("send", {"message": message})

From 9f73b8844bb83e9c159559f873c005752ad00bcf Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 11 May 2023 17:51:03 +0200
Subject: [PATCH 068/438] chore: render deprecated method parameters (#1913)

---
 playwright/async_api/_generated.py | 6 ++++++
 playwright/sync_api/_generated.py  | 6 ++++++
 scripts/documentation_provider.py  | 4 ++++
 3 files changed, 16 insertions(+)

diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index c09b1fe53..fed10692d 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -4021,6 +4021,7 @@ async def is_hidden(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `frame.is_hidden()` does not wait for the element to become hidden and returns immediately.
 
         Returns
         -------
@@ -4054,6 +4055,7 @@ async def is_visible(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `frame.is_visible()` does not wait for the element to become visible and returns immediately.
 
         Returns
         -------
@@ -8425,6 +8427,7 @@ async def is_hidden(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `page.is_hidden()` does not wait for the↵element to become hidden and returns immediately.
 
         Returns
         -------
@@ -8458,6 +8461,7 @@ async def is_visible(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `page.is_visible()` does not wait↵for the element to become visible and returns immediately.
 
         Returns
         -------
@@ -17047,6 +17051,7 @@ async def is_hidden(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `locator.is_hidden()` does not wait for the element to become hidden and returns immediately.
 
         Returns
         -------
@@ -17073,6 +17078,7 @@ async def is_visible(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `locator.is_visible()` does not wait for the element to become visible and returns immediately.
 
         Returns
         -------
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index a03ee987b..33318acd4 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -4087,6 +4087,7 @@ def is_hidden(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `frame.is_hidden()` does not wait for the element to become hidden and returns immediately.
 
         Returns
         -------
@@ -4122,6 +4123,7 @@ def is_visible(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `frame.is_visible()` does not wait for the element to become visible and returns immediately.
 
         Returns
         -------
@@ -8455,6 +8457,7 @@ def is_hidden(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `page.is_hidden()` does not wait for the↵element to become hidden and returns immediately.
 
         Returns
         -------
@@ -8490,6 +8493,7 @@ def is_visible(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `page.is_visible()` does not wait↵for the element to become visible and returns immediately.
 
         Returns
         -------
@@ -17171,6 +17175,7 @@ def is_hidden(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `locator.is_hidden()` does not wait for the element to become hidden and returns immediately.
 
         Returns
         -------
@@ -17199,6 +17204,7 @@ def is_visible(self, *, timeout: typing.Optional[float] = None) -> bool:
         Parameters
         ----------
         timeout : Union[float, None]
+            Deprecated: This option is ignored. `locator.is_visible()` does not wait for the element to become visible and returns immediately.
 
         Returns
         -------
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 5ca03551a..866e9887b 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -179,6 +179,10 @@ def print_entry(
                         print(
                             f"{indent}    {self.indent_paragraph(self.render_links(doc_value['comment']), f'{indent}    ')}"
                         )
+                    if doc_value.get("deprecated"):
+                        print(
+                            f"{indent}    Deprecated: {self.render_links(doc_value['deprecated'])}"
+                        )
                     self.compare_types(code_type, doc_value, f"{fqname}({name}=)", "in")
         if (
             signature

From 572a78a0e86f5f67d46d0dbfb8bcd3629fea7cf9 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 11 May 2023 17:52:05 +0200
Subject: [PATCH 069/438] fix: make it possible to send connect_over_cdp
 headers (#1912)

---
 playwright/_impl/_browser_type.py           |  3 +++
 tests/async/test_browsertype_connect_cdp.py | 14 +++++++++++++-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 494cc2297..51a103c76 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -44,6 +44,7 @@
     locals_to_params,
 )
 from playwright._impl._json_pipe import JsonPipeTransport
+from playwright._impl._network import serialize_headers
 from playwright._impl._wait_helper import throw_on_timeout
 
 if TYPE_CHECKING:
@@ -166,6 +167,8 @@ async def connect_over_cdp(
         headers: Dict[str, str] = None,
     ) -> Browser:
         params = locals_to_params(locals())
+        if params.get("headers"):
+            params["headers"] = serialize_headers(params["headers"])
         response = await self._channel.send_return_as_dict("connectOverCDP", params)
         browser = cast(Browser, from_channel(response["browser"]))
         self._did_launch_browser(browser)
diff --git a/tests/async/test_browsertype_connect_cdp.py b/tests/async/test_browsertype_connect_cdp.py
index ec8caeeea..0e1e94009 100644
--- a/tests/async/test_browsertype_connect_cdp.py
+++ b/tests/async/test_browsertype_connect_cdp.py
@@ -12,12 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import asyncio
 from typing import Dict
 
 import pytest
 import requests
 
-from playwright.async_api import BrowserType
+from playwright.async_api import BrowserType, Error
 from tests.server import Server, find_free_port
 
 pytestmark = pytest.mark.only_browser("chromium")
@@ -86,3 +87,14 @@ async def test_conect_over_a_ws_endpoint(
     assert len(cdp_browser2.contexts) == 1
     await cdp_browser2.close()
     await browser_server.close()
+
+
+async def test_connect_over_cdp_passing_header_works(
+    launch_arguments: Dict, browser_type: BrowserType, server: Server
+):
+    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"}
+        )
+    assert (await request).getHeader("foo") == "bar"

From 04235c05f28691c75d9e3228328a983b2f398079 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 15 May 2023 20:13:25 +0200
Subject: [PATCH 070/438] chore: bump greenlet to v2.0.2 (#1917)

---
 conda_build_config.yaml | 1 -
 meta.yaml               | 2 +-
 setup.py                | 2 +-
 3 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/conda_build_config.yaml b/conda_build_config.yaml
index 80519fa04..ab4332208 100644
--- a/conda_build_config.yaml
+++ b/conda_build_config.yaml
@@ -1,5 +1,4 @@
 python:
-  - 3.7
   - 3.8
   - 3.9
   - "3.10"
diff --git a/meta.yaml b/meta.yaml
index de7cc29d9..7fcb47cbb 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -23,7 +23,7 @@ requirements:
     - setuptools_scm
   run:
     - python
-    - greenlet ==2.0.1
+    - greenlet ==2.0.2
     - pyee ==9.0.4
     - typing_extensions # [py<39]
 test:
diff --git a/setup.py b/setup.py
index b2ab3b9b7..88d020a46 100644
--- a/setup.py
+++ b/setup.py
@@ -212,7 +212,7 @@ def _download_and_extract_local_driver(
     packages=["playwright"],
     include_package_data=True,
     install_requires=[
-        "greenlet==2.0.1",
+        "greenlet==2.0.2",
         "pyee==9.0.4",
         "typing-extensions;python_version<='3.8'",
     ],

From 4394ede6ca013eab1dbf40becdc138753a814e58 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 16 May 2023 18:28:04 +0200
Subject: [PATCH 071/438] chore: don't have Playwright globally installed in
 Docker image (#1921)

---
 utils/docker/Dockerfile.focal | 3 +++
 utils/docker/Dockerfile.jammy | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/utils/docker/Dockerfile.focal b/utils/docker/Dockerfile.focal
index d6fd57b25..247b58b49 100644
--- a/utils/docker/Dockerfile.focal
+++ b/utils/docker/Dockerfile.focal
@@ -35,6 +35,9 @@ COPY ./dist/*-manylinux*.whl /tmp/
 RUN mkdir /ms-playwright && \
     mkdir /ms-playwright-agent && \
     cd /ms-playwright-agent && \
+    pip install virtualenv && \
+    virtualenv venv && \
+    . venv/bin/activate && \
     # if its amd64 then install the manylinux1_x86_64 pip package
     if [ "$(uname -m)" = "x86_64" ]; then pip install /tmp/*manylinux1_x86_64*.whl; fi && \
     # if its arm64 then install the manylinux1_aarch64 pip package
diff --git a/utils/docker/Dockerfile.jammy b/utils/docker/Dockerfile.jammy
index 0e17daf4b..8e6498381 100644
--- a/utils/docker/Dockerfile.jammy
+++ b/utils/docker/Dockerfile.jammy
@@ -35,6 +35,9 @@ COPY ./dist/*-manylinux*.whl /tmp/
 RUN mkdir /ms-playwright && \
     mkdir /ms-playwright-agent && \
     cd /ms-playwright-agent && \
+    pip install virtualenv && \
+    virtualenv venv && \
+    . venv/bin/activate && \
     # if its amd64 then install the manylinux1_x86_64 pip package
     if [ "$(uname -m)" = "x86_64" ]; then pip install /tmp/*manylinux1_x86_64*.whl; fi && \
     # if its arm64 then install the manylinux1_aarch64 pip package

From 177855e303dbfd61c83898c4714ad005930c2e9c Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 17 May 2023 01:26:05 +0200
Subject: [PATCH 072/438] chore: add ability to set expect timeout (#1918)

---
 playwright/_impl/_assertions.py  | 40 ++++++++++++-----
 playwright/async_api/__init__.py | 73 +++++++++++++++++++-------------
 playwright/sync_api/__init__.py  | 73 +++++++++++++++++++-------------
 tests/async/test_assertions.py   | 18 ++++++++
 tests/sync/test_assertions.py    | 18 ++++++++
 5 files changed, 154 insertions(+), 68 deletions(-)

diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index aa3648769..46e54a9f3 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -25,11 +25,16 @@
 
 class AssertionsBase:
     def __init__(
-        self, locator: Locator, is_not: bool = False, message: Optional[str] = None
+        self,
+        locator: Locator,
+        timeout: float = None,
+        is_not: bool = False,
+        message: Optional[str] = None,
     ) -> None:
         self._actual_locator = locator
         self._loop = locator._loop
         self._dispatcher_fiber = locator._dispatcher_fiber
+        self._timeout = timeout
         self._is_not = is_not
         self._custom_message = message
 
@@ -43,7 +48,7 @@ async def _expect_impl(
         __tracebackhide__ = True
         expect_options["isNot"] = self._is_not
         if expect_options.get("timeout") is None:
-            expect_options["timeout"] = 5_000
+            expect_options["timeout"] = self._timeout or 5_000
         if expect_options["isNot"]:
             message = message.replace("expected to", "expected not to")
         if "useInnerText" in expect_options and expect_options["useInnerText"] is None:
@@ -67,14 +72,20 @@ async def _expect_impl(
 
 class PageAssertions(AssertionsBase):
     def __init__(
-        self, page: Page, is_not: bool = False, message: Optional[str] = None
+        self,
+        page: Page,
+        timeout: float = None,
+        is_not: bool = False,
+        message: Optional[str] = None,
     ) -> None:
-        super().__init__(page.locator(":root"), is_not, message)
+        super().__init__(page.locator(":root"), timeout, is_not, message)
         self._actual_page = page
 
     @property
     def _not(self) -> "PageAssertions":
-        return PageAssertions(self._actual_page, not self._is_not, self._custom_message)
+        return PageAssertions(
+            self._actual_page, self._timeout, not self._is_not, self._custom_message
+        )
 
     async def to_have_title(
         self, title_or_reg_exp: Union[Pattern[str], str], timeout: float = None
@@ -120,15 +131,19 @@ async def not_to_have_url(
 
 class LocatorAssertions(AssertionsBase):
     def __init__(
-        self, locator: Locator, is_not: bool = False, message: Optional[str] = None
+        self,
+        locator: Locator,
+        timeout: float = None,
+        is_not: bool = False,
+        message: Optional[str] = None,
     ) -> None:
-        super().__init__(locator, is_not, message)
+        super().__init__(locator, timeout, is_not, message)
         self._actual_locator = locator
 
     @property
     def _not(self) -> "LocatorAssertions":
         return LocatorAssertions(
-            self._actual_locator, not self._is_not, self._custom_message
+            self._actual_locator, self._timeout, not self._is_not, self._custom_message
         )
 
     async def to_contain_text(
@@ -676,10 +691,15 @@ async def not_to_be_in_viewport(
 
 class APIResponseAssertions:
     def __init__(
-        self, response: APIResponse, is_not: bool = False, message: Optional[str] = None
+        self,
+        response: APIResponse,
+        timeout: float = None,
+        is_not: bool = False,
+        message: Optional[str] = None,
     ) -> None:
         self._loop = response._loop
         self._dispatcher_fiber = response._dispatcher_fiber
+        self._timeout = timeout
         self._is_not = is_not
         self._actual = response
         self._custom_message = message
@@ -687,7 +707,7 @@ def __init__(
     @property
     def _not(self) -> "APIResponseAssertions":
         return APIResponseAssertions(
-            self._actual, not self._is_not, self._custom_message
+            self._actual, self._timeout, not self._is_not, self._custom_message
         )
 
     async def to_be_ok(
diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index 59e972c6d..d01d3b616 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.py
@@ -87,35 +87,50 @@ def async_playwright() -> PlaywrightContextManager:
     return PlaywrightContextManager()
 
 
-@overload
-def expect(actual: Page, message: Optional[str] = None) -> PageAssertions:
-    ...
-
-
-@overload
-def expect(actual: Locator, message: Optional[str] = None) -> LocatorAssertions:
-    ...
-
-
-@overload
-def expect(actual: APIResponse, message: Optional[str] = None) -> APIResponseAssertions:
-    ...
-
-
-def expect(
-    actual: Union[Page, Locator, APIResponse], message: Optional[str] = None
-) -> Union[PageAssertions, LocatorAssertions, APIResponseAssertions]:
-    if isinstance(actual, Page):
-        return PageAssertions(PageAssertionsImpl(actual._impl_obj, message=message))
-    elif isinstance(actual, Locator):
-        return LocatorAssertions(
-            LocatorAssertionsImpl(actual._impl_obj, message=message)
-        )
-    elif isinstance(actual, APIResponse):
-        return APIResponseAssertions(
-            APIResponseAssertionsImpl(actual._impl_obj, message=message)
-        )
-    raise ValueError(f"Unsupported type: {type(actual)}")
+class Expect:
+    def __init__(self) -> None:
+        self._timeout: Optional[float] = None
+
+    def set_timeout(self, timeout: float) -> None:
+        self._timeout = timeout
+
+    @overload
+    def __call__(self, actual: Page, message: Optional[str] = None) -> PageAssertions:
+        ...
+
+    @overload
+    def __call__(
+        self, actual: Locator, message: Optional[str] = None
+    ) -> LocatorAssertions:
+        ...
+
+    @overload
+    def __call__(
+        self, actual: APIResponse, message: Optional[str] = None
+    ) -> APIResponseAssertions:
+        ...
+
+    def __call__(
+        self, actual: Union[Page, Locator, APIResponse], message: Optional[str] = None
+    ) -> Union[PageAssertions, LocatorAssertions, APIResponseAssertions]:
+        if isinstance(actual, Page):
+            return PageAssertions(
+                PageAssertionsImpl(actual._impl_obj, self._timeout, message=message)
+            )
+        elif isinstance(actual, Locator):
+            return LocatorAssertions(
+                LocatorAssertionsImpl(actual._impl_obj, self._timeout, message=message)
+            )
+        elif isinstance(actual, APIResponse):
+            return APIResponseAssertions(
+                APIResponseAssertionsImpl(
+                    actual._impl_obj, self._timeout, message=message
+                )
+            )
+        raise ValueError(f"Unsupported type: {type(actual)}")
+
+
+expect = Expect()
 
 
 __all__ = [
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index cf624b040..3de47b2a7 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -87,35 +87,50 @@ def sync_playwright() -> PlaywrightContextManager:
     return PlaywrightContextManager()
 
 
-@overload
-def expect(actual: Page, message: Optional[str] = None) -> PageAssertions:
-    ...
-
-
-@overload
-def expect(actual: Locator, message: Optional[str] = None) -> LocatorAssertions:
-    ...
-
-
-@overload
-def expect(actual: APIResponse, message: Optional[str] = None) -> APIResponseAssertions:
-    ...
-
-
-def expect(
-    actual: Union[Page, Locator, APIResponse], message: Optional[str] = None
-) -> Union[PageAssertions, LocatorAssertions, APIResponseAssertions]:
-    if isinstance(actual, Page):
-        return PageAssertions(PageAssertionsImpl(actual._impl_obj, message=message))
-    elif isinstance(actual, Locator):
-        return LocatorAssertions(
-            LocatorAssertionsImpl(actual._impl_obj, message=message)
-        )
-    elif isinstance(actual, APIResponse):
-        return APIResponseAssertions(
-            APIResponseAssertionsImpl(actual._impl_obj, message=message)
-        )
-    raise ValueError(f"Unsupported type: {type(actual)}")
+class Expect:
+    def __init__(self) -> None:
+        self._timeout: Optional[float] = None
+
+    def set_timeout(self, timeout: float) -> None:
+        self._timeout = timeout
+
+    @overload
+    def __call__(self, actual: Page, message: Optional[str] = None) -> PageAssertions:
+        ...
+
+    @overload
+    def __call__(
+        self, actual: Locator, message: Optional[str] = None
+    ) -> LocatorAssertions:
+        ...
+
+    @overload
+    def __call__(
+        self, actual: APIResponse, message: Optional[str] = None
+    ) -> APIResponseAssertions:
+        ...
+
+    def __call__(
+        self, actual: Union[Page, Locator, APIResponse], message: Optional[str] = None
+    ) -> Union[PageAssertions, LocatorAssertions, APIResponseAssertions]:
+        if isinstance(actual, Page):
+            return PageAssertions(
+                PageAssertionsImpl(actual._impl_obj, self._timeout, message=message)
+            )
+        elif isinstance(actual, Locator):
+            return LocatorAssertions(
+                LocatorAssertionsImpl(actual._impl_obj, self._timeout, message=message)
+            )
+        elif isinstance(actual, APIResponse):
+            return APIResponseAssertions(
+                APIResponseAssertionsImpl(
+                    actual._impl_obj, self._timeout, message=message
+                )
+            )
+        raise ValueError(f"Unsupported type: {type(actual)}")
+
+
+expect = Expect()
 
 
 __all__ = [
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 3014610fd..f0d6583d9 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -790,3 +790,21 @@ async def test_should_be_attached_over_navigation(page: Page, server: Server) ->
     await page.goto(server.PREFIX + "/input/checkbox.html")
     await task
     assert task.done()
+
+
+async def test_should_be_able_to_set_custom_timeout(page: Page) -> None:
+    with pytest.raises(AssertionError) as exc_info:
+        await expect(page.locator("#a1")).to_be_visible(timeout=111)
+    assert "LocatorAssertions.to_be_visible with timeout 111ms" in str(exc_info.value)
+
+
+async def test_should_be_able_to_set_custom_global_timeout(page: Page) -> None:
+    try:
+        expect.set_timeout(111)
+        with pytest.raises(AssertionError) as exc_info:
+            await expect(page.locator("#a1")).to_be_visible()
+        assert "LocatorAssertions.to_be_visible with timeout 111ms" in str(
+            exc_info.value
+        )
+    finally:
+        expect.set_timeout(None)
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index d9cc3b43e..1d5c09b55 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -852,3 +852,21 @@ def test_should_be_attached_with_impossible_timeout(page: Page) -> None:
 def test_should_be_attached_with_impossible_timeout_not(page: Page) -> None:
     page.set_content("<div id=node>Text content</div>")
     expect(page.locator("no-such-thing")).not_to_be_attached(timeout=1)
+
+
+def test_should_be_able_to_set_custom_timeout(page: Page) -> None:
+    with pytest.raises(AssertionError) as exc_info:
+        expect(page.locator("#a1")).to_be_visible(timeout=111)
+    assert "LocatorAssertions.to_be_visible with timeout 111ms" in str(exc_info.value)
+
+
+def test_should_be_able_to_set_custom_global_timeout(page: Page) -> None:
+    try:
+        expect.set_timeout(111)
+        with pytest.raises(AssertionError) as exc_info:
+            expect(page.locator("#a1")).to_be_visible()
+        assert "LocatorAssertions.to_be_visible with timeout 111ms" in str(
+            exc_info.value
+        )
+    finally:
+        expect.set_timeout(5_000)

From a45cb4c1b1b07137834891b559e386a8d62cdde8 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 17 May 2023 18:28:06 +0200
Subject: [PATCH 073/438] chore(roll): roll Playwright to
 1.34.0-alpha-may-17-2023 (#1924)

---
 README.md                                 |   2 +-
 playwright/_impl/_browser.py              |  14 +-
 playwright/_impl/_browser_context.py      |  35 ++++
 playwright/_impl/_connection.py           |   7 +-
 playwright/_impl/_console_message.py      |  19 +-
 playwright/_impl/_dialog.py               |  12 +-
 playwright/_impl/_locator.py              |   8 +
 playwright/_impl/_page.py                 |  20 +--
 playwright/async_api/_generated.py        | 210 ++++++++++++++++++++--
 playwright/sync_api/_generated.py         | 198 ++++++++++++++++++--
 setup.py                                  |   2 +-
 tests/async/test_accessibility.py         |  10 +-
 tests/async/test_browsercontext_events.py | 182 +++++++++++++++++++
 tests/async/test_locators.py              |  25 +++
 tests/async/test_popup.py                 |  19 +-
 tests/async/test_selectors_misc.py        |  54 ++++++
 tests/sync/test_accessibility.py          |  10 +-
 17 files changed, 750 insertions(+), 77 deletions(-)
 create mode 100644 tests/async/test_browsercontext_events.py
 create mode 100644 tests/async/test_selectors_misc.py

diff --git a/README.md b/README.md
index 224349861..081734543 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 |   :---   | :---: | :---: | :---:   |
 | Chromium <!-- GEN:chromium-version -->113.0.5672.53<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->112.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->113.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index 4266098cc..2c499d5b1 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -167,11 +167,15 @@ async def new_page(
         recordHarContent: HarContentPolicy = None,
     ) -> Page:
         params = locals_to_params(locals())
-        context = await self.new_context(**params)
-        page = await context.new_page()
-        page._owned_context = context
-        context._owner_page = page
-        return page
+
+        async def inner() -> Page:
+            context = await self.new_context(**params)
+            page = await context.new_page()
+            page._owned_context = context
+            context._owner_page = page
+            return page
+
+        return await self._connection.wrap_api_call(inner)
 
     async def close(self) -> None:
         if self._is_closed_or_closing:
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index f2787f862..5678441b4 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -44,6 +44,8 @@
     from_channel,
     from_nullable_channel,
 )
+from playwright._impl._console_message import ConsoleMessage
+from playwright._impl._dialog import Dialog
 from playwright._impl._event_context_manager import EventContextManagerImpl
 from playwright._impl._fetch import APIRequestContext
 from playwright._impl._frame import Frame
@@ -82,6 +84,8 @@ class BrowserContext(ChannelOwner):
     Events = SimpleNamespace(
         BackgroundPage="backgroundpage",
         Close="close",
+        Console="console",
+        Dialog="dialog",
         Page="page",
         ServiceWorker="serviceworker",
         Request="request",
@@ -136,6 +140,14 @@ def __init__(
             "serviceWorker",
             lambda params: self._on_service_worker(from_channel(params["worker"])),
         )
+        self._channel.on(
+            "console",
+            lambda params: self._on_console_message(from_channel(params["message"])),
+        )
+
+        self._channel.on(
+            "dialog", lambda params: self._on_dialog(from_channel(params["dialog"]))
+        )
         self._channel.on(
             "request",
             lambda params: self._on_request(
@@ -174,6 +186,8 @@ def __init__(
         )
         self._set_event_to_subscription_mapping(
             {
+                BrowserContext.Events.Console: "console",
+                BrowserContext.Events.Dialog: "dialog",
                 BrowserContext.Events.Request: "request",
                 BrowserContext.Events.Response: "response",
                 BrowserContext.Events.RequestFinished: "requestFinished",
@@ -507,6 +521,27 @@ def _on_request_finished(
         if response:
             response._finished_future.set_result(True)
 
+    def _on_console_message(self, message: ConsoleMessage) -> None:
+        self.emit(BrowserContext.Events.Console, message)
+        page = message.page
+        if page:
+            page.emit(Page.Events.Console, message)
+
+    def _on_dialog(self, dialog: Dialog) -> None:
+        has_listeners = self.emit(BrowserContext.Events.Dialog, dialog)
+        page = dialog.page
+        if page:
+            has_listeners = page.emit(Page.Events.Dialog, dialog) or has_listeners
+        if not has_listeners:
+            # Although we do similar handling on the server side, we still need this logic
+            # on the client side due to a possible race condition between two async calls:
+            # a) removing "dialog" listener subscription (client->server)
+            # b) actual "dialog" event (server->client)
+            if dialog.type == "beforeunload":
+                asyncio.create_task(dialog.accept())
+            else:
+                asyncio.create_task(dialog.dismiss())
+
     def _on_request(self, request: Request, page: Optional[Page]) -> None:
         self.emit(BrowserContext.Events.Request, request)
         if page:
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 1b693ff62..5f906c47e 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -161,8 +161,11 @@ def _set_event_to_subscription_mapping(self, mapping: Dict[str, str]) -> None:
     def _update_subscription(self, event: str, enabled: bool) -> None:
         protocol_event = self._event_to_subscription_mapping.get(event)
         if protocol_event:
-            self._channel.send_no_reply(
-                "updateSubscription", {"event": protocol_event, "enabled": enabled}
+            self._connection.wrap_api_call_sync(
+                lambda: self._channel.send_no_reply(
+                    "updateSubscription", {"event": protocol_event, "enabled": enabled}
+                ),
+                True,
             )
 
     def _add_event_handler(self, event: str, k: Any, v: Any) -> None:
diff --git a/playwright/_impl/_console_message.py b/playwright/_impl/_console_message.py
index dd19b40ce..9bed32ac8 100644
--- a/playwright/_impl/_console_message.py
+++ b/playwright/_impl/_console_message.py
@@ -12,18 +12,29 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from typing import Dict, List
+from typing import TYPE_CHECKING, Dict, List, Optional
 
 from playwright._impl._api_structures import SourceLocation
-from playwright._impl._connection import ChannelOwner, from_channel
+from playwright._impl._connection import (
+    ChannelOwner,
+    from_channel,
+    from_nullable_channel,
+)
 from playwright._impl._js_handle import JSHandle
 
+if TYPE_CHECKING:  # pragma: no cover
+    from playwright._impl._page import Page
+
 
 class ConsoleMessage(ChannelOwner):
     def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        # Note: currently, we only report console messages for pages and they always have a page.
+        # However, in the future we might report console messages for service workers or something else,
+        # where page() would be null.
+        self._page: Optional["Page"] = from_nullable_channel(initializer.get("page"))
 
     def __repr__(self) -> str:
         return f"<ConsoleMessage type={self.type} text={self.text}>"
@@ -46,3 +57,7 @@ def args(self) -> List[JSHandle]:
     @property
     def location(self) -> SourceLocation:
         return self._initializer["location"]
+
+    @property
+    def page(self) -> Optional["Page"]:
+        return self._page
diff --git a/playwright/_impl/_dialog.py b/playwright/_impl/_dialog.py
index 585cfde75..a0c6ca77f 100644
--- a/playwright/_impl/_dialog.py
+++ b/playwright/_impl/_dialog.py
@@ -12,17 +12,21 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from typing import Dict
+from typing import TYPE_CHECKING, Dict, Optional
 
-from playwright._impl._connection import ChannelOwner
+from playwright._impl._connection import ChannelOwner, from_nullable_channel
 from playwright._impl._helper import locals_to_params
 
+if TYPE_CHECKING:  # pragma: no cover
+    from playwright._impl._page import Page
+
 
 class Dialog(ChannelOwner):
     def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        self._page: Optional["Page"] = from_nullable_channel(initializer.get("page"))
 
     def __repr__(self) -> str:
         return f"<Dialog type={self.type} message={self.message} default_value={self.default_value}>"
@@ -39,6 +43,10 @@ def message(self) -> str:
     def default_value(self) -> str:
         return self._initializer["defaultValue"]
 
+    @property
+    def page(self) -> Optional["Page"]:
+        return self._page
+
     async def accept(self, promptText: str = None) -> None:
         await self._channel.send("accept", locals_to_params(locals()))
 
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index f5df9ca6b..416b09214 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -356,6 +356,14 @@ def or_(self, locator: "Locator") -> "Locator":
             self._selector + " >> internal:or=" + json.dumps(locator._selector),
         )
 
+    def and_(self, locator: "Locator") -> "Locator":
+        if locator._frame != self._frame:
+            raise Error("Locators must belong to the same frame.")
+        return Locator(
+            self._frame,
+            self._selector + " >> internal:and=" + json.dumps(locator._selector),
+        )
+
     async def focus(self, timeout: float = None) -> None:
         params = locals_to_params(locals())
         return await self._frame.focus(self._selector, strict=True, **params)
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 2414df934..75dd3b2e0 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -48,7 +48,6 @@
     from_nullable_channel,
 )
 from playwright._impl._console_message import ConsoleMessage
-from playwright._impl._dialog import Dialog
 from playwright._impl._download import Download
 from playwright._impl._element_handle import ElementHandle
 from playwright._impl._event_context_manager import EventContextManagerImpl
@@ -159,14 +158,7 @@ def __init__(
             lambda params: self._on_binding(from_channel(params["binding"])),
         )
         self._channel.on("close", lambda _: self._on_close())
-        self._channel.on(
-            "console",
-            lambda params: self.emit(
-                Page.Events.Console, from_channel(params["message"])
-            ),
-        )
         self._channel.on("crash", lambda _: self._on_crash())
-        self._channel.on("dialog", lambda params: self._on_dialog(params))
         self._channel.on("download", lambda params: self._on_download(params))
         self._channel.on(
             "fileChooser",
@@ -223,6 +215,8 @@ def __init__(
 
         self._set_event_to_subscription_mapping(
             {
+                Page.Events.Console: "console",
+                Page.Events.Dialog: "dialog",
                 Page.Events.Request: "request",
                 Page.Events.Response: "response",
                 Page.Events.RequestFinished: "requestFinished",
@@ -286,16 +280,6 @@ def _on_close(self) -> None:
     def _on_crash(self) -> None:
         self.emit(Page.Events.Crash, self)
 
-    def _on_dialog(self, params: Any) -> None:
-        dialog = cast(Dialog, from_channel(params["dialog"]))
-        if self.listeners(Page.Events.Dialog):
-            self.emit(Page.Events.Dialog, dialog)
-        else:
-            if dialog.type == "beforeunload":
-                asyncio.create_task(dialog.accept())
-            else:
-                asyncio.create_task(dialog.dismiss())
-
     def _on_download(self, params: Any) -> None:
         url = params["url"]
         suggested_filename = params["suggestedFilename"]
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index fed10692d..7ff612aec 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -848,7 +848,7 @@ async def fallback(
 
         ```py
         # Handle GET requests.
-        def handle_post(route):
+        def handle_get(route):
             if route.request.method != \"GET\":
                 route.fallback()
                 return
@@ -869,7 +869,7 @@ def handle_post(route):
 
         ```py
         # Handle GET requests.
-        def handle_post(route):
+        def handle_get(route):
             if route.request.method != \"GET\":
                 route.fallback()
                 return
@@ -7091,6 +7091,18 @@ def location(self) -> SourceLocation:
         """
         return mapping.from_impl(self._impl_obj.location)
 
+    @property
+    def page(self) -> typing.Optional["Page"]:
+        """ConsoleMessage.page
+
+        The page that produced this console message, if any.
+
+        Returns
+        -------
+        Union[Page, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.page)
+
 
 mapping.register(ConsoleMessageImpl, ConsoleMessage)
 
@@ -7132,6 +7144,18 @@ def default_value(self) -> str:
         """
         return mapping.from_maybe_impl(self._impl_obj.default_value)
 
+    @property
+    def page(self) -> typing.Optional["Page"]:
+        """Dialog.page
+
+        The page that initiated this dialog, if available.
+
+        Returns
+        -------
+        Union[Page, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.page)
+
     async def accept(self, prompt_text: typing.Optional[str] = None) -> None:
         """Dialog.accept
 
@@ -7324,9 +7348,9 @@ def on(
         Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
         emitted if the page throws an error or a warning.
 
-        The arguments passed into `console.log` appear as arguments on the event handler.
+        The arguments passed into `console.log` are available on the `ConsoleMessage` event handler argument.
 
-        An example of handling `console` event:
+        **Usage**
 
         ```py
         async def print_args(msg):
@@ -7336,7 +7360,7 @@ async def print_args(msg):
             print(values)
 
         page.on(\"console\", print_args)
-        await page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```
 
         ```py
@@ -7345,7 +7369,7 @@ def print_args(msg):
                 print(arg.json_value())
 
         page.on(\"console\", print_args)
-        page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```"""
 
     @typing.overload
@@ -7392,12 +7416,14 @@ def on(
         [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
         and actions like click will never finish.
 
+        **Usage**
+
         ```python
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed.
-        """
+        **NOTE** When no `page.on('dialog')` or `browser_context.on('dialog')` listeners are present, all dialogs are
+        automatically dismissed."""
 
     @typing.overload
     def on(
@@ -7624,9 +7650,9 @@ def once(
         Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
         emitted if the page throws an error or a warning.
 
-        The arguments passed into `console.log` appear as arguments on the event handler.
+        The arguments passed into `console.log` are available on the `ConsoleMessage` event handler argument.
 
-        An example of handling `console` event:
+        **Usage**
 
         ```py
         async def print_args(msg):
@@ -7636,7 +7662,7 @@ async def print_args(msg):
             print(values)
 
         page.on(\"console\", print_args)
-        await page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```
 
         ```py
@@ -7645,7 +7671,7 @@ def print_args(msg):
                 print(arg.json_value())
 
         page.on(\"console\", print_args)
-        page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```"""
 
     @typing.overload
@@ -7692,12 +7718,14 @@ def once(
         [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
         and actions like click will never finish.
 
+        **Usage**
+
         ```python
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed.
-        """
+        **NOTE** When no `page.on('dialog')` or `browser_context.on('dialog')` listeners are present, all dialogs are
+        automatically dismissed."""
 
     @typing.overload
     def once(
@@ -9897,7 +9925,7 @@ async def screenshot(
             When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Defaults to
             `false`.
         clip : Union[{x: float, y: float, width: float, height: float}, None]
-            An object which specifies clipping of the resulting image. Should have the following fields:
+            An object which specifies clipping of the resulting image.
         animations : Union["allow", "disabled", None]
             When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different
             treatment depending on their duration:
@@ -12485,6 +12513,63 @@ def on(
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
 
+    @typing.overload
+    def on(
+        self,
+        event: Literal["console"],
+        f: typing.Callable[
+            ["ConsoleMessage"], "typing.Union[typing.Awaitable[None], None]"
+        ],
+    ) -> None:
+        """
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
+        emitted if the page throws an error or a warning.
+
+        The arguments passed into `console.log` and the page are available on the `ConsoleMessage` event handler argument.
+
+        **Usage**
+
+        ```py
+        async def print_args(msg):
+            values = []
+            for arg in msg.args:
+                values.append(await arg.json_value())
+            print(values)
+
+        context.on(\"console\", print_args)
+        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
+        ```
+
+        ```py
+        def print_args(msg):
+            for arg in msg.args:
+                print(arg.json_value())
+
+        context.on(\"console\", print_args)
+        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
+        ```"""
+
+    @typing.overload
+    def on(
+        self,
+        event: Literal["dialog"],
+        f: typing.Callable[["Dialog"], "typing.Union[typing.Awaitable[None], None]"],
+    ) -> None:
+        """
+        Emitted when a JavaScript dialog appears, such as `alert`, `prompt`, `confirm` or `beforeunload`. Listener **must**
+        either `dialog.accept()` or `dialog.dismiss()` the dialog - otherwise the page will
+        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
+        and actions like click will never finish.
+
+        **Usage**
+
+        ```python
+        context.on(\"dialog\", lambda dialog: dialog.accept())
+        ```
+
+        **NOTE** When no `page.on('dialog')` or `browser_context.on('dialog')` listeners are present, all dialogs are
+        automatically dismissed."""
+
     @typing.overload
     def on(
         self,
@@ -12617,6 +12702,63 @@ def once(
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
 
+    @typing.overload
+    def once(
+        self,
+        event: Literal["console"],
+        f: typing.Callable[
+            ["ConsoleMessage"], "typing.Union[typing.Awaitable[None], None]"
+        ],
+    ) -> None:
+        """
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
+        emitted if the page throws an error or a warning.
+
+        The arguments passed into `console.log` and the page are available on the `ConsoleMessage` event handler argument.
+
+        **Usage**
+
+        ```py
+        async def print_args(msg):
+            values = []
+            for arg in msg.args:
+                values.append(await arg.json_value())
+            print(values)
+
+        context.on(\"console\", print_args)
+        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
+        ```
+
+        ```py
+        def print_args(msg):
+            for arg in msg.args:
+                print(arg.json_value())
+
+        context.on(\"console\", print_args)
+        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
+        ```"""
+
+    @typing.overload
+    def once(
+        self,
+        event: Literal["dialog"],
+        f: typing.Callable[["Dialog"], "typing.Union[typing.Awaitable[None], None]"],
+    ) -> None:
+        """
+        Emitted when a JavaScript dialog appears, such as `alert`, `prompt`, `confirm` or `beforeunload`. Listener **must**
+        either `dialog.accept()` or `dialog.dismiss()` the dialog - otherwise the page will
+        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
+        and actions like click will never finish.
+
+        **Usage**
+
+        ```python
+        context.on(\"dialog\", lambda dialog: dialog.accept())
+        ```
+
+        **NOTE** When no `page.on('dialog')` or `browser_context.on('dialog')` listeners are present, all dialogs are
+        automatically dismissed."""
+
     @typing.overload
     def once(
         self,
@@ -12886,6 +13028,9 @@ async def add_cookies(self, cookies: typing.List[SetCookieParam]) -> None:
         Parameters
         ----------
         cookies : List[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
+            Adds cookies to the browser context.
+
+            For the cookie to apply to all subdomains as well, prefix domain with a dot, like this: ".example.com".
         """
 
         return mapping.from_maybe_impl(
@@ -13938,8 +14083,7 @@ async def new_context(
             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()`. Either a path to the file with saved storage, or
-            an object with the following fields:
+            information obtained via `browser_context.storage_state()`.
         base_url : Union[str, None]
             When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
             `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
@@ -14153,8 +14297,7 @@ async def new_page(
             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()`. Either a path to the file with saved storage, or
-            an object with the following fields:
+            information obtained via `browser_context.storage_state()`.
         base_url : Union[str, None]
             When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
             `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
@@ -16585,6 +16728,35 @@ def or_(self, locator: "Locator") -> "Locator":
 
         return mapping.from_impl(self._impl_obj.or_(locator=locator._impl_obj))
 
+    def and_(self, locator: "Locator") -> "Locator":
+        """Locator.and_
+
+        Creates a locator that matches both this locator and the argument locator.
+
+        **Usage**
+
+        The following example finds a button with a specific title.
+
+        ```py
+        button = page.get_by_role(\"button\").and_(page.getByTitle(\"Subscribe\"))
+        ```
+
+        ```py
+        button = page.get_by_role(\"button\").and_(page.getByTitle(\"Subscribe\"))
+        ```
+
+        Parameters
+        ----------
+        locator : Locator
+            Additional locator to match.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.and_(locator=locator._impl_obj))
+
     async def focus(self, *, timeout: typing.Optional[float] = None) -> None:
         """Locator.focus
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 33318acd4..7be26802b 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -860,7 +860,7 @@ def fallback(
 
         ```py
         # Handle GET requests.
-        def handle_post(route):
+        def handle_get(route):
             if route.request.method != \"GET\":
                 route.fallback()
                 return
@@ -881,7 +881,7 @@ def handle_post(route):
 
         ```py
         # Handle GET requests.
-        def handle_post(route):
+        def handle_get(route):
             if route.request.method != \"GET\":
                 route.fallback()
                 return
@@ -7211,6 +7211,18 @@ def location(self) -> SourceLocation:
         """
         return mapping.from_impl(self._impl_obj.location)
 
+    @property
+    def page(self) -> typing.Optional["Page"]:
+        """ConsoleMessage.page
+
+        The page that produced this console message, if any.
+
+        Returns
+        -------
+        Union[Page, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.page)
+
 
 mapping.register(ConsoleMessageImpl, ConsoleMessage)
 
@@ -7252,6 +7264,18 @@ def default_value(self) -> str:
         """
         return mapping.from_maybe_impl(self._impl_obj.default_value)
 
+    @property
+    def page(self) -> typing.Optional["Page"]:
+        """Dialog.page
+
+        The page that initiated this dialog, if available.
+
+        Returns
+        -------
+        Union[Page, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.page)
+
     def accept(self, prompt_text: typing.Optional[str] = None) -> None:
         """Dialog.accept
 
@@ -7436,9 +7460,9 @@ def on(
         Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
         emitted if the page throws an error or a warning.
 
-        The arguments passed into `console.log` appear as arguments on the event handler.
+        The arguments passed into `console.log` are available on the `ConsoleMessage` event handler argument.
 
-        An example of handling `console` event:
+        **Usage**
 
         ```py
         async def print_args(msg):
@@ -7448,7 +7472,7 @@ async def print_args(msg):
             print(values)
 
         page.on(\"console\", print_args)
-        await page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```
 
         ```py
@@ -7457,7 +7481,7 @@ def print_args(msg):
                 print(arg.json_value())
 
         page.on(\"console\", print_args)
-        page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```"""
 
     @typing.overload
@@ -7498,12 +7522,14 @@ def on(
         [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
         and actions like click will never finish.
 
+        **Usage**
+
         ```python
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed.
-        """
+        **NOTE** When no `page.on('dialog')` or `browser_context.on('dialog')` listeners are present, all dialogs are
+        automatically dismissed."""
 
     @typing.overload
     def on(
@@ -7684,9 +7710,9 @@ def once(
         Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
         emitted if the page throws an error or a warning.
 
-        The arguments passed into `console.log` appear as arguments on the event handler.
+        The arguments passed into `console.log` are available on the `ConsoleMessage` event handler argument.
 
-        An example of handling `console` event:
+        **Usage**
 
         ```py
         async def print_args(msg):
@@ -7696,7 +7722,7 @@ async def print_args(msg):
             print(values)
 
         page.on(\"console\", print_args)
-        await page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```
 
         ```py
@@ -7705,7 +7731,7 @@ def print_args(msg):
                 print(arg.json_value())
 
         page.on(\"console\", print_args)
-        page.evaluate(\"console.log('hello', 5, {foo: 'bar'})\")
+        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```"""
 
     @typing.overload
@@ -7748,12 +7774,14 @@ def once(
         [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
         and actions like click will never finish.
 
+        **Usage**
+
         ```python
         page.on(\"dialog\", lambda dialog: dialog.accept())
         ```
 
-        **NOTE** When no `page.on('dialog')` listeners are present, all dialogs are automatically dismissed.
-        """
+        **NOTE** When no `page.on('dialog')` or `browser_context.on('dialog')` listeners are present, all dialogs are
+        automatically dismissed."""
 
     @typing.overload
     def once(
@@ -9965,7 +9993,7 @@ def screenshot(
             When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Defaults to
             `false`.
         clip : Union[{x: float, y: float, width: float, height: float}, None]
-            An object which specifies clipping of the resulting image. Should have the following fields:
+            An object which specifies clipping of the resulting image.
         animations : Union["allow", "disabled", None]
             When set to `"disabled"`, stops CSS animations, CSS transitions and Web Animations. Animations get different
             treatment depending on their duration:
@@ -12589,6 +12617,57 @@ def on(
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
 
+    @typing.overload
+    def on(
+        self, event: Literal["console"], f: typing.Callable[["ConsoleMessage"], "None"]
+    ) -> None:
+        """
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
+        emitted if the page throws an error or a warning.
+
+        The arguments passed into `console.log` and the page are available on the `ConsoleMessage` event handler argument.
+
+        **Usage**
+
+        ```py
+        async def print_args(msg):
+            values = []
+            for arg in msg.args:
+                values.append(await arg.json_value())
+            print(values)
+
+        context.on(\"console\", print_args)
+        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
+        ```
+
+        ```py
+        def print_args(msg):
+            for arg in msg.args:
+                print(arg.json_value())
+
+        context.on(\"console\", print_args)
+        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
+        ```"""
+
+    @typing.overload
+    def on(
+        self, event: Literal["dialog"], f: typing.Callable[["Dialog"], "None"]
+    ) -> None:
+        """
+        Emitted when a JavaScript dialog appears, such as `alert`, `prompt`, `confirm` or `beforeunload`. Listener **must**
+        either `dialog.accept()` or `dialog.dismiss()` the dialog - otherwise the page will
+        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
+        and actions like click will never finish.
+
+        **Usage**
+
+        ```python
+        context.on(\"dialog\", lambda dialog: dialog.accept())
+        ```
+
+        **NOTE** When no `page.on('dialog')` or `browser_context.on('dialog')` listeners are present, all dialogs are
+        automatically dismissed."""
+
     @typing.overload
     def on(self, event: Literal["page"], f: typing.Callable[["Page"], "None"]) -> None:
         """
@@ -12697,6 +12776,57 @@ def once(
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
 
+    @typing.overload
+    def once(
+        self, event: Literal["console"], f: typing.Callable[["ConsoleMessage"], "None"]
+    ) -> None:
+        """
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
+        emitted if the page throws an error or a warning.
+
+        The arguments passed into `console.log` and the page are available on the `ConsoleMessage` event handler argument.
+
+        **Usage**
+
+        ```py
+        async def print_args(msg):
+            values = []
+            for arg in msg.args:
+                values.append(await arg.json_value())
+            print(values)
+
+        context.on(\"console\", print_args)
+        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
+        ```
+
+        ```py
+        def print_args(msg):
+            for arg in msg.args:
+                print(arg.json_value())
+
+        context.on(\"console\", print_args)
+        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
+        ```"""
+
+    @typing.overload
+    def once(
+        self, event: Literal["dialog"], f: typing.Callable[["Dialog"], "None"]
+    ) -> None:
+        """
+        Emitted when a JavaScript dialog appears, such as `alert`, `prompt`, `confirm` or `beforeunload`. Listener **must**
+        either `dialog.accept()` or `dialog.dismiss()` the dialog - otherwise the page will
+        [freeze](https://developer.mozilla.org/en-US/docs/Web/JavaScript/EventLoop#never_blocking) waiting for the dialog,
+        and actions like click will never finish.
+
+        **Usage**
+
+        ```python
+        context.on(\"dialog\", lambda dialog: dialog.accept())
+        ```
+
+        **NOTE** When no `page.on('dialog')` or `browser_context.on('dialog')` listeners are present, all dialogs are
+        automatically dismissed."""
+
     @typing.overload
     def once(
         self, event: Literal["page"], f: typing.Callable[["Page"], "None"]
@@ -12950,6 +13080,9 @@ def add_cookies(self, cookies: typing.List[SetCookieParam]) -> None:
         Parameters
         ----------
         cookies : List[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
+            Adds cookies to the browser context.
+
+            For the cookie to apply to all subdomains as well, prefix domain with a dot, like this: ".example.com".
         """
 
         return mapping.from_maybe_impl(
@@ -14012,8 +14145,7 @@ def new_context(
             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()`. Either a path to the file with saved storage, or
-            an object with the following fields:
+            information obtained via `browser_context.storage_state()`.
         base_url : Union[str, None]
             When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
             `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
@@ -14229,8 +14361,7 @@ def new_page(
             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()`. Either a path to the file with saved storage, or
-            an object with the following fields:
+            information obtained via `browser_context.storage_state()`.
         base_url : Union[str, None]
             When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
             `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
@@ -16695,6 +16826,35 @@ def or_(self, locator: "Locator") -> "Locator":
 
         return mapping.from_impl(self._impl_obj.or_(locator=locator._impl_obj))
 
+    def and_(self, locator: "Locator") -> "Locator":
+        """Locator.and_
+
+        Creates a locator that matches both this locator and the argument locator.
+
+        **Usage**
+
+        The following example finds a button with a specific title.
+
+        ```py
+        button = page.get_by_role(\"button\").and_(page.getByTitle(\"Subscribe\"))
+        ```
+
+        ```py
+        button = page.get_by_role(\"button\").and_(page.getByTitle(\"Subscribe\"))
+        ```
+
+        Parameters
+        ----------
+        locator : Locator
+            Additional locator to match.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.and_(locator=locator._impl_obj))
+
     def focus(self, *, timeout: typing.Optional[float] = None) -> None:
         """Locator.focus
 
diff --git a/setup.py b/setup.py
index 88d020a46..4ce9c812a 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.33.0"
+driver_version = "1.34.0-alpha-may-17-2023"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_accessibility.py b/tests/async/test_accessibility.py
index 623bd5908..8b2ff2e16 100644
--- a/tests/async/test_accessibility.py
+++ b/tests/async/test_accessibility.py
@@ -12,6 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import os
+import sys
+
 import pytest
 
 
@@ -93,7 +96,12 @@ async def test_accessibility_should_work(page, is_firefox, is_chromium):
                 {"role": "textbox", "name": "placeholder", "value": "and a value"},
                 {
                     "role": "textbox",
-                    "name": "This is a description!",
+                    "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
             ],
diff --git a/tests/async/test_browsercontext_events.py b/tests/async/test_browsercontext_events.py
new file mode 100644
index 000000000..da6ce191a
--- /dev/null
+++ b/tests/async/test_browsercontext_events.py
@@ -0,0 +1,182 @@
+# 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.sync_api import Page
+
+from ..server import HttpRequestWithPostBody, Server
+
+
+async def test_console_event_should_work(page: Page) -> None:
+    [message, _] = await asyncio.gather(
+        page.context.wait_for_event("console"),
+        page.evaluate("() => console.log('hello')"),
+    )
+    assert message.text == "hello"
+    assert message.page == page
+
+
+async def test_console_event_should_work_in_popup(page: Page) -> None:
+    [message, popup, _] = await asyncio.gather(
+        page.context.wait_for_event("console"),
+        page.wait_for_event("popup"),
+        page.evaluate(
+            """() => {
+            const win = window.open('');
+            win.console.log('hello');
+        }"""
+        ),
+    )
+    assert message.text == "hello"
+    assert message.page == popup
+
+
+# console message from javascript: url is not reported at all
+@pytest.mark.skip_browser("firefox")
+async def test_console_event_should_work_in_popup_2(
+    page: Page, browser_name: str
+) -> None:
+    [message, popup, _] = await asyncio.gather(
+        page.context.wait_for_event("console", lambda msg: msg.type == "log"),
+        page.context.wait_for_event("page"),
+        page.evaluate(
+            """async () => {
+            const win = window.open('javascript:console.log("hello")');
+            await new Promise(f => setTimeout(f, 0));
+            win.close();
+        }"""
+        ),
+    )
+    assert message.text == "hello"
+    assert message.page == popup
+
+
+# console message from javascript: url is not reported at all
+@pytest.mark.skip_browser("firefox")
+async def test_console_event_should_work_in_immediately_closed_popup(
+    page: Page, browser_name: str
+) -> None:
+    [message, popup, _] = await asyncio.gather(
+        page.context.wait_for_event("console"),
+        page.wait_for_event("popup"),
+        page.evaluate(
+            """async () => {
+            const win = window.open();
+            win.console.log('hello');
+            win.close();
+        }"""
+        ),
+    )
+    assert message.text == "hello"
+    assert message.page == popup
+
+
+async def test_dialog_event_should_work1(page: Page) -> None:
+    prompt_task = None
+
+    async def open_dialog() -> None:
+        nonlocal prompt_task
+        prompt_task = asyncio.create_task(page.evaluate("() => prompt('hey?')"))
+
+    [dialog1, dialog2, _] = await asyncio.gather(
+        page.context.wait_for_event("dialog"),
+        page.wait_for_event("dialog"),
+        open_dialog(),
+    )
+    assert dialog1 == dialog2
+    assert dialog1.message == "hey?"
+    assert dialog1.page == page
+    await dialog1.accept("hello")
+    assert await prompt_task == "hello"
+
+
+async def test_dialog_event_should_work_in_popup(page: Page) -> None:
+    prompt_task = None
+
+    async def open_dialog() -> None:
+        nonlocal prompt_task
+        prompt_task = asyncio.create_task(
+            page.evaluate("() => window.open('').prompt('hey?')")
+        )
+
+    [dialog, popup, _] = await asyncio.gather(
+        page.context.wait_for_event("dialog"),
+        page.wait_for_event("popup"),
+        open_dialog(),
+    )
+    assert dialog.message == "hey?"
+    assert dialog.page == popup
+    await dialog.accept("hello")
+    assert await prompt_task == "hello"
+
+
+# console message from javascript: url is not reported at all
+@pytest.mark.skip_browser("firefox")
+async def test_dialog_event_should_work_in_popup_2(
+    page: Page, browser_name: str
+) -> None:
+    promise = asyncio.create_task(
+        page.evaluate("() => window.open('javascript:prompt(\"hey?\")')")
+    )
+    dialog = await page.context.wait_for_event("dialog")
+    assert dialog.message == "hey?"
+    assert dialog.page is None
+    await dialog.accept("hello")
+    await promise
+
+
+# console message from javascript: url is not reported at all
+@pytest.mark.skip_browser("firefox")
+async def test_dialog_event_should_work_in_immdiately_closed_popup(page: Page) -> None:
+    [message, popup, _] = await asyncio.gather(
+        page.context.wait_for_event("console"),
+        page.wait_for_event("popup"),
+        page.evaluate(
+            """() => {
+            const win = window.open();
+            win.console.log('hello');
+            win.close();
+        }"""
+        ),
+    )
+    assert message.text == "hello"
+    assert message.page == popup
+
+
+async def test_dialog_event_should_work_with_inline_script_tag(
+    page: Page, server: Server
+) -> None:
+    def handle_route(request: HttpRequestWithPostBody) -> None:
+        request.setHeader("content-type", "text/html")
+        request.write(b"""<script>window.result = prompt('hey?')</script>""")
+        request.finish()
+
+    server.set_route("/popup.html", handle_route)
+    await page.goto(server.EMPTY_PAGE)
+    await page.set_content("<a href='popup.html' target=_blank>Click me</a>")
+
+    promise = asyncio.create_task(page.click("a"))
+    [dialog, popup] = await asyncio.gather(
+        page.context.wait_for_event("dialog"),
+        page.wait_for_event("popup"),
+    )
+
+    assert dialog.message == "hey?"
+    assert dialog.page == popup
+    await dialog.accept("hello")
+    await promise
+    await popup.evaluate("window.result") == "hello"
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 57be74c90..2de3a244c 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -949,6 +949,31 @@ async def test_should_support_locator_filter(page: Page) -> None:
     await expect(page.locator("div").filter(has_not_text="foo")).to_have_count(2)
 
 
+async def test_locators_should_support_locator_and(page: Page, server: Server):
+    await page.set_content(
+        """
+        <div data-testid=foo>hello</div><div data-testid=bar>world</div>
+        <span data-testid=foo>hello2</span><span data-testid=bar>world2</span>
+    """
+    )
+    await expect(page.locator("div").and_(page.locator("div"))).to_have_count(2)
+    await expect(page.locator("div").and_(page.get_by_test_id("foo"))).to_have_text(
+        ["hello"]
+    )
+    await expect(page.locator("div").and_(page.get_by_test_id("bar"))).to_have_text(
+        ["world"]
+    )
+    await expect(page.get_by_test_id("foo").and_(page.locator("div"))).to_have_text(
+        ["hello"]
+    )
+    await expect(page.get_by_test_id("bar").and_(page.locator("span"))).to_have_text(
+        ["world2"]
+    )
+    await expect(
+        page.locator("span").and_(page.get_by_test_id(re.compile("bar|foo")))
+    ).to_have_count(2)
+
+
 async def test_locators_has_does_not_encode_unicode(page: Page, server: Server):
     await page.goto(server.EMPTY_PAGE)
     locators = [
diff --git a/tests/async/test_popup.py b/tests/async/test_popup.py
index d1dda1443..68ed1273d 100644
--- a/tests/async/test_popup.py
+++ b/tests/async/test_popup.py
@@ -316,20 +316,27 @@ async def test_should_emit_for_immediately_closed_popups(context, server):
 
 async def test_should_be_able_to_capture_alert(context):
     page = await context.new_page()
-    evaluate_promise = asyncio.create_task(
-        page.evaluate(
-            """() => {
+    evaluate_task = None
+
+    async def evaluate() -> None:
+        nonlocal evaluate_task
+        evaluate_task = asyncio.create_task(
+            page.evaluate(
+                """() => {
                 const win = window.open('')
                 win.alert('hello')
             }"""
+            )
         )
+
+    [popup, dialog, _] = await asyncio.gather(
+        page.wait_for_event("popup"), context.wait_for_event("dialog"), evaluate()
     )
 
-    popup = await page.wait_for_event("popup")
-    dialog = await popup.wait_for_event("dialog")
     assert dialog.message == "hello"
+    assert dialog.page == popup
     await dialog.dismiss()
-    await evaluate_promise
+    await evaluate_task
 
 
 async def test_should_work_with_empty_url(context):
diff --git a/tests/async/test_selectors_misc.py b/tests/async/test_selectors_misc.py
new file mode 100644
index 000000000..480adb7f7
--- /dev/null
+++ b/tests/async/test_selectors_misc.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 playwright.async_api import Page
+
+
+async def test_should_work_with_internal_and(page: Page, server):
+    await page.set_content(
+        """
+        <div class=foo>hello</div><div class=bar>world</div>
+        <span class=foo>hello2</span><span class=bar>world2</span>
+    """
+    )
+    assert (
+        await page.eval_on_selector_all(
+            'div >> internal:and="span"', "els => els.map(e => e.textContent)"
+        )
+    ) == []
+    assert (
+        await page.eval_on_selector_all(
+            'div >> internal:and=".foo"', "els => els.map(e => e.textContent)"
+        )
+    ) == ["hello"]
+    assert (
+        await page.eval_on_selector_all(
+            'div >> internal:and=".bar"', "els => els.map(e => e.textContent)"
+        )
+    ) == ["world"]
+    assert (
+        await page.eval_on_selector_all(
+            'span >> internal:and="span"', "els => els.map(e => e.textContent)"
+        )
+    ) == ["hello2", "world2"]
+    assert (
+        await page.eval_on_selector_all(
+            '.foo >> internal:and="div"', "els => els.map(e => e.textContent)"
+        )
+    ) == ["hello"]
+    assert (
+        await page.eval_on_selector_all(
+            '.bar >> internal:and="span"', "els => els.map(e => e.textContent)"
+        )
+    ) == ["world2"]
diff --git a/tests/sync/test_accessibility.py b/tests/sync/test_accessibility.py
index d4fdb9dfa..d71f27a4d 100644
--- a/tests/sync/test_accessibility.py
+++ b/tests/sync/test_accessibility.py
@@ -12,6 +12,9 @@
 # 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
@@ -97,7 +100,12 @@ def test_accessibility_should_work(
                 {"role": "textbox", "name": "placeholder", "value": "and a value"},
                 {
                     "role": "textbox",
-                    "name": "This is a description!",
+                    "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
             ],

From 790757dd0b426e0dbbf2418b1040d6d58ed2c8e6 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 18 May 2023 00:10:39 +0200
Subject: [PATCH 074/438] test: add test for Command + C does not terminate
 driver connection (#1908)

---
 tests/common/test_signals.py | 121 +++++++++++++++++++++++++++++++++++
 1 file changed, 121 insertions(+)
 create mode 100644 tests/common/test_signals.py

diff --git a/tests/common/test_signals.py b/tests/common/test_signals.py
new file mode 100644
index 000000000..7d78865ce
--- /dev/null
+++ b/tests/common/test_signals.py
@@ -0,0 +1,121 @@
+import asyncio
+import multiprocessing
+import os
+import signal
+import sys
+from typing import Any, Dict
+
+import pytest
+
+from playwright.async_api import async_playwright
+from playwright.sync_api import sync_playwright
+
+
+def _test_signals_async(
+    browser_name: str, launch_arguments: Dict, wait_queue: "multiprocessing.Queue[str]"
+) -> None:
+    os.setpgrp()
+    sigint_received = False
+
+    def my_sig_handler(signum: int, frame: Any) -> None:
+        nonlocal sigint_received
+        sigint_received = True
+
+    signal.signal(signal.SIGINT, my_sig_handler)
+
+    async def main() -> None:
+        playwright = await async_playwright().start()
+        browser = await playwright[browser_name].launch(
+            **launch_arguments,
+            handle_sigint=False,
+        )
+        context = await browser.new_context()
+        page = await context.new_page()
+        notified = False
+        try:
+            nonlocal sigint_received
+            while not sigint_received:
+                if not notified:
+                    wait_queue.put("ready")
+                    notified = True
+                await page.wait_for_timeout(100)
+        finally:
+            wait_queue.put("close context")
+            await context.close()
+            wait_queue.put("close browser")
+            await browser.close()
+            wait_queue.put("close playwright")
+            await playwright.stop()
+            wait_queue.put("all done")
+
+    asyncio.run(main())
+
+
+def _test_signals_sync(
+    browser_name: str, launch_arguments: Dict, wait_queue: "multiprocessing.Queue[str]"
+) -> None:
+    os.setpgrp()
+    sigint_received = False
+
+    def my_sig_handler(signum: int, frame: Any) -> None:
+        nonlocal sigint_received
+        sigint_received = True
+
+    signal.signal(signal.SIGINT, my_sig_handler)
+
+    playwright = sync_playwright().start()
+    browser = playwright[browser_name].launch(
+        **launch_arguments,
+        handle_sigint=False,
+    )
+    context = browser.new_context()
+    page = context.new_page()
+    notified = False
+    try:
+        while not sigint_received:
+            if not notified:
+                wait_queue.put("ready")
+                notified = True
+            page.wait_for_timeout(100)
+    finally:
+        wait_queue.put("close context")
+        context.close()
+        wait_queue.put("close browser")
+        browser.close()
+        wait_queue.put("close playwright")
+        playwright.stop()
+        wait_queue.put("all done")
+
+
+def _create_signals_test(
+    target: Any, browser_name: str, launch_arguments: Dict
+) -> None:
+    wait_queue: "multiprocessing.Queue[str]" = multiprocessing.Queue()
+    process = multiprocessing.Process(
+        target=target, args=[browser_name, launch_arguments, wait_queue]
+    )
+    process.start()
+    assert process.pid is not None
+    logs = [wait_queue.get()]
+    os.killpg(os.getpgid(process.pid), signal.SIGINT)
+    process.join()
+    while not wait_queue.empty():
+        logs.append(wait_queue.get())
+    assert logs == [
+        "ready",
+        "close context",
+        "close browser",
+        "close playwright",
+        "all done",
+    ]
+    assert process.exitcode == 0
+
+
+@pytest.mark.skipif(sys.platform == "win32", reason="there is no SIGINT on Windows")
+def test_signals_sync(browser_name: str, launch_arguments: Dict) -> None:
+    _create_signals_test(_test_signals_sync, browser_name, launch_arguments)
+
+
+@pytest.mark.skipif(sys.platform == "win32", reason="there is no SIGINT on Windows")
+def test_signals_async(browser_name: str, launch_arguments: Dict) -> None:
+    _create_signals_test(_test_signals_async, browser_name, launch_arguments)

From d4a874f3eebbb70dfc6f915dc607e27d079cc5fb Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 18 May 2023 02:53:56 +0200
Subject: [PATCH 075/438] chore: rename expect.set_timeout to set_options
 (#1927)

---
 playwright/async_api/__init__.py | 14 ++++++++++++--
 playwright/sync_api/__init__.py  | 14 ++++++++++++--
 tests/async/test_assertions.py   |  4 ++--
 tests/sync/test_assertions.py    |  4 ++--
 4 files changed, 28 insertions(+), 8 deletions(-)

diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index d01d3b616..c09a5678d 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.py
@@ -91,8 +91,18 @@ class Expect:
     def __init__(self) -> None:
         self._timeout: Optional[float] = None
 
-    def set_timeout(self, timeout: float) -> None:
-        self._timeout = timeout
+    def set_options(self, timeout: float = None) -> None:
+        """
+        This method sets global `expect()` options.
+
+        Args:
+            timeout (float): Timeout value in milliseconds. Default to 5000 milliseconds.
+
+        Returns:
+            None
+        """
+        if timeout is not None:
+            self._timeout = timeout
 
     @overload
     def __call__(self, actual: Page, message: Optional[str] = None) -> PageAssertions:
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index 3de47b2a7..55351b658 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -91,8 +91,18 @@ class Expect:
     def __init__(self) -> None:
         self._timeout: Optional[float] = None
 
-    def set_timeout(self, timeout: float) -> None:
-        self._timeout = timeout
+    def set_options(self, timeout: float = None) -> None:
+        """
+        This method sets global `expect()` options.
+
+        Args:
+            timeout (float): Timeout value in milliseconds. Default to 5000 milliseconds.
+
+        Returns:
+            None
+        """
+        if timeout is not None:
+            self._timeout = timeout
 
     @overload
     def __call__(self, actual: Page, message: Optional[str] = None) -> PageAssertions:
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index f0d6583d9..2e8e262a6 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -800,11 +800,11 @@ async def test_should_be_able_to_set_custom_timeout(page: Page) -> None:
 
 async def test_should_be_able_to_set_custom_global_timeout(page: Page) -> None:
     try:
-        expect.set_timeout(111)
+        expect.set_options(timeout=111)
         with pytest.raises(AssertionError) as exc_info:
             await expect(page.locator("#a1")).to_be_visible()
         assert "LocatorAssertions.to_be_visible with timeout 111ms" in str(
             exc_info.value
         )
     finally:
-        expect.set_timeout(None)
+        expect.set_options(timeout=None)
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 1d5c09b55..724f1d980 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -862,11 +862,11 @@ def test_should_be_able_to_set_custom_timeout(page: Page) -> None:
 
 def test_should_be_able_to_set_custom_global_timeout(page: Page) -> None:
     try:
-        expect.set_timeout(111)
+        expect.set_options(timeout=111)
         with pytest.raises(AssertionError) as exc_info:
             expect(page.locator("#a1")).to_be_visible()
         assert "LocatorAssertions.to_be_visible with timeout 111ms" in str(
             exc_info.value
         )
     finally:
-        expect.set_timeout(5_000)
+        expect.set_options(timeout=5_000)

From 7a91855989a0073a4e971191b356492c54163059 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 25 May 2023 16:48:35 -0700
Subject: [PATCH 076/438] build(deps): bump requests from 2.28.2 to 2.31.0
 (#1935)

Bumps [requests](https://github.com/psf/requests) from 2.28.2 to 2.31.0.
- [Release notes](https://github.com/psf/requests/releases)
- [Changelog](https://github.com/psf/requests/blob/main/HISTORY.md)
- [Commits](https://github.com/psf/requests/compare/v2.28.2...v2.31.0)

---
updated-dependencies:
- dependency-name: requests
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index a252da3bd..a5655ed92 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -15,7 +15,7 @@ pytest-cov==4.0.0
 pytest-repeat==0.9.1
 pytest-timeout==2.1.0
 pytest-xdist==3.1.0
-requests==2.28.2
+requests==2.31.0
 service_identity==21.1.0
 setuptools==67.1.0
 twine==4.0.2

From e6a7a37ee7e5331bf6ff9c7c08e6b56e566219c2 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 26 May 2023 13:49:59 -0700
Subject: [PATCH 077/438] chore(roll): roll Playwright to 1.34.3 (#1930)

---
 README.md                                 |   2 +-
 playwright/_impl/_browser_context.py      |   7 +
 playwright/async_api/_generated.py        |  32 ++++
 playwright/sync_api/_generated.py         |  32 ++++
 setup.py                                  |   2 +-
 tests/async/test_browsercontext.py        |   5 +-
 tests/async/test_browsercontext_events.py |   8 +
 tests/async/test_interception.py          |   5 +-
 tests/sync/test_browsercontext_events.py  | 200 ++++++++++++++++++++++
 tests/sync/test_locators.py               |  19 ++
 tests/sync/test_selectors_misc.py         |  54 ++++++
 11 files changed, 360 insertions(+), 6 deletions(-)
 create mode 100644 tests/sync/test_browsercontext_events.py
 create mode 100644 tests/sync/test_selectors_misc.py

diff --git a/README.md b/README.md
index 081734543..ae6c59054 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->113.0.5672.53<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->114.0.5735.35<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->113.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 5678441b4..8b7df9722 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -478,6 +478,13 @@ async def wait_for_event(
             pass
         return await event_info
 
+    def expect_console_message(
+        self,
+        predicate: Callable[[ConsoleMessage], bool] = None,
+        timeout: float = None,
+    ) -> EventContextManagerImpl[ConsoleMessage]:
+        return self.expect_event(Page.Events.Console, predicate, timeout)
+
     def expect_page(
         self,
         predicate: Callable[[Page], bool] = None,
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 7ff612aec..b3eabb16f 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -13733,6 +13733,38 @@ async def wait_for_event(
             )
         )
 
+    def expect_console_message(
+        self,
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None
+    ) -> AsyncEventContextManager["ConsoleMessage"]:
+        """BrowserContext.expect_console_message
+
+        Performs action and waits for a `ConsoleMessage` to be logged by in the pages in the context. If predicate is
+        provided, it passes `ConsoleMessage` value into the `predicate` function and waits for `predicate(message)` to
+        return a truthy value. Will throw an error if the page is closed before the `browser_context.on('console')` event
+        is fired.
+
+        Parameters
+        ----------
+        predicate : Union[Callable[[ConsoleMessage], bool], None]
+            Receives the `ConsoleMessage` object 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[ConsoleMessage]
+        """
+
+        return AsyncEventContextManager(
+            self._impl_obj.expect_console_message(
+                predicate=self._wrap_handler(predicate), timeout=timeout
+            ).future
+        )
+
     def expect_page(
         self,
         predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 7be26802b..ce94063be 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -13799,6 +13799,38 @@ def wait_for_event(
             )
         )
 
+    def expect_console_message(
+        self,
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None
+    ) -> EventContextManager["ConsoleMessage"]:
+        """BrowserContext.expect_console_message
+
+        Performs action and waits for a `ConsoleMessage` to be logged by in the pages in the context. If predicate is
+        provided, it passes `ConsoleMessage` value into the `predicate` function and waits for `predicate(message)` to
+        return a truthy value. Will throw an error if the page is closed before the `browser_context.on('console')` event
+        is fired.
+
+        Parameters
+        ----------
+        predicate : Union[Callable[[ConsoleMessage], bool], None]
+            Receives the `ConsoleMessage` object 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[ConsoleMessage]
+        """
+        return EventContextManager(
+            self,
+            self._impl_obj.expect_console_message(
+                predicate=self._wrap_handler(predicate), timeout=timeout
+            ).future,
+        )
+
     def expect_page(
         self,
         predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
diff --git a/setup.py b/setup.py
index 4ce9c812a..93a9caa17 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.34.0-alpha-may-17-2023"
+driver_version = "1.34.3"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index 5966e3e79..ec3b7e230 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import asyncio
+import re
 from urllib.parse import urlparse
 
 import pytest
@@ -477,13 +478,13 @@ def handler(route, request, ordinal):
     def handler4(route, request):
         handler(route, request, 4)
 
-    await context.route("**/empty.html", handler4)
+    await context.route(re.compile("empty.html"), handler4)
 
     await page.goto(server.EMPTY_PAGE)
     assert intercepted == [4]
 
     intercepted = []
-    await context.unroute("**/empty.html", handler4)
+    await context.unroute(re.compile("empty.html"), handler4)
     await page.goto(server.EMPTY_PAGE)
     assert intercepted == [3]
 
diff --git a/tests/async/test_browsercontext_events.py b/tests/async/test_browsercontext_events.py
index da6ce191a..ff37015dc 100644
--- a/tests/async/test_browsercontext_events.py
+++ b/tests/async/test_browsercontext_events.py
@@ -180,3 +180,11 @@ def handle_route(request: HttpRequestWithPostBody) -> None:
     await dialog.accept("hello")
     await promise
     await popup.evaluate("window.result") == "hello"
+
+
+async def test_console_event_should_work_with_context_manager(page: Page) -> None:
+    async with page.context.expect_console_message() as cm_info:
+        await page.evaluate("() => console.log('hello')")
+    message = await cm_info.value
+    assert message.text == "hello"
+    assert message.page == page
diff --git a/tests/async/test_interception.py b/tests/async/test_interception.py
index 439f68125..08a24273a 100644
--- a/tests/async/test_interception.py
+++ b/tests/async/test_interception.py
@@ -14,6 +14,7 @@
 
 import asyncio
 import json
+import re
 
 import pytest
 
@@ -75,13 +76,13 @@ def handler4(route):
         intercepted.append(4)
         asyncio.create_task(route.continue_())
 
-    await page.route("**/empty.html", handler4)
+    await page.route(re.compile("empty.html"), handler4)
 
     await page.goto(server.EMPTY_PAGE)
     assert intercepted == [4]
 
     intercepted = []
-    await page.unroute("**/empty.html", handler4)
+    await page.unroute(re.compile("empty.html"), handler4)
     await page.goto(server.EMPTY_PAGE)
     assert intercepted == [3]
 
diff --git a/tests/sync/test_browsercontext_events.py b/tests/sync/test_browsercontext_events.py
new file mode 100644
index 000000000..6d0840e6a
--- /dev/null
+++ b/tests/sync/test_browsercontext_events.py
@@ -0,0 +1,200 @@
+# 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 Optional
+
+import pytest
+
+from playwright.sync_api import Dialog, Page
+
+from ..server import HttpRequestWithPostBody, Server
+
+
+def test_console_event_should_work(page: Page) -> None:
+    with page.context.expect_console_message() as console_info:
+        page.evaluate("() => console.log('hello')")
+    message = console_info.value
+    assert message.text == "hello"
+    assert message.page == page
+
+
+def test_console_event_should_work_in_popup(page: Page) -> None:
+    with page.context.expect_console_message() as console_info:
+        with page.expect_popup() as popup_info:
+            page.evaluate(
+                """() => {
+                const win = window.open('');
+                win.console.log('hello');
+                }"""
+            )
+    message = console_info.value
+    popup = popup_info.value
+    assert message.text == "hello"
+    assert message.page == popup
+
+
+# console message from javascript: url is not reported at all
+@pytest.mark.skip_browser("firefox")
+def test_console_event_should_work_in_popup_2(page: Page, browser_name: str) -> None:
+    with page.context.expect_console_message(
+        lambda msg: msg.type == "log"
+    ) as console_info:
+        with page.context.expect_page() as page_info:
+            page.evaluate(
+                """async () => {
+                const win = window.open('javascript:console.log("hello")');
+                await new Promise(f => setTimeout(f, 0));
+                win.close();
+            }"""
+            )
+    message = console_info.value
+    popup = page_info.value
+    assert message.text == "hello"
+    assert message.page == popup
+
+
+# console message from javascript: url is not reported at all
+@pytest.mark.skip_browser("firefox")
+def test_console_event_should_work_in_immediately_closed_popup(
+    page: Page, browser_name: str
+) -> None:
+    with page.context.expect_console_message(
+        lambda msg: msg.type == "log"
+    ) as console_info:
+        with page.context.expect_page() as page_info:
+            page.evaluate(
+                """() => {
+                const win = window.open('');
+                win.console.log('hello');
+                win.close();
+            }"""
+            )
+    message = console_info.value
+    popup = page_info.value
+    assert message.text == "hello"
+    assert message.page == popup
+
+
+def test_dialog_event_should_work1(page: Page) -> None:
+    dialog1: Optional[Dialog] = None
+
+    def handle_page_dialog(dialog: Dialog) -> None:
+        nonlocal dialog1
+        dialog1 = dialog
+        dialog.accept("hello")
+
+    page.on("dialog", handle_page_dialog)
+
+    dialog2: Optional[Dialog] = None
+
+    def handle_context_dialog(dialog: Dialog) -> None:
+        nonlocal dialog2
+        dialog2 = dialog
+
+    page.context.on("dialog", handle_context_dialog)
+
+    assert page.evaluate("() => prompt('hey?')") == "hello"
+    assert dialog1
+    assert dialog1 == dialog2
+    assert dialog1.message == "hey?"
+    assert dialog1.page == page
+
+
+def test_dialog_event_should_work_in_popup1(page: Page) -> None:
+    dialog: Optional[Dialog] = None
+
+    def handle_dialog(d: Dialog) -> None:
+        nonlocal dialog
+        dialog = d
+        dialog.accept("hello")
+
+    page.context.on("dialog", handle_dialog)
+
+    with page.expect_popup() as popup_info:
+        assert page.evaluate("() => window.open('').prompt('hey?')") == "hello"
+    popup = popup_info.value
+    assert dialog
+    assert dialog.message == "hey?"
+    assert dialog.page == popup
+
+
+# console message from javascript: url is not reported at all
+@pytest.mark.skip_browser("firefox")
+def test_dialog_event_should_work_in_popup_2(page: Page, browser_name: str) -> None:
+    def handle_dialog(dialog: Dialog) -> None:
+        assert dialog.message == "hey?"
+        assert dialog.page is None
+        dialog.accept("hello")
+
+    page.context.on("dialog", handle_dialog)
+
+    assert page.evaluate("() => window.open('javascript:prompt(\"hey?\")')")
+
+
+# console message from javascript: url is not reported at all
+@pytest.mark.skip_browser("firefox")
+def test_dialog_event_should_work_in_immdiately_closed_popup(page: Page) -> None:
+    popup = None
+
+    def handle_popup(p: Page) -> None:
+        nonlocal popup
+        popup = p
+
+    page.on("popup", handle_popup)
+
+    with page.context.expect_console_message() as console_info:
+        page.evaluate(
+            """() => {
+                const win = window.open();
+                win.console.log('hello');
+                win.close();
+            }"""
+        )
+    message = console_info.value
+
+    assert message.text == "hello"
+    assert message.page == popup
+
+
+def test_dialog_event_should_work_with_inline_script_tag(
+    page: Page, server: Server
+) -> None:
+    def handle_route(request: HttpRequestWithPostBody) -> None:
+        request.setHeader("content-type", "text/html")
+        request.write(b"""<script>window.result = prompt('hey?')</script>""")
+        request.finish()
+
+    server.set_route("/popup.html", handle_route)
+    page.goto(server.EMPTY_PAGE)
+    page.set_content("<a href='popup.html' target=_blank>Click me</a>")
+
+    def handle_dialog(dialog: Dialog) -> None:
+        assert dialog.message == "hey?"
+        assert dialog.page == popup
+        dialog.accept("hello")
+
+    page.context.on("dialog", handle_dialog)
+
+    with page.expect_popup() as popup_info:
+        page.click("a")
+    popup = popup_info.value
+    assert popup.evaluate("window.result") == "hello"
+
+
+def test_console_event_should_work_with_context_manager(page: Page) -> None:
+    with page.context.expect_console_message() as cm_info:
+        page.evaluate("() => console.log('hello')")
+    message = cm_info.value
+    assert message.text == "hello"
+    assert message.page == page
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 8c00368d9..2c0455d57 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -863,6 +863,25 @@ def test_should_support_locator_filter(page: Page) -> None:
     expect(page.locator("div").filter(has_not_text="foo")).to_have_count(2)
 
 
+def test_locators_should_support_locator_and(page: Page) -> None:
+    page.set_content(
+        """
+        <div data-testid=foo>hello</div><div data-testid=bar>world</div>
+        <span data-testid=foo>hello2</span><span data-testid=bar>world2</span>
+    """
+    )
+    expect(page.locator("div").and_(page.locator("div"))).to_have_count(2)
+    expect(page.locator("div").and_(page.get_by_test_id("foo"))).to_have_text(["hello"])
+    expect(page.locator("div").and_(page.get_by_test_id("bar"))).to_have_text(["world"])
+    expect(page.get_by_test_id("foo").and_(page.locator("div"))).to_have_text(["hello"])
+    expect(page.get_by_test_id("bar").and_(page.locator("span"))).to_have_text(
+        ["world2"]
+    )
+    expect(
+        page.locator("span").and_(page.get_by_test_id(re.compile("bar|foo")))
+    ).to_have_count(2)
+
+
 def test_locators_has_does_not_encode_unicode(page: Page, server: Server) -> None:
     page.goto(server.EMPTY_PAGE)
     locators = [
diff --git a/tests/sync/test_selectors_misc.py b/tests/sync/test_selectors_misc.py
new file mode 100644
index 000000000..ad7ec16ea
--- /dev/null
+++ b/tests/sync/test_selectors_misc.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 playwright.sync_api import Page
+
+
+def test_should_work_with_internal_and(page: Page) -> None:
+    page.set_content(
+        """
+        <div class=foo>hello</div><div class=bar>world</div>
+        <span class=foo>hello2</span><span class=bar>world2</span>
+    """
+    )
+    assert (
+        page.eval_on_selector_all(
+            'div >> internal:and="span"', "els => els.map(e => e.textContent)"
+        )
+    ) == []
+    assert (
+        page.eval_on_selector_all(
+            'div >> internal:and=".foo"', "els => els.map(e => e.textContent)"
+        )
+    ) == ["hello"]
+    assert (
+        page.eval_on_selector_all(
+            'div >> internal:and=".bar"', "els => els.map(e => e.textContent)"
+        )
+    ) == ["world"]
+    assert (
+        page.eval_on_selector_all(
+            'span >> internal:and="span"', "els => els.map(e => e.textContent)"
+        )
+    ) == ["hello2", "world2"]
+    assert (
+        page.eval_on_selector_all(
+            '.foo >> internal:and="div"', "els => els.map(e => e.textContent)"
+        )
+    ) == ["hello"]
+    assert (
+        page.eval_on_selector_all(
+            '.bar >> internal:and="span"', "els => els.map(e => e.textContent)"
+        )
+    ) == ["world2"]

From 45b1312bda8b36c5ec546c52431d01297bd06aa9 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Sun, 4 Jun 2023 14:37:34 +0200
Subject: [PATCH 078/438] docs: replace whatsmyuseragent with playwright.dev
 (#1952)

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ae6c59054..f26e6d303 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@ with sync_playwright() as p:
     for browser_type in [p.chromium, p.firefox, p.webkit]:
         browser = browser_type.launch()
         page = browser.new_page()
-        page.goto('http://whatsmyuseragent.org/')
+        page.goto('http://playwright.dev')
         page.screenshot(path=f'example-{browser_type.name}.png')
         browser.close()
 ```
@@ -39,7 +39,7 @@ async def main():
         for browser_type in [p.chromium, p.firefox, p.webkit]:
             browser = await browser_type.launch()
             page = await browser.new_page()
-            await page.goto('http://whatsmyuseragent.org/')
+            await page.goto('http://playwright.dev')
             await page.screenshot(path=f'example-{browser_type.name}.png')
             await browser.close()
 

From 6980e901849b6fd551e53cd5e2d298f60ac8977b Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 12 Jun 2023 23:14:54 +0200
Subject: [PATCH 079/438] chore(roll): roll Playwright to
 1.35.0-beta-1686247644000 (#1964)

---
 README.md                                    |   2 +-
 playwright/_impl/_browser_context.py         |  10 +-
 playwright/_impl/_element_handle.py          |   1 +
 playwright/_impl/_helper.py                  |  28 ++-
 playwright/_impl/_locator.py                 |   1 +
 playwright/_impl/_network.py                 |   1 +
 playwright/_impl/_page.py                    |  29 ++-
 playwright/_impl/_set_input_files_helpers.py |  28 +--
 playwright/async_api/_generated.py           | 181 ++++++++++---------
 playwright/sync_api/_generated.py            | 181 ++++++++++---------
 setup.py                                     |   2 +-
 tests/assets/input/fileupload-multi.html     |  12 ++
 tests/async/test_input.py                    |  30 +++
 13 files changed, 304 insertions(+), 202 deletions(-)
 create mode 100644 tests/assets/input/fileupload-multi.html

diff --git a/README.md b/README.md
index f26e6d303..59117f718 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->114.0.5735.35<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->115.0.5790.24<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->113.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 8b7df9722..270232b35 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -232,13 +232,19 @@ def _on_binding(self, binding_call: BindingCall) -> None:
         asyncio.create_task(binding_call.call(func))
 
     def set_default_navigation_timeout(self, timeout: float) -> None:
-        self._timeout_settings.set_navigation_timeout(timeout)
+        return self._set_default_navigation_timeout_impl(timeout)
+
+    def _set_default_navigation_timeout_impl(self, timeout: Optional[float]) -> None:
+        self._timeout_settings.set_default_navigation_timeout(timeout)
         self._channel.send_no_reply(
             "setDefaultNavigationTimeoutNoReply", dict(timeout=timeout)
         )
 
     def set_default_timeout(self, timeout: float) -> None:
-        self._timeout_settings.set_timeout(timeout)
+        return self._set_default_timeout_impl(timeout)
+
+    def _set_default_timeout_impl(self, timeout: Optional[float]) -> None:
+        self._timeout_settings.set_default_timeout(timeout)
         self._channel.send_no_reply("setDefaultTimeoutNoReply", dict(timeout=timeout))
 
     @property
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index efb5925ae..3b96c444e 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -287,6 +287,7 @@ async def screenshot(
         caret: Literal["hide", "initial"] = None,
         scale: Literal["css", "device"] = None,
         mask: List["Locator"] = None,
+        mask_color: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
         if "path" in params:
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index c87c092da..0af327d11 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -177,27 +177,35 @@ class HarLookupResult(TypedDict, total=False):
 class TimeoutSettings:
     def __init__(self, parent: Optional["TimeoutSettings"]) -> None:
         self._parent = parent
-        self._timeout: Optional[float] = None
-        self._navigation_timeout: Optional[float] = None
+        self._default_timeout: Optional[float] = None
+        self._default_navigation_timeout: Optional[float] = None
 
-    def set_timeout(self, timeout: float) -> None:
-        self._timeout = timeout
+    def set_default_timeout(self, timeout: Optional[float]) -> None:
+        self._default_timeout = timeout
 
     def timeout(self, timeout: float = None) -> float:
         if timeout is not None:
             return timeout
-        if self._timeout is not None:
-            return self._timeout
+        if self._default_timeout is not None:
+            return self._default_timeout
         if self._parent:
             return self._parent.timeout()
         return 30000
 
-    def set_navigation_timeout(self, navigation_timeout: float) -> None:
-        self._navigation_timeout = navigation_timeout
+    def set_default_navigation_timeout(
+        self, navigation_timeout: Optional[float]
+    ) -> None:
+        self._default_navigation_timeout = navigation_timeout
+
+    def default_navigation_timeout(self) -> Optional[float]:
+        return self._default_navigation_timeout
+
+    def default_timeout(self) -> Optional[float]:
+        return self._default_timeout
 
     def navigation_timeout(self) -> float:
-        if self._navigation_timeout is not None:
-            return self._navigation_timeout
+        if self._default_navigation_timeout is not None:
+            return self._default_navigation_timeout
         if self._parent:
             return self._parent.navigation_timeout()
         return 30000
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 416b09214..246617d06 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -524,6 +524,7 @@ async def screenshot(
         caret: Literal["hide", "initial"] = None,
         scale: Literal["css", "device"] = None,
         mask: List["Locator"] = None,
+        mask_color: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
         return await self._with_element(
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 112e4735e..419d5793e 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -422,6 +422,7 @@ async def continue_route() -> None:
                 if "headers" in params:
                     params["headers"] = serialize_headers(params["headers"])
                 params["requestUrl"] = self.request._initializer["url"]
+                params["isFallback"] = is_internal
                 await self._connection.wrap_api_call(
                     lambda: self._race_with_page_close(
                         self._channel.send(
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 75dd3b2e0..902f3b5f1 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -323,13 +323,13 @@ def frames(self) -> List[Frame]:
         return self._frames.copy()
 
     def set_default_navigation_timeout(self, timeout: float) -> None:
-        self._timeout_settings.set_navigation_timeout(timeout)
+        self._timeout_settings.set_default_navigation_timeout(timeout)
         self._channel.send_no_reply(
             "setDefaultNavigationTimeoutNoReply", dict(timeout=timeout)
         )
 
     def set_default_timeout(self, timeout: float) -> None:
-        self._timeout_settings.set_timeout(timeout)
+        self._timeout_settings.set_default_timeout(timeout)
         self._channel.send_no_reply("setDefaultTimeoutNoReply", dict(timeout=timeout))
 
     async def query_selector(
@@ -641,6 +641,7 @@ async def screenshot(
         caret: Literal["hide", "initial"] = None,
         scale: Literal["css", "device"] = None,
         mask: List["Locator"] = None,
+        mask_color: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
         if "path" in params:
@@ -957,13 +958,25 @@ def request(self) -> "APIRequestContext":
         return self.context.request
 
     async def pause(self) -> None:
-        await asyncio.wait(
-            [
-                asyncio.create_task(self._browser_context._pause()),
-                self._closed_or_crashed_future,
-            ],
-            return_when=asyncio.FIRST_COMPLETED,
+        default_navigation_timeout = (
+            self._browser_context._timeout_settings.default_navigation_timeout()
         )
+        default_timeout = self._browser_context._timeout_settings.default_timeout()
+        self._browser_context.set_default_navigation_timeout(0)
+        self._browser_context.set_default_timeout(0)
+        try:
+            await asyncio.wait(
+                [
+                    asyncio.create_task(self._browser_context._pause()),
+                    self._closed_or_crashed_future,
+                ],
+                return_when=asyncio.FIRST_COMPLETED,
+            )
+        finally:
+            self._browser_context._set_default_navigation_timeout_impl(
+                default_navigation_timeout
+            )
+            self._browser_context._set_default_timeout_impl(default_timeout)
 
     async def pdf(
         self,
diff --git a/playwright/_impl/_set_input_files_helpers.py b/playwright/_impl/_set_input_files_helpers.py
index a03a41e91..2ee52347b 100644
--- a/playwright/_impl/_set_input_files_helpers.py
+++ b/playwright/_impl/_set_input_files_helpers.py
@@ -33,26 +33,26 @@ async def convert_input_files(
 ) -> InputFilesList:
     file_list = files if isinstance(files, list) else [files]
 
-    has_large_buffer = any(
-        [
-            len(f.get("buffer", "")) > SIZE_LIMIT_IN_BYTES
-            for f in file_list
-            if not isinstance(f, (str, Path))
-        ]
+    total_buffer_size_exceeds_limit = (
+        sum(
+            [
+                len(f.get("buffer", ""))
+                for f in file_list
+                if not isinstance(f, (str, Path))
+            ]
+        )
+        > SIZE_LIMIT_IN_BYTES
     )
-    if has_large_buffer:
+    if total_buffer_size_exceeds_limit:
         raise Error(
             "Cannot set buffer larger than 50Mb, please write it to a file and pass its path instead."
         )
 
-    has_large_file = any(
-        [
-            os.stat(f).st_size > SIZE_LIMIT_IN_BYTES
-            for f in file_list
-            if isinstance(f, (str, Path))
-        ]
+    total_file_size_exceeds_limit = (
+        sum([os.stat(f).st_size for f in file_list if isinstance(f, (str, Path))])
+        > SIZE_LIMIT_IN_BYTES
     )
-    if has_large_file:
+    if total_file_size_exceeds_limit:
         if context._channel._connection.is_remote:
             streams = []
             for file in file_list:
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index b3eabb16f..6b6c9ffbd 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -2765,7 +2765,8 @@ async def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None
+        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask_color: typing.Optional[str] = None
     ) -> bytes:
         """ElementHandle.screenshot
 
@@ -2812,7 +2813,10 @@ async def screenshot(
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+        mask_color : Union[str, None]
+            Specify the color of the overlay box for masked elements, in
+            [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
 
         Returns
         -------
@@ -2830,6 +2834,7 @@ async def screenshot(
                 caret=caret,
                 scale=scale,
                 mask=mapping.to_impl(mask),
+                mask_color=mask_color,
             )
         )
 
@@ -9899,7 +9904,8 @@ async def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None
+        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask_color: typing.Optional[str] = None
     ) -> bytes:
         """Page.screenshot
 
@@ -9944,7 +9950,10 @@ async def screenshot(
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+        mask_color : Union[str, None]
+            Specify the color of the overlay box for masked elements, in
+            [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
 
         Returns
         -------
@@ -9964,6 +9973,7 @@ async def screenshot(
                 caret=caret,
                 scale=scale,
                 mask=mapping.to_impl(mask),
+                mask_color=mask_color,
             )
         )
 
@@ -14045,23 +14055,23 @@ async def new_context(
             Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
             [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
-            Toggles bypassing page's Content-Security-Policy.
+            Toggles bypassing page's Content-Security-Policy. Defaults to `false`.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
-            our [emulation guide](../emulation.md#locale--timezone).
+            `Accept-Language` request header value as well as number and date formatting rules. Defaults to the system default
+            locale. Learn more about emulation in our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
-            for a list of supported timezone IDs.
+            for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
-            more details.
+            more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
-            An object containing additional HTTP headers to be sent with every request.
+            An object containing additional HTTP headers to be sent with every request. Defaults to none.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
@@ -14093,7 +14103,7 @@ async def new_context(
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
-            Network proxy settings to use with this context.
+            Network proxy settings to use with this context. Defaults to none.
 
             **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
             all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
@@ -14120,7 +14130,7 @@ async def new_context(
             When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
             `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
             using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
-            corresponding URL. Examples:
+            corresponding URL. Unset by default. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
             - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
               `http://localhost:3000/foo/bar.html`
@@ -14129,8 +14139,8 @@ async def new_context(
         strict_selectors : Union[bool, None]
             If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
             selectors that imply single target DOM element will throw when more than one element matches the selector. This
-            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
-            mode.
+            option does not affect any Locator APIs (Locators are always strict). Defaults to `false`. See `Locator` to learn
+            more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -14259,23 +14269,23 @@ async def new_page(
             Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
             [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
-            Toggles bypassing page's Content-Security-Policy.
+            Toggles bypassing page's Content-Security-Policy. Defaults to `false`.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
-            our [emulation guide](../emulation.md#locale--timezone).
+            `Accept-Language` request header value as well as number and date formatting rules. Defaults to the system default
+            locale. Learn more about emulation in our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
-            for a list of supported timezone IDs.
+            for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
-            more details.
+            more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
-            An object containing additional HTTP headers to be sent with every request.
+            An object containing additional HTTP headers to be sent with every request. Defaults to none.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
@@ -14307,7 +14317,7 @@ async def new_page(
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
-            Network proxy settings to use with this context.
+            Network proxy settings to use with this context. Defaults to none.
 
             **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
             all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
@@ -14334,7 +14344,7 @@ async def new_page(
             When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
             `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
             using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
-            corresponding URL. Examples:
+            corresponding URL. Unset by default. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
             - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
               `http://localhost:3000/foo/bar.html`
@@ -14343,8 +14353,8 @@ async def new_page(
         strict_selectors : Union[bool, None]
             If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
             selectors that imply single target DOM element will throw when more than one element matches the selector. This
-            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
-            mode.
+            option does not affect any Locator APIs (Locators are always strict). Defaults to `false`. See `Locator` to learn
+            more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -14804,23 +14814,23 @@ async def launch_persistent_context(
             Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
             [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
-            Toggles bypassing page's Content-Security-Policy.
+            Toggles bypassing page's Content-Security-Policy. Defaults to `false`.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
-            our [emulation guide](../emulation.md#locale--timezone).
+            `Accept-Language` request header value as well as number and date formatting rules. Defaults to the system default
+            locale. Learn more about emulation in our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
-            for a list of supported timezone IDs.
+            for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
-            more details.
+            more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
-            An object containing additional HTTP headers to be sent with every request.
+            An object containing additional HTTP headers to be sent with every request. Defaults to none.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
@@ -14872,7 +14882,7 @@ async def launch_persistent_context(
             When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
             `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
             using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
-            corresponding URL. Examples:
+            corresponding URL. Unset by default. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
             - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
               `http://localhost:3000/foo/bar.html`
@@ -14881,8 +14891,8 @@ async def launch_persistent_context(
         strict_selectors : Union[bool, None]
             If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
             selectors that imply single target DOM element will throw when more than one element matches the selector. This
-            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
-            mode.
+            option does not affect any Locator APIs (Locators are always strict). Defaults to `false`. See `Locator` to learn
+            more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -15184,7 +15194,7 @@ async def stop(self) -> None:
 
         >>> browser = playwright.chromium.launch()
         >>> page = browser.new_page()
-        >>> page.goto(\"http://whatsmyuseragent.org/\")
+        >>> page.goto(\"https://playwright.dev/\")
         >>> page.screenshot(path=\"example.png\")
         >>> browser.close()
 
@@ -15379,11 +15389,11 @@ def last(self) -> "Locator":
         **Usage**
 
         ```py
-        banana = await page.get_by_role(\"listitem\").last()
+        banana = await page.get_by_role(\"listitem\").last
         ```
 
         ```py
-        banana = page.get_by_role(\"listitem\").last()
+        banana = page.get_by_role(\"listitem\").last
         ```
 
         Returns
@@ -17368,7 +17378,8 @@ async def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None
+        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask_color: typing.Optional[str] = None
     ) -> bytes:
         """Locator.screenshot
 
@@ -17439,7 +17450,10 @@ async def screenshot(
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+        mask_color : Union[str, None]
+            Specify the color of the overlay box for masked elements, in
+            [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
 
         Returns
         -------
@@ -17457,6 +17471,7 @@ async def screenshot(
                 caret=caret,
                 scale=scale,
                 mask=mapping.to_impl(mask),
+                mask_color=mask_color,
             )
         )
 
@@ -18898,7 +18913,7 @@ async def new_context(
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         extra_http_headers : Union[Dict[str, str], None]
-            An object containing additional HTTP headers to be sent with every request.
+            An object containing additional HTTP headers to be sent with every request. Defaults to none.
         http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
@@ -18973,7 +18988,7 @@ async def to_have_title(
         title_or_reg_exp : Union[Pattern[str], str]
             Expected title or RegExp.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -18998,7 +19013,7 @@ async def not_to_have_title(
         title_or_reg_exp : Union[Pattern[str], str]
             Expected title or RegExp.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19041,7 +19056,7 @@ async def to_have_url(
         url_or_reg_exp : Union[Pattern[str], str]
             Expected URL string or RegExp.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19066,7 +19081,7 @@ async def not_to_have_url(
         url_or_reg_exp : Union[Pattern[str], str]
             Expected URL string or RegExp.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19177,7 +19192,7 @@ async def to_contain_text(
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         ignore_case : Union[bool, None]
             Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
             expression flag if specified.
@@ -19218,7 +19233,7 @@ async def not_to_contain_text(
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         ignore_case : Union[bool, None]
             Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
             expression flag if specified.
@@ -19268,7 +19283,7 @@ async def to_have_attribute(
         value : Union[Pattern[str], str]
             Expected attribute value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19296,7 +19311,7 @@ async def not_to_have_attribute(
         value : Union[Pattern[str], str]
             Expected attribute value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19366,7 +19381,7 @@ async def to_have_class(
         expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19397,7 +19412,7 @@ async def not_to_have_class(
         expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19435,7 +19450,7 @@ async def to_have_count(
         count : int
             Expected count.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19455,7 +19470,7 @@ async def not_to_have_count(
         count : int
             Expected count.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19497,7 +19512,7 @@ async def to_have_css(
         value : Union[Pattern[str], str]
             CSS property value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19523,7 +19538,7 @@ async def not_to_have_css(
         value : Union[Pattern[str], str]
             CSS property value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19564,7 +19579,7 @@ async def to_have_id(
         id : Union[Pattern[str], str]
             Element id.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19587,7 +19602,7 @@ async def not_to_have_id(
         id : Union[Pattern[str], str]
             Element id.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19626,7 +19641,7 @@ async def to_have_js_property(
         value : Any
             Property value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19650,7 +19665,7 @@ async def not_to_have_js_property(
         value : Any
             Property value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19694,7 +19709,7 @@ async def to_have_value(
         value : Union[Pattern[str], str]
             Expected value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19717,7 +19732,7 @@ async def not_to_have_value(
         value : Union[Pattern[str], str]
             Expected value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19775,7 +19790,7 @@ async def to_have_values(
         values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
             Expected options currently selected.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19804,7 +19819,7 @@ async def not_to_have_values(
         values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
             Expected options currently selected.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19909,7 +19924,7 @@ async def to_have_text(
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         ignore_case : Union[bool, None]
             Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
             expression flag if specified.
@@ -19950,7 +19965,7 @@ async def not_to_have_text(
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         ignore_case : Union[bool, None]
             Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
             expression flag if specified.
@@ -19990,7 +20005,7 @@ async def to_be_attached(
         ----------
         attached : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20027,7 +20042,7 @@ async def to_be_checked(
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         checked : Union[bool, None]
         """
         __tracebackhide__ = True
@@ -20050,7 +20065,7 @@ async def not_to_be_attached(
         ----------
         attached : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20068,7 +20083,7 @@ async def not_to_be_checked(
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20104,7 +20119,7 @@ async def to_be_disabled(self, *, timeout: typing.Optional[float] = None) -> Non
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20122,7 +20137,7 @@ async def not_to_be_disabled(
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20160,7 +20175,7 @@ async def to_be_editable(
         ----------
         editable : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20182,7 +20197,7 @@ async def not_to_be_editable(
         ----------
         editable : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20214,7 +20229,7 @@ async def to_be_empty(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20230,7 +20245,7 @@ async def not_to_be_empty(self, *, timeout: typing.Optional[float] = None) -> No
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20268,7 +20283,7 @@ async def to_be_enabled(
         ----------
         enabled : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20290,7 +20305,7 @@ async def not_to_be_enabled(
         ----------
         enabled : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20323,7 +20338,7 @@ async def to_be_hidden(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20339,7 +20354,7 @@ async def not_to_be_hidden(self, *, timeout: typing.Optional[float] = None) -> N
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20372,7 +20387,7 @@ async def to_be_visible(
         ----------
         visible : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20394,7 +20409,7 @@ async def not_to_be_visible(
         ----------
         visible : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20426,7 +20441,7 @@ async def to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20444,7 +20459,7 @@ async def not_to_be_focused(
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20495,7 +20510,7 @@ async def to_be_in_viewport(
             The minimal ratio of the element to intersect viewport. If equals to `0`, then element should intersect viewport at
             any positive ratio. Defaults to `0`.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20517,7 +20532,7 @@ async def not_to_be_in_viewport(
         ----------
         ratio : Union[float, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index ce94063be..32d1e99e0 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -2799,7 +2799,8 @@ def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None
+        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask_color: typing.Optional[str] = None
     ) -> bytes:
         """ElementHandle.screenshot
 
@@ -2846,7 +2847,10 @@ def screenshot(
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+        mask_color : Union[str, None]
+            Specify the color of the overlay box for masked elements, in
+            [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
 
         Returns
         -------
@@ -2865,6 +2869,7 @@ def screenshot(
                     caret=caret,
                     scale=scale,
                     mask=mapping.to_impl(mask),
+                    mask_color=mask_color,
                 )
             )
         )
@@ -9967,7 +9972,8 @@ def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None
+        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask_color: typing.Optional[str] = None
     ) -> bytes:
         """Page.screenshot
 
@@ -10012,7 +10018,10 @@ def screenshot(
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+        mask_color : Union[str, None]
+            Specify the color of the overlay box for masked elements, in
+            [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
 
         Returns
         -------
@@ -10033,6 +10042,7 @@ def screenshot(
                     caret=caret,
                     scale=scale,
                     mask=mapping.to_impl(mask),
+                    mask_color=mask_color,
                 )
             )
         )
@@ -14107,23 +14117,23 @@ def new_context(
             Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
             [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
-            Toggles bypassing page's Content-Security-Policy.
+            Toggles bypassing page's Content-Security-Policy. Defaults to `false`.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
-            our [emulation guide](../emulation.md#locale--timezone).
+            `Accept-Language` request header value as well as number and date formatting rules. Defaults to the system default
+            locale. Learn more about emulation in our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
-            for a list of supported timezone IDs.
+            for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
-            more details.
+            more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
-            An object containing additional HTTP headers to be sent with every request.
+            An object containing additional HTTP headers to be sent with every request. Defaults to none.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
@@ -14155,7 +14165,7 @@ def new_context(
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
-            Network proxy settings to use with this context.
+            Network proxy settings to use with this context. Defaults to none.
 
             **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
             all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
@@ -14182,7 +14192,7 @@ def new_context(
             When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
             `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
             using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
-            corresponding URL. Examples:
+            corresponding URL. Unset by default. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
             - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
               `http://localhost:3000/foo/bar.html`
@@ -14191,8 +14201,8 @@ def new_context(
         strict_selectors : Union[bool, None]
             If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
             selectors that imply single target DOM element will throw when more than one element matches the selector. This
-            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
-            mode.
+            option does not affect any Locator APIs (Locators are always strict). Defaults to `false`. See `Locator` to learn
+            more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -14323,23 +14333,23 @@ def new_page(
             Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
             [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
-            Toggles bypassing page's Content-Security-Policy.
+            Toggles bypassing page's Content-Security-Policy. Defaults to `false`.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
-            our [emulation guide](../emulation.md#locale--timezone).
+            `Accept-Language` request header value as well as number and date formatting rules. Defaults to the system default
+            locale. Learn more about emulation in our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
-            for a list of supported timezone IDs.
+            for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
-            more details.
+            more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
-            An object containing additional HTTP headers to be sent with every request.
+            An object containing additional HTTP headers to be sent with every request. Defaults to none.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
@@ -14371,7 +14381,7 @@ def new_page(
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
-            Network proxy settings to use with this context.
+            Network proxy settings to use with this context. Defaults to none.
 
             **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
             all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
@@ -14398,7 +14408,7 @@ def new_page(
             When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
             `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
             using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
-            corresponding URL. Examples:
+            corresponding URL. Unset by default. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
             - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
               `http://localhost:3000/foo/bar.html`
@@ -14407,8 +14417,8 @@ def new_page(
         strict_selectors : Union[bool, None]
             If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
             selectors that imply single target DOM element will throw when more than one element matches the selector. This
-            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
-            mode.
+            option does not affect any Locator APIs (Locators are always strict). Defaults to `false`. See `Locator` to learn
+            more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -14874,23 +14884,23 @@ def launch_persistent_context(
             Whether or not to enable JavaScript in the context. Defaults to `true`. Learn more about
             [disabling JavaScript](../emulation.md#javascript-enabled).
         bypass_csp : Union[bool, None]
-            Toggles bypassing page's Content-Security-Policy.
+            Toggles bypassing page's Content-Security-Policy. Defaults to `false`.
         user_agent : Union[str, None]
             Specific user agent to use in this context.
         locale : Union[str, None]
             Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value,
-            `Accept-Language` request header value as well as number and date formatting rules. Learn more about emulation in
-            our [emulation guide](../emulation.md#locale--timezone).
+            `Accept-Language` request header value as well as number and date formatting rules. Defaults to the system default
+            locale. Learn more about emulation in our [emulation guide](../emulation.md#locale--timezone).
         timezone_id : Union[str, None]
             Changes the timezone of the context. See
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
-            for a list of supported timezone IDs.
+            for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
         permissions : Union[List[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
-            more details.
+            more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
-            An object containing additional HTTP headers to be sent with every request.
+            An object containing additional HTTP headers to be sent with every request. Defaults to none.
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
@@ -14942,7 +14952,7 @@ def launch_persistent_context(
             When using `page.goto()`, `page.route()`, `page.wait_for_url()`,
             `page.expect_request()`, or `page.expect_response()` it takes the base URL in consideration by
             using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the
-            corresponding URL. Examples:
+            corresponding URL. Unset by default. Examples:
             - baseURL: `http://localhost:3000` and navigating to `/bar.html` results in `http://localhost:3000/bar.html`
             - baseURL: `http://localhost:3000/foo/` and navigating to `./bar.html` results in
               `http://localhost:3000/foo/bar.html`
@@ -14951,8 +14961,8 @@ def launch_persistent_context(
         strict_selectors : Union[bool, None]
             If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on
             selectors that imply single target DOM element will throw when more than one element matches the selector. This
-            option does not affect any Locator APIs (Locators are always strict). See `Locator` to learn more about the strict
-            mode.
+            option does not affect any Locator APIs (Locators are always strict). Defaults to `false`. See `Locator` to learn
+            more about the strict mode.
         service_workers : Union["allow", "block", None]
             Whether to allow sites to register Service workers. Defaults to `'allow'`.
             - `'allow'`: [Service Workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) can be
@@ -15260,7 +15270,7 @@ def stop(self) -> None:
 
         >>> browser = playwright.chromium.launch()
         >>> page = browser.new_page()
-        >>> page.goto(\"http://whatsmyuseragent.org/\")
+        >>> page.goto(\"https://playwright.dev/\")
         >>> page.screenshot(path=\"example.png\")
         >>> browser.close()
 
@@ -15457,11 +15467,11 @@ def last(self) -> "Locator":
         **Usage**
 
         ```py
-        banana = await page.get_by_role(\"listitem\").last()
+        banana = await page.get_by_role(\"listitem\").last
         ```
 
         ```py
-        banana = page.get_by_role(\"listitem\").last()
+        banana = page.get_by_role(\"listitem\").last
         ```
 
         Returns
@@ -17486,7 +17496,8 @@ def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None
+        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask_color: typing.Optional[str] = None
     ) -> bytes:
         """Locator.screenshot
 
@@ -17557,7 +17568,10 @@ def screenshot(
             Defaults to `"device"`.
         mask : Union[List[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+        mask_color : Union[str, None]
+            Specify the color of the overlay box for masked elements, in
+            [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
 
         Returns
         -------
@@ -17576,6 +17590,7 @@ def screenshot(
                     caret=caret,
                     scale=scale,
                     mask=mapping.to_impl(mask),
+                    mask_color=mask_color,
                 )
             )
         )
@@ -19046,7 +19061,7 @@ def new_context(
             - baseURL: `http://localhost:3000/foo` (without trailing slash) and navigating to `./bar.html` results in
               `http://localhost:3000/bar.html`
         extra_http_headers : Union[Dict[str, str], None]
-            An object containing additional HTTP headers to be sent with every request.
+            An object containing additional HTTP headers to be sent with every request. Defaults to none.
         http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
@@ -19123,7 +19138,7 @@ def to_have_title(
         title_or_reg_exp : Union[Pattern[str], str]
             Expected title or RegExp.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19150,7 +19165,7 @@ def not_to_have_title(
         title_or_reg_exp : Union[Pattern[str], str]
             Expected title or RegExp.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19195,7 +19210,7 @@ def to_have_url(
         url_or_reg_exp : Union[Pattern[str], str]
             Expected URL string or RegExp.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19222,7 +19237,7 @@ def not_to_have_url(
         url_or_reg_exp : Union[Pattern[str], str]
             Expected URL string or RegExp.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19335,7 +19350,7 @@ def to_contain_text(
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         ignore_case : Union[bool, None]
             Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
             expression flag if specified.
@@ -19378,7 +19393,7 @@ def not_to_contain_text(
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         ignore_case : Union[bool, None]
             Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
             expression flag if specified.
@@ -19430,7 +19445,7 @@ def to_have_attribute(
         value : Union[Pattern[str], str]
             Expected attribute value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19460,7 +19475,7 @@ def not_to_have_attribute(
         value : Union[Pattern[str], str]
             Expected attribute value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19532,7 +19547,7 @@ def to_have_class(
         expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19565,7 +19580,7 @@ def not_to_have_class(
         expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19605,7 +19620,7 @@ def to_have_count(
         count : int
             Expected count.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19625,7 +19640,7 @@ def not_to_have_count(
         count : int
             Expected count.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19667,7 +19682,7 @@ def to_have_css(
         value : Union[Pattern[str], str]
             CSS property value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19695,7 +19710,7 @@ def not_to_have_css(
         value : Union[Pattern[str], str]
             CSS property value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19736,7 +19751,7 @@ def to_have_id(
         id : Union[Pattern[str], str]
             Element id.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19759,7 +19774,7 @@ def not_to_have_id(
         id : Union[Pattern[str], str]
             Element id.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19798,7 +19813,7 @@ def to_have_js_property(
         value : Any
             Property value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19824,7 +19839,7 @@ def not_to_have_js_property(
         value : Any
             Property value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19870,7 +19885,7 @@ def to_have_value(
         value : Union[Pattern[str], str]
             Expected value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19893,7 +19908,7 @@ def not_to_have_value(
         value : Union[Pattern[str], str]
             Expected value.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19951,7 +19966,7 @@ def to_have_values(
         values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
             Expected options currently selected.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -19982,7 +19997,7 @@ def not_to_have_values(
         values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
             Expected options currently selected.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20089,7 +20104,7 @@ def to_have_text(
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         ignore_case : Union[bool, None]
             Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
             expression flag if specified.
@@ -20132,7 +20147,7 @@ def not_to_have_text(
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         ignore_case : Union[bool, None]
             Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
             expression flag if specified.
@@ -20174,7 +20189,7 @@ def to_be_attached(
         ----------
         attached : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20213,7 +20228,7 @@ def to_be_checked(
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         checked : Union[bool, None]
         """
         __tracebackhide__ = True
@@ -20236,7 +20251,7 @@ def not_to_be_attached(
         ----------
         attached : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20254,7 +20269,7 @@ def not_to_be_checked(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20290,7 +20305,7 @@ def to_be_disabled(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20306,7 +20321,7 @@ def not_to_be_disabled(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20344,7 +20359,7 @@ def to_be_editable(
         ----------
         editable : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20368,7 +20383,7 @@ def not_to_be_editable(
         ----------
         editable : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20402,7 +20417,7 @@ def to_be_empty(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20418,7 +20433,7 @@ def not_to_be_empty(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20456,7 +20471,7 @@ def to_be_enabled(
         ----------
         enabled : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20478,7 +20493,7 @@ def not_to_be_enabled(
         ----------
         enabled : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20513,7 +20528,7 @@ def to_be_hidden(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20529,7 +20544,7 @@ def not_to_be_hidden(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20562,7 +20577,7 @@ def to_be_visible(
         ----------
         visible : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20584,7 +20599,7 @@ def not_to_be_visible(
         ----------
         visible : Union[bool, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20618,7 +20633,7 @@ def to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20634,7 +20649,7 @@ def not_to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None:
         Parameters
         ----------
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20685,7 +20700,7 @@ def to_be_in_viewport(
             The minimal ratio of the element to intersect viewport. If equals to `0`, then element should intersect viewport at
             any positive ratio. Defaults to `0`.
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
@@ -20707,7 +20722,7 @@ def not_to_be_in_viewport(
         ----------
         ratio : Union[float, None]
         timeout : Union[float, None]
-            Time to retry the assertion for.
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
         __tracebackhide__ = True
 
diff --git a/setup.py b/setup.py
index 93a9caa17..00fc2eb38 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.34.3"
+driver_version = "1.35.0-beta-1686247644000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/assets/input/fileupload-multi.html b/tests/assets/input/fileupload-multi.html
new file mode 100644
index 000000000..05dd5a223
--- /dev/null
+++ b/tests/assets/input/fileupload-multi.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>File upload test</title>
+  </head>
+  <body>
+    <form action="/upload" method="post" enctype="multipart/form-data">
+      <input type="file" multiple name="file1">
+      <input type="submit">
+    </form>
+  </body>
+</html>
diff --git a/tests/async/test_input.py b/tests/async/test_input.py
index 10248fa60..ead68ecb5 100644
--- a/tests/async/test_input.py
+++ b/tests/async/test_input.py
@@ -15,6 +15,7 @@
 import asyncio
 import os
 import re
+import shutil
 import sys
 
 import pytest
@@ -348,3 +349,32 @@ async def test_should_upload_large_file(page, server, tmp_path):
     )
     assert match.group("name") == b"file1"
     assert match.group("filename") == b"200MB.zip"
+
+
+@flaky
+async def test_should_upload_multiple_large_file(page: Page, server, tmp_path):
+    files_count = 10
+    await page.goto(server.PREFIX + "/input/fileupload-multi.html")
+    upload_file = tmp_path / "50MB_1.zip"
+    data = b"A" * 1024
+    with upload_file.open("wb") as f:
+        # 49 is close to the actual limit
+        for i in range(0, 49 * 1024):
+            f.write(data)
+    input = page.locator('input[type="file"]')
+    upload_files = [upload_file]
+    for i in range(2, files_count + 1):
+        dst_file = tmp_path / f"50MB_{i}.zip"
+        shutil.copy(upload_file, dst_file)
+        upload_files.append(dst_file)
+    async with page.expect_file_chooser() as fc_info:
+        await input.click()
+    file_chooser = await fc_info.value
+    await file_chooser.set_files(upload_files)
+    files_len = await page.evaluate(
+        'document.getElementsByTagName("input")[0].files.length'
+    )
+    assert file_chooser.is_multiple()
+    assert files_len == files_count
+    for path in upload_files:
+        path.unlink()

From f1c11fbd3000ee072b117ddebed9da1e0c2226b3 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 13 Jun 2023 09:34:43 +0200
Subject: [PATCH 080/438] chore(roll): roll Playwright to 1.35.0 (#1971)

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

diff --git a/setup.py b/setup.py
index 00fc2eb38..7d040e609 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.35.0-beta-1686247644000"
+driver_version = "1.35.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From f8c4548e737a23b960cc034c453bb2a019d78b57 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 16 Jun 2023 21:46:48 +0200
Subject: [PATCH 081/438] chore: improve expect.set_options timeout reset
 handling (#1981)

---
 playwright/async_api/__init__.py | 8 +++++---
 playwright/sync_api/__init__.py  | 8 +++++---
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index c09a5678d..e63e27b8d 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.py
@@ -18,7 +18,7 @@
 web automation that is ever-green, capable, reliable and fast.
 """
 
-from typing import Optional, Union, overload
+from typing import Any, Optional, Union, overload
 
 import playwright._impl._api_structures
 import playwright._impl._api_types
@@ -88,10 +88,12 @@ def async_playwright() -> PlaywrightContextManager:
 
 
 class Expect:
+    _unset: Any = object()
+
     def __init__(self) -> None:
         self._timeout: Optional[float] = None
 
-    def set_options(self, timeout: float = None) -> None:
+    def set_options(self, timeout: Optional[float] = _unset) -> None:
         """
         This method sets global `expect()` options.
 
@@ -101,7 +103,7 @@ def set_options(self, timeout: float = None) -> None:
         Returns:
             None
         """
-        if timeout is not None:
+        if timeout is not self._unset:
             self._timeout = timeout
 
     @overload
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index 55351b658..8553aaf2f 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -18,7 +18,7 @@
 web automation that is ever-green, capable, reliable and fast.
 """
 
-from typing import Optional, Union, overload
+from typing import Any, Optional, Union, overload
 
 import playwright._impl._api_structures
 import playwright._impl._api_types
@@ -88,10 +88,12 @@ def sync_playwright() -> PlaywrightContextManager:
 
 
 class Expect:
+    _unset: Any = object()
+
     def __init__(self) -> None:
         self._timeout: Optional[float] = None
 
-    def set_options(self, timeout: float = None) -> None:
+    def set_options(self, timeout: Optional[float] = _unset) -> None:
         """
         This method sets global `expect()` options.
 
@@ -101,7 +103,7 @@ def set_options(self, timeout: float = None) -> None:
         Returns:
             None
         """
-        if timeout is not None:
+        if timeout is not self._unset:
             self._timeout = timeout
 
     @overload

From 062059604022201273772d4ad312fc8e62ede5ea Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 16 Jun 2023 21:50:23 +0200
Subject: [PATCH 082/438] chore: drop Python 3.7 (#1980)

---
 .github/ISSUE_TEMPLATE/bug.md                 |   2 +-
 .github/workflows/ci.yml                      |  36 +---
 playwright/_impl/_driver.py                   |  17 --
 playwright/sync_api/_context_manager.py       |  15 --
 .../sync_api/_py37ThreadedChildWatcher.py     | 166 ------------------
 pyproject.toml                                |   4 +-
 setup.py                                      |   3 +-
 7 files changed, 5 insertions(+), 238 deletions(-)
 delete mode 100644 playwright/sync_api/_py37ThreadedChildWatcher.py

diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md
index 6580e2a32..52ebde9e5 100644
--- a/.github/ISSUE_TEMPLATE/bug.md
+++ b/.github/ISSUE_TEMPLATE/bug.md
@@ -10,7 +10,7 @@ assignees: ''
 **Context:**
 - Playwright Version: [what Playwright version do you use?]
 - Operating System: [e.g. Windows, Linux or Mac]
-- Python version: [e.g. 3.7, 3.9]
+- Python version: [e.g. 3.8, 3.9]
 - Browser: [e.g. All, Chromium, Firefox, WebKit]
 - Extra: [any specific details about your environment]
 
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index f55451700..48c8a7521 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -43,34 +43,13 @@ jobs:
   build:
     name: Build
     timeout-minutes: 45
-    env:
-      DEBUG: pw:*
-      DEBUG_FILE: pw-log.txt
     strategy:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: [3.7, 3.8]
+        python-version: [3.8, 3.9]
         browser: [chromium, firefox, webkit]
         include:
-        - os: ubuntu-latest
-          python-version: 3.9
-          browser: chromium
-        - os: windows-latest
-          python-version: 3.9
-          browser: chromium
-        - os: macos-latest
-          python-version: 3.9
-          browser: chromium
-        - os: macos-11.0
-          python-version: 3.9
-          browser: chromium
-        - os: macos-11.0
-          python-version: 3.9
-          browser: firefox
-        - os: macos-11.0
-          python-version: 3.9
-          browser: webkit
         - os: ubuntu-latest
           python-version: '3.10'
           browser: chromium
@@ -129,18 +108,10 @@ jobs:
     - name: Test Async API
       if: matrix.os == 'ubuntu-latest'
       run: xvfb-run pytest tests/async --browser=${{ matrix.browser }} --timeout 90
-    - uses: actions/upload-artifact@v3
-      if: failure()
-      with:
-        name: ${{ matrix.browser }}-${{ matrix.os }}-${{ matrix.python-version }}
-        path: pw-log.txt
 
   test-stable:
     name: Stable
     timeout-minutes: 45
-    env:
-      DEBUG: pw:*
-      DEBUG_FILE: pw-log.txt
     strategy:
       fail-fast: false
       matrix:
@@ -179,11 +150,6 @@ jobs:
     - name: Test Async API
       if: matrix.os == 'ubuntu-latest'
       run: xvfb-run pytest tests/async --browser=chromium --browser-channel=${{ matrix.browser-channel }} --timeout 90
-    - uses: actions/upload-artifact@v3
-      if: failure()
-      with:
-        name: ${{ matrix.browser-channel }}-${{ matrix.os }}
-        path: pw-log.txt
 
   build-conda:
     name: Conda Build
diff --git a/playwright/_impl/_driver.py b/playwright/_impl/_driver.py
index f3b911f48..d8004d296 100644
--- a/playwright/_impl/_driver.py
+++ b/playwright/_impl/_driver.py
@@ -12,7 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import asyncio
 import inspect
 import os
 import sys
@@ -30,22 +29,6 @@ def compute_driver_executable() -> Path:
     return package_path / "driver" / "playwright.sh"
 
 
-if sys.version_info.major == 3 and sys.version_info.minor == 7:
-    if sys.platform == "win32":
-        # Use ProactorEventLoop in 3.7, which is default in 3.8
-        asyncio.set_event_loop_policy(asyncio.WindowsProactorEventLoopPolicy())
-    else:
-        # Prevent Python 3.7 from throwing on Linux:
-        # RuntimeError: Cannot add child handler, the child watcher does not have a loop attached
-        asyncio.get_event_loop()
-        try:
-            asyncio.get_child_watcher()
-        except Exception:
-            # uvloop does not support child watcher
-            # see https://github.com/microsoft/playwright-python/issues/582
-            pass
-
-
 def get_driver_env() -> dict:
     env = os.environ.copy()
     env["PW_LANG_NAME"] = "python"
diff --git a/playwright/sync_api/_context_manager.py b/playwright/sync_api/_context_manager.py
index 4249a1fa1..9813f8920 100644
--- a/playwright/sync_api/_context_manager.py
+++ b/playwright/sync_api/_context_manager.py
@@ -13,7 +13,6 @@
 # limitations under the License.
 
 import asyncio
-import sys
 from typing import TYPE_CHECKING, Any, Optional, cast
 
 from greenlet import greenlet
@@ -50,20 +49,6 @@ def __enter__(self) -> SyncPlaywright:
 Please use the Async API instead."""
             )
 
-        # In Python 3.7, asyncio.Process.wait() hangs because it does not use ThreadedChildWatcher
-        # which is used in Python 3.8+. This is unix specific and also takes care about
-        # cleaning up zombie processes. See https://bugs.python.org/issue35621
-        if (
-            sys.version_info[0] == 3
-            and sys.version_info[1] == 7
-            and sys.platform != "win32"
-            and isinstance(asyncio.get_child_watcher(), asyncio.SafeChildWatcher)
-        ):
-            from ._py37ThreadedChildWatcher import ThreadedChildWatcher  # type: ignore
-
-            self._watcher = ThreadedChildWatcher()
-            asyncio.set_child_watcher(self._watcher)  # type: ignore
-
         # Create a new fiber for the protocol dispatcher. It will be pumping events
         # until the end of times. We will pass control to that fiber every time we
         # block while waiting for a response.
diff --git a/playwright/sync_api/_py37ThreadedChildWatcher.py b/playwright/sync_api/_py37ThreadedChildWatcher.py
deleted file mode 100644
index cd121267f..000000000
--- a/playwright/sync_api/_py37ThreadedChildWatcher.py
+++ /dev/null
@@ -1,166 +0,0 @@
-# PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
-# --------------------------------------------
-#
-# 1. This LICENSE AGREEMENT is between the Python Software Foundation
-# ("PSF"), and the Individual or Organization ("Licensee") accessing and
-# otherwise using this software ("Python") in source or binary form and
-# its associated documentation.
-#
-# 2. Subject to the terms and conditions of this License Agreement, PSF hereby
-# grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce,
-# analyze, test, perform and/or display publicly, prepare derivative works,
-# distribute, and otherwise use Python alone or in any derivative version,
-# provided, however, that PSF's License Agreement and PSF's notice of copyright,
-# i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
-# 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Python Software Foundation;
-# All Rights Reserved" are retained in Python alone or in any derivative version
-# prepared by Licensee.
-#
-# 3. In the event Licensee prepares a derivative work that is based on
-# or incorporates Python or any part thereof, and wants to make
-# the derivative work available to others as provided herein, then
-# Licensee hereby agrees to include in any such work a brief summary of
-# the changes made to Python.
-#
-# 4. PSF is making Python available to Licensee on an "AS IS"
-# basis.  PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
-# IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND
-# DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
-# FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT
-# INFRINGE ANY THIRD PARTY RIGHTS.
-#
-# 5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
-# FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
-# A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON,
-# OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
-#
-# 6. This License Agreement will automatically terminate upon a material
-# breach of its terms and conditions.
-#
-# 7. Nothing in this License Agreement shall be deemed to create any
-# relationship of agency, partnership, or joint venture between PSF and
-# Licensee.  This License Agreement does not grant permission to use PSF
-# trademarks or trade name in a trademark sense to endorse or promote
-# products or services of Licensee, or any third party.
-#
-# 8. By copying, installing or otherwise using Python, Licensee
-# agrees to be bound by the terms and conditions of this License
-# Agreement.
-#
-# type: ignore
-
-import itertools
-import os
-import threading
-import warnings
-from asyncio import AbstractChildWatcher, events
-from asyncio.log import logger
-
-
-class ThreadedChildWatcher(AbstractChildWatcher):
-    """Threaded child watcher implementation.
-    The watcher uses a thread per process
-    for waiting for the process finish.
-    It doesn't require subscription on POSIX signal
-    but a thread creation is not free.
-    The watcher has O(1) complexity, its performance doesn't depend
-    on amount of spawn processes.
-    """
-
-    def __init__(self):
-        self._pid_counter = itertools.count(0)
-        self._threads = {}
-
-    def is_active(self):
-        return True
-
-    def close(self):
-        self._join_threads()
-
-    def _join_threads(self):
-        """Internal: Join all non-daemon threads"""
-        threads = [
-            thread
-            for thread in list(self._threads.values())
-            if thread.is_alive() and not thread.daemon
-        ]
-        for thread in threads:
-            thread.join()
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        pass
-
-    def __del__(self, _warn=warnings.warn):
-        threads = [
-            thread for thread in list(self._threads.values()) if thread.is_alive()
-        ]
-        if threads:
-            _warn(
-                f"{self.__class__} has registered but not finished child processes",
-                ResourceWarning,
-                source=self,
-            )
-
-    def add_child_handler(self, pid, callback, *args):
-        loop = events.get_running_loop()
-        thread = threading.Thread(
-            target=self._do_waitpid,
-            name=f"waitpid-{next(self._pid_counter)}",
-            args=(loop, pid, callback, args),
-            daemon=True,
-        )
-        self._threads[pid] = thread
-        thread.start()
-
-    def remove_child_handler(self, pid):
-        # asyncio never calls remove_child_handler() !!!
-        # The method is no-op but is implemented because
-        # abstract base classes requires it
-        return True
-
-    def attach_loop(self, loop):
-        pass
-
-    def _do_waitpid(self, loop, expected_pid, callback, args):
-        assert expected_pid > 0
-
-        try:
-            pid, status = os.waitpid(expected_pid, 0)
-        except ChildProcessError:
-            # The child process is already reaped
-            # (may happen if waitpid() is called elsewhere).
-            pid = expected_pid
-            returncode = 255
-            logger.warning(
-                "Unknown child process pid %d, will report returncode 255", pid
-            )
-        else:
-            returncode = _compute_returncode(status)
-            if loop.get_debug():
-                logger.debug(
-                    "process %s exited with returncode %s", expected_pid, returncode
-                )
-
-        if loop.is_closed():
-            logger.warning("Loop %r that handles pid %r is closed", loop, pid)
-        else:
-            loop.call_soon_threadsafe(callback, pid, returncode, *args)
-
-        self._threads.pop(expected_pid)
-
-
-def _compute_returncode(status):
-    if os.WIFSIGNALED(status):
-        # The child process died because of a signal.
-        return -os.WTERMSIG(status)
-    elif os.WIFEXITED(status):
-        # The child process exited (e.g sys.exit()).
-        return os.WEXITSTATUS(status)
-    else:
-        # The child exited, but we don't understand its status.
-        # This shouldn't happen, but if it does, let's just
-        # return that status; perhaps that helps debug it.
-        return status
diff --git a/pyproject.toml b/pyproject.toml
index 1a2ac2e51..2c8d76843 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -15,7 +15,7 @@ asyncio_mode = "auto"
 
 [tool.mypy]
 ignore_missing_imports = true
-python_version = "3.7"
+python_version = "3.8"
 warn_unused_ignores = false
 warn_redundant_casts = true
 warn_unused_configs = true
@@ -32,7 +32,7 @@ profile = "black"
 [tool.pyright]
 include = ["playwright", "tests/sync"]
 ignore = ["tests/async/", "scripts/", "examples/"]
-pythonVersion = "3.7"
+pythonVersion = "3.8"
 reportMissingImports = false
 reportTypedDictNotRequiredAccess = false
 reportCallInDefaultInitializer = true
diff --git a/setup.py b/setup.py
index 7d040e609..02f705604 100644
--- a/setup.py
+++ b/setup.py
@@ -221,7 +221,6 @@ def _download_and_extract_local_driver(
         "Topic :: Internet :: WWW/HTTP :: Browsers",
         "Intended Audience :: Developers",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.7",
         "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
@@ -229,7 +228,7 @@ def _download_and_extract_local_driver(
         "License :: OSI Approved :: Apache Software License",
         "Operating System :: OS Independent",
     ],
-    python_requires=">=3.7",
+    python_requires=">=3.8",
     cmdclass={"bdist_wheel": PlaywrightBDistWheelCommand},
     use_scm_version={
         "version_scheme": "post-release",

From 52e66dec35e01678b664f75b45a4735c9ae71d1f Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 10 Jul 2023 22:36:12 +0200
Subject: [PATCH 083/438] chore: hide Batch window on win32 (#2004)

---
 playwright/_impl/_transport.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index 5565c62b7..3c9f96be0 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -16,6 +16,7 @@
 import io
 import json
 import os
+import subprocess
 import sys
 from abc import ABC, abstractmethod
 from pathlib import Path
@@ -113,6 +114,12 @@ async def connect(self) -> None:
             if getattr(sys, "frozen", False):
                 env.setdefault("PLAYWRIGHT_BROWSERS_PATH", "0")
 
+            startupinfo = None
+            if sys.platform == "win32":
+                startupinfo = subprocess.STARTUPINFO()
+                startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
+                startupinfo.wShowWindow = subprocess.SW_HIDE
+
             self._proc = await asyncio.create_subprocess_exec(
                 str(self._driver_executable),
                 "run-driver",
@@ -121,6 +128,7 @@ async def connect(self) -> None:
                 stderr=_get_stderr_fileno(),
                 limit=32768,
                 env=env,
+                startupinfo=startupinfo,
             )
         except Exception as exc:
             self.on_error_future.set_exception(exc)

From 42a3db2762bab169a3337a33076cbf1c31c5f2cb Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 13 Jul 2023 13:31:38 +0200
Subject: [PATCH 084/438] chore(roll): roll Playwright to v1.36.0 (#2012)

---
 README.md                          |  6 +--
 playwright/_impl/_js_handle.py     |  3 ++
 playwright/async_api/_generated.py | 79 ++++++++++++++++--------------
 playwright/sync_api/_generated.py  | 79 ++++++++++++++++--------------
 setup.py                           |  2 +-
 tests/async/test_evaluate.py       |  7 ++-
 6 files changed, 95 insertions(+), 81 deletions(-)

diff --git a/README.md b/README.md
index 59117f718..2e3f456f3 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 -->115.0.5790.24<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->113.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->115.0.5790.75<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| WebKit <!-- GEN:webkit-version -->17.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->115.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 51e1ee18a..b23b61ced 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -192,6 +192,9 @@ def parse_value(value: Any, refs: Optional[Dict[int, Any]] = None) -> Any:
         if "u" in value:
             return urlparse(value["u"])
 
+        if "bi" in value:
+            return int(value["bi"])
+
         if "a" in value:
             a: List = []
             refs[value["id"]] = a
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 6b6c9ffbd..f73b91c31 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -896,7 +896,7 @@ async def handle(route, request):
             # override headers
             headers = {
                 **request.headers,
-                \"foo\": \"foo-value\" # set \"foo\" header
+                \"foo\": \"foo-value\", # set \"foo\" header
                 \"bar\": None # remove \"bar\" header
             }
             await route.fallback(headers=headers)
@@ -909,7 +909,7 @@ def handle(route, request):
             # override headers
             headers = {
                 **request.headers,
-                \"foo\": \"foo-value\" # set \"foo\" header
+                \"foo\": \"foo-value\", # set \"foo\" header
                 \"bar\": None # remove \"bar\" header
             }
             route.fallback(headers=headers)
@@ -958,7 +958,7 @@ async def handle(route, request):
             # override headers
             headers = {
                 **request.headers,
-                \"foo\": \"foo-value\" # set \"foo\" header
+                \"foo\": \"foo-value\", # set \"foo\" header
                 \"bar\": None # remove \"bar\" header
             }
             await route.continue_(headers=headers)
@@ -971,7 +971,7 @@ def handle(route, request):
             # override headers
             headers = {
                 **request.headers,
-                \"foo\": \"foo-value\" # set \"foo\" header
+                \"foo\": \"foo-value\", # set \"foo\" header
                 \"bar\": None # remove \"bar\" header
             }
             route.continue_(headers=headers)
@@ -1650,7 +1650,7 @@ async def get_properties(self) -> typing.Dict[str, "JSHandle"]:
         **Usage**
 
         ```py
-        handle = await page.evaluate_handle(\"({window, document})\")
+        handle = await page.evaluate_handle(\"({ window, document })\")
         properties = await handle.get_properties()
         window_handle = properties.get(\"window\")
         document_handle = properties.get(\"document\")
@@ -1658,7 +1658,7 @@ async def get_properties(self) -> typing.Dict[str, "JSHandle"]:
         ```
 
         ```py
-        handle = page.evaluate_handle(\"({window, document})\")
+        handle = page.evaluate_handle(\"({ window, document })\")
         properties = handle.get_properties()
         window_handle = properties.get(\"window\")
         document_handle = properties.get(\"document\")
@@ -2896,13 +2896,13 @@ async def eval_on_selector(
         ```py
         tweet_handle = await page.query_selector(\".tweet\")
         assert await tweet_handle.eval_on_selector(\".like\", \"node => node.innerText\") == \"100\"
-        assert await tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") = \"10\"
+        assert await tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") == \"10\"
         ```
 
         ```py
         tweet_handle = page.query_selector(\".tweet\")
         assert tweet_handle.eval_on_selector(\".like\", \"node => node.innerText\") == \"100\"
-        assert tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") = \"10\"
+        assert tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") == \"10\"
         ```
 
         Parameters
@@ -3124,11 +3124,11 @@ async def snapshot(
 
         ```py
         def find_focused_node(node):
-            if (node.get(\"focused\"))
+            if node.get(\"focused\"):
                 return node
             for child in (node.get(\"children\") or []):
                 found_node = find_focused_node(child)
-                if (found_node)
+                if found_node:
                     return found_node
             return None
 
@@ -3140,11 +3140,11 @@ def find_focused_node(node):
 
         ```py
         def find_focused_node(node):
-            if (node.get(\"focused\"))
+            if node.get(\"focused\"):
                 return node
             for child in (node.get(\"children\") or []):
                 found_node = find_focused_node(child)
-                if (found_node)
+                if found_node:
                     return found_node
             return None
 
@@ -7396,6 +7396,7 @@ def on(
             # or while waiting for an event.
             await page.wait_for_event(\"popup\")
         except Error as e:
+            pass
             # when the page crashes, exception message contains \"crash\".
         ```
 
@@ -7406,6 +7407,7 @@ def on(
             # or while waiting for an event.
             page.wait_for_event(\"popup\")
         except Error as e:
+            pass
             # when the page crashes, exception message contains \"crash\".
         ```"""
 
@@ -7698,6 +7700,7 @@ def once(
             # or while waiting for an event.
             await page.wait_for_event(\"popup\")
         except Error as e:
+            pass
             # when the page crashes, exception message contains \"crash\".
         ```
 
@@ -7708,6 +7711,7 @@ def once(
             # or while waiting for an event.
             page.wait_for_event(\"popup\")
         except Error as e:
+            pass
             # when the page crashes, exception message contains \"crash\".
         ```"""
 
@@ -9765,18 +9769,18 @@ async def route(
 
         ```py
         def handle_route(route):
-          if (\"my-string\" in route.request.post_data)
+          if (\"my-string\" in route.request.post_data):
             route.fulfill(body=\"mocked-data\")
-          else
+          else:
             route.continue_()
         await page.route(\"/api/**\", handle_route)
         ```
 
         ```py
         def handle_route(route):
-          if (\"my-string\" in route.request.post_data)
+          if (\"my-string\" in route.request.post_data):
             route.fulfill(body=\"mocked-data\")
-          else
+          else:
             route.continue_()
         page.route(\"/api/**\", handle_route)
         ```
@@ -13502,18 +13506,18 @@ async def route(
 
         ```py
         def handle_route(route):
-          if (\"my-string\" in route.request.post_data)
+          if (\"my-string\" in route.request.post_data):
             route.fulfill(body=\"mocked-data\")
-          else
+          else:
             route.continue_()
         await context.route(\"/api/**\", handle_route)
         ```
 
         ```py
         def handle_route(route):
-          if (\"my-string\" in route.request.post_data)
+          if (\"my-string\" in route.request.post_data):
             route.fulfill(body=\"mocked-data\")
-          else
+          else:
             route.continue_()
         context.route(\"/api/**\", handle_route)
         ```
@@ -15188,17 +15192,17 @@ async def stop(self) -> None:
         in REPL applications.
 
         ```py
-        >>> from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright
 
-        >>> playwright = sync_playwright().start()
+        playwright = sync_playwright().start()
 
-        >>> browser = playwright.chromium.launch()
-        >>> page = browser.new_page()
-        >>> page.goto(\"https://playwright.dev/\")
-        >>> page.screenshot(path=\"example.png\")
-        >>> browser.close()
+        browser = playwright.chromium.launch()
+        page = browser.new_page()
+        page.goto(\"https://playwright.dev/\")
+        page.screenshot(path=\"example.png\")
+        browser.close()
 
-        >>> playwright.stop()
+        playwright.stop()
         ```
         """
 
@@ -16681,19 +16685,18 @@ def filter(
         ```py
         row_locator = page.locator(\"tr\")
         # ...
-        await row_locator
-            .filter(has_text=\"text in column 1\")
-            .filter(has=page.get_by_role(\"button\", name=\"column 2 button\"))
-            .screenshot()
+        await row_locator.filter(has_text=\"text in column 1\").filter(
+            has=page.get_by_role(\"button\", name=\"column 2 button\")
+        ).screenshot()
+
         ```
 
         ```py
         row_locator = page.locator(\"tr\")
         # ...
-        row_locator
-            .filter(has_text=\"text in column 1\")
-            .filter(has=page.get_by_role(\"button\", name=\"column 2 button\"))
-            .screenshot()
+        row_locator.filter(has_text=\"text in column 1\").filter(
+            has=page.get_by_role(\"button\", name=\"column 2 button\")
+        ).screenshot()
         ```
 
         Parameters
@@ -16744,7 +16747,7 @@ def or_(self, locator: "Locator") -> "Locator":
         new_email = page.get_by_role(\"button\", name=\"New\")
         dialog = page.get_by_text(\"Confirm security settings\")
         await expect(new_email.or_(dialog)).to_be_visible()
-        if (await dialog.is_visible())
+        if (await dialog.is_visible()):
           await page.get_by_role(\"button\", name=\"Dismiss\").click()
         await new_email.click()
         ```
@@ -16753,7 +16756,7 @@ def or_(self, locator: "Locator") -> "Locator":
         new_email = page.get_by_role(\"button\", name=\"New\")
         dialog = page.get_by_text(\"Confirm security settings\")
         expect(new_email.or_(dialog)).to_be_visible()
-        if (dialog.is_visible())
+        if (dialog.is_visible()):
           page.get_by_role(\"button\", name=\"Dismiss\").click()
         new_email.click()
         ```
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 32d1e99e0..f1b41ca37 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -908,7 +908,7 @@ async def handle(route, request):
             # override headers
             headers = {
                 **request.headers,
-                \"foo\": \"foo-value\" # set \"foo\" header
+                \"foo\": \"foo-value\", # set \"foo\" header
                 \"bar\": None # remove \"bar\" header
             }
             await route.fallback(headers=headers)
@@ -921,7 +921,7 @@ def handle(route, request):
             # override headers
             headers = {
                 **request.headers,
-                \"foo\": \"foo-value\" # set \"foo\" header
+                \"foo\": \"foo-value\", # set \"foo\" header
                 \"bar\": None # remove \"bar\" header
             }
             route.fallback(headers=headers)
@@ -972,7 +972,7 @@ async def handle(route, request):
             # override headers
             headers = {
                 **request.headers,
-                \"foo\": \"foo-value\" # set \"foo\" header
+                \"foo\": \"foo-value\", # set \"foo\" header
                 \"bar\": None # remove \"bar\" header
             }
             await route.continue_(headers=headers)
@@ -985,7 +985,7 @@ def handle(route, request):
             # override headers
             headers = {
                 **request.headers,
-                \"foo\": \"foo-value\" # set \"foo\" header
+                \"foo\": \"foo-value\", # set \"foo\" header
                 \"bar\": None # remove \"bar\" header
             }
             route.continue_(headers=headers)
@@ -1654,7 +1654,7 @@ def get_properties(self) -> typing.Dict[str, "JSHandle"]:
         **Usage**
 
         ```py
-        handle = await page.evaluate_handle(\"({window, document})\")
+        handle = await page.evaluate_handle(\"({ window, document })\")
         properties = await handle.get_properties()
         window_handle = properties.get(\"window\")
         document_handle = properties.get(\"document\")
@@ -1662,7 +1662,7 @@ def get_properties(self) -> typing.Dict[str, "JSHandle"]:
         ```
 
         ```py
-        handle = page.evaluate_handle(\"({window, document})\")
+        handle = page.evaluate_handle(\"({ window, document })\")
         properties = handle.get_properties()
         window_handle = properties.get(\"window\")
         document_handle = properties.get(\"document\")
@@ -2932,13 +2932,13 @@ def eval_on_selector(
         ```py
         tweet_handle = await page.query_selector(\".tweet\")
         assert await tweet_handle.eval_on_selector(\".like\", \"node => node.innerText\") == \"100\"
-        assert await tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") = \"10\"
+        assert await tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") == \"10\"
         ```
 
         ```py
         tweet_handle = page.query_selector(\".tweet\")
         assert tweet_handle.eval_on_selector(\".like\", \"node => node.innerText\") == \"100\"
-        assert tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") = \"10\"
+        assert tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") == \"10\"
         ```
 
         Parameters
@@ -3168,11 +3168,11 @@ def snapshot(
 
         ```py
         def find_focused_node(node):
-            if (node.get(\"focused\"))
+            if node.get(\"focused\"):
                 return node
             for child in (node.get(\"children\") or []):
                 found_node = find_focused_node(child)
-                if (found_node)
+                if found_node:
                     return found_node
             return None
 
@@ -3184,11 +3184,11 @@ def find_focused_node(node):
 
         ```py
         def find_focused_node(node):
-            if (node.get(\"focused\"))
+            if node.get(\"focused\"):
                 return node
             for child in (node.get(\"children\") or []):
                 found_node = find_focused_node(child)
-                if (found_node)
+                if found_node:
                     return found_node
             return None
 
@@ -7504,6 +7504,7 @@ def on(self, event: Literal["crash"], f: typing.Callable[["Page"], "None"]) -> N
             # or while waiting for an event.
             await page.wait_for_event(\"popup\")
         except Error as e:
+            pass
             # when the page crashes, exception message contains \"crash\".
         ```
 
@@ -7514,6 +7515,7 @@ def on(self, event: Literal["crash"], f: typing.Callable[["Page"], "None"]) -> N
             # or while waiting for an event.
             page.wait_for_event(\"popup\")
         except Error as e:
+            pass
             # when the page crashes, exception message contains \"crash\".
         ```"""
 
@@ -7756,6 +7758,7 @@ def once(
             # or while waiting for an event.
             await page.wait_for_event(\"popup\")
         except Error as e:
+            pass
             # when the page crashes, exception message contains \"crash\".
         ```
 
@@ -7766,6 +7769,7 @@ def once(
             # or while waiting for an event.
             page.wait_for_event(\"popup\")
         except Error as e:
+            pass
             # when the page crashes, exception message contains \"crash\".
         ```"""
 
@@ -9827,18 +9831,18 @@ def route(
 
         ```py
         def handle_route(route):
-          if (\"my-string\" in route.request.post_data)
+          if (\"my-string\" in route.request.post_data):
             route.fulfill(body=\"mocked-data\")
-          else
+          else:
             route.continue_()
         await page.route(\"/api/**\", handle_route)
         ```
 
         ```py
         def handle_route(route):
-          if (\"my-string\" in route.request.post_data)
+          if (\"my-string\" in route.request.post_data):
             route.fulfill(body=\"mocked-data\")
-          else
+          else:
             route.continue_()
         page.route(\"/api/**\", handle_route)
         ```
@@ -13558,18 +13562,18 @@ def route(
 
         ```py
         def handle_route(route):
-          if (\"my-string\" in route.request.post_data)
+          if (\"my-string\" in route.request.post_data):
             route.fulfill(body=\"mocked-data\")
-          else
+          else:
             route.continue_()
         await context.route(\"/api/**\", handle_route)
         ```
 
         ```py
         def handle_route(route):
-          if (\"my-string\" in route.request.post_data)
+          if (\"my-string\" in route.request.post_data):
             route.fulfill(body=\"mocked-data\")
-          else
+          else:
             route.continue_()
         context.route(\"/api/**\", handle_route)
         ```
@@ -15264,17 +15268,17 @@ def stop(self) -> None:
         in REPL applications.
 
         ```py
-        >>> from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright
 
-        >>> playwright = sync_playwright().start()
+        playwright = sync_playwright().start()
 
-        >>> browser = playwright.chromium.launch()
-        >>> page = browser.new_page()
-        >>> page.goto(\"https://playwright.dev/\")
-        >>> page.screenshot(path=\"example.png\")
-        >>> browser.close()
+        browser = playwright.chromium.launch()
+        page = browser.new_page()
+        page.goto(\"https://playwright.dev/\")
+        page.screenshot(path=\"example.png\")
+        browser.close()
 
-        >>> playwright.stop()
+        playwright.stop()
         ```
         """
 
@@ -16779,19 +16783,18 @@ def filter(
         ```py
         row_locator = page.locator(\"tr\")
         # ...
-        await row_locator
-            .filter(has_text=\"text in column 1\")
-            .filter(has=page.get_by_role(\"button\", name=\"column 2 button\"))
-            .screenshot()
+        await row_locator.filter(has_text=\"text in column 1\").filter(
+            has=page.get_by_role(\"button\", name=\"column 2 button\")
+        ).screenshot()
+
         ```
 
         ```py
         row_locator = page.locator(\"tr\")
         # ...
-        row_locator
-            .filter(has_text=\"text in column 1\")
-            .filter(has=page.get_by_role(\"button\", name=\"column 2 button\"))
-            .screenshot()
+        row_locator.filter(has_text=\"text in column 1\").filter(
+            has=page.get_by_role(\"button\", name=\"column 2 button\")
+        ).screenshot()
         ```
 
         Parameters
@@ -16842,7 +16845,7 @@ def or_(self, locator: "Locator") -> "Locator":
         new_email = page.get_by_role(\"button\", name=\"New\")
         dialog = page.get_by_text(\"Confirm security settings\")
         await expect(new_email.or_(dialog)).to_be_visible()
-        if (await dialog.is_visible())
+        if (await dialog.is_visible()):
           await page.get_by_role(\"button\", name=\"Dismiss\").click()
         await new_email.click()
         ```
@@ -16851,7 +16854,7 @@ def or_(self, locator: "Locator") -> "Locator":
         new_email = page.get_by_role(\"button\", name=\"New\")
         dialog = page.get_by_text(\"Confirm security settings\")
         expect(new_email.or_(dialog)).to_be_visible()
-        if (dialog.is_visible())
+        if (dialog.is_visible()):
           page.get_by_role(\"button\", name=\"Dismiss\").click()
         new_email.click()
         ```
diff --git a/setup.py b/setup.py
index 02f705604..79ab19e30 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.35.0"
+driver_version = "1.36.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_evaluate.py b/tests/async/test_evaluate.py
index 6ef57cc71..95c528d33 100644
--- a/tests/async/test_evaluate.py
+++ b/tests/async/test_evaluate.py
@@ -16,7 +16,7 @@
 from datetime import datetime
 from urllib.parse import ParseResult, urlparse
 
-from playwright.async_api import Error
+from playwright.async_api import Error, Page
 
 
 async def test_evaluate_work(page):
@@ -64,6 +64,11 @@ async def test_evaluate_transfer_arrays(page):
     assert result == [1, 2, 3]
 
 
+async def test_evaluate_transfer_bigint(page: Page) -> None:
+    assert await page.evaluate("() => 42n") == 42
+    assert await page.evaluate("a => a", 17) == 17
+
+
 async def test_evaluate_return_undefined_for_objects_with_symbols(page):
     assert await page.evaluate('[Symbol("foo4")]') == [None]
     assert (

From 59da1783e6719e5b4abed2e8562973e9920542ed Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 26 Jul 2023 17:35:34 +0200
Subject: [PATCH 085/438] chore: update GH issue templates (#2024)

chore: update issue templates
---
 .github/ISSUE_TEMPLATE/bug.md        | 47 +++++++++++++++++++++-------
 .github/ISSUE_TEMPLATE/config.yml    |  4 +--
 .github/ISSUE_TEMPLATE/question.yml  | 11 -------
 .github/ISSUE_TEMPLATE/regression.md | 32 +++++++++++++++++++
 4 files changed, 70 insertions(+), 24 deletions(-)
 delete mode 100644 .github/ISSUE_TEMPLATE/question.yml
 create mode 100644 .github/ISSUE_TEMPLATE/regression.md

diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md
index 52ebde9e5..b74140629 100644
--- a/.github/ISSUE_TEMPLATE/bug.md
+++ b/.github/ISSUE_TEMPLATE/bug.md
@@ -7,17 +7,34 @@ assignees: ''
 
 ---
 
-**Context:**
-- Playwright Version: [what Playwright version do you use?]
-- Operating System: [e.g. Windows, Linux or Mac]
-- Python version: [e.g. 3.8, 3.9]
-- Browser: [e.g. All, Chromium, Firefox, WebKit]
-- Extra: [any specific details about your environment]
+<!-- ⚠️⚠️ Do not delete this template ⚠️⚠️ -->
 
-**Code Snippet**
+<!-- 🔎 Search existing issues to avoid creating duplicates. -->
+<!-- 🧪 Test using the latest Playwright release to see if your issue has already been fixed -->
+<!-- 💡 Provide enough information for us to be able to reproduce your issue locally -->
 
-Help us help you! Put down a short code snippet that illustrates your bug and
-that we can run and debug locally.
+### System info
+- Playwright Version: [v1.XX]
+- Operating System: [All, Windows 11, Ubuntu 20, macOS 13.2, etc.]
+- Browser: [All, Chromium, Firefox, WebKit]
+- Other info:
+
+### Source code
+
+- [ ] I provided exact source code that allows reproducing the issue locally.
+
+<!-- For simple cases, please provide a self-contained test file along with the config file -->
+<!-- For larger cases, you can provide a GitHub repo you created for this issue -->
+<!-- If we can not reproduce the problem locally, we won't be able to act on it -->
+<!-- You can still file without the exact code and we will try to help, but if we can't repro, it will be closed -->
+
+**Link to the GitHub repository with the repro**
+
+[https://github.com/your_profile/playwright_issue_title]
+
+or
+
+**Test file (self-contained)**
 
 ```python
 from playwright.sync_api import sync_playwright
@@ -28,6 +45,14 @@ with sync_playwright() as p:
     browser.close()
 ```
 
-**Describe the bug**
+**Steps**
+- [Run the test]
+- [...]
+
+**Expected**
+
+[Describe expected behavior]
+
+**Actual**
 
-Add any other details about the problem here.
+[Describe actual behavior]
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index 7b92d8d4c..726c186c0 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,4 +1,4 @@
 contact_links:
-  - name: Join our Slack community
-    url: https://aka.ms/playwright-slack
+  - name: Join our Discord Server
+    url: https://aka.ms/playwright/discord
     about: Ask questions and discuss with other community members
diff --git a/.github/ISSUE_TEMPLATE/question.yml b/.github/ISSUE_TEMPLATE/question.yml
deleted file mode 100644
index c805b9812..000000000
--- a/.github/ISSUE_TEMPLATE/question.yml
+++ /dev/null
@@ -1,11 +0,0 @@
-name: I have a question
-description: Feel free to ask us your questions!
-title: "[Question]: "
-labels: []
-body:
-  - type: textarea
-    id: question
-    attributes:
-      label: Your question
-    validations:
-      required: true
diff --git a/.github/ISSUE_TEMPLATE/regression.md b/.github/ISSUE_TEMPLATE/regression.md
new file mode 100644
index 000000000..44a903108
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/regression.md
@@ -0,0 +1,32 @@
+---
+name: Report regression
+about: Functionality that used to work and does not any more
+title: "[REGRESSION]: "
+labels: ''
+assignees: ''
+
+---
+
+**Context:**
+- GOOD Playwright Version: [what Playwright version worked nicely?]
+- BAD Playwright Version: [what Playwright version doesn't work any more?]
+- Operating System: [e.g. Windows, Linux or Mac]
+- Extra: [any specific details about your environment]
+
+**Code Snippet**
+
+Help us help you! Put down a short code snippet that illustrates your bug and
+that we can run and debug locally. For example:
+
+```python
+from playwright.sync_api import sync_playwright
+with sync_playwright() as p:
+    browser = p.chromium.launch()
+    page = browser.new_page()
+    # ...
+    browser.close()
+```
+
+**Describe the bug**
+
+Add any other details about the problem here.

From cd98efc7843c52e080145c29ac019c4940ca46dd Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 9 Aug 2023 12:09:10 +0200
Subject: [PATCH 086/438] devops: fix conda build pipeline (pin conda) (#2038)

---
 .github/workflows/ci.yml      | 2 ++
 .github/workflows/publish.yml | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 48c8a7521..d1ca84f60 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -167,6 +167,8 @@ jobs:
         with:
           python-version: 3.9
           channels: conda-forge
+          # TODO: Can be removed after https://github.com/conda/conda/issues/12955 is fixed
+          conda-version: 23.5.2
       - name: Prepare
         run: conda install conda-build conda-verify
       - name: Build
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 2f3ce0a27..191d8a387 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -38,6 +38,8 @@ jobs:
         with:
           python-version: 3.9
           channels: conda-forge
+          # TODO: Can be removed after https://github.com/conda/conda/issues/12955 is fixed
+          conda-version: 23.5.2
       - name: Prepare
         run: conda install anaconda-client conda-build conda-verify
       - name: Build and Upload

From 7ef13c3becfd0e42a2804624b9c2ac6206529505 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 9 Aug 2023 15:17:08 +0200
Subject: [PATCH 087/438] devops: do not publish conda packages with v prefix
 (#2039)

---
 meta.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/meta.yaml b/meta.yaml
index 7fcb47cbb..d5739a63b 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -1,6 +1,6 @@
 package:
   name: playwright
-  version: "{{ environ.get('GIT_DESCRIBE_TAG') }}"
+  version: "{{ environ.get('GIT_DESCRIBE_TAG') | replace('v', '') }}"
 
 source:
   path: .

From faa256d367ce27f5dba0c9aec18d1335b8ab8061 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 9 Aug 2023 20:54:39 +0200
Subject: [PATCH 088/438] chore(roll): roll Playwright to
 1.37.0-alpha-aug-8-2023 (#2035)

---
 README.md                          |  2 +-
 playwright/_impl/_artifact.py      |  5 ++++
 playwright/_impl/_browser.py       | 18 ++++++++---
 playwright/_impl/_browser_type.py  | 17 +++++++----
 playwright/_impl/_locator.py       |  2 +-
 playwright/_impl/_stream.py        |  9 ++++++
 playwright/async_api/_generated.py | 48 +++++++++++++++++++++++-------
 playwright/sync_api/_generated.py  | 48 +++++++++++++++++++++++-------
 setup.py                           |  2 +-
 tests/async/test_locators.py       | 29 ++++++++++++++++++
 tests/async/test_navigation.py     |  6 ++--
 11 files changed, 148 insertions(+), 38 deletions(-)

diff --git a/README.md b/README.md
index 2e3f456f3..6ee8df143 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->115.0.5790.75<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->116.0.5845.62<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->115.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/playwright/_impl/_artifact.py b/playwright/_impl/_artifact.py
index 14202117e..78985a774 100644
--- a/playwright/_impl/_artifact.py
+++ b/playwright/_impl/_artifact.py
@@ -47,5 +47,10 @@ async def failure(self) -> Optional[str]:
     async def delete(self) -> None:
         await self._channel.send("delete")
 
+    async def read_info_buffer(self) -> bytes:
+        stream = cast(Stream, from_channel(await self._channel.send("stream")))
+        buffer = await stream.read_all()
+        return buffer
+
     async def cancel(self) -> None:
         await self._channel.send("cancel")
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index 2c499d5b1..b58782614 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -12,11 +12,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import base64
 import json
 from pathlib import Path
 from types import SimpleNamespace
-from typing import TYPE_CHECKING, Dict, List, Pattern, Union, cast
+from typing import TYPE_CHECKING, Dict, List, Optional, Pattern, Union, cast
 
 from playwright._impl._api_structures import (
     Geolocation,
@@ -25,6 +24,7 @@
     StorageState,
     ViewportSize,
 )
+from playwright._impl._artifact import Artifact
 from playwright._impl._browser_context import BrowserContext
 from playwright._impl._cdp_session import CDPSession
 from playwright._impl._connection import ChannelOwner, from_channel
@@ -39,6 +39,7 @@
     async_readfile,
     is_safe_close_error,
     locals_to_params,
+    make_dirs_for_file,
     prepare_record_har_options,
 )
 from playwright._impl._network import serialize_headers
@@ -61,6 +62,7 @@ def __init__(
         self._is_connected = True
         self._is_closed_or_closing = False
         self._should_close_connection_on_close = False
+        self._cr_tracing_path: Optional[str] = None
 
         self._contexts: List[BrowserContext] = []
         self._channel.on("close", lambda _: self._on_close())
@@ -207,12 +209,20 @@ async def start_tracing(
         if page:
             params["page"] = page._channel
         if path:
+            self._cr_tracing_path = str(path)
             params["path"] = str(path)
         await self._channel.send("startTracing", params)
 
     async def stop_tracing(self) -> bytes:
-        encoded_binary = await self._channel.send("stopTracing")
-        return base64.b64decode(encoded_binary)
+        artifact = cast(Artifact, from_channel(await self._channel.send("stopTracing")))
+        buffer = await artifact.read_info_buffer()
+        await artifact.delete()
+        if self._cr_tracing_path:
+            make_dirs_for_file(self._cr_tracing_path)
+            with open(self._cr_tracing_path, "wb") as f:
+                f.write(buffer)
+            self._cr_tracing_path = None
+        return buffer
 
 
 async def prepare_browser_context_params(params: Dict) -> None:
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 51a103c76..4d93a9b14 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -29,6 +29,7 @@
 from playwright._impl._connection import (
     ChannelOwner,
     Connection,
+    filter_none,
     from_channel,
     from_nullable_channel,
 )
@@ -187,6 +188,7 @@ async def connect(
         timeout: float = None,
         slow_mo: float = None,
         headers: Dict[str, str] = None,
+        expose_network: str = None,
     ) -> Browser:
         if timeout is None:
             timeout = 30000
@@ -198,12 +200,15 @@ async def connect(
         pipe_channel = (
             await local_utils._channel.send_return_as_dict(
                 "connect",
-                {
-                    "wsEndpoint": ws_endpoint,
-                    "headers": headers,
-                    "slowMo": slow_mo,
-                    "timeout": timeout,
-                },
+                filter_none(
+                    {
+                        "wsEndpoint": ws_endpoint,
+                        "headers": headers,
+                        "slowMo": slow_mo,
+                        "timeout": timeout,
+                        "exposeNetwork": expose_network,
+                    }
+                ),
             )
         )["pipe"]
         transport = JsonPipeTransport(self._connection._loop, pipe_channel)
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 246617d06..409489558 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -241,7 +241,7 @@ def locator(
             raise Error("Locators must belong to the same frame.")
         return Locator(
             self._frame,
-            f"{self._selector} >> {selector_or_locator._selector}",
+            f"{self._selector} >> internal:chain={json.dumps(selector_or_locator._selector)}",
             has_text=has_text,
             has_not_text=has_not_text,
             has_not=has_not,
diff --git a/playwright/_impl/_stream.py b/playwright/_impl/_stream.py
index 762b282c8..d27427589 100644
--- a/playwright/_impl/_stream.py
+++ b/playwright/_impl/_stream.py
@@ -35,3 +35,12 @@ async def save_as(self, path: Union[str, Path]) -> None:
                 None, lambda: file.write(base64.b64decode(binary))
             )
         await self._loop.run_in_executor(None, lambda: file.close())
+
+    async def read_all(self) -> bytes:
+        binary = b""
+        while True:
+            chunk = await self._channel.send("read", {"size": 1024 * 1024})
+            if not chunk:
+                break
+            binary += base64.b64decode(chunk)
+        return binary
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index f73b91c31..1393ca13c 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -4277,6 +4277,9 @@ async def set_content(
     ) -> None:
         """Frame.set_content
 
+        This method internally calls [document.write()](https://developer.mozilla.org/en-US/docs/Web/API/Document/write),
+        inheriting all its specific characteristics and behaviors.
+
         Parameters
         ----------
         html : str
@@ -9156,6 +9159,9 @@ async def set_content(
     ) -> None:
         """Page.set_content
 
+        This method internally calls [document.write()](https://developer.mozilla.org/en-US/docs/Web/API/Document/write),
+        inheriting all its specific characteristics and behaviors.
+
         Parameters
         ----------
         html : str
@@ -9854,7 +9860,7 @@ async def route_from_har(
         """Page.route_from_har
 
         If specified the network requests that are made in the page will be served from the HAR file. Read more about
-        [Replaying from HAR](https://playwright.dev/python/docs/network#replaying-from-har).
+        [Replaying from HAR](https://playwright.dev/python/docs/mock#replaying-from-har).
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
@@ -13592,7 +13598,7 @@ async def route_from_har(
         """BrowserContext.route_from_har
 
         If specified the network requests that are made in the context will be served from the HAR file. Read more about
-        [Replaying from HAR](https://playwright.dev/python/docs/network#replaying-from-har).
+        [Replaying from HAR](https://playwright.dev/python/docs/mock#replaying-from-har).
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
@@ -14088,7 +14094,7 @@ async def new_context(
         is_mobile : Union[bool, None]
             Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
             so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
-            about [mobile emulation](../emulation.md#isMobile).
+            about [mobile emulation](../emulation.md#ismobile).
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
@@ -14302,7 +14308,7 @@ async def new_page(
         is_mobile : Union[bool, None]
             Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
             so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
-            about [mobile emulation](../emulation.md#isMobile).
+            about [mobile emulation](../emulation.md#ismobile).
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
@@ -14847,7 +14853,7 @@ async def launch_persistent_context(
         is_mobile : Union[bool, None]
             Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
             so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
-            about [mobile emulation](../emulation.md#isMobile).
+            about [mobile emulation](../emulation.md#ismobile).
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
@@ -15033,7 +15039,8 @@ async def connect(
         *,
         timeout: typing.Optional[float] = None,
         slow_mo: typing.Optional[float] = None,
-        headers: typing.Optional[typing.Dict[str, str]] = None
+        headers: typing.Optional[typing.Dict[str, str]] = None,
+        expose_network: typing.Optional[str] = None
     ) -> "Browser":
         """BrowserType.connect
 
@@ -15052,6 +15059,20 @@ async def connect(
             on. Defaults to 0.
         headers : Union[Dict[str, str], None]
             Additional HTTP headers to be sent with web socket connect request. Optional.
+        expose_network : Union[str, None]
+            This option exposes network available on the connecting client to the browser being connected to. Consists of a
+            list of rules separated by comma.
+
+            Available rules:
+            1. Hostname pattern, for example: `example.com`, `*.org:99`, `x.*.y.com`, `*foo.org`.
+            1. IP literal, for example: `127.0.0.1`, `0.0.0.0:99`, `[::1]`, `[0:0::1]:99`.
+            1. `<loopback>` that matches local loopback interfaces: `localhost`, `*.localhost`, `127.0.0.1`, `[::1]`.
+
+            Some common examples:
+            1. `"*"` to expose all network.
+            1. `"<loopback>"` to expose localhost network.
+            1. `"*.test.internal-domain,*.staging.internal-domain,<loopback>"` to expose test/staging deployments and
+               localhost.
 
         Returns
         -------
@@ -15064,6 +15085,7 @@ async def connect(
                 timeout=timeout,
                 slow_mo=slow_mo,
                 headers=mapping.to_impl(headers),
+                expose_network=expose_network,
             )
         )
 
@@ -16833,7 +16855,8 @@ async def blur(self, *, timeout: typing.Optional[float] = None) -> None:
     async def all(self) -> typing.List["Locator"]:
         """Locator.all
 
-        When locator points to a list of elements, returns array of locators, pointing to respective elements.
+        When the locator points to a list of elements, this returns an array of locators, pointing to their respective
+        elements.
 
         **NOTE** `locator.all()` does not wait for elements to match the locator, and instead immediately returns
         whatever is present in the page.  When the list of elements changes dynamically, `locator.all()` will
@@ -17803,6 +17826,9 @@ async def type(
     ) -> None:
         """Locator.type
 
+        **NOTE** In most cases, you should use `locator.fill()` instead. You only need to type characters if there
+        is special keyboard handling on the page.
+
         Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the
         text.
 
@@ -19908,16 +19934,16 @@ async def to_have_text(
         from playwright.sync_api import expect
 
         # ✓ Has the right items in the right order
-        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
+        expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
 
         # ✖ Wrong order
-        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 3\", \"Text 2\", \"Text 1\"])
+        expect(page.locator(\"ul > li\")).to_have_text([\"Text 3\", \"Text 2\", \"Text 1\"])
 
         # ✖ Last item does not match
-        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text\"])
+        expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text\"])
 
         # ✖ Locator points to the outer list element, not to the list items
-        await expect(page.locator(\"ul\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
+        expect(page.locator(\"ul\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
         ```
 
         Parameters
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index f1b41ca37..66b989217 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -4353,6 +4353,9 @@ def set_content(
     ) -> None:
         """Frame.set_content
 
+        This method internally calls [document.write()](https://developer.mozilla.org/en-US/docs/Web/API/Document/write),
+        inheriting all its specific characteristics and behaviors.
+
         Parameters
         ----------
         html : str
@@ -9206,6 +9209,9 @@ def set_content(
     ) -> None:
         """Page.set_content
 
+        This method internally calls [document.write()](https://developer.mozilla.org/en-US/docs/Web/API/Document/write),
+        inheriting all its specific characteristics and behaviors.
+
         Parameters
         ----------
         html : str
@@ -9920,7 +9926,7 @@ def route_from_har(
         """Page.route_from_har
 
         If specified the network requests that are made in the page will be served from the HAR file. Read more about
-        [Replaying from HAR](https://playwright.dev/python/docs/network#replaying-from-har).
+        [Replaying from HAR](https://playwright.dev/python/docs/mock#replaying-from-har).
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
@@ -13652,7 +13658,7 @@ def route_from_har(
         """BrowserContext.route_from_har
 
         If specified the network requests that are made in the context will be served from the HAR file. Read more about
-        [Replaying from HAR](https://playwright.dev/python/docs/network#replaying-from-har).
+        [Replaying from HAR](https://playwright.dev/python/docs/mock#replaying-from-har).
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
@@ -14150,7 +14156,7 @@ def new_context(
         is_mobile : Union[bool, None]
             Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
             so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
-            about [mobile emulation](../emulation.md#isMobile).
+            about [mobile emulation](../emulation.md#ismobile).
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
@@ -14366,7 +14372,7 @@ def new_page(
         is_mobile : Union[bool, None]
             Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
             so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
-            about [mobile emulation](../emulation.md#isMobile).
+            about [mobile emulation](../emulation.md#ismobile).
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
@@ -14917,7 +14923,7 @@ def launch_persistent_context(
         is_mobile : Union[bool, None]
             Whether the `meta viewport` tag is taken into account and touch events are enabled. isMobile is a part of device,
             so you don't actually need to set it manually. Defaults to `false` and is not supported in Firefox. Learn more
-            about [mobile emulation](../emulation.md#isMobile).
+            about [mobile emulation](../emulation.md#ismobile).
         has_touch : Union[bool, None]
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
@@ -15107,7 +15113,8 @@ def connect(
         *,
         timeout: typing.Optional[float] = None,
         slow_mo: typing.Optional[float] = None,
-        headers: typing.Optional[typing.Dict[str, str]] = None
+        headers: typing.Optional[typing.Dict[str, str]] = None,
+        expose_network: typing.Optional[str] = None
     ) -> "Browser":
         """BrowserType.connect
 
@@ -15126,6 +15133,20 @@ def connect(
             on. Defaults to 0.
         headers : Union[Dict[str, str], None]
             Additional HTTP headers to be sent with web socket connect request. Optional.
+        expose_network : Union[str, None]
+            This option exposes network available on the connecting client to the browser being connected to. Consists of a
+            list of rules separated by comma.
+
+            Available rules:
+            1. Hostname pattern, for example: `example.com`, `*.org:99`, `x.*.y.com`, `*foo.org`.
+            1. IP literal, for example: `127.0.0.1`, `0.0.0.0:99`, `[::1]`, `[0:0::1]:99`.
+            1. `<loopback>` that matches local loopback interfaces: `localhost`, `*.localhost`, `127.0.0.1`, `[::1]`.
+
+            Some common examples:
+            1. `"*"` to expose all network.
+            1. `"<loopback>"` to expose localhost network.
+            1. `"*.test.internal-domain,*.staging.internal-domain,<loopback>"` to expose test/staging deployments and
+               localhost.
 
         Returns
         -------
@@ -15139,6 +15160,7 @@ def connect(
                     timeout=timeout,
                     slow_mo=slow_mo,
                     headers=mapping.to_impl(headers),
+                    expose_network=expose_network,
                 )
             )
         )
@@ -16933,7 +16955,8 @@ def blur(self, *, timeout: typing.Optional[float] = None) -> None:
     def all(self) -> typing.List["Locator"]:
         """Locator.all
 
-        When locator points to a list of elements, returns array of locators, pointing to respective elements.
+        When the locator points to a list of elements, this returns an array of locators, pointing to their respective
+        elements.
 
         **NOTE** `locator.all()` does not wait for elements to match the locator, and instead immediately returns
         whatever is present in the page.  When the list of elements changes dynamically, `locator.all()` will
@@ -17931,6 +17954,9 @@ def type(
     ) -> None:
         """Locator.type
 
+        **NOTE** In most cases, you should use `locator.fill()` instead. You only need to type characters if there
+        is special keyboard handling on the page.
+
         Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the
         text.
 
@@ -20088,16 +20114,16 @@ def to_have_text(
         from playwright.sync_api import expect
 
         # ✓ Has the right items in the right order
-        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
+        expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
 
         # ✖ Wrong order
-        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 3\", \"Text 2\", \"Text 1\"])
+        expect(page.locator(\"ul > li\")).to_have_text([\"Text 3\", \"Text 2\", \"Text 1\"])
 
         # ✖ Last item does not match
-        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text\"])
+        expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text\"])
 
         # ✖ Locator points to the outer list element, not to the list items
-        await expect(page.locator(\"ul\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
+        expect(page.locator(\"ul\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
         ```
 
         Parameters
diff --git a/setup.py b/setup.py
index 79ab19e30..462453adb 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.36.0"
+driver_version = "1.37.0-alpha-aug-8-2023"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 2de3a244c..0630fadad 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -846,6 +846,35 @@ async def test_locator_should_support_locator_or(page: Page, server: Server) ->
     )
 
 
+async def test_locator_should_support_locator_locator_with_and_or(page: Page) -> None:
+    await page.set_content(
+        """
+        <div>one <span>two</span> <button>three</button> </div>
+        <span>four</span>
+        <button>five</button>
+        """
+    )
+
+    await expect(page.locator("div").locator(page.locator("button"))).to_have_text(
+        ["three"]
+    )
+    await expect(
+        page.locator("div").locator(page.locator("button").or_(page.locator("span")))
+    ).to_have_text(["two", "three"])
+    await expect(page.locator("button").or_(page.locator("span"))).to_have_text(
+        ["two", "three", "four", "five"]
+    )
+
+    await expect(
+        page.locator("div").locator(
+            page.locator("button").and_(page.get_by_role("button"))
+        )
+    ).to_have_text(["three"])
+    await expect(page.locator("button").and_(page.get_by_role("button"))).to_have_text(
+        ["three", "five"]
+    )
+
+
 async def test_locator_highlight_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/grid.html")
     await page.locator(".box").nth(3).highlight()
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index bf41f6938..89fec6700 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -906,11 +906,11 @@ async def test_frame_goto_should_reject_when_frame_detaches(page, server, browse
     with pytest.raises(Error) as exc_info:
         await navigation_task
     if browser_name == "chromium":
-        assert ("frame was detached" in exc_info.value.message) or (
-            "net::ERR_ABORTED" in exc_info.value.message
+        assert "net::ERR_FAILED" in exc_info.value.message or (
+            "frame was detached" in exc_info.value.message.lower()
         )
     else:
-        assert "frame was detached" in exc_info.value.message
+        assert "frame was detached" in exc_info.value.message.lower()
 
 
 async def test_frame_goto_should_continue_after_client_redirect(page, server):

From 8838e31a6f4836c47416b1504a2cba1a48f6112d Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 10 Aug 2023 07:16:25 +0200
Subject: [PATCH 089/438] fix: allow sys.stderr.fileno() to throw
 NotImplementedError (#2040)

---
 playwright/_impl/_transport.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index 3c9f96be0..d49b5a2d5 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -37,7 +37,7 @@ def _get_stderr_fileno() -> Optional[int]:
             return None
 
         return sys.stderr.fileno()
-    except (AttributeError, io.UnsupportedOperation):
+    except (NotImplementedError, AttributeError, io.UnsupportedOperation):
         # pytest-xdist monkeypatches sys.stderr with an object that is not an actual file.
         # https://docs.python.org/3/library/faulthandler.html#issue-with-file-descriptors
         # This is potentially dangerous, but the best we can do.

From 8a94f5b36bc6d4c755b7de8a870a2a18b92ab6bb Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 14 Aug 2023 14:52:34 +0200
Subject: [PATCH 090/438] chore: fix update_api.sh script on Windows (#2044)

---
 scripts/update_api.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scripts/update_api.sh b/scripts/update_api.sh
index 85147658f..616df730c 100755
--- a/scripts/update_api.sh
+++ b/scripts/update_api.sh
@@ -6,7 +6,7 @@ function update_api {
     generate_script="$2"
     git checkout HEAD -- "$file_name"
 
-    if python "$generate_script" > .x; then
+    if PYTHONIOENCODING=utf-8 python "$generate_script" > .x; then
         mv .x "$file_name"
         pre-commit run --files $file_name
         echo "Regenerated APIs"

From 42c0bf19d7ae415552172d7c04cdb7afd9dad7fb Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 14 Aug 2023 14:52:46 +0200
Subject: [PATCH 091/438] chore(roll): roll to Playwright 1.37.0 (#2042)

---
 README.md | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 6ee8df143..77a30804d 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->116.0.5845.62<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->116.0.5845.82<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->115.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/setup.py b/setup.py
index 462453adb..c935ae536 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.37.0-alpha-aug-8-2023"
+driver_version = "1.37.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 0e92fbc2cceba0551305f2e36f75f9b71f5d5b6e Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 5 Sep 2023 19:07:46 +0200
Subject: [PATCH 092/438] feat(roll): roll to Playwright
 1.38.0-alpha-sep-4-2023 (#2058)

---
 README.md                                  |   2 +-
 playwright/_impl/_api_types.py             |  18 +-
 playwright/_impl/_browser.py               |   2 +
 playwright/_impl/_browser_context.py       |  16 ++
 playwright/_impl/_connection.py            |   2 +-
 playwright/_impl/_frame.py                 |  22 +--
 playwright/_impl/_helper.py                |   4 +-
 playwright/_impl/_locator.py               |   9 +
 playwright/_impl/_network.py               |  46 +++--
 playwright/_impl/_page.py                  |   8 +-
 playwright/_impl/_page_error.py            |  36 ++++
 playwright/async_api/_generated.py         | 192 ++++++++++++++-------
 playwright/sync_api/_generated.py          | 190 +++++++++++++-------
 scripts/documentation_provider.py          |   4 +-
 scripts/expected_api_mismatch.txt          |   5 -
 scripts/generate_api.py                    |  11 +-
 scripts/generate_async_api.py              |   4 +-
 scripts/generate_sync_api.py               |   4 +-
 setup.py                                   |   2 +-
 tests/async/test_browsercontext_events.py  |   8 +
 tests/async/test_locators.py               |   6 +
 tests/async/test_network.py                |   5 +-
 tests/async/test_page_network_request.py   |  43 +++++
 tests/async/test_page_request_intercept.py |  17 +-
 tests/async/test_popup.py                  |   1 +
 tests/async/test_request_fulfill.py        |  10 +-
 tests/sync/test_request_fulfill.py         |   6 +-
 27 files changed, 486 insertions(+), 187 deletions(-)
 create mode 100644 playwright/_impl/_page_error.py
 create mode 100644 tests/async/test_page_network_request.py

diff --git a/README.md b/README.md
index 77a30804d..39d199a75 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->116.0.5845.82<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->117.0.5938.35<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->115.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/playwright/_impl/_api_types.py b/playwright/_impl/_api_types.py
index f4627ae7f..e921e9867 100644
--- a/playwright/_impl/_api_types.py
+++ b/playwright/_impl/_api_types.py
@@ -21,11 +21,23 @@
 
 class Error(Exception):
     def __init__(self, message: str) -> None:
-        self.message = message
-        self.name: Optional[str] = None
-        self.stack: Optional[str] = None
+        self._message = message
+        self._name: Optional[str] = None
+        self._stack: Optional[str] = None
         super().__init__(message)
 
+    @property
+    def message(self) -> str:
+        return self._message
+
+    @property
+    def name(self) -> Optional[str]:
+        return self._name
+
+    @property
+    def stack(self) -> Optional[str]:
+        return self._stack
+
 
 class TimeoutError(Error):
     pass
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index b58782614..79ed408bd 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -254,3 +254,5 @@ async def prepare_browser_context_params(params: Dict) -> None:
         params["reducedMotion"] = "no-override"
     if params.get("forcedColors", None) == "null":
         params["forcedColors"] = "no-override"
+    if "acceptDownloads" in params:
+        params["acceptDownloads"] = "accept" if params["acceptDownloads"] else "deny"
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 270232b35..03920bcde 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -63,11 +63,13 @@
     async_readfile,
     async_writefile,
     locals_to_params,
+    parse_error,
     prepare_record_har_options,
     to_impl,
 )
 from playwright._impl._network import Request, Response, Route, serialize_headers
 from playwright._impl._page import BindingCall, Page, Worker
+from playwright._impl._page_error import PageError
 from playwright._impl._tracing import Tracing
 from playwright._impl._wait_helper import WaitHelper
 
@@ -87,6 +89,7 @@ class BrowserContext(ChannelOwner):
         Console="console",
         Dialog="dialog",
         Page="page",
+        PageError="pageerror",
         ServiceWorker="serviceworker",
         Request="request",
         Response="response",
@@ -148,6 +151,13 @@ def __init__(
         self._channel.on(
             "dialog", lambda params: self._on_dialog(from_channel(params["dialog"]))
         )
+        self._channel.on(
+            "pageError",
+            lambda params: self._on_page_error(
+                parse_error(params["error"]["error"]),
+                from_nullable_channel(params["page"]),
+            ),
+        )
         self._channel.on(
             "request",
             lambda params: self._on_request(
@@ -206,6 +216,7 @@ def _on_page(self, page: Page) -> None:
             page._opener.emit(Page.Events.Popup, page)
 
     async def _on_route(self, route: Route) -> None:
+        route._context = self
         route_handlers = self._routes.copy()
         for route_handler in route_handlers:
             if not route_handler.matches(route.request.url):
@@ -555,6 +566,11 @@ def _on_dialog(self, dialog: Dialog) -> None:
             else:
                 asyncio.create_task(dialog.dismiss())
 
+    async def _on_page_error(self, error: Error, page: Optional[Page]) -> None:
+        self.emit(BrowserContext.Events.PageError, PageError(self._loop, page, error))
+        if page:
+            page.emit(Page.Events.PageError, error)
+
     def _on_request(self, request: Request, page: Optional[Page]) -> None:
         self.emit(BrowserContext.Events.Request, request)
         if page:
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 5f906c47e..45e80b003 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -368,7 +368,7 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
             error = msg.get("error")
             if error:
                 parsed_error = parse_error(error["error"])  # type: ignore
-                parsed_error.stack = "".join(
+                parsed_error._stack = "".join(
                     traceback.format_list(callback.stack_trace)[-10:]
                 )
                 callback.future.set_exception(parsed_error)
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 9cd12a1d2..b004d3cbc 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -82,7 +82,7 @@ def __init__(
         self._url = initializer["url"]
         self._detached = False
         self._child_frames: List[Frame] = []
-        self._page: "Page"
+        self._page: Optional[Page] = None
         self._load_states: Set[str] = set(initializer["loadStates"])
         self._event_emitter = EventEmitter()
         self._channel.on(
@@ -105,26 +105,16 @@ def _on_load_state(
             self._event_emitter.emit("loadstate", add)
         elif remove and remove in self._load_states:
             self._load_states.remove(remove)
-        if (
-            not self._parent_frame
-            and add == "load"
-            and hasattr(self, "_page")
-            and self._page
-        ):
+        if not self._parent_frame and add == "load" and self._page:
             self._page.emit("load", self._page)
-        if (
-            not self._parent_frame
-            and add == "domcontentloaded"
-            and hasattr(self, "_page")
-            and self._page
-        ):
+        if not self._parent_frame and add == "domcontentloaded" and self._page:
             self._page.emit("domcontentloaded", self._page)
 
     def _on_frame_navigated(self, event: FrameNavigatedEvent) -> None:
         self._url = event["url"]
         self._name = event["name"]
         self._event_emitter.emit("navigated", event)
-        if "error" not in event and hasattr(self, "_page") and self._page:
+        if "error" not in event and self._page:
             self._page.emit("framenavigated", self)
 
     async def _query_count(self, selector: str) -> int:
@@ -132,6 +122,7 @@ async def _query_count(self, selector: str) -> int:
 
     @property
     def page(self) -> "Page":
+        assert self._page
         return self._page
 
     async def goto(
@@ -151,6 +142,7 @@ async def goto(
     def _setup_navigation_wait_helper(
         self, wait_name: str, timeout: float = None
     ) -> WaitHelper:
+        assert self._page
         wait_helper = WaitHelper(self._page, f"frame.{wait_name}")
         wait_helper.reject_on_event(
             self._page, "close", Error("Navigation failed because page was closed!")
@@ -175,6 +167,7 @@ def expect_navigation(
         wait_until: DocumentLoadState = None,
         timeout: float = None,
     ) -> EventContextManagerImpl[Response]:
+        assert self._page
         if not wait_until:
             wait_until = "load"
 
@@ -225,6 +218,7 @@ async def wait_for_url(
         wait_until: DocumentLoadState = None,
         timeout: float = None,
     ) -> None:
+        assert self._page
         matcher = URLMatcher(self._page._browser_context._options.get("baseURL"), url)
         if matcher.matches(self.url):
             await self._wait_for_load_state_impl(state=wait_until, timeout=timeout)
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 0af327d11..5f8031127 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -222,8 +222,8 @@ def parse_error(error: ErrorPayload) -> Error:
     if error.get("name") == "TimeoutError":
         base_error_class = TimeoutError
     exc = base_error_class(cast(str, patch_error_message(error.get("message"))))
-    exc.name = error["name"]
-    exc.stack = error["stack"]
+    exc._name = error["name"]
+    exc._stack = error["stack"]
     return exc
 
 
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 409489558..8c9a18f03 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -625,6 +625,15 @@ async def type(
             **params,
         )
 
+    async def press_sequentially(
+        self,
+        text: str,
+        delay: float = None,
+        timeout: float = None,
+        noWaitAfter: bool = None,
+    ) -> None:
+        await self.type(text, delay=delay, timeout=timeout, noWaitAfter=noWaitAfter)
+
     async def uncheck(
         self,
         position: Position = None,
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 419d5793e..35234d286 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -61,6 +61,7 @@
 from playwright._impl._wait_helper import WaitHelper
 
 if TYPE_CHECKING:  # pragma: no cover
+    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
@@ -191,7 +192,20 @@ async def response(self) -> Optional["Response"]:
 
     @property
     def frame(self) -> "Frame":
-        return from_channel(self._initializer["frame"])
+        if not self._initializer.get("frame"):
+            raise Error("Service Worker requests do not have an associated frame.")
+        frame = cast("Frame", from_channel(self._initializer["frame"]))
+        if not frame._page:
+            raise Error(
+                "\n".join(
+                    [
+                        "Frame for this navigation request is not available, because the request",
+                        "was issued before the frame is created. You can check whether the request",
+                        "is a navigation request by calling isNavigationRequest() method.",
+                    ]
+                )
+            )
+        return frame
 
     def is_navigation_request(self) -> bool:
         return self._initializer["isNavigationRequest"]
@@ -244,9 +258,15 @@ async def _actual_headers(self) -> "RawHeaders":
         return await self._all_headers_future
 
     def _target_closed_future(self) -> asyncio.Future:
-        if not hasattr(self.frame, "_page"):
+        frame = cast(
+            Optional["Frame"], from_nullable_channel(self._initializer.get("frame"))
+        )
+        if not frame:
             return asyncio.Future()
-        return self.frame._page._closed_or_crashed_future
+        page = frame._page
+        if not page:
+            return asyncio.Future()
+        return page._closed_or_crashed_future
 
 
 class Route(ChannelOwner):
@@ -255,6 +275,7 @@ def __init__(
     ) -> None:
         super().__init__(parent, type, guid, initializer)
         self._handling_future: Optional[asyncio.Future["bool"]] = None
+        self._context: "BrowserContext" = cast("BrowserContext", None)
 
     def _start_handling(self) -> "asyncio.Future[bool]":
         self._handling_future = asyncio.Future()
@@ -368,15 +389,16 @@ async def fetch(
         maxRedirects: int = None,
         timeout: float = None,
     ) -> "APIResponse":
-        page = self.request.frame._page
-        return await page.context.request._inner_fetch(
-            self.request,
-            url,
-            method,
-            headers,
-            postData,
-            maxRedirects=maxRedirects,
-            timeout=timeout,
+        return await self._connection.wrap_api_call(
+            lambda: self._context.request._inner_fetch(
+                self.request,
+                url,
+                method,
+                headers,
+                postData,
+                maxRedirects=maxRedirects,
+                timeout=timeout,
+            )
         )
 
     async def fallback(
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 902f3b5f1..be2538689 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -75,7 +75,6 @@
     is_safe_close_error,
     locals_to_params,
     make_dirs_for_file,
-    parse_error,
     serialize_error,
 )
 from playwright._impl._input import Keyboard, Mouse, Touchscreen
@@ -177,12 +176,6 @@ def __init__(
             "frameDetached",
             lambda params: self._on_frame_detached(from_channel(params["frame"])),
         )
-        self._channel.on(
-            "pageError",
-            lambda params: self.emit(
-                Page.Events.PageError, parse_error(params["error"]["error"])
-            ),
-        )
         self._channel.on(
             "route",
             lambda params: asyncio.create_task(
@@ -239,6 +232,7 @@ def _on_frame_detached(self, frame: Frame) -> None:
         self.emit(Page.Events.FrameDetached, frame)
 
     async def _on_route(self, route: Route) -> None:
+        route._context = self.context
         route_handlers = self._routes.copy()
         for route_handler in route_handlers:
             if not route_handler.matches(route.request.url):
diff --git a/playwright/_impl/_page_error.py b/playwright/_impl/_page_error.py
new file mode 100644
index 000000000..d57bbf9e2
--- /dev/null
+++ b/playwright/_impl/_page_error.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.
+
+from asyncio import AbstractEventLoop
+from typing import Optional
+
+from playwright._impl._helper import Error
+from playwright._impl._page import Page
+
+
+class PageError:
+    def __init__(
+        self, loop: AbstractEventLoop, page: Optional[Page], error: Error
+    ) -> None:
+        self._loop = loop
+        self._page = page
+        self._error = error
+
+    @property
+    def page(self) -> Optional[Page]:
+        return self._page
+
+    @property
+    def error(self) -> Error:
+        return self._error
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 1393ca13c..65c2d0f2c 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -79,6 +79,7 @@
 from playwright._impl._network import WebSocket as WebSocketImpl
 from playwright._impl._page import Page as PageImpl
 from playwright._impl._page import Worker as WorkerImpl
+from playwright._impl._page_error import PageError as PageErrorImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
 from playwright._impl._selectors import Selectors as SelectorsImpl
 from playwright._impl._tracing import Tracing as TracingImpl
@@ -169,6 +170,21 @@ def frame(self) -> "Frame":
 
         Returns the `Frame` that initiated this request.
 
+        **Usage**
+
+        ```py
+        frame_url = request.frame.url
+        ```
+
+        **Details**
+
+        Note that in some cases the frame is not available, and this method will throw.
+        - When request originates in the Service Worker. You can use `request.serviceWorker()` to check that.
+        - When navigation request is issued before the corresponding frame is created. You can use
+          `request.is_navigation_request()` to check that.
+
+        Here is an example that handles all the cases:
+
         Returns
         -------
         Frame
@@ -330,6 +346,9 @@ def is_navigation_request(self) -> bool:
 
         Whether this request is driving frame's navigation.
 
+        Some navigation requests are issued before the corresponding frame is created, and therefore do not have
+        `request.frame()` available.
+
         Returns
         -------
         bool
@@ -2316,7 +2335,7 @@ async def fill(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
-        To send fine-grained keyboard events, use `element_handle.type()`.
+        To send fine-grained keyboard events, use `keyboard.type()`.
 
         Parameters
         ----------
@@ -2457,30 +2476,6 @@ async def type(
 
         **Usage**
 
-        ```py
-        await element_handle.type(\"hello\") # types instantly
-        await element_handle.type(\"world\", delay=100) # types slower, like a user
-        ```
-
-        ```py
-        element_handle.type(\"hello\") # types instantly
-        element_handle.type(\"world\", delay=100) # types slower, like a user
-        ```
-
-        An example of typing into a text field and then submitting the form:
-
-        ```py
-        element_handle = await page.query_selector(\"input\")
-        await element_handle.type(\"some text\")
-        await element_handle.press(\"Enter\")
-        ```
-
-        ```py
-        element_handle = page.query_selector(\"input\")
-        element_handle.type(\"some text\")
-        element_handle.press(\"Enter\")
-        ```
-
         Parameters
         ----------
         text : str
@@ -5770,16 +5765,6 @@ async def type(
 
         **Usage**
 
-        ```py
-        await frame.type(\"#mytextarea\", \"hello\") # types instantly
-        await frame.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
-        ```
-
-        ```py
-        frame.type(\"#mytextarea\", \"hello\") # types instantly
-        frame.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
-        ```
-
         Parameters
         ----------
         selector : str
@@ -7273,6 +7258,16 @@ async def save_as(self, path: typing.Union[str, pathlib.Path]) -> None:
         Copy the download to a user-specified path. It is safe to call this method while the download is still in progress.
         Will wait for the download to finish if necessary.
 
+        **Usage**
+
+        ```py
+        await download.save_as(\"/path/to/save/at/\" + download.suggested_filename)
+        ```
+
+        ```py
+        download.save_as(\"/path/to/save/at/\" + download.suggested_filename)
+        ```
+
         Parameters
         ----------
         path : Union[pathlib.Path, str]
@@ -11441,16 +11436,6 @@ async def type(
 
         **Usage**
 
-        ```py
-        await page.type(\"#mytextarea\", \"hello\") # types instantly
-        await page.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
-        ```
-
-        ```py
-        page.type(\"#mytextarea\", \"hello\") # types instantly
-        page.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
-        ```
-
         Parameters
         ----------
         selector : str
@@ -12499,6 +12484,35 @@ async def set_checked(
 mapping.register(PageImpl, Page)
 
 
+class PageError(AsyncBase):
+    @property
+    def page(self) -> typing.Optional["Page"]:
+        """PageError.page
+
+        The page that produced this unhandled exception, if any.
+
+        Returns
+        -------
+        Union[Page, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.page)
+
+    @property
+    def error(self) -> "Error":
+        """PageError.error
+
+        Unhandled error that was thrown.
+
+        Returns
+        -------
+        Error
+        """
+        return mapping.from_impl(self._impl_obj.error)
+
+
+mapping.register(PageErrorImpl, PageError)
+
+
 class BrowserContext(AsyncContextManager):
     @typing.overload
     def on(
@@ -12622,6 +12636,16 @@ def on(
         **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
         need it in most cases)."""
 
+    @typing.overload
+    def on(
+        self,
+        event: Literal["pageerror"],
+        f: typing.Callable[["PageError"], "typing.Union[typing.Awaitable[None], None]"],
+    ) -> None:
+        """
+        Emitted when unhandled exceptions occur on any pages created through this context. To only listen for `pageError`
+        events from a particular page, use `page.on('page_error')`."""
+
     @typing.overload
     def on(
         self,
@@ -12811,6 +12835,16 @@ def once(
         **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
         need it in most cases)."""
 
+    @typing.overload
+    def once(
+        self,
+        event: Literal["pageerror"],
+        f: typing.Callable[["PageError"], "typing.Union[typing.Awaitable[None], None]"],
+    ) -> None:
+        """
+        Emitted when unhandled exceptions occur on any pages created through this context. To only listen for `pageError`
+        events from a particular page, use `page.on('page_error')`."""
+
     @typing.overload
     def once(
         self,
@@ -15968,7 +16002,7 @@ async def fill(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
-        To send fine-grained keyboard events, use `locator.type()`.
+        To send fine-grained keyboard events, use `locator.press_sequentially()`.
 
         Parameters
         ----------
@@ -17826,8 +17860,46 @@ async def type(
     ) -> None:
         """Locator.type
 
-        **NOTE** In most cases, you should use `locator.fill()` instead. You only need to type characters if there
-        is special keyboard handling on the page.
+        Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the
+        text.
+
+        To press a special key, like `Control` or `ArrowDown`, use `locator.press()`.
+
+        **Usage**
+
+        Parameters
+        ----------
+        text : str
+            A text to type into a focused element.
+        delay : Union[float, None]
+            Time to wait between key presses in milliseconds. Defaults to 0.
+        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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.type(
+                text=text, delay=delay, timeout=timeout, noWaitAfter=no_wait_after
+            )
+        )
+
+    async def press_sequentially(
+        self,
+        text: str,
+        *,
+        delay: typing.Optional[float] = None,
+        timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None
+    ) -> None:
+        """Locator.press_sequentially
+
+        **NOTE** In most cases, you should use `locator.fill()` instead. You only need to press keys one by one if
+        there is special keyboard handling on the page.
 
         Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the
         text.
@@ -17837,33 +17909,33 @@ async def type(
         **Usage**
 
         ```py
-        await element.type(\"hello\") # types instantly
-        await element.type(\"world\", delay=100) # types slower, like a user
+        await locator.press_sequentially(\"hello\") # types instantly
+        await locator.press_sequentially(\"world\", delay=100) # types slower, like a user
         ```
 
         ```py
-        element.type(\"hello\") # types instantly
-        element.type(\"world\", delay=100) # types slower, like a user
+        locator.press_sequentially(\"hello\") # types instantly
+        locator.press_sequentially(\"world\", delay=100) # types slower, like a user
         ```
 
         An example of typing into a text field and then submitting the form:
 
         ```py
-        element = page.get_by_label(\"Password\")
-        await element.type(\"my password\")
-        await element.press(\"Enter\")
+        locator = page.get_by_label(\"Password\")
+        await locator.press_sequentially(\"my password\")
+        await locator.press(\"Enter\")
         ```
 
         ```py
-        element = page.get_by_label(\"Password\")
-        element.type(\"my password\")
-        element.press(\"Enter\")
+        locator = page.get_by_label(\"Password\")
+        locator.press_sequentially(\"my password\")
+        locator.press(\"Enter\")
         ```
 
         Parameters
         ----------
         text : str
-            A text to type into a focused element.
+            String of characters to sequentially press into a focused element.
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
@@ -17876,7 +17948,7 @@ async def type(
         """
 
         return mapping.from_maybe_impl(
-            await self._impl_obj.type(
+            await self._impl_obj.press_sequentially(
                 text=text, delay=delay, timeout=timeout, noWaitAfter=no_wait_after
             )
         )
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 66b989217..775bc81b3 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -73,6 +73,7 @@
 from playwright._impl._network import WebSocket as WebSocketImpl
 from playwright._impl._page import Page as PageImpl
 from playwright._impl._page import Worker as WorkerImpl
+from playwright._impl._page_error import PageError as PageErrorImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
 from playwright._impl._selectors import Selectors as SelectorsImpl
 from playwright._impl._sync_base import (
@@ -169,6 +170,21 @@ def frame(self) -> "Frame":
 
         Returns the `Frame` that initiated this request.
 
+        **Usage**
+
+        ```py
+        frame_url = request.frame.url
+        ```
+
+        **Details**
+
+        Note that in some cases the frame is not available, and this method will throw.
+        - When request originates in the Service Worker. You can use `request.serviceWorker()` to check that.
+        - When navigation request is issued before the corresponding frame is created. You can use
+          `request.is_navigation_request()` to check that.
+
+        Here is an example that handles all the cases:
+
         Returns
         -------
         Frame
@@ -330,6 +346,9 @@ def is_navigation_request(self) -> bool:
 
         Whether this request is driving frame's navigation.
 
+        Some navigation requests are issued before the corresponding frame is created, and therefore do not have
+        `request.frame()` available.
+
         Returns
         -------
         bool
@@ -2334,7 +2353,7 @@ def fill(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
-        To send fine-grained keyboard events, use `element_handle.type()`.
+        To send fine-grained keyboard events, use `keyboard.type()`.
 
         Parameters
         ----------
@@ -2481,30 +2500,6 @@ def type(
 
         **Usage**
 
-        ```py
-        await element_handle.type(\"hello\") # types instantly
-        await element_handle.type(\"world\", delay=100) # types slower, like a user
-        ```
-
-        ```py
-        element_handle.type(\"hello\") # types instantly
-        element_handle.type(\"world\", delay=100) # types slower, like a user
-        ```
-
-        An example of typing into a text field and then submitting the form:
-
-        ```py
-        element_handle = await page.query_selector(\"input\")
-        await element_handle.type(\"some text\")
-        await element_handle.press(\"Enter\")
-        ```
-
-        ```py
-        element_handle = page.query_selector(\"input\")
-        element_handle.type(\"some text\")
-        element_handle.press(\"Enter\")
-        ```
-
         Parameters
         ----------
         text : str
@@ -5878,16 +5873,6 @@ def type(
 
         **Usage**
 
-        ```py
-        await frame.type(\"#mytextarea\", \"hello\") # types instantly
-        await frame.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
-        ```
-
-        ```py
-        frame.type(\"#mytextarea\", \"hello\") # types instantly
-        frame.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
-        ```
-
         Parameters
         ----------
         selector : str
@@ -7393,6 +7378,16 @@ def save_as(self, path: typing.Union[str, pathlib.Path]) -> None:
         Copy the download to a user-specified path. It is safe to call this method while the download is still in progress.
         Will wait for the download to finish if necessary.
 
+        **Usage**
+
+        ```py
+        await download.save_as(\"/path/to/save/at/\" + download.suggested_filename)
+        ```
+
+        ```py
+        download.save_as(\"/path/to/save/at/\" + download.suggested_filename)
+        ```
+
         Parameters
         ----------
         path : Union[pathlib.Path, str]
@@ -11537,16 +11532,6 @@ def type(
 
         **Usage**
 
-        ```py
-        await page.type(\"#mytextarea\", \"hello\") # types instantly
-        await page.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
-        ```
-
-        ```py
-        page.type(\"#mytextarea\", \"hello\") # types instantly
-        page.type(\"#mytextarea\", \"world\", delay=100) # types slower, like a user
-        ```
-
         Parameters
         ----------
         selector : str
@@ -12609,6 +12594,35 @@ def set_checked(
 mapping.register(PageImpl, Page)
 
 
+class PageError(SyncBase):
+    @property
+    def page(self) -> typing.Optional["Page"]:
+        """PageError.page
+
+        The page that produced this unhandled exception, if any.
+
+        Returns
+        -------
+        Union[Page, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.page)
+
+    @property
+    def error(self) -> "Error":
+        """PageError.error
+
+        Unhandled error that was thrown.
+
+        Returns
+        -------
+        Error
+        """
+        return mapping.from_impl(self._impl_obj.error)
+
+
+mapping.register(PageErrorImpl, PageError)
+
+
 class BrowserContext(SyncContextManager):
     @typing.overload
     def on(
@@ -12716,6 +12730,14 @@ def on(self, event: Literal["page"], f: typing.Callable[["Page"], "None"]) -> No
         **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
         need it in most cases)."""
 
+    @typing.overload
+    def on(
+        self, event: Literal["pageerror"], f: typing.Callable[["PageError"], "None"]
+    ) -> None:
+        """
+        Emitted when unhandled exceptions occur on any pages created through this context. To only listen for `pageError`
+        events from a particular page, use `page.on('page_error')`."""
+
     @typing.overload
     def on(
         self, event: Literal["request"], f: typing.Callable[["Request"], "None"]
@@ -12877,6 +12899,14 @@ def once(
         **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
         need it in most cases)."""
 
+    @typing.overload
+    def once(
+        self, event: Literal["pageerror"], f: typing.Callable[["PageError"], "None"]
+    ) -> None:
+        """
+        Emitted when unhandled exceptions occur on any pages created through this context. To only listen for `pageError`
+        events from a particular page, use `page.on('page_error')`."""
+
     @typing.overload
     def once(
         self, event: Literal["request"], f: typing.Callable[["Request"], "None"]
@@ -16060,7 +16090,7 @@ def fill(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
-        To send fine-grained keyboard events, use `locator.type()`.
+        To send fine-grained keyboard events, use `locator.press_sequentially()`.
 
         Parameters
         ----------
@@ -17954,8 +17984,48 @@ def type(
     ) -> None:
         """Locator.type
 
-        **NOTE** In most cases, you should use `locator.fill()` instead. You only need to type characters if there
-        is special keyboard handling on the page.
+        Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the
+        text.
+
+        To press a special key, like `Control` or `ArrowDown`, use `locator.press()`.
+
+        **Usage**
+
+        Parameters
+        ----------
+        text : str
+            A text to type into a focused element.
+        delay : Union[float, None]
+            Time to wait between key presses in milliseconds. Defaults to 0.
+        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.
+        no_wait_after : Union[bool, None]
+            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
+            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
+            navigating to inaccessible pages. Defaults to `false`.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.type(
+                    text=text, delay=delay, timeout=timeout, noWaitAfter=no_wait_after
+                )
+            )
+        )
+
+    def press_sequentially(
+        self,
+        text: str,
+        *,
+        delay: typing.Optional[float] = None,
+        timeout: typing.Optional[float] = None,
+        no_wait_after: typing.Optional[bool] = None
+    ) -> None:
+        """Locator.press_sequentially
+
+        **NOTE** In most cases, you should use `locator.fill()` instead. You only need to press keys one by one if
+        there is special keyboard handling on the page.
 
         Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the
         text.
@@ -17965,33 +18035,33 @@ def type(
         **Usage**
 
         ```py
-        await element.type(\"hello\") # types instantly
-        await element.type(\"world\", delay=100) # types slower, like a user
+        await locator.press_sequentially(\"hello\") # types instantly
+        await locator.press_sequentially(\"world\", delay=100) # types slower, like a user
         ```
 
         ```py
-        element.type(\"hello\") # types instantly
-        element.type(\"world\", delay=100) # types slower, like a user
+        locator.press_sequentially(\"hello\") # types instantly
+        locator.press_sequentially(\"world\", delay=100) # types slower, like a user
         ```
 
         An example of typing into a text field and then submitting the form:
 
         ```py
-        element = page.get_by_label(\"Password\")
-        await element.type(\"my password\")
-        await element.press(\"Enter\")
+        locator = page.get_by_label(\"Password\")
+        await locator.press_sequentially(\"my password\")
+        await locator.press(\"Enter\")
         ```
 
         ```py
-        element = page.get_by_label(\"Password\")
-        element.type(\"my password\")
-        element.press(\"Enter\")
+        locator = page.get_by_label(\"Password\")
+        locator.press_sequentially(\"my password\")
+        locator.press(\"Enter\")
         ```
 
         Parameters
         ----------
         text : str
-            A text to type into a focused element.
+            String of characters to sequentially press into a focused element.
         delay : Union[float, None]
             Time to wait between key presses in milliseconds. Defaults to 0.
         timeout : Union[float, None]
@@ -18005,7 +18075,7 @@ def type(
 
         return mapping.from_maybe_impl(
             self._sync(
-                self._impl_obj.type(
+                self._impl_obj.press_sequentially(
                     text=text, delay=delay, timeout=timeout, noWaitAfter=no_wait_after
                 )
             )
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 866e9887b..f625143ea 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -323,7 +323,7 @@ def serialize_python_type(self, value: Any) -> str:
         str_value = str(value)
         if isinstance(value, list):
             return f"[{', '.join(list(map(lambda a: self.serialize_python_type(a), value)))}]"
-        if str_value == "<class 'playwright._impl._types.Error'>":
+        if str_value == "<class 'playwright._impl._api_types.Error'>":
             return "Error"
         if str_value == "<class 'NoneType'>":
             return "None"
@@ -472,6 +472,8 @@ def print_remainder(self) -> None:
             for [member_name, member] in clazz["members"].items():
                 if member.get("deprecated"):
                     continue
+                if class_name in ["Error"]:
+                    continue
                 entry = f"{class_name}.{member_name}"
                 if entry not in self.printed_entries:
                     self.errors.add(f"Method not implemented: {entry}")
diff --git a/scripts/expected_api_mismatch.txt b/scripts/expected_api_mismatch.txt
index e42b74650..47c084c61 100644
--- a/scripts/expected_api_mismatch.txt
+++ b/scripts/expected_api_mismatch.txt
@@ -12,8 +12,3 @@ Parameter type mismatch in BrowserContext.route(handler=): documented as Callabl
 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]
 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]]
 Parameter type mismatch in Page.unroute(handler=): documented as Union[Callable[[Route, Request], Union[Any, Any]], None], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
-
-# Temporary Fix
-Method not implemented: Error.name
-Method not implemented: Error.stack
-Method not implemented: Error.message
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index a84327eac..bfd850593 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -45,12 +45,13 @@
 from playwright._impl._fetch import APIRequest, APIRequestContext, APIResponse
 from playwright._impl._file_chooser import FileChooser
 from playwright._impl._frame import Frame
-from playwright._impl._helper import to_snake_case
+from playwright._impl._helper import Error, to_snake_case
 from playwright._impl._input import Keyboard, Mouse, Touchscreen
 from playwright._impl._js_handle import JSHandle, Serializable
 from playwright._impl._locator import FrameLocator, Locator
 from playwright._impl._network import Request, Response, Route, WebSocket
 from playwright._impl._page import Page, Worker
+from playwright._impl._page_error import PageError
 from playwright._impl._playwright import Playwright
 from playwright._impl._selectors import Selectors
 from playwright._impl._tracing import Tracing
@@ -239,6 +240,7 @@ def return_value(value: Any) -> List[str]:
 from playwright._impl._js_handle import JSHandle as JSHandleImpl
 from playwright._impl._network import Request as RequestImpl, Response as ResponseImpl, Route as RouteImpl, WebSocket as WebSocketImpl
 from playwright._impl._page import Page as PageImpl, Worker as WorkerImpl
+from playwright._impl._page_error import PageError as PageErrorImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
 from playwright._impl._selectors import Selectors as SelectorsImpl
 from playwright._impl._video import Video as VideoImpl
@@ -250,7 +252,7 @@ def return_value(value: Any) -> List[str]:
 """
 
 
-all_types = [
+generated_types = [
     Request,
     Response,
     Route,
@@ -271,6 +273,7 @@ def return_value(value: Any) -> List[str]:
     Download,
     Video,
     Page,
+    PageError,
     BrowserContext,
     CDPSession,
     Browser,
@@ -286,6 +289,10 @@ def return_value(value: Any) -> List[str]:
     APIResponseAssertions,
 ]
 
+all_types = generated_types + [
+    Error,
+]
+
 api_globals = globals()
 assert Serializable
 
diff --git a/scripts/generate_async_api.py b/scripts/generate_async_api.py
index f4d96a994..d3579a91c 100755
--- a/scripts/generate_async_api.py
+++ b/scripts/generate_async_api.py
@@ -20,9 +20,9 @@
 
 from scripts.documentation_provider import DocumentationProvider
 from scripts.generate_api import (
-    all_types,
     api_globals,
     arguments,
+    generated_types,
     get_type_hints,
     header,
     process_type,
@@ -131,7 +131,7 @@ def main() -> None:
         "from playwright._impl._async_base import AsyncEventContextManager, AsyncBase, AsyncContextManager, mapping"
     )
 
-    for t in all_types:
+    for t in generated_types:
         generate(t)
     documentation_provider.print_remainder()
 
diff --git a/scripts/generate_sync_api.py b/scripts/generate_sync_api.py
index 70c262c75..a932fa8a4 100755
--- a/scripts/generate_sync_api.py
+++ b/scripts/generate_sync_api.py
@@ -21,9 +21,9 @@
 
 from scripts.documentation_provider import DocumentationProvider
 from scripts.generate_api import (
-    all_types,
     api_globals,
     arguments,
+    generated_types,
     get_type_hints,
     header,
     process_type,
@@ -132,7 +132,7 @@ def main() -> None:
         "from playwright._impl._sync_base import EventContextManager, SyncBase, SyncContextManager, mapping"
     )
 
-    for t in all_types:
+    for t in generated_types:
         generate(t)
     documentation_provider.print_remainder()
 
diff --git a/setup.py b/setup.py
index c935ae536..12056ccef 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.37.0"
+driver_version = "1.38.0-alpha-sep-4-2023"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_browsercontext_events.py b/tests/async/test_browsercontext_events.py
index ff37015dc..e65b0750c 100644
--- a/tests/async/test_browsercontext_events.py
+++ b/tests/async/test_browsercontext_events.py
@@ -188,3 +188,11 @@ async def test_console_event_should_work_with_context_manager(page: Page) -> Non
     message = await cm_info.value
     assert message.text == "hello"
     assert message.page == page
+
+
+async def test_page_error_event_should_work(page: Page) -> None:
+    async with page.context.expect_event("pageerror") as page_error_info:
+        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
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 0630fadad..50dc91cfb 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -375,6 +375,12 @@ async def test_locators_should_type(page: Page):
     assert await page.eval_on_selector("input", "input => input.value") == "hello"
 
 
+async def test_locators_should_press_sequentially(page: Page):
+    await page.set_content("<input type='text' />")
+    await page.locator("input").press_sequentially("hello")
+    assert await page.eval_on_selector("input", "input => input.value") == "hello"
+
+
 async def test_locators_should_screenshot(
     page: Page, server: Server, assert_to_be_golden
 ):
diff --git a/tests/async/test_network.py b/tests/async/test_network.py
index f118fe384..f4072fff4 100644
--- a/tests/async/test_network.py
+++ b/tests/async/test_network.py
@@ -605,7 +605,10 @@ def handle_request(request):
                 == "Server returned nothing (no headers, no data)"
             )
         else:
-            assert failed_requests[0].failure == "Message Corrupt"
+            assert failed_requests[0].failure in [
+                "Message Corrupt",
+                "Connection terminated unexpectedly",
+            ]
     else:
         assert failed_requests[0].failure == "NS_ERROR_NET_RESET"
     assert failed_requests[0].frame
diff --git a/tests/async/test_page_network_request.py b/tests/async/test_page_network_request.py
new file mode 100644
index 000000000..f2a1383ba
--- /dev/null
+++ b/tests/async/test_page_network_request.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
+
+import pytest
+
+from playwright.async_api import Error, Page, Request
+from tests.server import Server
+
+
+async def test_should_not_allow_to_access_frame_on_popup_main_request(
+    page: Page, server: Server
+):
+    await page.set_content(f'<a target=_blank href="{server.EMPTY_PAGE}">click me</a>')
+    request_promise = asyncio.ensure_future(page.context.wait_for_event("request"))
+    popup_promise = asyncio.ensure_future(page.context.wait_for_event("page"))
+    clicked = asyncio.ensure_future(page.get_by_text("click me").click())
+    request: Request = await request_promise
+
+    assert request.is_navigation_request()
+
+    with pytest.raises(Error) as exc_info:
+        request.frame
+    assert (
+        "Frame for this navigation request is not available" in exc_info.value.message
+    )
+
+    response = await request.response()
+    await response.finished()
+    await popup_promise
+    await clicked
diff --git a/tests/async/test_page_request_intercept.py b/tests/async/test_page_request_intercept.py
index 09e6f56ce..2491645c6 100644
--- a/tests/async/test_page_request_intercept.py
+++ b/tests/async/test_page_request_intercept.py
@@ -16,7 +16,7 @@
 
 import pytest
 
-from playwright.async_api import Page, Route
+from playwright.async_api import Page, Route, expect
 from tests.server import Server
 
 
@@ -79,3 +79,18 @@ async def handle(route: Route):
     await page.goto(server.PREFIX + "/empty.html")
     request = await request_promise
     assert request.post_body.decode("utf-8") == '{"foo":"bar"}'
+
+
+async def test_should_fulfill_popup_main_request_using_alias(
+    page: Page, server: Server
+):
+    async def route_handler(route: Route):
+        response = await route.fetch()
+        await route.fulfill(response=response, body="hello")
+
+    await page.context.route("**/*", route_handler)
+    await page.set_content(f'<a target=_blank href="{server.EMPTY_PAGE}">click me</a>')
+    [popup, _] = await asyncio.gather(
+        page.wait_for_event("popup"), page.get_by_text("click me").click()
+    )
+    await expect(popup.locator("body")).to_have_text("hello")
diff --git a/tests/async/test_popup.py b/tests/async/test_popup.py
index 68ed1273d..42e4c29e5 100644
--- a/tests/async/test_popup.py
+++ b/tests/async/test_popup.py
@@ -396,6 +396,7 @@ async def test_should_work_with_clicking_target__blank(context, server):
     popup = await popup_info.value
     assert await page.evaluate("!!window.opener") is False
     assert await popup.evaluate("!!window.opener")
+    assert popup.main_frame.page == popup
 
 
 async def test_should_work_with_fake_clicking_target__blank_and_rel_noopener(
diff --git a/tests/async/test_request_fulfill.py b/tests/async/test_request_fulfill.py
index b48ae8047..3b5fa99e5 100644
--- a/tests/async/test_request_fulfill.py
+++ b/tests/async/test_request_fulfill.py
@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import json
-
 from playwright.async_api import Page, Route
 from tests.server import Server
 
@@ -39,9 +37,7 @@ async def handle(route: Route) -> None:
     assert response
     assert response.status == 201
     assert response.headers["content-type"] == "application/json"
-    assert json.loads(await page.evaluate("document.body.textContent")) == {
-        "bar": "baz"
-    }
+    assert await response.json() == {"bar": "baz"}
 
 
 async def test_should_fulfill_json_overriding_existing_response(
@@ -73,6 +69,4 @@ async def handle(route: Route) -> None:
     assert response.headers["content-type"] == "application/json"
     assert response.headers["foo"] == "bar"
     assert original["tags"] == ["a", "b"]
-    assert json.loads(await page.evaluate("document.body.textContent")) == {
-        "tags": ["c"]
-    }
+    assert await response.json() == {"tags": ["c"]}
diff --git a/tests/sync/test_request_fulfill.py b/tests/sync/test_request_fulfill.py
index d51737389..569cf5e2c 100644
--- a/tests/sync/test_request_fulfill.py
+++ b/tests/sync/test_request_fulfill.py
@@ -12,8 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import json
-
 from playwright.sync_api import Page, Route
 from tests.server import Server
 
@@ -40,7 +38,7 @@ def handle(route: Route) -> None:
     assert response
     assert response.status == 201
     assert response.headers["content-type"] == "application/json"
-    assert json.loads(page.evaluate("document.body.textContent")) == {"bar": "baz"}
+    assert response.json() == {"bar": "baz"}
 
 
 def test_should_fulfill_json_overriding_existing_response(
@@ -72,4 +70,4 @@ def handle(route: Route) -> None:
     assert response.headers["content-type"] == "application/json"
     assert response.headers["foo"] == "bar"
     assert original["tags"] == ["a", "b"]
-    assert json.loads(page.evaluate("document.body.textContent")) == {"tags": ["c"]}
+    assert response.json() == {"tags": ["c"]}

From f41668940d34df703a02f5d0a1404033292562ac Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 15 Sep 2023 21:04:19 +0200
Subject: [PATCH 093/438] chore: update dev dependencies (#2076)

---
 .pre-commit-config.yaml |  8 ++++----
 local-requirements.txt  | 36 ++++++++++++++++++------------------
 pyproject.toml          |  1 +
 scripts/__init__.py     |  0
 4 files changed, 23 insertions(+), 22 deletions(-)
 create mode 100644 scripts/__init__.py

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index f1d634094..cbb4a473d 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -15,16 +15,16 @@ repos:
       - id: check-executables-have-shebangs
       - id: check-merge-conflict
   - repo: https://github.com/psf/black
-    rev: 23.1.0
+    rev: 23.9.1
     hooks:
       - id: black
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v0.982
+    rev: v1.5.1
     hooks:
       - id: mypy
-        additional_dependencies: [types-pyOpenSSL==22.1.0.1]
+        additional_dependencies: [types-pyOpenSSL==23.2.0.2]
   - repo: https://github.com/pycqa/flake8
-    rev: 5.0.4
+    rev: 6.1.0
     hooks:
       - id: flake8
   - repo: https://github.com/pycqa/isort
diff --git a/local-requirements.txt b/local-requirements.txt
index a5655ed92..d41003744 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,24 +1,24 @@
-auditwheel==5.3.0
-autobahn==23.1.1
-black==23.1.0
-flake8==5.0.4
+auditwheel==5.4.0
+autobahn==23.1.2
+black==23.9.1
+flake8==6.1.0
 flaky==3.7.0
-mypy==0.982
-objgraph==3.5.0
-Pillow==9.4.0
+mypy==1.5.1
+objgraph==3.6.0
+Pillow==10.0.0
 pixelmatch==0.3.0
-pre-commit==2.20.0
-pyOpenSSL==23.0.0
-pytest==7.2.1
-pytest-asyncio==0.20.3
-pytest-cov==4.0.0
+pre-commit==3.4.0
+pyOpenSSL==23.2.0
+pytest==7.4.2
+pytest-asyncio==0.21.1
+pytest-cov==4.1.0
 pytest-repeat==0.9.1
 pytest-timeout==2.1.0
-pytest-xdist==3.1.0
+pytest-xdist==3.3.1
 requests==2.31.0
-service_identity==21.1.0
-setuptools==67.1.0
+service_identity==23.1.0
+setuptools==68.2.2
 twine==4.0.2
-twisted==22.10.0
-types-pyOpenSSL==23.0.0.2
-wheel==0.38.4
+twisted==23.8.0
+types-pyOpenSSL==23.2.0.2
+wheel==0.41.2
diff --git a/pyproject.toml b/pyproject.toml
index 2c8d76843..43cd8c708 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -21,6 +21,7 @@ warn_redundant_casts = true
 warn_unused_configs = true
 check_untyped_defs = true
 disallow_untyped_defs = true
+no_implicit_optional = false
 
 [[tool.mypy.overrides]]
 module = "tests/async.*"
diff --git a/scripts/__init__.py b/scripts/__init__.py
new file mode 100644
index 000000000..e69de29bb

From 7873afd0017eb1bc15955e57c276f60f1b107726 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 15 Sep 2023 22:24:08 +0200
Subject: [PATCH 094/438] chore(roll): roll Playwright to 1.38.0 (#2075)

---
 README.md                                     |  4 +-
 playwright/_impl/_browser_context.py          |  6 +--
 playwright/_impl/_js_handle.py                | 10 +++++
 .../_impl/{_page_error.py => _web_error.py}   |  2 +-
 playwright/async_api/_generated.py            | 37 +++++++++++--------
 playwright/sync_api/_generated.py             | 33 ++++++++++-------
 scripts/generate_api.py                       |  6 +--
 setup.py                                      |  2 +-
 tests/async/test_browsercontext_events.py     |  2 +-
 tests/async/test_evaluate.py                  |  8 ++++
 10 files changed, 69 insertions(+), 41 deletions(-)
 rename playwright/_impl/{_page_error.py => _web_error.py} (98%)

diff --git a/README.md b/README.md
index 39d199a75..eaf9a473a 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 -->117.0.5938.35<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->117.0.5938.62<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->115.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->117.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 03920bcde..4293f1220 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -69,9 +69,9 @@
 )
 from playwright._impl._network import Request, Response, Route, serialize_headers
 from playwright._impl._page import BindingCall, Page, Worker
-from playwright._impl._page_error import PageError
 from playwright._impl._tracing import Tracing
 from playwright._impl._wait_helper import WaitHelper
+from playwright._impl._web_error import WebError
 
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._browser import Browser
@@ -89,7 +89,7 @@ class BrowserContext(ChannelOwner):
         Console="console",
         Dialog="dialog",
         Page="page",
-        PageError="pageerror",
+        WebError="weberror",
         ServiceWorker="serviceworker",
         Request="request",
         Response="response",
@@ -567,7 +567,7 @@ def _on_dialog(self, dialog: Dialog) -> None:
                 asyncio.create_task(dialog.dismiss())
 
     async def _on_page_error(self, error: Error, page: Optional[Page]) -> None:
-        self.emit(BrowserContext.Events.PageError, PageError(self._loop, page, error))
+        self.emit(BrowserContext.Events.WebError, WebError(self._loop, page, error))
         if page:
             page.emit(Page.Events.PageError, error)
 
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index b23b61ced..374f37f74 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -195,6 +195,16 @@ def parse_value(value: Any, refs: Optional[Dict[int, Any]] = None) -> Any:
         if "bi" in value:
             return int(value["bi"])
 
+        if "m" in value:
+            v = {}
+            refs[value["m"]["id"]] = v
+            return v
+
+        if "se" in value:
+            v = set()
+            refs[value["se"]["id"]] = v
+            return v
+
         if "a" in value:
             a: List = []
             refs[value["id"]] = a
diff --git a/playwright/_impl/_page_error.py b/playwright/_impl/_web_error.py
similarity index 98%
rename from playwright/_impl/_page_error.py
rename to playwright/_impl/_web_error.py
index d57bbf9e2..eb1b51948 100644
--- a/playwright/_impl/_page_error.py
+++ b/playwright/_impl/_web_error.py
@@ -19,7 +19,7 @@
 from playwright._impl._page import Page
 
 
-class PageError:
+class WebError:
     def __init__(
         self, loop: AbstractEventLoop, page: Optional[Page], error: Error
     ) -> None:
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 65c2d0f2c..baebb4265 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -79,11 +79,11 @@
 from playwright._impl._network import WebSocket as WebSocketImpl
 from playwright._impl._page import Page as PageImpl
 from playwright._impl._page import Worker as WorkerImpl
-from playwright._impl._page_error import PageError as PageErrorImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
 from playwright._impl._selectors import Selectors as SelectorsImpl
 from playwright._impl._tracing import Tracing as TracingImpl
 from playwright._impl._video import Video as VideoImpl
+from playwright._impl._web_error import WebError as WebErrorImpl
 
 
 class Request(AsyncBase):
@@ -1302,6 +1302,9 @@ async def insert_text(self, text: str) -> None:
     async def type(self, text: str, *, delay: typing.Optional[float] = None) -> None:
         """Keyboard.type
 
+        **NOTE** In most cases, you should use `locator.fill()` instead. You only need to press keys one by one if
+        there is special keyboard handling on the page - in this case use `locator.press_sequentially()`.
+
         Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text.
 
         To press a special key, like `Control` or `ArrowDown`, use `keyboard.press()`.
@@ -1337,6 +1340,8 @@ async def type(self, text: str, *, delay: typing.Optional[float] = None) -> None
     async def press(self, key: str, *, delay: typing.Optional[float] = None) -> None:
         """Keyboard.press
 
+        **NOTE** In most cases, you should use `locator.press()` instead.
+
         `key` can specify the intended
         [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
         to generate the text for. A superset of the `key` values can be found
@@ -2335,7 +2340,7 @@ async def fill(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
-        To send fine-grained keyboard events, use `keyboard.type()`.
+        To send fine-grained keyboard events, use `locator.press_sequentially()`.
 
         Parameters
         ----------
@@ -4633,7 +4638,7 @@ async def fill(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
-        To send fine-grained keyboard events, use `frame.type()`.
+        To send fine-grained keyboard events, use `locator.press_sequentially()`.
 
         Parameters
         ----------
@@ -10278,7 +10283,7 @@ async def fill(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
-        To send fine-grained keyboard events, use `page.type()`.
+        To send fine-grained keyboard events, use `locator.press_sequentially()`.
 
         Parameters
         ----------
@@ -12484,10 +12489,10 @@ async def set_checked(
 mapping.register(PageImpl, Page)
 
 
-class PageError(AsyncBase):
+class WebError(AsyncBase):
     @property
     def page(self) -> typing.Optional["Page"]:
-        """PageError.page
+        """WebError.page
 
         The page that produced this unhandled exception, if any.
 
@@ -12499,7 +12504,7 @@ def page(self) -> typing.Optional["Page"]:
 
     @property
     def error(self) -> "Error":
-        """PageError.error
+        """WebError.error
 
         Unhandled error that was thrown.
 
@@ -12510,7 +12515,7 @@ def error(self) -> "Error":
         return mapping.from_impl(self._impl_obj.error)
 
 
-mapping.register(PageErrorImpl, PageError)
+mapping.register(WebErrorImpl, WebError)
 
 
 class BrowserContext(AsyncContextManager):
@@ -12639,12 +12644,12 @@ def on(
     @typing.overload
     def on(
         self,
-        event: Literal["pageerror"],
-        f: typing.Callable[["PageError"], "typing.Union[typing.Awaitable[None], None]"],
+        event: Literal["weberror"],
+        f: typing.Callable[["WebError"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when unhandled exceptions occur on any pages created through this context. To only listen for `pageError`
-        events from a particular page, use `page.on('page_error')`."""
+        Emitted when exception is unhandled in any of the pages in this context. To listen for errors from a particular
+        page, use `page.on('page_error')` instead."""
 
     @typing.overload
     def on(
@@ -12838,12 +12843,12 @@ def once(
     @typing.overload
     def once(
         self,
-        event: Literal["pageerror"],
-        f: typing.Callable[["PageError"], "typing.Union[typing.Awaitable[None], None]"],
+        event: Literal["weberror"],
+        f: typing.Callable[["WebError"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        Emitted when unhandled exceptions occur on any pages created through this context. To only listen for `pageError`
-        events from a particular page, use `page.on('page_error')`."""
+        Emitted when exception is unhandled in any of the pages in this context. To listen for errors from a particular
+        page, use `page.on('page_error')` instead."""
 
     @typing.overload
     def once(
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 775bc81b3..f4e575041 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -73,7 +73,6 @@
 from playwright._impl._network import WebSocket as WebSocketImpl
 from playwright._impl._page import Page as PageImpl
 from playwright._impl._page import Worker as WorkerImpl
-from playwright._impl._page_error import PageError as PageErrorImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
 from playwright._impl._selectors import Selectors as SelectorsImpl
 from playwright._impl._sync_base import (
@@ -84,6 +83,7 @@
 )
 from playwright._impl._tracing import Tracing as TracingImpl
 from playwright._impl._video import Video as VideoImpl
+from playwright._impl._web_error import WebError as WebErrorImpl
 
 
 class Request(SyncBase):
@@ -1300,6 +1300,9 @@ def insert_text(self, text: str) -> None:
     def type(self, text: str, *, delay: typing.Optional[float] = None) -> None:
         """Keyboard.type
 
+        **NOTE** In most cases, you should use `locator.fill()` instead. You only need to press keys one by one if
+        there is special keyboard handling on the page - in this case use `locator.press_sequentially()`.
+
         Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text.
 
         To press a special key, like `Control` or `ArrowDown`, use `keyboard.press()`.
@@ -1335,6 +1338,8 @@ def type(self, text: str, *, delay: typing.Optional[float] = None) -> None:
     def press(self, key: str, *, delay: typing.Optional[float] = None) -> None:
         """Keyboard.press
 
+        **NOTE** In most cases, you should use `locator.press()` instead.
+
         `key` can specify the intended
         [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) value or a single character
         to generate the text for. A superset of the `key` values can be found
@@ -2353,7 +2358,7 @@ def fill(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
-        To send fine-grained keyboard events, use `keyboard.type()`.
+        To send fine-grained keyboard events, use `locator.press_sequentially()`.
 
         Parameters
         ----------
@@ -4721,7 +4726,7 @@ def fill(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
-        To send fine-grained keyboard events, use `frame.type()`.
+        To send fine-grained keyboard events, use `locator.press_sequentially()`.
 
         Parameters
         ----------
@@ -10354,7 +10359,7 @@ def fill(
         [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be filled
         instead.
 
-        To send fine-grained keyboard events, use `page.type()`.
+        To send fine-grained keyboard events, use `locator.press_sequentially()`.
 
         Parameters
         ----------
@@ -12594,10 +12599,10 @@ def set_checked(
 mapping.register(PageImpl, Page)
 
 
-class PageError(SyncBase):
+class WebError(SyncBase):
     @property
     def page(self) -> typing.Optional["Page"]:
-        """PageError.page
+        """WebError.page
 
         The page that produced this unhandled exception, if any.
 
@@ -12609,7 +12614,7 @@ def page(self) -> typing.Optional["Page"]:
 
     @property
     def error(self) -> "Error":
-        """PageError.error
+        """WebError.error
 
         Unhandled error that was thrown.
 
@@ -12620,7 +12625,7 @@ def error(self) -> "Error":
         return mapping.from_impl(self._impl_obj.error)
 
 
-mapping.register(PageErrorImpl, PageError)
+mapping.register(WebErrorImpl, WebError)
 
 
 class BrowserContext(SyncContextManager):
@@ -12732,11 +12737,11 @@ def on(self, event: Literal["page"], f: typing.Callable[["Page"], "None"]) -> No
 
     @typing.overload
     def on(
-        self, event: Literal["pageerror"], f: typing.Callable[["PageError"], "None"]
+        self, event: Literal["weberror"], f: typing.Callable[["WebError"], "None"]
     ) -> None:
         """
-        Emitted when unhandled exceptions occur on any pages created through this context. To only listen for `pageError`
-        events from a particular page, use `page.on('page_error')`."""
+        Emitted when exception is unhandled in any of the pages in this context. To listen for errors from a particular
+        page, use `page.on('page_error')` instead."""
 
     @typing.overload
     def on(
@@ -12901,11 +12906,11 @@ def once(
 
     @typing.overload
     def once(
-        self, event: Literal["pageerror"], f: typing.Callable[["PageError"], "None"]
+        self, event: Literal["weberror"], f: typing.Callable[["WebError"], "None"]
     ) -> None:
         """
-        Emitted when unhandled exceptions occur on any pages created through this context. To only listen for `pageError`
-        events from a particular page, use `page.on('page_error')`."""
+        Emitted when exception is unhandled in any of the pages in this context. To listen for errors from a particular
+        page, use `page.on('page_error')` instead."""
 
     @typing.overload
     def once(
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index bfd850593..da5cc8ed2 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -51,11 +51,11 @@
 from playwright._impl._locator import FrameLocator, Locator
 from playwright._impl._network import Request, Response, Route, WebSocket
 from playwright._impl._page import Page, Worker
-from playwright._impl._page_error import PageError
 from playwright._impl._playwright import Playwright
 from playwright._impl._selectors import Selectors
 from playwright._impl._tracing import Tracing
 from playwright._impl._video import Video
+from playwright._impl._web_error import WebError
 
 
 def process_type(value: Any, param: bool = False) -> str:
@@ -240,7 +240,7 @@ def return_value(value: Any) -> List[str]:
 from playwright._impl._js_handle import JSHandle as JSHandleImpl
 from playwright._impl._network import Request as RequestImpl, Response as ResponseImpl, Route as RouteImpl, WebSocket as WebSocketImpl
 from playwright._impl._page import Page as PageImpl, Worker as WorkerImpl
-from playwright._impl._page_error import PageError as PageErrorImpl
+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._video import Video as VideoImpl
@@ -273,7 +273,7 @@ def return_value(value: Any) -> List[str]:
     Download,
     Video,
     Page,
-    PageError,
+    WebError,
     BrowserContext,
     CDPSession,
     Browser,
diff --git a/setup.py b/setup.py
index 12056ccef..f8d3c4046 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.38.0-alpha-sep-4-2023"
+driver_version = "1.38.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_browsercontext_events.py b/tests/async/test_browsercontext_events.py
index e65b0750c..dd8642786 100644
--- a/tests/async/test_browsercontext_events.py
+++ b/tests/async/test_browsercontext_events.py
@@ -191,7 +191,7 @@ async def test_console_event_should_work_with_context_manager(page: Page) -> Non
 
 
 async def test_page_error_event_should_work(page: Page) -> None:
-    async with page.context.expect_event("pageerror") as page_error_info:
+    async with page.context.expect_event("weberror") as page_error_info:
         await page.set_content('<script>throw new Error("boom")</script>')
     page_error = await page_error_info.value
     assert page_error.page == page
diff --git a/tests/async/test_evaluate.py b/tests/async/test_evaluate.py
index 95c528d33..bdafe0f34 100644
--- a/tests/async/test_evaluate.py
+++ b/tests/async/test_evaluate.py
@@ -69,6 +69,14 @@ async def test_evaluate_transfer_bigint(page: Page) -> None:
     assert await page.evaluate("a => a", 17) == 17
 
 
+async def test_should_transfer_maps(page):
+    assert await page.evaluate("() => new Map([[1, { test: 42n }]])") == {}
+
+
+async def test_should_transfer_sets(page):
+    assert await page.evaluate("() => new Set([1, { test: 42n }])") == set()
+
+
 async def test_evaluate_return_undefined_for_objects_with_symbols(page):
     assert await page.evaluate('[Symbol("foo4")]') == [None]
     assert (

From e57603359d6fa749f58c4bb4def50ce40ee3d0ec Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 18 Sep 2023 22:38:03 +0200
Subject: [PATCH 095/438] chore(roll): roll to new upstream RegExp / str escape
 logic (#2080)

---
 playwright/_impl/_browser_context.py |   2 +-
 playwright/_impl/_locator.py         |   9 +-
 playwright/_impl/_str_utils.py       |  20 ++-
 tests/async/test_selectors_get_by.py |  38 +++++
 tests/async/test_selectors_text.py   | 237 ++++++++++++++++++++++++++-
 5 files changed, 294 insertions(+), 12 deletions(-)

diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 4293f1220..ddb8ac41a 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -566,7 +566,7 @@ def _on_dialog(self, dialog: Dialog) -> None:
             else:
                 asyncio.create_task(dialog.dismiss())
 
-    async def _on_page_error(self, error: Error, page: Optional[Page]) -> None:
+    def _on_page_error(self, error: Error, page: Optional[Page]) -> None:
         self.emit(BrowserContext.Events.WebError, WebError(self._loop, page, error))
         if page:
             page.emit(Page.Events.PageError, error)
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 8c9a18f03..8a0c8282f 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -52,7 +52,6 @@
 from playwright._impl._str_utils import (
     escape_for_attribute_selector,
     escape_for_text_selector,
-    escape_regex_flags,
 )
 
 if sys.version_info >= (3, 8):  # pragma: no cover
@@ -847,16 +846,12 @@ def set_test_id_attribute_name(attribute_name: str) -> None:
 def get_by_test_id_selector(
     test_id_attribute_name: str, test_id: Union[str, Pattern[str]]
 ) -> str:
-    if isinstance(test_id, Pattern):
-        return f"internal:testid=[{test_id_attribute_name}=/{test_id.pattern}/{escape_regex_flags(test_id)}]"
     return f"internal:testid=[{test_id_attribute_name}={escape_for_attribute_selector(test_id, True)}]"
 
 
 def get_by_attribute_text_selector(
     attr_name: str, text: Union[str, Pattern[str]], exact: bool = None
 ) -> str:
-    if isinstance(text, Pattern):
-        return f"internal:attr=[{attr_name}=/{text.pattern}/{escape_regex_flags(text)}]"
     return f"internal:attr=[{attr_name}={escape_for_attribute_selector(text, exact=exact)}]"
 
 
@@ -915,9 +910,7 @@ def get_by_role_selector(
         props.append(
             (
                 "name",
-                f"/{name.pattern}/{escape_regex_flags(name)}"
-                if isinstance(name, Pattern)
-                else escape_for_attribute_selector(name, exact),
+                escape_for_attribute_selector(name, exact=exact),
             )
         )
     if pressed is not None:
diff --git a/playwright/_impl/_str_utils.py b/playwright/_impl/_str_utils.py
index 769f530de..8b3e65a39 100644
--- a/playwright/_impl/_str_utils.py
+++ b/playwright/_impl/_str_utils.py
@@ -39,15 +39,31 @@ def escape_for_regex(text: str) -> str:
     return re.sub(r"[.*+?^>${}()|[\]\\]", "\\$&", text)
 
 
+def escape_regex_for_selector(text: Pattern) -> str:
+    # Even number of backslashes followed by the quote -> insert a backslash.
+    return (
+        "/"
+        + re.sub(r'(^|[^\\])(\\\\)*(["\'`])', r"\1\2\\\3", text.pattern).replace(
+            ">>", "\\>\\>"
+        )
+        + "/"
+        + escape_regex_flags(text)
+    )
+
+
 def escape_for_text_selector(
     text: Union[str, Pattern[str]], exact: bool = None, case_sensitive: bool = None
 ) -> str:
     if isinstance(text, Pattern):
-        return f"/{text.pattern}/{escape_regex_flags(text)}"
+        return escape_regex_for_selector(text)
     return json.dumps(text) + ("s" if exact else "i")
 
 
-def escape_for_attribute_selector(value: str, exact: bool = None) -> str:
+def escape_for_attribute_selector(
+    value: Union[str, Pattern], exact: bool = None
+) -> str:
+    if isinstance(value, Pattern):
+        return escape_regex_for_selector(value)
     # TODO: this should actually be
     #   cssEscape(value).replace(/\\ /g, ' ')
     # However, our attribute selectors do not conform to CSS parsing spec,
diff --git a/tests/async/test_selectors_get_by.py b/tests/async/test_selectors_get_by.py
index 1a07d1a9a..718264b62 100644
--- a/tests/async/test_selectors_get_by.py
+++ b/tests/async/test_selectors_get_by.py
@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import re
+
 from playwright.async_api import Page, expect
 
 
@@ -87,6 +89,42 @@ async def test_get_by_escaping(page: Page) -> None:
         0, timeout=500
     )
 
+    await page.set_content(
+        """<label for=target>foo &gt;&gt; bar</label><input id=target>"""
+    )
+    await page.eval_on_selector(
+        "input",
+        """input => {
+        input.setAttribute('placeholder', 'foo >> bar');
+        input.setAttribute('title', 'foo >> bar');
+        input.setAttribute('alt', 'foo >> bar');
+    }""",
+    )
+    assert await page.get_by_text("foo >> bar").text_content() == "foo >> bar"
+    await expect(page.locator("label")).to_have_text("foo >> bar")
+    await expect(page.get_by_text("foo >> bar")).to_have_text("foo >> bar")
+    assert (
+        await page.get_by_text(re.compile("foo >> bar")).text_content() == "foo >> bar"
+    )
+    await expect(page.get_by_label("foo >> bar")).to_have_attribute("id", "target")
+    await expect(page.get_by_label(re.compile("foo >> bar"))).to_have_attribute(
+        "id", "target"
+    )
+    await expect(page.get_by_placeholder("foo >> bar")).to_have_attribute(
+        "id", "target"
+    )
+    await expect(page.get_by_alt_text("foo >> bar")).to_have_attribute("id", "target")
+    await expect(page.get_by_title("foo >> bar")).to_have_attribute("id", "target")
+    await expect(page.get_by_placeholder(re.compile("foo >> bar"))).to_have_attribute(
+        "id", "target"
+    )
+    await expect(page.get_by_alt_text(re.compile("foo >> bar"))).to_have_attribute(
+        "id", "target"
+    )
+    await expect(page.get_by_title(re.compile("foo >> bar"))).to_have_attribute(
+        "id", "target"
+    )
+
 
 async def test_get_by_role_escaping(
     page: Page,
diff --git a/tests/async/test_selectors_text.py b/tests/async/test_selectors_text.py
index 1f09bdebd..9de7f6b4d 100644
--- a/tests/async/test_selectors_text.py
+++ b/tests/async/test_selectors_text.py
@@ -1,6 +1,8 @@
 import re
 
-from playwright.async_api import Page, expect
+import pytest
+
+from playwright.async_api import Error, Page, expect
 
 
 async def test_has_text_and_internal_text_should_match_full_node_text_in_strict_mode(
@@ -33,3 +35,236 @@ async def test_has_text_and_internal_text_should_match_full_node_text_in_strict_
         "div1"
     )
     await expect(page.locator("div", has_text=re.compile("^hello$"))).to_have_id("div2")
+
+
+async def test_should_work(page: Page, server) -> None:
+    await page.set_content(
+        """
+        <div>yo</div><div>ya</div><div>\nye  </div>
+    """
+    )
+    assert await page.eval_on_selector("text=ya", "e => e.outerHTML") == "<div>ya</div>"
+    assert (
+        await page.eval_on_selector('text="ya"', "e => e.outerHTML") == "<div>ya</div>"
+    )
+    assert (
+        await page.eval_on_selector("text=/^[ay]+$/", "e => e.outerHTML")
+        == "<div>ya</div>"
+    )
+    assert (
+        await page.eval_on_selector("text=/Ya/i", "e => e.outerHTML") == "<div>ya</div>"
+    )
+    assert (
+        await page.eval_on_selector("text=ye", "e => e.outerHTML")
+        == "<div>\nye  </div>"
+    )
+    assert ">\nye  </div>" in await page.get_by_text("ye").evaluate("e => e.outerHTML")
+
+    await page.set_content(
+        """
+        <div> ye </div><div>ye</div>
+    """
+    )
+    assert (
+        await page.eval_on_selector('text="ye"', "e => e.outerHTML")
+        == "<div> ye </div>"
+    )
+    assert "> ye </div>" in await page.get_by_text("ye", exact=True).first.evaluate(
+        "e => e.outerHTML"
+    )
+
+    await page.set_content(
+        """
+        <div>yo</div><div>"ya</div><div> hello world! </div>
+    """
+    )
+    assert (
+        await page.eval_on_selector('text="\\"ya"', "e => e.outerHTML")
+        == '<div>"ya</div>'
+    )
+    assert (
+        await page.eval_on_selector("text=/hello/", "e => e.outerHTML")
+        == "<div> hello world! </div>"
+    )
+    assert (
+        await page.eval_on_selector("text=/^\\s*heLLo/i", "e => e.outerHTML")
+        == "<div> hello world! </div>"
+    )
+
+    await page.set_content(
+        """
+        <div>yo<div>ya</div>hey<div>hey</div></div>
+    """
+    )
+    assert (
+        await page.eval_on_selector("text=hey", "e => e.outerHTML") == "<div>hey</div>"
+    )
+    assert (
+        await page.eval_on_selector('text=yo>>text="ya"', "e => e.outerHTML")
+        == "<div>ya</div>"
+    )
+    assert (
+        await page.eval_on_selector('text=yo>> text="ya"', "e => e.outerHTML")
+        == "<div>ya</div>"
+    )
+    assert (
+        await page.eval_on_selector("text=yo >>text='ya'", "e => e.outerHTML")
+        == "<div>ya</div>"
+    )
+    assert (
+        await page.eval_on_selector("text=yo >> text='ya'", "e => e.outerHTML")
+        == "<div>ya</div>"
+    )
+    assert (
+        await page.eval_on_selector("'yo'>>\"ya\"", "e => e.outerHTML")
+        == "<div>ya</div>"
+    )
+    assert (
+        await page.eval_on_selector("\"yo\" >> 'ya'", "e => e.outerHTML")
+        == "<div>ya</div>"
+    )
+
+    await page.set_content(
+        """
+        <div>yo<span id="s1"></span></div><div>yo<span id="s2"></span><span id="s3"></span></div>
+        """
+    )
+    assert (
+        await page.eval_on_selector_all(
+            "text=yo", "es => es.map(e => e.outerHTML).join('\\n')"
+        )
+        == '<div>yo<span id="s1"></span></div>\n<div>yo<span id="s2"></span><span id="s3"></span></div>'
+    )
+
+    await page.set_content("<div>'</div><div>\"</div><div>\\</div><div>x</div>")
+    assert (
+        await page.eval_on_selector("text='\\''", "e => e.outerHTML") == "<div>'</div>"
+    )
+    assert (
+        await page.eval_on_selector("text='\"'", "e => e.outerHTML") == '<div>"</div>'
+    )
+    assert (
+        await page.eval_on_selector('text="\\""', "e => e.outerHTML") == '<div>"</div>'
+    )
+    assert (
+        await page.eval_on_selector('text="\'"', "e => e.outerHTML") == "<div>'</div>"
+    )
+    assert (
+        await page.eval_on_selector('text="\\x"', "e => e.outerHTML") == "<div>x</div>"
+    )
+    assert (
+        await page.eval_on_selector("text='\\x'", "e => e.outerHTML") == "<div>x</div>"
+    )
+    assert (
+        await page.eval_on_selector("text='\\\\'", "e => e.outerHTML")
+        == "<div>\\</div>"
+    )
+    assert (
+        await page.eval_on_selector('text="\\\\"', "e => e.outerHTML")
+        == "<div>\\</div>"
+    )
+    assert await page.eval_on_selector('text="', "e => e.outerHTML") == '<div>"</div>'
+    assert await page.eval_on_selector("text='", "e => e.outerHTML") == "<div>'</div>"
+    assert await page.eval_on_selector('"x"', "e => e.outerHTML") == "<div>x</div>"
+    assert await page.eval_on_selector("'x'", "e => e.outerHTML") == "<div>x</div>"
+    with pytest.raises(Error):
+        await page.query_selector_all('"')
+    with pytest.raises(Error):
+        await page.query_selector_all("'")
+
+    await page.set_content("<div> ' </div><div> \" </div>")
+    assert await page.eval_on_selector('text="', "e => e.outerHTML") == '<div> " </div>'
+    assert await page.eval_on_selector("text='", "e => e.outerHTML") == "<div> ' </div>"
+
+    await page.set_content("<div>Hi''&gt;&gt;foo=bar</div>")
+    assert (
+        await page.eval_on_selector("text=\"Hi''>>foo=bar\"", "e => e.outerHTML")
+        == "<div>Hi''&gt;&gt;foo=bar</div>"
+    )
+    await page.set_content("<div>Hi'\"&gt;&gt;foo=bar</div>")
+    assert (
+        await page.eval_on_selector('text="Hi\'\\">>foo=bar"', "e => e.outerHTML")
+        == "<div>Hi'\"&gt;&gt;foo=bar</div>"
+    )
+
+    await page.set_content("<div>Hi&gt;&gt;<span></span></div>")
+    assert (
+        await page.eval_on_selector('text="Hi>>">>span', "e => e.outerHTML")
+        == "<span></span>"
+    )
+    assert (
+        await page.eval_on_selector("text=/Hi\\>\\>/ >> span", "e => e.outerHTML")
+        == "<span></span>"
+    )
+
+    await page.set_content("<div>a<br>b</div><div>a</div>")
+    assert (
+        await page.eval_on_selector("text=a", "e => e.outerHTML") == "<div>a<br>b</div>"
+    )
+    assert (
+        await page.eval_on_selector("text=b", "e => e.outerHTML") == "<div>a<br>b</div>"
+    )
+    assert (
+        await page.eval_on_selector("text=ab", "e => e.outerHTML")
+        == "<div>a<br>b</div>"
+    )
+    assert await page.query_selector("text=abc") is None
+    assert await page.eval_on_selector_all("text=a", "els => els.length") == 2
+    assert await page.eval_on_selector_all("text=b", "els => els.length") == 1
+    assert await page.eval_on_selector_all("text=ab", "els => els.length") == 1
+    assert await page.eval_on_selector_all("text=abc", "els => els.length") == 0
+
+    await page.set_content("<div></div><span></span>")
+    await page.eval_on_selector(
+        "div",
+        """div => {
+        div.appendChild(document.createTextNode('hello'))
+        div.appendChild(document.createTextNode('world'))
+    }""",
+    )
+    await page.eval_on_selector(
+        "span",
+        """span => {
+        span.appendChild(document.createTextNode('hello'))
+        span.appendChild(document.createTextNode('world'))
+    }""",
+    )
+    assert (
+        await page.eval_on_selector("text=lowo", "e => e.outerHTML")
+        == "<div>helloworld</div>"
+    )
+    assert (
+        await page.eval_on_selector_all(
+            "text=lowo", "els => els.map(e => e.outerHTML).join('')"
+        )
+        == "<div>helloworld</div><span>helloworld</span>"
+    )
+
+    await page.set_content("<span>Sign&nbsp;in</span><span>Hello\n \nworld</span>")
+    assert (
+        await page.eval_on_selector("text=Sign in", "e => e.outerHTML")
+        == "<span>Sign&nbsp;in</span>"
+    )
+    assert len((await page.query_selector_all("text=Sign \tin"))) == 1
+    assert len((await page.query_selector_all('text="Sign in"'))) == 1
+    assert (
+        await page.eval_on_selector("text=lo wo", "e => e.outerHTML")
+        == "<span>Hello\n \nworld</span>"
+    )
+    assert (
+        await page.eval_on_selector('text="Hello world"', "e => e.outerHTML")
+        == "<span>Hello\n \nworld</span>"
+    )
+    assert await page.query_selector('text="lo wo"') is None
+    assert len((await page.query_selector_all("text=lo \nwo"))) == 1
+    assert len(await page.query_selector_all('text="lo \nwo"')) == 0
+
+    await page.set_content("<div>let's<span>hello</span></div>")
+    assert (
+        await page.eval_on_selector("text=/let's/i >> span", "e => e.outerHTML")
+        == "<span>hello</span>"
+    )
+    assert (
+        await page.eval_on_selector("text=/let\\'s/i >> span", "e => e.outerHTML")
+        == "<span>hello</span>"
+    )

From f1c44c15fe69ff5975c14c27825e77b5b6510db3 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 19 Sep 2023 00:04:51 +0200
Subject: [PATCH 096/438] devops: Set up CI/CD with Azure Pipelines (#2054)

---
 .azure-pipelines/publish.yml  | 35 +++++++++++++++++++++++++++++++++++
 .github/workflows/publish.yml | 21 ---------------------
 2 files changed, 35 insertions(+), 21 deletions(-)
 create mode 100644 .azure-pipelines/publish.yml

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
new file mode 100644
index 000000000..8e209dacd
--- /dev/null
+++ b/.azure-pipelines/publish.yml
@@ -0,0 +1,35 @@
+trigger:
+  tags:
+    include:
+    - '*'
+
+pool:
+  vmImage: ubuntu-latest
+
+steps:
+- task: UsePythonVersion@0
+  inputs:
+    versionSpec: '3.8'
+  displayName: 'Use Python'
+
+- script: |
+    python -m pip install --upgrade pip
+    pip install -r local-requirements.txt
+    pip install -e .
+    python setup.py bdist_wheel --all
+  displayName: 'Install & Build'
+
+- task: EsrpRelease@4
+  inputs:
+    ConnectedServiceName: 'Playwright-ESRP'
+    Intent: 'PackageDistribution'
+    ContentType: 'PyPi'
+    ContentSource: 'Folder'
+    FolderLocation: './dist/'
+    WaitForReleaseCompletion: true
+    Owners: 'maxschmitt@microsoft.com'
+    Approvers: 'maxschmitt@microsoft.com'
+    ServiceEndpointUrl: 'https://api.esrp.microsoft.com'
+    MainPublisher: 'Playwright'
+    DomainTenantId: '72f988bf-86f1-41af-91ab-2d7cd011db47'
+  displayName: 'ESRP Release to PIP'
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 191d8a387..5ef512838 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -3,27 +3,6 @@ on:
   release:
     types: [published]
 jobs:
-  deploy-pypi:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python
-      uses: actions/setup-python@v4
-      with:
-        python-version: 3.9
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install -r local-requirements.txt
-        pip install -e .
-        python setup.py bdist_wheel --all
-        python -m playwright install-deps
-    - name: Publish package
-      env:
-        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
-        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
-      run: twine upload dist/*
-
   deploy-conda:
     strategy:
       matrix:

From 34175c6dfed89721679af761918723b8a52ccc42 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 6 Oct 2023 13:29:36 +0000
Subject: [PATCH 097/438] build(deps): bump pillow from 10.0.0 to 10.0.1
 (#2099)

Bumps [pillow](https://github.com/python-pillow/Pillow) from 10.0.0 to 10.0.1.
- [Release notes](https://github.com/python-pillow/Pillow/releases)
- [Changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst)
- [Commits](https://github.com/python-pillow/Pillow/compare/10.0.0...10.0.1)

---
updated-dependencies:
- dependency-name: pillow
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index d41003744..f8f6e524f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -5,7 +5,7 @@ flake8==6.1.0
 flaky==3.7.0
 mypy==1.5.1
 objgraph==3.6.0
-Pillow==10.0.0
+Pillow==10.0.1
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==23.2.0

From e81afd41201b7ba0df0df99cdef956bed3d3e961 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 10 Oct 2023 18:03:38 +0200
Subject: [PATCH 098/438] devops: don't trigger AzDO Pipeline on PRs (#2107)

---
 .azure-pipelines/publish.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index 8e209dacd..74c85ea53 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -1,3 +1,6 @@
+# don't trigger for Pull Requests
+pr: none
+
 trigger:
   tags:
     include:

From 2886f00c94edd0f4a5b6c30e7114844a63f666b5 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 11 Oct 2023 18:05:45 +0200
Subject: [PATCH 099/438] chore: roll Playwright to 1.39.0-alpha-oct-10-2023
 (#2109)

---
 README.md                            |  12 +-
 playwright/_impl/_assertions.py      |   2 +-
 playwright/_impl/_browser_context.py |   5 +-
 playwright/_impl/_connection.py      |   6 +-
 playwright/_impl/_console_message.py |  30 +++--
 playwright/_impl/_js_handle.py       |  10 --
 playwright/_impl/_local_utils.py     |  15 +++
 playwright/_impl/_object_factory.py  |   3 -
 playwright/_impl/_playwright.py      |  19 +---
 playwright/async_api/_generated.py   | 157 +++++++++++++++++++--------
 playwright/sync_api/_generated.py    | 157 +++++++++++++++++++--------
 setup.py                             |   2 +-
 tests/async/test_evaluate.py         |   8 --
 tests/async/test_keyboard.py         |   2 -
 14 files changed, 263 insertions(+), 165 deletions(-)

diff --git a/README.md b/README.md
index eaf9a473a..c8f53740a 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,12 @@
-# 🎭 [Playwright](https://playwright.dev) for Python [![PyPI version](https://badge.fury.io/py/playwright.svg)](https://pypi.python.org/pypi/playwright/) [![Anaconda version](https://img.shields.io/conda/v/microsoft/playwright)](https://anaconda.org/Microsoft/playwright) [![Join Slack](https://img.shields.io/badge/join-slack-infomational)](https://aka.ms/playwright-slack)
+# 🎭 [Playwright](https://playwright.dev) for Python [![PyPI version](https://badge.fury.io/py/playwright.svg)](https://pypi.python.org/pypi/playwright/) [![Anaconda version](https://img.shields.io/conda/v/microsoft/playwright)](https://anaconda.org/Microsoft/playwright) [![Join Discord](https://img.shields.io/badge/join-discord-infomational)](https://aka.ms/playwright/discord)
 
 Playwright is a Python library to automate [Chromium](https://www.chromium.org/Home), [Firefox](https://www.mozilla.org/en-US/firefox/new/) and [WebKit](https://webkit.org/) browsers with a single API. Playwright delivers automation that is **ever-green**, **capable**, **reliable** and **fast**. [See how Playwright is better](https://playwright.dev/python/docs/why-playwright).
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->117.0.5938.62<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->119.0.6045.9<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->117.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->118.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
@@ -49,6 +49,6 @@ asyncio.run(main())
 ## Other languages
 
 More comfortable in another programming language? [Playwright](https://playwright.dev) is also available in
-- [Node.js (JavaScript / TypeScript)](https://playwright.dev/docs/intro)
-- [.NET](https://playwright.dev/dotnet/docs/intro)
-- [Java](https://playwright.dev/java/docs/intro)
+- [Node.js (JavaScript / TypeScript)](https://playwright.dev/docs/intro),
+- [.NET](https://playwright.dev/dotnet/docs/intro),
+- [Java](https://playwright.dev/java/docs/intro).
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 46e54a9f3..f54a672e1 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -220,7 +220,7 @@ async def to_have_attribute(
         __tracebackhide__ = True
         expected_text = to_expected_text_values([value])
         await self._expect_impl(
-            "to.have.attribute",
+            "to.have.attribute.value",
             FrameExpectOptions(
                 expressionArg=name, expectedText=expected_text, timeout=timeout
             ),
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index ddb8ac41a..1c7c546fe 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -145,7 +145,7 @@ def __init__(
         )
         self._channel.on(
             "console",
-            lambda params: self._on_console_message(from_channel(params["message"])),
+            lambda event: self._on_console_message(event),
         )
 
         self._channel.on(
@@ -545,7 +545,8 @@ def _on_request_finished(
         if response:
             response._finished_future.set_result(True)
 
-    def _on_console_message(self, message: ConsoleMessage) -> None:
+    def _on_console_message(self, event: Dict) -> None:
+        message = ConsoleMessage(event, self._loop, self._dispatcher_fiber)
         self.emit(BrowserContext.Events.Console, message)
         page = message.page
         if page:
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 45e80b003..e11612fcf 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -345,12 +345,12 @@ def _send_message_to_server(
                 "internal": not stack_trace_information["apiName"],
             },
         }
-        self._transport.send(message)
-        self._callbacks[id] = callback
-
         if self._tracing_count > 0 and frames and guid != "localUtils":
             self.local_utils.add_stack_to_tracing_no_reply(id, frames)
 
+        self._transport.send(message)
+        self._callbacks[id] = callback
+
         return callback
 
     def dispatch(self, msg: ParsedMessagePayload) -> None:
diff --git a/playwright/_impl/_console_message.py b/playwright/_impl/_console_message.py
index 9bed32ac8..ba8fc0a38 100644
--- a/playwright/_impl/_console_message.py
+++ b/playwright/_impl/_console_message.py
@@ -12,29 +12,25 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from typing import TYPE_CHECKING, Dict, List, Optional
+from asyncio import AbstractEventLoop
+from typing import TYPE_CHECKING, Any, Dict, List, Optional
 
 from playwright._impl._api_structures import SourceLocation
-from playwright._impl._connection import (
-    ChannelOwner,
-    from_channel,
-    from_nullable_channel,
-)
+from playwright._impl._connection import from_channel, from_nullable_channel
 from playwright._impl._js_handle import JSHandle
 
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._page import Page
 
 
-class ConsoleMessage(ChannelOwner):
+class ConsoleMessage:
     def __init__(
-        self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
+        self, event: Dict, loop: AbstractEventLoop, dispatcher_fiber: Any
     ) -> None:
-        super().__init__(parent, type, guid, initializer)
-        # Note: currently, we only report console messages for pages and they always have a page.
-        # However, in the future we might report console messages for service workers or something else,
-        # where page() would be null.
-        self._page: Optional["Page"] = from_nullable_channel(initializer.get("page"))
+        self._event = event
+        self._loop = loop
+        self._dispatcher_fiber = dispatcher_fiber
+        self._page: Optional["Page"] = from_nullable_channel(event.get("page"))
 
     def __repr__(self) -> str:
         return f"<ConsoleMessage type={self.type} text={self.text}>"
@@ -44,19 +40,19 @@ def __str__(self) -> str:
 
     @property
     def type(self) -> str:
-        return self._initializer["type"]
+        return self._event["type"]
 
     @property
     def text(self) -> str:
-        return self._initializer["text"]
+        return self._event["text"]
 
     @property
     def args(self) -> List[JSHandle]:
-        return list(map(from_channel, self._initializer["args"]))
+        return list(map(from_channel, self._event["args"]))
 
     @property
     def location(self) -> SourceLocation:
-        return self._initializer["location"]
+        return self._event["location"]
 
     @property
     def page(self) -> Optional["Page"]:
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 374f37f74..b23b61ced 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -195,16 +195,6 @@ def parse_value(value: Any, refs: Optional[Dict[int, Any]] = None) -> Any:
         if "bi" in value:
             return int(value["bi"])
 
-        if "m" in value:
-            v = {}
-            refs[value["m"]["id"]] = v
-            return v
-
-        if "se" in value:
-            v = set()
-            refs[value["se"]["id"]] = v
-            return v
-
         if "a" in value:
             a: List = []
             refs[value["id"]] = a
diff --git a/playwright/_impl/_local_utils.py b/playwright/_impl/_local_utils.py
index af0683ed2..7172ee58a 100644
--- a/playwright/_impl/_local_utils.py
+++ b/playwright/_impl/_local_utils.py
@@ -25,6 +25,10 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        self.devices = {
+            device["name"]: parse_device_descriptor(device["descriptor"])
+            for device in initializer["deviceDescriptors"]
+        }
 
     async def zip(self, params: Dict) -> None:
         await self._channel.send("zip", params)
@@ -75,3 +79,14 @@ def add_stack_to_tracing_no_reply(self, id: int, frames: List[StackFrame]) -> No
                 }
             },
         )
+
+
+def parse_device_descriptor(dict: Dict) -> Dict:
+    return {
+        "user_agent": dict["userAgent"],
+        "viewport": dict["viewport"],
+        "device_scale_factor": dict["deviceScaleFactor"],
+        "is_mobile": dict["isMobile"],
+        "has_touch": dict["hasTouch"],
+        "default_browser_type": dict["defaultBrowserType"],
+    }
diff --git a/playwright/_impl/_object_factory.py b/playwright/_impl/_object_factory.py
index f6dc4a260..2652e41fe 100644
--- a/playwright/_impl/_object_factory.py
+++ b/playwright/_impl/_object_factory.py
@@ -20,7 +20,6 @@
 from playwright._impl._browser_type import BrowserType
 from playwright._impl._cdp_session import CDPSession
 from playwright._impl._connection import ChannelOwner
-from playwright._impl._console_message import ConsoleMessage
 from playwright._impl._dialog import Dialog
 from playwright._impl._element_handle import ElementHandle
 from playwright._impl._fetch import APIRequestContext
@@ -60,8 +59,6 @@ def create_remote_object(
         return BrowserContext(parent, type, guid, initializer)
     if type == "CDPSession":
         return CDPSession(parent, type, guid, initializer)
-    if type == "ConsoleMessage":
-        return ConsoleMessage(parent, type, guid, initializer)
     if type == "Dialog":
         return Dialog(parent, type, guid, initializer)
     if type == "ElementHandle":
diff --git a/playwright/_impl/_playwright.py b/playwright/_impl/_playwright.py
index d3edfacc1..c02e73316 100644
--- a/playwright/_impl/_playwright.py
+++ b/playwright/_impl/_playwright.py
@@ -17,7 +17,6 @@
 from playwright._impl._browser_type import BrowserType
 from playwright._impl._connection import ChannelOwner, from_channel
 from playwright._impl._fetch import APIRequest
-from playwright._impl._local_utils import LocalUtils
 from playwright._impl._selectors import Selectors, SelectorsOwner
 
 
@@ -48,12 +47,7 @@ def __init__(
         self._connection.on(
             "close", lambda: self.selectors._remove_channel(selectors_owner)
         )
-        self.devices = {}
-        self.devices = {
-            device["name"]: parse_device_descriptor(device["descriptor"])
-            for device in initializer["deviceDescriptors"]
-        }
-        self._utils: LocalUtils = from_channel(initializer["utils"])
+        self.devices = self._connection.local_utils.devices
 
     def __getitem__(self, value: str) -> "BrowserType":
         if value == "chromium":
@@ -72,14 +66,3 @@ def _set_selectors(self, selectors: Selectors) -> None:
 
     async def stop(self) -> None:
         pass
-
-
-def parse_device_descriptor(dict: Dict) -> Dict:
-    return {
-        "user_agent": dict["userAgent"],
-        "viewport": dict["viewport"],
-        "device_scale_factor": dict["deviceScaleFactor"],
-        "is_mobile": dict["isMobile"],
-        "has_touch": dict["hasTouch"],
-        "default_browser_type": dict["defaultBrowserType"],
-    }
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index baebb4265..0b08eb102 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -2206,7 +2206,7 @@ async def select_option(
         **Usage**
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         await handle.select_option(\"blue\")
         # single selection matching the label
         await handle.select_option(label=\"blue\")
@@ -2215,7 +2215,7 @@ async def select_option(
         ```
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         handle.select_option(\"blue\")
         # single selection matching both the label
         handle.select_option(label=\"blue\")
@@ -3804,9 +3804,9 @@ async def wait_for_selector(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             chromium = playwright.chromium
             browser = await chromium.launch()
             page = await browser.new_page()
@@ -3823,9 +3823,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             chromium = playwright.chromium
             browser = chromium.launch()
             page = browser.new_page()
@@ -5597,7 +5597,7 @@ async def select_option(
         **Usage**
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         await frame.select_option(\"select#colors\", \"blue\")
         # single selection matching the label
         await frame.select_option(\"select#colors\", label=\"blue\")
@@ -5606,7 +5606,7 @@ async def select_option(
         ```
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         frame.select_option(\"select#colors\", \"blue\")
         # single selection matching both the label
         frame.select_option(\"select#colors\", label=\"blue\")
@@ -6029,9 +6029,9 @@ async def wait_for_function(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch()
             page = await browser.new_page()
@@ -6046,9 +6046,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch()
             page = browser.new_page()
@@ -6927,9 +6927,9 @@ async def register(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             tag_selector = \"\"\"
               {
                   // Returns the first element matching given selector in the root's subtree.
@@ -6965,9 +6965,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             tag_selector = \"\"\"
               {
                   // Returns the first element matching given selector in the root's subtree.
@@ -8245,9 +8245,9 @@ async def wait_for_selector(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             chromium = playwright.chromium
             browser = await chromium.launch()
             page = await browser.new_page()
@@ -8264,9 +8264,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             chromium = playwright.chromium
             browser = chromium.launch()
             page = browser.new_page()
@@ -8923,14 +8923,14 @@ async def expose_function(self, name: str, callback: typing.Callable) -> None:
         ```py
         import asyncio
         import hashlib
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
         def sha256(text):
             m = hashlib.sha256()
             m.update(bytes(text, \"utf8\"))
             return m.hexdigest()
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch(headless=False)
             page = await browser.new_page()
@@ -8954,14 +8954,14 @@ async def main():
 
         ```py
         import hashlib
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
         def sha256(text):
             m = hashlib.sha256()
             m.update(bytes(text, \"utf8\"))
             return m.hexdigest()
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch(headless=False)
             page = browser.new_page()
@@ -9021,9 +9021,9 @@ async def expose_binding(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch(headless=false)
             context = await browser.new_context()
@@ -9047,9 +9047,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch(headless=false)
             context = browser.new_context()
@@ -11267,7 +11267,7 @@ async def select_option(
         **Usage**
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         await page.select_option(\"select#colors\", \"blue\")
         # single selection matching the label
         await page.select_option(\"select#colors\", label=\"blue\")
@@ -11276,7 +11276,7 @@ async def select_option(
         ```
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         page.select_option(\"select#colors\", \"blue\")
         # single selection matching both the label
         page.select_option(\"select#colors\", label=\"blue\")
@@ -11740,9 +11740,9 @@ async def wait_for_function(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch()
             page = await browser.new_page()
@@ -11757,9 +11757,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch()
             page = browser.new_page()
@@ -13299,9 +13299,9 @@ async def expose_binding(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch(headless=false)
             context = await browser.new_context()
@@ -13325,9 +13325,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch(headless=false)
             context = browser.new_context()
@@ -13412,14 +13412,14 @@ async def expose_function(self, name: str, callback: typing.Callable) -> None:
         ```py
         import asyncio
         import hashlib
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        def sha256(text):
+        def sha256(text: str) -> str:
             m = hashlib.sha256()
             m.update(bytes(text, \"utf8\"))
             return m.hexdigest()
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch(headless=False)
             context = await browser.new_context()
@@ -13446,12 +13446,12 @@ async def main():
         import hashlib
         from playwright.sync_api import sync_playwright
 
-        def sha256(text):
+        def sha256(text: str) -> str:
             m = hashlib.sha256()
             m.update(bytes(text, \"utf8\"))
             return m.hexdigest()
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch(headless=False)
             context = browser.new_context()
@@ -15141,9 +15141,9 @@ def devices(self) -> typing.Dict:
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             iphone = playwright.devices[\"iPhone 6\"]
             browser = await webkit.launch()
@@ -15160,9 +15160,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             iphone = playwright.devices[\"iPhone 6\"]
             browser = webkit.launch()
@@ -16926,6 +16926,9 @@ async def count(self) -> int:
 
         Returns the number of elements matching the locator.
 
+        **NOTE** If you need to assert the number of elements on the page, prefer `locator_assertions.to_have_count()`
+        to avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17034,6 +17037,9 @@ async def get_attribute(
 
         Returns the matching element's attribute value.
 
+        **NOTE** If you need to assert an element's attribute, prefer `locator_assertions.to_have_attribute()` to
+        avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         Parameters
         ----------
         name : str
@@ -17146,6 +17152,9 @@ async def inner_text(self, *, timeout: typing.Optional[float] = None) -> str:
 
         Returns the [`element.innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText).
 
+        **NOTE** If you need to assert text on the page, prefer `locator_assertions.to_have_text()` with
+        `useInnerText` option to avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17164,6 +17173,9 @@ async def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
 
         Returns the value for the matching `<input>` or `<textarea>` or `<select>` element.
 
+        **NOTE** If you need to assert input value, prefer `locator_assertions.to_have_value()` to avoid flakiness.
+        See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17201,6 +17213,9 @@ async def is_checked(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is checked. Throws if the element is not a checkbox or radio input.
 
+        **NOTE** If you need to assert that checkbox is checked, prefer `locator_assertions.to_be_checked()` to avoid
+        flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17229,6 +17244,9 @@ async def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is disabled, the opposite of [enabled](https://playwright.dev/python/docs/actionability#enabled).
 
+        **NOTE** If you need to assert that an element is disabled, prefer `locator_assertions.to_be_disabled()` to
+        avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17259,6 +17277,9 @@ async def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable).
 
+        **NOTE** If you need to assert that an element is editable, prefer `locator_assertions.to_be_editable()` to
+        avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17289,6 +17310,9 @@ async def is_enabled(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [enabled](https://playwright.dev/python/docs/actionability#enabled).
 
+        **NOTE** If you need to assert that an element is enabled, prefer `locator_assertions.to_be_enabled()` to
+        avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17317,6 +17341,9 @@ async def is_hidden(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).
 
+        **NOTE** If you need to assert that element is hidden, prefer `locator_assertions.to_be_hidden()` to avoid
+        flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17344,6 +17371,9 @@ async def is_visible(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible).
 
+        **NOTE** If you need to assert that element is visible, prefer `locator_assertions.to_be_visible()` to avoid
+        flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17840,6 +17870,9 @@ async def text_content(
 
         Returns the [`node.textContent`](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent).
 
+        **NOTE** If you need to assert text on the page, prefer `locator_assertions.to_have_text()` to avoid
+        flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -18031,6 +18064,9 @@ async def all_inner_texts(self) -> typing.List[str]:
 
         Returns an array of `node.innerText` values for all matching nodes.
 
+        **NOTE** If you need to assert text on the page, prefer `locator_assertions.to_have_text()` with
+        `useInnerText` option to avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -18053,6 +18089,9 @@ async def all_text_contents(self) -> typing.List[str]:
 
         Returns an array of `node.textContent` values for all matching nodes.
 
+        **NOTE** If you need to assert text on the page, prefer `locator_assertions.to_have_text()` to avoid
+        flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -20479,14 +20518,38 @@ async def to_be_visible(
         Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/actionability#attached) and
         [visible](https://playwright.dev/python/docs/actionability#visible) DOM node.
 
+        To check that at least one element from the list is visible, use `locator.first()`.
+
         **Usage**
 
         ```py
+        # A specific element is visible.
         await expect(page.get_by_text(\"Welcome\")).to_be_visible()
+
+        # At least one item in the list is visible.
+        await expect(page.get_by_test_id(\"todo-item\").first).to_be_visible()
+
+        # At least one of the two elements is visible, possibly both.
+        await expect(
+            page.get_by_role(\"button\", name=\"Sign in\")
+            .or_(page.get_by_role(\"button\", name=\"Sign up\"))
+            .first
+        ).to_be_visible()
         ```
 
         ```py
+        # A specific element is visible.
         expect(page.get_by_text(\"Welcome\")).to_be_visible()
+
+        # At least one item in the list is visible.
+        expect(page.get_by_test_id(\"todo-item\").first).to_be_visible()
+
+        # At least one of the two elements is visible, possibly both.
+        expect(
+            page.get_by_role(\"button\", name=\"Sign in\")
+            .or_(page.get_by_role(\"button\", name=\"Sign up\"))
+            .first
+        ).to_be_visible()
         ```
 
         Parameters
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index f4e575041..ce7df8109 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -2220,7 +2220,7 @@ def select_option(
         **Usage**
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         await handle.select_option(\"blue\")
         # single selection matching the label
         await handle.select_option(label=\"blue\")
@@ -2229,7 +2229,7 @@ def select_option(
         ```
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         handle.select_option(\"blue\")
         # single selection matching both the label
         handle.select_option(label=\"blue\")
@@ -3860,9 +3860,9 @@ def wait_for_selector(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             chromium = playwright.chromium
             browser = await chromium.launch()
             page = await browser.new_page()
@@ -3879,9 +3879,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             chromium = playwright.chromium
             browser = chromium.launch()
             page = browser.new_page()
@@ -5699,7 +5699,7 @@ def select_option(
         **Usage**
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         await frame.select_option(\"select#colors\", \"blue\")
         # single selection matching the label
         await frame.select_option(\"select#colors\", label=\"blue\")
@@ -5708,7 +5708,7 @@ def select_option(
         ```
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         frame.select_option(\"select#colors\", \"blue\")
         # single selection matching both the label
         frame.select_option(\"select#colors\", label=\"blue\")
@@ -6145,9 +6145,9 @@ def wait_for_function(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch()
             page = await browser.new_page()
@@ -6162,9 +6162,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch()
             page = browser.new_page()
@@ -7045,9 +7045,9 @@ def register(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             tag_selector = \"\"\"
               {
                   // Returns the first element matching given selector in the root's subtree.
@@ -7083,9 +7083,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             tag_selector = \"\"\"
               {
                   // Returns the first element matching given selector in the root's subtree.
@@ -8265,9 +8265,9 @@ def wait_for_selector(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             chromium = playwright.chromium
             browser = await chromium.launch()
             page = await browser.new_page()
@@ -8284,9 +8284,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             chromium = playwright.chromium
             browser = chromium.launch()
             page = browser.new_page()
@@ -8969,14 +8969,14 @@ def expose_function(self, name: str, callback: typing.Callable) -> None:
         ```py
         import asyncio
         import hashlib
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
         def sha256(text):
             m = hashlib.sha256()
             m.update(bytes(text, \"utf8\"))
             return m.hexdigest()
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch(headless=False)
             page = await browser.new_page()
@@ -9000,14 +9000,14 @@ async def main():
 
         ```py
         import hashlib
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
         def sha256(text):
             m = hashlib.sha256()
             m.update(bytes(text, \"utf8\"))
             return m.hexdigest()
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch(headless=False)
             page = browser.new_page()
@@ -9069,9 +9069,9 @@ def expose_binding(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch(headless=false)
             context = await browser.new_context()
@@ -9095,9 +9095,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch(headless=false)
             context = browser.new_context()
@@ -11357,7 +11357,7 @@ def select_option(
         **Usage**
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         await page.select_option(\"select#colors\", \"blue\")
         # single selection matching the label
         await page.select_option(\"select#colors\", label=\"blue\")
@@ -11366,7 +11366,7 @@ def select_option(
         ```
 
         ```py
-        # single selection matching the value
+        # Single selection matching the value or label
         page.select_option(\"select#colors\", \"blue\")
         # single selection matching both the label
         page.select_option(\"select#colors\", label=\"blue\")
@@ -11844,9 +11844,9 @@ def wait_for_function(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch()
             page = await browser.new_page()
@@ -11861,9 +11861,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch()
             page = browser.new_page()
@@ -13347,9 +13347,9 @@ def expose_binding(
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch(headless=false)
             context = await browser.new_context()
@@ -13373,9 +13373,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch(headless=false)
             context = browser.new_context()
@@ -13462,14 +13462,14 @@ def expose_function(self, name: str, callback: typing.Callable) -> None:
         ```py
         import asyncio
         import hashlib
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        def sha256(text):
+        def sha256(text: str) -> str:
             m = hashlib.sha256()
             m.update(bytes(text, \"utf8\"))
             return m.hexdigest()
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = await webkit.launch(headless=False)
             context = await browser.new_context()
@@ -13496,12 +13496,12 @@ async def main():
         import hashlib
         from playwright.sync_api import sync_playwright
 
-        def sha256(text):
+        def sha256(text: str) -> str:
             m = hashlib.sha256()
             m.update(bytes(text, \"utf8\"))
             return m.hexdigest()
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             browser = webkit.launch(headless=False)
             context = browser.new_context()
@@ -15213,9 +15213,9 @@ def devices(self) -> typing.Dict:
 
         ```py
         import asyncio
-        from playwright.async_api import async_playwright
+        from playwright.async_api import async_playwright, Playwright
 
-        async def run(playwright):
+        async def run(playwright: Playwright):
             webkit = playwright.webkit
             iphone = playwright.devices[\"iPhone 6\"]
             browser = await webkit.launch()
@@ -15232,9 +15232,9 @@ async def main():
         ```
 
         ```py
-        from playwright.sync_api import sync_playwright
+        from playwright.sync_api import sync_playwright, Playwright
 
-        def run(playwright):
+        def run(playwright: Playwright):
             webkit = playwright.webkit
             iphone = playwright.devices[\"iPhone 6\"]
             browser = webkit.launch()
@@ -17022,6 +17022,9 @@ def count(self) -> int:
 
         Returns the number of elements matching the locator.
 
+        **NOTE** If you need to assert the number of elements on the page, prefer `locator_assertions.to_have_count()`
+        to avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17132,6 +17135,9 @@ def get_attribute(
 
         Returns the matching element's attribute value.
 
+        **NOTE** If you need to assert an element's attribute, prefer `locator_assertions.to_have_attribute()` to
+        avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         Parameters
         ----------
         name : str
@@ -17248,6 +17254,9 @@ def inner_text(self, *, timeout: typing.Optional[float] = None) -> str:
 
         Returns the [`element.innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText).
 
+        **NOTE** If you need to assert text on the page, prefer `locator_assertions.to_have_text()` with
+        `useInnerText` option to avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17268,6 +17277,9 @@ def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
 
         Returns the value for the matching `<input>` or `<textarea>` or `<select>` element.
 
+        **NOTE** If you need to assert input value, prefer `locator_assertions.to_have_value()` to avoid flakiness.
+        See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17305,6 +17317,9 @@ def is_checked(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is checked. Throws if the element is not a checkbox or radio input.
 
+        **NOTE** If you need to assert that checkbox is checked, prefer `locator_assertions.to_be_checked()` to avoid
+        flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17335,6 +17350,9 @@ def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is disabled, the opposite of [enabled](https://playwright.dev/python/docs/actionability#enabled).
 
+        **NOTE** If you need to assert that an element is disabled, prefer `locator_assertions.to_be_disabled()` to
+        avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17365,6 +17383,9 @@ def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable).
 
+        **NOTE** If you need to assert that an element is editable, prefer `locator_assertions.to_be_editable()` to
+        avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17395,6 +17416,9 @@ def is_enabled(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [enabled](https://playwright.dev/python/docs/actionability#enabled).
 
+        **NOTE** If you need to assert that an element is enabled, prefer `locator_assertions.to_be_enabled()` to
+        avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17425,6 +17449,9 @@ def is_hidden(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).
 
+        **NOTE** If you need to assert that element is hidden, prefer `locator_assertions.to_be_hidden()` to avoid
+        flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17454,6 +17481,9 @@ def is_visible(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         Returns whether the element is [visible](https://playwright.dev/python/docs/actionability#visible).
 
+        **NOTE** If you need to assert that element is visible, prefer `locator_assertions.to_be_visible()` to avoid
+        flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -17964,6 +17994,9 @@ def text_content(
 
         Returns the [`node.textContent`](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent).
 
+        **NOTE** If you need to assert text on the page, prefer `locator_assertions.to_have_text()` to avoid
+        flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -18161,6 +18194,9 @@ def all_inner_texts(self) -> typing.List[str]:
 
         Returns an array of `node.innerText` values for all matching nodes.
 
+        **NOTE** If you need to assert text on the page, prefer `locator_assertions.to_have_text()` with
+        `useInnerText` option to avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -18183,6 +18219,9 @@ def all_text_contents(self) -> typing.List[str]:
 
         Returns an array of `node.textContent` values for all matching nodes.
 
+        **NOTE** If you need to assert text on the page, prefer `locator_assertions.to_have_text()` to avoid
+        flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
+
         **Usage**
 
         ```py
@@ -20667,14 +20706,38 @@ def to_be_visible(
         Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/actionability#attached) and
         [visible](https://playwright.dev/python/docs/actionability#visible) DOM node.
 
+        To check that at least one element from the list is visible, use `locator.first()`.
+
         **Usage**
 
         ```py
+        # A specific element is visible.
         await expect(page.get_by_text(\"Welcome\")).to_be_visible()
+
+        # At least one item in the list is visible.
+        await expect(page.get_by_test_id(\"todo-item\").first).to_be_visible()
+
+        # At least one of the two elements is visible, possibly both.
+        await expect(
+            page.get_by_role(\"button\", name=\"Sign in\")
+            .or_(page.get_by_role(\"button\", name=\"Sign up\"))
+            .first
+        ).to_be_visible()
         ```
 
         ```py
+        # A specific element is visible.
         expect(page.get_by_text(\"Welcome\")).to_be_visible()
+
+        # At least one item in the list is visible.
+        expect(page.get_by_test_id(\"todo-item\").first).to_be_visible()
+
+        # At least one of the two elements is visible, possibly both.
+        expect(
+            page.get_by_role(\"button\", name=\"Sign in\")
+            .or_(page.get_by_role(\"button\", name=\"Sign up\"))
+            .first
+        ).to_be_visible()
         ```
 
         Parameters
diff --git a/setup.py b/setup.py
index f8d3c4046..137b00a5f 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.38.0"
+driver_version = "1.39.0-alpha-oct-10-2023"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_evaluate.py b/tests/async/test_evaluate.py
index bdafe0f34..95c528d33 100644
--- a/tests/async/test_evaluate.py
+++ b/tests/async/test_evaluate.py
@@ -69,14 +69,6 @@ async def test_evaluate_transfer_bigint(page: Page) -> None:
     assert await page.evaluate("a => a", 17) == 17
 
 
-async def test_should_transfer_maps(page):
-    assert await page.evaluate("() => new Map([[1, { test: 42n }]])") == {}
-
-
-async def test_should_transfer_sets(page):
-    assert await page.evaluate("() => new Set([1, { test: 42n }])") == set()
-
-
 async def test_evaluate_return_undefined_for_objects_with_symbols(page):
     assert await page.evaluate('[Symbol("foo4")]') == [None]
     assert (
diff --git a/tests/async/test_keyboard.py b/tests/async/test_keyboard.py
index 1d12c6c22..6aee344eb 100644
--- a/tests/async/test_keyboard.py
+++ b/tests/async/test_keyboard.py
@@ -506,8 +506,6 @@ async def test_should_press_the_meta_key(page, server, is_firefox, is_mac):
         assert key == "Meta"
 
     if is_firefox:
-        assert code == "OSLeft"
-    else:
         assert code == "MetaLeft"
 
     if is_firefox and not is_mac:

From 48f4e5b5229d254d2941da462737a818a89f7989 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 12 Oct 2023 17:35:51 +0200
Subject: [PATCH 100/438] chore: ensure copyright header in Python files
 (#2112)

---
 .pre-commit-config.yaml                       |  7 ++
 .../mvctests/test_clear_completed_button.py   | 13 ++++
 examples/todomvc/mvctests/test_counter.py     | 13 ++++
 examples/todomvc/mvctests/test_editing.py     | 13 ++++
 examples/todomvc/mvctests/test_item.py        | 13 ++++
 .../mvctests/test_mark_all_as_completed.py    | 13 ++++
 examples/todomvc/mvctests/test_new_todo.py    | 13 ++++
 examples/todomvc/mvctests/test_persistence.py | 13 ++++
 examples/todomvc/mvctests/test_routing.py     | 13 ++++
 examples/todomvc/mvctests/utils.py            | 13 ++++
 playwright/_impl/_har_router.py               | 13 ++++
 playwright/_impl/_map.py                      | 13 ++++
 playwright/_impl/_set_input_files_helpers.py  | 13 ++++
 scripts/update_versions.py                    | 13 ++++
 tests/async/conftest.py                       |  2 +-
 tests/async/test_accessibility.py             |  4 +-
 tests/async/test_add_init_script.py           |  2 +-
 tests/async/test_assertions.py                |  2 +-
 tests/async/test_asyncio.py                   |  2 +-
 tests/async/test_browser.py                   |  2 +-
 ...st_browsercontext_service_worker_policy.py | 13 ++++
 tests/async/test_chromium_tracing.py          |  2 +-
 tests/async/test_device_descriptors.py        | 13 ++++
 tests/async/test_headful.py                   |  4 +-
 tests/async/test_queryselector.py             | 13 ++++
 tests/async/test_selectors_text.py            | 13 ++++
 tests/async/test_tracing.py                   |  2 +-
 tests/async/test_worker.py                    |  2 +-
 tests/common/test_collect_handles.py          |  0
 tests/common/test_events.py                   | 13 ++++
 tests/common/test_signals.py                  | 13 ++++
 tests/common/test_threads.py                  |  2 +-
 tests/conftest.py                             |  2 +-
 tests/sync/conftest.py                        |  2 +-
 tests/sync/test_accessibility.py              |  4 +-
 tests/sync/test_add_init_script.py            |  2 +-
 tests/sync/test_assertions.py                 |  2 +-
 tests/sync/test_browser.py                    |  2 +-
 ...st_browsercontext_service_worker_policy.py | 13 ++++
 tests/sync/test_locator_get_by.py             |  2 +-
 tests/sync/test_queryselector.py              | 13 ++++
 tests/sync/test_sync.py                       |  2 +-
 tests/sync/test_tracing.py                    |  2 +-
 tests/test_generation_scripts.py              |  2 +-
 tests/test_installation.py                    |  2 +-
 tests/test_reference_count_async.py           |  2 +-
 utils/linting/check_file_header.py            | 70 +++++++++++++++++++
 47 files changed, 376 insertions(+), 26 deletions(-)
 create mode 100644 tests/common/test_collect_handles.py
 create mode 100755 utils/linting/check_file_header.py

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index cbb4a473d..774b001ec 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -40,3 +40,10 @@ repos:
         pass_filenames: false
         types: [python]
         additional_dependencies: ["pyright@1.1.278"]
+  - repo: local
+    hooks:
+      - id: check-license-header
+        name: Check License Header
+        entry: ./utils/linting/check_file_header.py
+        language: python
+        types: [python]
diff --git a/examples/todomvc/mvctests/test_clear_completed_button.py b/examples/todomvc/mvctests/test_clear_completed_button.py
index 0d7757f06..a36b5b2b0 100644
--- a/examples/todomvc/mvctests/test_clear_completed_button.py
+++ b/examples/todomvc/mvctests/test_clear_completed_button.py
@@ -1,3 +1,16 @@
+# 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 Generator
 
 import pytest
diff --git a/examples/todomvc/mvctests/test_counter.py b/examples/todomvc/mvctests/test_counter.py
index 150ac085e..17bc98637 100644
--- a/examples/todomvc/mvctests/test_counter.py
+++ b/examples/todomvc/mvctests/test_counter.py
@@ -1,3 +1,16 @@
+# 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 Generator
 
 import pytest
diff --git a/examples/todomvc/mvctests/test_editing.py b/examples/todomvc/mvctests/test_editing.py
index 8fa0c6d7d..39d5caad6 100644
--- a/examples/todomvc/mvctests/test_editing.py
+++ b/examples/todomvc/mvctests/test_editing.py
@@ -1,3 +1,16 @@
+# 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 Generator
 
 import pytest
diff --git a/examples/todomvc/mvctests/test_item.py b/examples/todomvc/mvctests/test_item.py
index 52f5ea834..99cef20f5 100644
--- a/examples/todomvc/mvctests/test_item.py
+++ b/examples/todomvc/mvctests/test_item.py
@@ -1,3 +1,16 @@
+# 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 Generator
 
 import pytest
diff --git a/examples/todomvc/mvctests/test_mark_all_as_completed.py b/examples/todomvc/mvctests/test_mark_all_as_completed.py
index a3e55108b..bec157bd8 100644
--- a/examples/todomvc/mvctests/test_mark_all_as_completed.py
+++ b/examples/todomvc/mvctests/test_mark_all_as_completed.py
@@ -1,3 +1,16 @@
+# 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 Generator
 
 import pytest
diff --git a/examples/todomvc/mvctests/test_new_todo.py b/examples/todomvc/mvctests/test_new_todo.py
index 5619e9a6f..15a0dbbbf 100644
--- a/examples/todomvc/mvctests/test_new_todo.py
+++ b/examples/todomvc/mvctests/test_new_todo.py
@@ -1,3 +1,16 @@
+# 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 re
 from typing import Generator
 
diff --git a/examples/todomvc/mvctests/test_persistence.py b/examples/todomvc/mvctests/test_persistence.py
index b417cdbaa..37457d51b 100644
--- a/examples/todomvc/mvctests/test_persistence.py
+++ b/examples/todomvc/mvctests/test_persistence.py
@@ -1,3 +1,16 @@
+# 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 Generator
 
 import pytest
diff --git a/examples/todomvc/mvctests/test_routing.py b/examples/todomvc/mvctests/test_routing.py
index 0b004575f..2d7efa3d2 100644
--- a/examples/todomvc/mvctests/test_routing.py
+++ b/examples/todomvc/mvctests/test_routing.py
@@ -1,3 +1,16 @@
+# 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 Generator
 
 import pytest
diff --git a/examples/todomvc/mvctests/utils.py b/examples/todomvc/mvctests/utils.py
index ba3d5decb..e0bf6ae1d 100644
--- a/examples/todomvc/mvctests/utils.py
+++ b/examples/todomvc/mvctests/utils.py
@@ -1,3 +1,16 @@
+# 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 Page
 
 TODO_ITEMS = ["buy some cheese", "feed the cat", "book a doctors appointment"]
diff --git a/playwright/_impl/_har_router.py b/playwright/_impl/_har_router.py
index 18e8b62e9..a96ba70bf 100644
--- a/playwright/_impl/_har_router.py
+++ b/playwright/_impl/_har_router.py
@@ -1,3 +1,16 @@
+# 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 base64
 from typing import TYPE_CHECKING, Optional, cast
diff --git a/playwright/_impl/_map.py b/playwright/_impl/_map.py
index d5c2dc5e4..95c05f445 100644
--- a/playwright/_impl/_map.py
+++ b/playwright/_impl/_map.py
@@ -1,3 +1,16 @@
+# 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, Generic, Tuple, TypeVar
 
 K = TypeVar("K")
diff --git a/playwright/_impl/_set_input_files_helpers.py b/playwright/_impl/_set_input_files_helpers.py
index 2ee52347b..8aabc4c61 100644
--- a/playwright/_impl/_set_input_files_helpers.py
+++ b/playwright/_impl/_set_input_files_helpers.py
@@ -1,3 +1,16 @@
+# 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
 import os
 import sys
diff --git a/scripts/update_versions.py b/scripts/update_versions.py
index a9f6bb503..50d8fff78 100644
--- a/scripts/update_versions.py
+++ b/scripts/update_versions.py
@@ -1,3 +1,16 @@
+# 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 re
 from pathlib import Path
 
diff --git a/tests/async/conftest.py b/tests/async/conftest.py
index 1048be55c..ba141fcd5 100644
--- a/tests/async/conftest.py
+++ b/tests/async/conftest.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/async/test_accessibility.py b/tests/async/test_accessibility.py
index 8b2ff2e16..fa9a54b97 100644
--- a/tests/async/test_accessibility.py
+++ b/tests/async/test_accessibility.py
@@ -1,10 +1,10 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
+# 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,
diff --git a/tests/async/test_add_init_script.py b/tests/async/test_add_init_script.py
index 515891a88..07279f5a1 100644
--- a/tests/async/test_add_init_script.py
+++ b/tests/async/test_add_init_script.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 2e8e262a6..91d16b0c5 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/async/test_asyncio.py b/tests/async/test_asyncio.py
index 4d6174d1b..7ee019ead 100644
--- a/tests/async/test_asyncio.py
+++ b/tests/async/test_asyncio.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/async/test_browser.py b/tests/async/test_browser.py
index b9124c102..17bfb5b2f 100644
--- a/tests/async/test_browser.py
+++ b/tests/async/test_browser.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/async/test_browsercontext_service_worker_policy.py b/tests/async/test_browsercontext_service_worker_policy.py
index 71a9636c7..7adcd2d54 100644
--- a/tests/async/test_browsercontext_service_worker_policy.py
+++ b/tests/async/test_browsercontext_service_worker_policy.py
@@ -1,3 +1,16 @@
+# 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.async_api import Browser
 from tests.server import Server
 
diff --git a/tests/async/test_chromium_tracing.py b/tests/async/test_chromium_tracing.py
index deb2b10ae..f1c34b5ba 100644
--- a/tests/async/test_chromium_tracing.py
+++ b/tests/async/test_chromium_tracing.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/async/test_device_descriptors.py b/tests/async/test_device_descriptors.py
index e8ca64625..ee2e72cdd 100644
--- a/tests/async/test_device_descriptors.py
+++ b/tests/async/test_device_descriptors.py
@@ -1,3 +1,16 @@
+# 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
 
 
diff --git a/tests/async/test_headful.py b/tests/async/test_headful.py
index 8939bf0c2..bc1df9b69 100644
--- a/tests/async/test_headful.py
+++ b/tests/async/test_headful.py
@@ -1,10 +1,10 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
+# 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,
diff --git a/tests/async/test_queryselector.py b/tests/async/test_queryselector.py
index 65e2700dd..814f7a3a9 100644
--- a/tests/async/test_queryselector.py
+++ b/tests/async/test_queryselector.py
@@ -1,3 +1,16 @@
+# 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.async_api import Error, Page
diff --git a/tests/async/test_selectors_text.py b/tests/async/test_selectors_text.py
index 9de7f6b4d..0b231ccab 100644
--- a/tests/async/test_selectors_text.py
+++ b/tests/async/test_selectors_text.py
@@ -1,3 +1,16 @@
+# 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 re
 
 import pytest
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index 13f510591..1473ab648 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/async/test_worker.py b/tests/async/test_worker.py
index 399df4407..08d6bd0cc 100644
--- a/tests/async/test_worker.py
+++ b/tests/async/test_worker.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/common/test_collect_handles.py b/tests/common/test_collect_handles.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/tests/common/test_events.py b/tests/common/test_events.py
index ac2ffe931..07d6c4e2b 100644
--- a/tests/common/test_events.py
+++ b/tests/common/test_events.py
@@ -1,3 +1,16 @@
+# 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
 
 import pytest
diff --git a/tests/common/test_signals.py b/tests/common/test_signals.py
index 7d78865ce..472e74042 100644
--- a/tests/common/test_signals.py
+++ b/tests/common/test_signals.py
@@ -1,3 +1,16 @@
+# 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 multiprocessing
 import os
diff --git a/tests/common/test_threads.py b/tests/common/test_threads.py
index 6d4b1963e..b957244f2 100644
--- a/tests/common/test_threads.py
+++ b/tests/common/test_threads.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/conftest.py b/tests/conftest.py
index 3c44f908c..a3b8e9992 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/sync/conftest.py b/tests/sync/conftest.py
index d7942bf90..075cccde2 100644
--- a/tests/sync/conftest.py
+++ b/tests/sync/conftest.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/sync/test_accessibility.py b/tests/sync/test_accessibility.py
index d71f27a4d..d7516d6d9 100644
--- a/tests/sync/test_accessibility.py
+++ b/tests/sync/test_accessibility.py
@@ -1,10 +1,10 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
+# 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,
diff --git a/tests/sync/test_add_init_script.py b/tests/sync/test_add_init_script.py
index 039862063..e17fc5e8b 100644
--- a/tests/sync/test_add_init_script.py
+++ b/tests/sync/test_add_init_script.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 724f1d980..7d53d18a6 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/sync/test_browser.py b/tests/sync/test_browser.py
index 31d43e68f..ded881c67 100644
--- a/tests/sync/test_browser.py
+++ b/tests/sync/test_browser.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/sync/test_browsercontext_service_worker_policy.py b/tests/sync/test_browsercontext_service_worker_policy.py
index 7f4350d7f..190bdfbd5 100644
--- a/tests/sync/test_browsercontext_service_worker_policy.py
+++ b/tests/sync/test_browsercontext_service_worker_policy.py
@@ -1,3 +1,16 @@
+# 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 Browser
 from tests.server import Server
 
diff --git a/tests/sync/test_locator_get_by.py b/tests/sync/test_locator_get_by.py
index 42939672f..0e5d4396b 100644
--- a/tests/sync/test_locator_get_by.py
+++ b/tests/sync/test_locator_get_by.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/sync/test_queryselector.py b/tests/sync/test_queryselector.py
index 367b90e9a..f773b5109 100644
--- a/tests/sync/test_queryselector.py
+++ b/tests/sync/test_queryselector.py
@@ -1,3 +1,16 @@
+# 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 pathlib import Path
 
 import pytest
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index 11f6aab08..e22490426 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index 5c5084240..61e67009d 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/test_generation_scripts.py b/tests/test_generation_scripts.py
index 91127dc02..9a4f78293 100644
--- a/tests/test_generation_scripts.py
+++ b/tests/test_generation_scripts.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/test_installation.py b/tests/test_installation.py
index ccde56361..e0f9433ab 100644
--- a/tests/test_installation.py
+++ b/tests/test_installation.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/tests/test_reference_count_async.py b/tests/test_reference_count_async.py
index 345be83a5..cc1564aa6 100644
--- a/tests/test_reference_count_async.py
+++ b/tests/test_reference_count_async.py
@@ -1,6 +1,6 @@
 # Copyright (c) Microsoft Corporation.
 #
-# Licensed under the Apache License, Version 2.0 (the "License")
+# 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
 #
diff --git a/utils/linting/check_file_header.py b/utils/linting/check_file_header.py
new file mode 100755
index 000000000..5ccf79d5f
--- /dev/null
+++ b/utils/linting/check_file_header.py
@@ -0,0 +1,70 @@
+#!/usr/bin/env python
+# 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
+from pathlib import Path
+from typing import List
+
+LICENSE_HEADER = """
+# 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.
+""".strip()
+
+
+def file_has_license(file_path: str) -> None:
+    path = Path(file_path)
+    if not path.name.endswith(".py"):
+        return
+    if not path.exists():
+        raise Exception(f"File {file_path} does not exist")
+    content = path.read_text(encoding="utf-8")
+    if content.strip() == "":
+        return
+    if content.startswith("#!"):
+        # flake8: noqa: E203
+        content = content[content.find("\n") + 1 :]
+    if not content.startswith(LICENSE_HEADER):
+        raise Exception(f"File {file_path} does not have license header")
+
+
+def main() -> None:
+    errors: List[str] = []
+
+    for file_path in sys.argv[1:]:
+        try:
+            file_has_license(file_path)
+        except Exception as e:
+            errors.append(str(e))
+
+    if errors:
+        print("Missing license header in files:")
+        for error in errors:
+            print("  -", error)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

From bc1e717f93863daa94367d5292fefb0e108dac81 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 12 Oct 2023 18:28:34 +0200
Subject: [PATCH 101/438] chore: collect stale handles from the server side
 (#2111)

---
 playwright/_impl/_connection.py | 38 ++++++++++++++++++++-------------
 tests/async/test_asyncio.py     | 19 ++++++++++++++++-
 tests/sync/test_sync.py         | 18 ++++++++++++++++
 3 files changed, 59 insertions(+), 16 deletions(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index e11612fcf..7f58c214e 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -51,11 +51,11 @@
 
 
 class Channel(AsyncIOEventEmitter):
-    def __init__(self, connection: "Connection", guid: str) -> None:
+    def __init__(self, connection: "Connection", object: "ChannelOwner") -> None:
         super().__init__()
-        self._connection: Connection = connection
-        self._guid = guid
-        self._object: Optional[ChannelOwner] = None
+        self._connection = connection
+        self._guid = object._guid
+        self._object = object
 
     async def send(self, method: str, params: Dict = None) -> Any:
         return await self._connection.wrap_api_call(
@@ -71,7 +71,7 @@ def send_no_reply(self, method: str, params: Dict = None) -> None:
         # No reply messages are used to e.g. waitForEventInfo(after).
         self._connection.wrap_api_call_sync(
             lambda: self._connection._send_message_to_server(
-                self._guid, method, {} if params is None else params, True
+                self._object, method, {} if params is None else params, True
             )
         )
 
@@ -80,7 +80,9 @@ async def inner_send(
     ) -> Any:
         if params is None:
             params = {}
-        callback = self._connection._send_message_to_server(self._guid, method, params)
+        callback = self._connection._send_message_to_server(
+            self._object, method, params
+        )
         if self._connection._error:
             error = self._connection._error
             self._connection._error = None
@@ -121,7 +123,7 @@ def __init__(
         self._loop: asyncio.AbstractEventLoop = parent._loop
         self._dispatcher_fiber: Any = parent._dispatcher_fiber
         self._type = type
-        self._guid = guid
+        self._guid: str = guid
         self._connection: Connection = (
             parent._connection if isinstance(parent, ChannelOwner) else parent
         )
@@ -129,9 +131,9 @@ def __init__(
             parent if isinstance(parent, ChannelOwner) else None
         )
         self._objects: Dict[str, "ChannelOwner"] = {}
-        self._channel: Channel = Channel(self._connection, guid)
-        self._channel._object = self
+        self._channel: Channel = Channel(self._connection, self)
         self._initializer = initializer
+        self._was_collected = False
 
         self._connection._objects[guid] = self
         if self._parent:
@@ -139,15 +141,16 @@ def __init__(
 
         self._event_to_subscription_mapping: Dict[str, str] = {}
 
-    def _dispose(self) -> None:
+    def _dispose(self, reason: Optional[str]) -> None:
         # Clean up from parent and connection.
         if self._parent:
             del self._parent._objects[self._guid]
         del self._connection._objects[self._guid]
+        self._was_collected = reason == "gc"
 
         # Dispose all children.
         for object in list(self._objects.values()):
-            object._dispose()
+            object._dispose(reason)
         self._objects.clear()
 
     def _adopt(self, child: "ChannelOwner") -> None:
@@ -308,10 +311,14 @@ def set_in_tracing(self, is_tracing: bool) -> None:
             self._tracing_count -= 1
 
     def _send_message_to_server(
-        self, guid: str, method: str, params: Dict, no_reply: bool = False
+        self, object: ChannelOwner, method: str, params: Dict, no_reply: bool = False
     ) -> ProtocolCallback:
         if self._closed_error_message:
             raise Error(self._closed_error_message)
+        if object._was_collected:
+            raise Error(
+                "The object has been collected to prevent unbounded heap growth."
+            )
         self._last_id += 1
         id = self._last_id
         callback = ProtocolCallback(self._loop)
@@ -335,7 +342,7 @@ def _send_message_to_server(
         )
         message = {
             "id": id,
-            "guid": guid,
+            "guid": object._guid,
             "method": method,
             "params": self._replace_channels_with_guids(params),
             "metadata": {
@@ -345,7 +352,7 @@ def _send_message_to_server(
                 "internal": not stack_trace_information["apiName"],
             },
         }
-        if self._tracing_count > 0 and frames and guid != "localUtils":
+        if self._tracing_count > 0 and frames and object._guid != "localUtils":
             self.local_utils.add_stack_to_tracing_no_reply(id, frames)
 
         self._transport.send(message)
@@ -401,7 +408,8 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
             return
 
         if method == "__dispose__":
-            self._objects[guid]._dispose()
+            assert isinstance(params, dict)
+            self._objects[guid]._dispose(cast(Optional[str], params.get("reason")))
             return
         object = self._objects[guid]
         should_replace_guids_with_channels = "jsonPipe@" not in guid
diff --git a/tests/async/test_asyncio.py b/tests/async/test_asyncio.py
index 7ee019ead..f82081276 100644
--- a/tests/async/test_asyncio.py
+++ b/tests/async/test_asyncio.py
@@ -17,7 +17,7 @@
 
 import pytest
 
-from playwright.async_api import async_playwright
+from playwright.async_api import Page, async_playwright
 
 from ..server import Server
 
@@ -67,3 +67,20 @@ async def test_cancel_pending_protocol_call_on_playwright_stop(server: Server) -
     with pytest.raises(Exception) as exc_info:
         await pending_task
     assert "Connection closed" in str(exc_info.value)
+
+
+async def test_should_collect_stale_handles(page: Page, server: Server) -> None:
+    page.on("request", lambda: None)
+    response = await page.goto(server.PREFIX + "/title.html")
+    for i in range(1000):
+        await page.evaluate(
+            """async () => {
+            const response = await fetch('/');
+            await response.text();
+        }"""
+        )
+    with pytest.raises(Exception) as exc_info:
+        await response.all_headers()
+    assert "The object has been collected to prevent unbounded heap growth." in str(
+        exc_info.value
+    )
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index e22490426..b21532c86 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -333,3 +333,21 @@ def test_call_sync_method_after_playwright_close_with_own_loop(
     p.start()
     p.join()
     assert p.exitcode == 0
+
+
+def test_should_collect_stale_handles(page: Page, server: Server) -> None:
+    page.on("request", lambda request: None)
+    response = page.goto(server.PREFIX + "/title.html")
+    assert response
+    for i in range(1000):
+        page.evaluate(
+            """async () => {
+            const response = await fetch('/');
+            await response.text();
+        }"""
+        )
+    with pytest.raises(Exception) as exc_info:
+        response.all_headers()
+    assert "The object has been collected to prevent unbounded heap growth." in str(
+        exc_info.value
+    )

From adfa5095d049a90195466301b1f2613e2fdb7d9c Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 12 Oct 2023 19:51:22 +0200
Subject: [PATCH 102/438] chore: update greenlet to 3.0.0 (#2102)

---
 .github/workflows/ci.yml | 8 +-------
 meta.yaml                | 2 +-
 setup.py                 | 2 +-
 3 files changed, 3 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d1ca84f60..23f645890 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -59,9 +59,6 @@ jobs:
         - os: macos-latest
           python-version: '3.10'
           browser: chromium
-        - os: macos-11.0
-          python-version: '3.10'
-          browser: chromium
         - os: windows-latest
           python-version: '3.11'
           browser: chromium
@@ -71,9 +68,6 @@ jobs:
         - os: ubuntu-latest
           python-version: '3.11'
           browser: chromium
-        - os: windows-latest
-          python-version: '3.11'
-          browser: chromium
     runs-on: ${{ matrix.os }}
     steps:
     - uses: actions/checkout@v3
@@ -156,7 +150,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-20.04, macos-11, windows-2019]
+        os: [ubuntu-20.04, macos-12, windows-2019]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v3
diff --git a/meta.yaml b/meta.yaml
index d5739a63b..6d7246c53 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -23,7 +23,7 @@ requirements:
     - setuptools_scm
   run:
     - python
-    - greenlet ==2.0.2
+    - greenlet ==3.0.0
     - pyee ==9.0.4
     - typing_extensions # [py<39]
 test:
diff --git a/setup.py b/setup.py
index 137b00a5f..a6ea02104 100644
--- a/setup.py
+++ b/setup.py
@@ -212,7 +212,7 @@ def _download_and_extract_local_driver(
     packages=["playwright"],
     include_package_data=True,
     install_requires=[
-        "greenlet==2.0.2",
+        "greenlet==3.0.0",
         "pyee==9.0.4",
         "typing-extensions;python_version<='3.8'",
     ],

From 9f042eca1ce2f29b662b442d61462b1c5a87fdaf Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 16 Oct 2023 18:24:31 +0200
Subject: [PATCH 103/438] chore: support Python 3.12 (#2116)

---
 .github/workflows/ci.yml                     | 17 ++++++---
 .github/workflows/publish_canary_docker.yml  |  2 +-
 .github/workflows/publish_release_docker.yml |  2 +-
 CONTRIBUTING.md                              |  2 +-
 local-requirements.txt                       |  1 -
 meta.yaml                                    |  2 +-
 pyproject.toml                               |  5 ++-
 scripts/__init__.py                          |  0
 scripts/generate_async_api.py                |  4 +-
 scripts/generate_sync_api.py                 |  4 +-
 setup.py                                     | 17 +++++----
 tests/test_generation_scripts.py             | 39 --------------------
 tests/test_installation.py                   |  7 ++--
 13 files changed, 37 insertions(+), 65 deletions(-)
 delete mode 100644 scripts/__init__.py
 delete mode 100644 tests/test_generation_scripts.py

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 23f645890..a8e7c7cec 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -28,7 +28,7 @@ jobs:
         python-version: "3.10"
     - name: Install dependencies & browsers
       run: |
-        python -m pip install --upgrade pip wheel
+        python -m pip install --upgrade pip
         pip install -r local-requirements.txt
         pip install -e .
         python setup.py bdist_wheel
@@ -68,6 +68,15 @@ jobs:
         - os: ubuntu-latest
           python-version: '3.11'
           browser: chromium
+        - os: windows-latest
+          python-version: '3.12'
+          browser: chromium
+        - os: macos-latest
+          python-version: '3.12'
+          browser: chromium
+        - os: ubuntu-latest
+          python-version: '3.12'
+          browser: chromium
     runs-on: ${{ matrix.os }}
     steps:
     - uses: actions/checkout@v3
@@ -77,7 +86,7 @@ jobs:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies & browsers
       run: |
-        python -m pip install --upgrade pip wheel
+        python -m pip install --upgrade pip
         pip install -r local-requirements.txt
         pip install -e .
         python setup.py bdist_wheel
@@ -88,8 +97,6 @@ jobs:
       run: pytest tests/test_reference_count_async.py --browser=${{ matrix.browser }}
     - name: Test Wheel Installation
       run: pytest tests/test_installation.py --browser=${{ matrix.browser }}
-    - name: Test Generation Scripts
-      run: pytest tests/test_generation_scripts.py --browser=${{ matrix.browser }}
     - name: Test Sync API
       if: matrix.os != 'ubuntu-latest'
       run: pytest tests/sync --browser=${{ matrix.browser }} --timeout 90
@@ -125,7 +132,7 @@ jobs:
         python-version: "3.10"
     - name: Install dependencies & browsers
       run: |
-        python -m pip install --upgrade pip wheel
+        python -m pip install --upgrade pip
         pip install -r local-requirements.txt
         pip install -e .
         python setup.py bdist_wheel
diff --git a/.github/workflows/publish_canary_docker.yml b/.github/workflows/publish_canary_docker.yml
index e5a962b49..757dee7b5 100644
--- a/.github/workflows/publish_canary_docker.yml
+++ b/.github/workflows/publish_canary_docker.yml
@@ -18,7 +18,7 @@ jobs:
         python-version: "3.10"
     - name: Install dependencies & browsers
       run: |
-        python -m pip install --upgrade pip wheel
+        python -m pip install --upgrade pip
         pip install -r local-requirements.txt
         pip install -e .
     - uses: azure/docker-login@v1
diff --git a/.github/workflows/publish_release_docker.yml b/.github/workflows/publish_release_docker.yml
index 9f255ad7a..8bb9c5c7b 100644
--- a/.github/workflows/publish_release_docker.yml
+++ b/.github/workflows/publish_release_docker.yml
@@ -33,7 +33,7 @@ jobs:
         platforms: arm64
     - name: Install dependencies & browsers
       run: |
-        python -m pip install --upgrade pip wheel
+        python -m pip install --upgrade pip
         pip install -r local-requirements.txt
         pip install -e .
     - run: ./utils/docker/publish_docker.sh stable
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 809b8e997..a5ab7d4bd 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -15,7 +15,7 @@ source ./env/bin/activate
 Install required dependencies:
 
 ```sh
-python -m pip install --upgrade pip wheel
+python -m pip install --upgrade pip
 pip install -r local-requirements.txt
 ```
 
diff --git a/local-requirements.txt b/local-requirements.txt
index f8f6e524f..caffb929c 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -18,7 +18,6 @@ pytest-xdist==3.3.1
 requests==2.31.0
 service_identity==23.1.0
 setuptools==68.2.2
-twine==4.0.2
 twisted==23.8.0
 types-pyOpenSSL==23.2.0.2
 wheel==0.41.2
diff --git a/meta.yaml b/meta.yaml
index 6d7246c53..32413e8c0 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -24,7 +24,7 @@ requirements:
   run:
     - python
     - greenlet ==3.0.0
-    - pyee ==9.0.4
+    - pyee ==11.0.1
     - typing_extensions # [py<39]
 test:
   requires:
diff --git a/pyproject.toml b/pyproject.toml
index 43cd8c708..094ca8c81 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,7 +1,10 @@
 [build-system]
-requires = ["setuptools==60.9.3", "setuptools-scm==7.0.5", "wheel==0.38.1", "auditwheel==5.1.2"]
+requires = ["setuptools==68.2.2", "setuptools-scm==8.0.4", "wheel==0.41.2", "auditwheel==5.4.0"]
 build-backend = "setuptools.build_meta"
 
+[tool.setuptools_scm]
+version_file = "playwright/_repo_version.py"
+
 [tool.pytest.ini_options]
 addopts = "-Wall -rsx -vv -s"
 markers = [
diff --git a/scripts/__init__.py b/scripts/__init__.py
deleted file mode 100644
index e69de29bb..000000000
diff --git a/scripts/generate_async_api.py b/scripts/generate_async_api.py
index d3579a91c..ca52ef1a3 100755
--- a/scripts/generate_async_api.py
+++ b/scripts/generate_async_api.py
@@ -18,8 +18,8 @@
 from types import FunctionType
 from typing import Any
 
-from scripts.documentation_provider import DocumentationProvider
-from scripts.generate_api import (
+from documentation_provider import DocumentationProvider
+from generate_api import (
     api_globals,
     arguments,
     generated_types,
diff --git a/scripts/generate_sync_api.py b/scripts/generate_sync_api.py
index a932fa8a4..01d6cb02b 100755
--- a/scripts/generate_sync_api.py
+++ b/scripts/generate_sync_api.py
@@ -19,8 +19,8 @@
 from types import FunctionType
 from typing import Any
 
-from scripts.documentation_provider import DocumentationProvider
-from scripts.generate_api import (
+from documentation_provider import DocumentationProvider
+from generate_api import (
     api_globals,
     arguments,
     generated_types,
diff --git a/setup.py b/setup.py
index a6ea02104..1052b1a54 100644
--- a/setup.py
+++ b/setup.py
@@ -209,11 +209,17 @@ def _download_and_extract_local_driver(
     project_urls={
         "Release notes": "https://github.com/microsoft/playwright-python/releases",
     },
-    packages=["playwright"],
+    packages=[
+        "playwright",
+        "playwright.async_api",
+        "playwright.sync_api",
+        "playwright._impl",
+        "playwright._impl.__pyinstaller",
+    ],
     include_package_data=True,
     install_requires=[
         "greenlet==3.0.0",
-        "pyee==9.0.4",
+        "pyee==11.0.1",
         "typing-extensions;python_version<='3.8'",
     ],
     classifiers=[
@@ -225,17 +231,12 @@ def _download_and_extract_local_driver(
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
         "License :: OSI Approved :: Apache Software License",
         "Operating System :: OS Independent",
     ],
     python_requires=">=3.8",
     cmdclass={"bdist_wheel": PlaywrightBDistWheelCommand},
-    use_scm_version={
-        "version_scheme": "post-release",
-        "write_to": "playwright/_repo_version.py",
-        "write_to_template": 'version = "{version}"\n',
-    },
-    setup_requires=["setuptools-scm==7.0.5", "wheel==0.38.1"],
     entry_points={
         "console_scripts": [
             "playwright=playwright.__main__:main",
diff --git a/tests/test_generation_scripts.py b/tests/test_generation_scripts.py
deleted file mode 100644
index 9a4f78293..000000000
--- a/tests/test_generation_scripts.py
+++ /dev/null
@@ -1,39 +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
-from io import StringIO
-from unittest.mock import patch
-
-import pytest
-
-pytestmark = pytest.mark.skipif(
-    sys.version_info < (3, 9), reason="requires python3.9 or higher"
-)
-
-
-@patch("sys.stderr", new_callable=StringIO)
-@patch("sys.stdout", new_callable=StringIO)
-def test_generate_sync_api(stdout: StringIO, stderr: StringIO) -> None:
-    from scripts.generate_sync_api import main as generate_sync_api
-
-    generate_sync_api()
-
-
-@patch("sys.stderr", new_callable=StringIO)
-@patch("sys.stdout", new_callable=StringIO)
-def test_generate_async_api(stdout: StringIO, stderr: StringIO) -> None:
-    from scripts.generate_async_api import main as generate_async_api
-
-    generate_async_api()
diff --git a/tests/test_installation.py b/tests/test_installation.py
index e0f9433ab..e002a477c 100644
--- a/tests/test_installation.py
+++ b/tests/test_installation.py
@@ -21,16 +21,17 @@
 
 
 def test_install(tmp_path: Path, browser_name: str) -> None:
+    env_dir = tmp_path / "env"
     env = EnvBuilder(with_pip=True)
-    env.create(env_dir=tmp_path)
-    context = env.ensure_directories(tmp_path)
+    env.create(env_dir=env_dir)
+    context = env.ensure_directories(env_dir)
     root = Path(__file__).parent.parent.resolve()
     if sys.platform == "win32":
         wheelpath = list((root / "dist").glob("playwright*win_amd64*.whl"))[0]
     elif sys.platform == "linux":
         wheelpath = list((root / "dist").glob("playwright*manylinux1*.whl"))[0]
     elif sys.platform == "darwin":
-        wheelpath = list((root / "dist").glob("playwright*macosx_10_*.whl"))[0]
+        wheelpath = list((root / "dist").glob("playwright*macosx_*.whl"))[0]
     subprocess.check_output(
         [
             context.env_exe,

From 147e4a3a3f6ffa19ad6639cbcc27323fc3163fe9 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 16 Oct 2023 18:24:50 +0200
Subject: [PATCH 104/438] chore(roll): roll Playwright to v1.39 (#2118)

---
 README.md | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index c8f53740a..988c74e29 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
 | Chromium <!-- GEN:chromium-version -->119.0.6045.9<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| WebKit <!-- GEN:webkit-version -->17.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->118.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
diff --git a/setup.py b/setup.py
index 1052b1a54..9b2d0fe00 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.39.0-alpha-oct-10-2023"
+driver_version = "1.39.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 59369fe126f49c10597d5c9099840bdc8ccdcf15 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 17 Oct 2023 21:37:19 +0200
Subject: [PATCH 105/438] chore: restore setup_requires in setup.py (#2124)

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

diff --git a/setup.py b/setup.py
index 9b2d0fe00..98b2dc854 100644
--- a/setup.py
+++ b/setup.py
@@ -222,6 +222,8 @@ def _download_and_extract_local_driver(
         "pyee==11.0.1",
         "typing-extensions;python_version<='3.8'",
     ],
+    # TODO: Can be removed once we migrate to pypa/build or pypa/installer.
+    setup_requires=["setuptools-scm==8.0.4", "wheel==0.41.2"],
     classifiers=[
         "Topic :: Software Development :: Testing",
         "Topic :: Internet :: WWW/HTTP :: Browsers",

From aacb4332bca22e2841204455a8ddfcd51cd90ee2 Mon Sep 17 00:00:00 2001
From: Alex Brook <90186562+abr-storm@users.noreply.github.com>
Date: Sun, 29 Oct 2023 08:37:13 +0000
Subject: [PATCH 106/438] test:
 `test_to_have_js_property_assertions_locator_to_have_text` =>
 `test_assertions_locator_to_have_text` (#2139)

rename test case
---
 tests/sync/test_assertions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 7d53d18a6..e11afe6f2 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -227,7 +227,7 @@ def test_to_have_js_property_pass_null(page: Page) -> None:
     expect(locator).to_have_js_property("foo", None)
 
 
-def test_to_have_js_property_assertions_locator_to_have_text(
+def test_assertions_locator_to_have_text(
     page: Page, server: Server
 ) -> None:
     page.goto(server.EMPTY_PAGE)

From f30301cfdc12a0a88303171cc5b6c0a7fa7b2e11 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 30 Oct 2023 16:40:59 +0100
Subject: [PATCH 107/438] fix: relative Firefox record_video_dir (#2141)

---
 playwright/_impl/_browser.py         |  2 +-
 playwright/_impl/_browser_context.py |  3 ---
 playwright/_impl/_page.py            |  2 +-
 playwright/_impl/_tracing.py         | 11 +++++++----
 tests/sync/test_assertions.py        |  4 +---
 5 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index 79ed408bd..2649d75ea 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -237,7 +237,7 @@ async def prepare_browser_context_params(params: Dict) -> None:
         params["recordHar"] = prepare_record_har_options(params)
         del params["recordHarPath"]
     if "recordVideoDir" in params:
-        params["recordVideo"] = {"dir": str(params["recordVideoDir"])}
+        params["recordVideo"] = {"dir": Path(params["recordVideoDir"]).absolute()}
         if "recordVideoSize" in params:
             params["recordVideo"]["size"] = params["recordVideoSize"]
             del params["recordVideoSize"]
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 1c7c546fe..6681e0852 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -479,9 +479,6 @@ async def _inner_close() -> None:
         await self._channel.send("close")
         await self._closed_future
 
-    async def _pause(self) -> None:
-        await self._channel.send("pause")
-
     async def storage_state(self, path: Union[str, Path] = None) -> StorageState:
         result = await self._channel.send_return_as_dict("storageState")
         if path:
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index be2538689..99944be41 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -961,7 +961,7 @@ async def pause(self) -> None:
         try:
             await asyncio.wait(
                 [
-                    asyncio.create_task(self._browser_context._pause()),
+                    asyncio.create_task(self._browser_context._channel.send("pause")),
                     self._closed_or_crashed_future,
                 ],
                 return_when=asyncio.FIRST_COMPLETED,
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index 509bbe336..98f19cb69 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -51,7 +51,7 @@ async def _inner_start() -> str:
                 "tracingStartChunk", filter_none({"title": title, "name": name})
             )
 
-        trace_name = await self._connection.wrap_api_call(_inner_start)
+        trace_name = await self._connection.wrap_api_call(_inner_start, True)
         await self._start_collecting_stacks(trace_name)
 
     async def start_chunk(self, title: str = None, name: str = None) -> None:
@@ -68,11 +68,14 @@ async def _start_collecting_stacks(self, trace_name: str) -> None:
         )
 
     async def stop_chunk(self, path: Union[pathlib.Path, str] = None) -> None:
-        await self._do_stop_chunk(path)
+        await self._connection.wrap_api_call(lambda: self._do_stop_chunk(path), True)
 
     async def stop(self, path: Union[pathlib.Path, str] = None) -> None:
-        await self._do_stop_chunk(path)
-        await self._channel.send("tracingStop")
+        async def _inner() -> None:
+            await self._do_stop_chunk(path)
+            await self._channel.send("tracingStop")
+
+        await self._connection.wrap_api_call(_inner, True)
 
     async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> None:
         if self._is_tracing:
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index e11afe6f2..3f83eec49 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -227,9 +227,7 @@ def test_to_have_js_property_pass_null(page: Page) -> None:
     expect(locator).to_have_js_property("foo", None)
 
 
-def test_assertions_locator_to_have_text(
-    page: Page, server: Server
-) -> None:
+def test_assertions_locator_to_have_text(page: Page, server: Server) -> None:
     page.goto(server.EMPTY_PAGE)
     page.set_content("<div id=foobar>kek</div>")
     expect(page.locator("div#foobar")).to_have_text("kek")

From fa727cc61ff4d44b48b15d533cee4b7be08f72a5 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 30 Oct 2023 16:47:38 +0100
Subject: [PATCH 108/438] devops: build Conda package for Python 3.12 (#2143)

---
 conda_build_config.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/conda_build_config.yaml b/conda_build_config.yaml
index ab4332208..92ada529f 100644
--- a/conda_build_config.yaml
+++ b/conda_build_config.yaml
@@ -3,3 +3,4 @@ python:
   - 3.9
   - "3.10"
   - "3.11"
+  - "3.12"

From df4f210e4a81b2dc24ff2223992cf578469d9ad9 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 30 Oct 2023 18:05:41 +0100
Subject: [PATCH 109/438] fix: hanging context managers (#2144)

---
 playwright/_impl/_async_base.py     |  8 +++++++-
 playwright/_impl/_sync_base.py      |  8 +++++++-
 tests/async/test_context_manager.py | 10 +++++++++-
 tests/async/test_page.py            |  8 ++++++++
 tests/sync/test_context_manager.py  | 10 +++++++++-
 tests/sync/test_sync.py             | 16 +++++++++++++---
 6 files changed, 53 insertions(+), 7 deletions(-)

diff --git a/playwright/_impl/_async_base.py b/playwright/_impl/_async_base.py
index 9b7a7e251..e497232d8 100644
--- a/playwright/_impl/_async_base.py
+++ b/playwright/_impl/_async_base.py
@@ -33,6 +33,9 @@ def __init__(self, future: "asyncio.Future[T]") -> None:
     async def value(self) -> T:
         return mapping.from_maybe_impl(await self._future)
 
+    def _cancel(self) -> None:
+        self._future.cancel()
+
     def is_done(self) -> bool:
         return self._future.done()
 
@@ -50,7 +53,10 @@ async def __aexit__(
         exc_val: BaseException,
         exc_tb: TracebackType,
     ) -> None:
-        await self._event.value
+        if exc_val:
+            self._event._cancel()
+        else:
+            await self._event.value
 
 
 class AsyncBase(ImplWrapper):
diff --git a/playwright/_impl/_sync_base.py b/playwright/_impl/_sync_base.py
index a26f2fb65..0eefbba13 100644
--- a/playwright/_impl/_sync_base.py
+++ b/playwright/_impl/_sync_base.py
@@ -59,6 +59,9 @@ def value(self) -> T:
             raise exception
         return cast(T, mapping.from_maybe_impl(self._future.result()))
 
+    def _cancel(self) -> None:
+        self._future.cancel()
+
     def is_done(self) -> bool:
         return self._future.done()
 
@@ -76,7 +79,10 @@ def __exit__(
         exc_val: BaseException,
         exc_tb: TracebackType,
     ) -> None:
-        self._event.value
+        if exc_val:
+            self._event._cancel()
+        else:
+            self._event.value
 
 
 class SyncBase(ImplWrapper):
diff --git a/tests/async/test_context_manager.py b/tests/async/test_context_manager.py
index 149943469..059ed5eb8 100644
--- a/tests/async/test_context_manager.py
+++ b/tests/async/test_context_manager.py
@@ -12,7 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from playwright.async_api import BrowserType
+import pytest
+
+from playwright.async_api import BrowserContext, BrowserType
 
 
 async def test_context_managers(browser_type: BrowserType, launch_arguments):
@@ -24,3 +26,9 @@ async def test_context_managers(browser_type: BrowserType, launch_arguments):
             assert len(browser.contexts) == 1
         assert len(browser.contexts) == 0
     assert not browser.is_connected()
+
+
+async def test_context_managers_not_hang(context: BrowserContext):
+    with pytest.raises(Exception, match="Oops!"):
+        async with await context.new_page():
+            raise Exception("Oops!")
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 8673abfda..b92516c3c 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -344,6 +344,14 @@ async def test_wait_for_response_should_use_context_timeout(
     assert "Timeout 1000ms exceeded" in exc_info.value.message
 
 
+async def test_expect_response_should_not_hang_when_predicate_throws(
+    page: Page,
+) -> None:
+    with pytest.raises(Exception, match="Oops!"):
+        async with page.expect_response("**/*"):
+            raise Exception("Oops!")
+
+
 async def test_expose_binding(page):
     binding_source = []
 
diff --git a/tests/sync/test_context_manager.py b/tests/sync/test_context_manager.py
index da9be9f94..6074691e9 100644
--- a/tests/sync/test_context_manager.py
+++ b/tests/sync/test_context_manager.py
@@ -14,7 +14,9 @@
 
 from typing import Dict
 
-from playwright.sync_api import BrowserType
+import pytest
+
+from playwright.sync_api import BrowserContext, BrowserType
 
 
 def test_context_managers(browser_type: BrowserType, launch_arguments: Dict) -> None:
@@ -26,3 +28,9 @@ def test_context_managers(browser_type: BrowserType, launch_arguments: Dict) ->
             assert len(browser.contexts) == 1
         assert len(browser.contexts) == 0
     assert not browser.is_connected()
+
+
+def test_context_managers_not_hang(context: BrowserContext) -> None:
+    with pytest.raises(Exception, match="Oops!"):
+        with context.new_page():
+            raise Exception("Oops!")
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index b21532c86..e2606dc8d 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -150,10 +150,14 @@ def test_sync_wait_for_event(page: Page, server: Server) -> None:
 
 
 def test_sync_wait_for_event_raise(page: Page) -> None:
-    with pytest.raises(Error):
-        with page.expect_event("popup", timeout=500) as popup:
+    with pytest.raises(AssertionError):
+        with page.expect_event("popup", timeout=500):
             assert False
-        assert popup.value is None
+
+    with pytest.raises(Error) as exc_info:
+        with page.expect_event("popup", timeout=500):
+            page.wait_for_timeout(1_000)
+    assert "Timeout 500ms exceeded" in exc_info.value.message
 
 
 def test_sync_make_existing_page_sync(page: Page) -> None:
@@ -281,6 +285,12 @@ def test_expect_response_should_work(page: Page, server: Server) -> None:
     assert resp.value.request
 
 
+def test_expect_response_should_not_hang_when_predicate_throws(page: Page) -> None:
+    with pytest.raises(Exception, match="Oops!"):
+        with page.expect_response("**/*"):
+            raise Exception("Oops!")
+
+
 def test_expect_response_should_use_context_timeout(
     page: Page, context: BrowserContext, server: Server
 ) -> None:

From 7278dadeefc4a7ef420b745fe66eb1e9ccadd9c1 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 3 Nov 2023 16:45:25 +0100
Subject: [PATCH 110/438] test: add test when using tracing via connect (#2145)

---
 tests/async/test_browsertype_connect.py | 60 +++++++++++++++++++++++++
 tests/async/test_tracing.py             | 58 ++++--------------------
 tests/sync/test_tracing.py              | 58 ++++--------------------
 tests/utils.py                          | 57 +++++++++++++++++++++++
 4 files changed, 135 insertions(+), 98 deletions(-)
 create mode 100644 tests/utils.py

diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index 1bbadeae1..cafdfaab3 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -14,6 +14,7 @@
 
 import asyncio
 import re
+from pathlib import Path
 from typing import Callable
 
 import pytest
@@ -22,6 +23,7 @@
 from playwright.async_api import BrowserType, Error, Playwright, Route
 from tests.conftest import RemoteServer
 from tests.server import Server
+from tests.utils import parse_trace
 
 
 async def test_browser_type_connect_should_be_able_to_reconnect_to_a_browser(
@@ -299,3 +301,61 @@ async def test_should_upload_large_file(
     )
     assert match.group("name") == b"file1"
     assert match.group("filename") == b"200MB.zip"
+
+
+async def test_should_record_trace_with_source(
+    launch_server: Callable[[], RemoteServer],
+    server: Server,
+    tmp_path: Path,
+    browser_type: BrowserType,
+):
+    remote = launch_server()
+    browser = await browser_type.connect(remote.ws_endpoint)
+    context = await browser.new_context()
+    page = await context.new_page()
+
+    await context.tracing.start(sources=True)
+    await page.goto(server.EMPTY_PAGE)
+    await page.set_content("<button>Click</button>")
+    await page.click("'Click'")
+    path = tmp_path / "trace1.zip"
+    await context.tracing.stop(path=path)
+
+    await context.close()
+    await browser.close()
+
+    (resources, events) = parse_trace(path)
+    current_file_content = Path(__file__).read_bytes()
+    found_current_file = False
+    for name, resource in resources.items():
+        if resource == current_file_content:
+            found_current_file = True
+            break
+    assert found_current_file
+
+
+async def test_should_record_trace_with_relative_trace_path(
+    launch_server: Callable[[], RemoteServer],
+    server: Server,
+    tmp_path: Path,
+    browser_type: BrowserType,
+):
+    remote = launch_server()
+    browser = await browser_type.connect(remote.ws_endpoint)
+    context = await browser.new_context()
+    page = await context.new_page()
+
+    await context.tracing.start(sources=True)
+    await page.goto(server.EMPTY_PAGE)
+    await page.set_content("<button>Click</button>")
+    await page.click("'Click'")
+    try:
+        await context.tracing.stop(path="trace1.zip")
+
+        await context.close()
+        await browser.close()
+
+        # make sure trace1.zip exists
+        assert Path("trace1.zip").exists()
+    finally:
+        Path("trace1.zip").unlink()
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index 1473ab648..702f1fd45 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -12,14 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import json
 import re
-import zipfile
 from pathlib import Path
-from typing import Any, Dict, List, Tuple
+from typing import Dict, List
 
 from playwright.async_api import Browser, BrowserContext, BrowserType, Page
 from tests.server import Server
+from tests.utils import get_trace_actions, parse_trace
 
 
 async def test_browser_context_output_trace(
@@ -110,7 +109,7 @@ async def test_should_collect_trace_with_resources_but_no_js(
 
     (_, events) = parse_trace(trace_file_path)
     assert events[0]["type"] == "context-options"
-    assert get_actions(events) == [
+    assert get_trace_actions(events) == [
         "Page.goto",
         "Page.set_content",
         "Page.click",
@@ -165,7 +164,7 @@ async def test_should_collect_two_traces(
 
     (_, events) = parse_trace(tracing1_path)
     assert events[0]["type"] == "context-options"
-    assert get_actions(events) == [
+    assert get_trace_actions(events) == [
         "Page.goto",
         "Page.set_content",
         "Page.click",
@@ -173,7 +172,7 @@ async def test_should_collect_two_traces(
 
     (_, events) = parse_trace(tracing2_path)
     assert events[0]["type"] == "context-options"
-    assert get_actions(events) == ["Page.dblclick", "Page.close"]
+    assert get_trace_actions(events) == ["Page.dblclick", "Page.close"]
 
 
 async def test_should_not_throw_when_stopping_without_start_but_not_exporting(
@@ -200,7 +199,7 @@ async def test_should_work_with_playwright_context_managers(
 
     (_, events) = parse_trace(trace_file_path)
     assert events[0]["type"] == "context-options"
-    assert get_actions(events) == [
+    assert get_trace_actions(events) == [
         "Page.goto",
         "Page.set_content",
         "Page.expect_console_message",
@@ -224,7 +223,7 @@ async def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
     await context.tracing.stop(path=trace_file_path)
 
     (_, events) = parse_trace(trace_file_path)
-    assert get_actions(events) == [
+    assert get_trace_actions(events) == [
         "Page.goto",
         "Page.wait_for_load_state",
         "Page.wait_for_load_state",
@@ -265,7 +264,7 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
         )
 
     (resources, events) = parse_trace(tmpdir / "trace1.zip")
-    assert get_actions(events) == ["Page.goto"]
+    assert get_trace_actions(events) == ["Page.goto"]
     assert resource_names(resources) == [
         "resources/XXX.css",
         "resources/XXX.html",
@@ -275,7 +274,7 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
     ]
 
     (resources, events) = parse_trace(tmpdir / "trace2.zip")
-    assert get_actions(events) == ["Page.goto"]
+    assert get_trace_actions(events) == ["Page.goto"]
     assert resource_names(resources) == [
         "resources/XXX.css",
         "resources/XXX.html",
@@ -284,42 +283,3 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
         "trace.stacks",
         "trace.trace",
     ]
-
-
-def parse_trace(path: Path) -> Tuple[Dict[str, bytes], List[Any]]:
-    resources: Dict[str, bytes] = {}
-    with zipfile.ZipFile(path, "r") as zip:
-        for name in zip.namelist():
-            resources[name] = zip.read(name)
-    action_map: Dict[str, Any] = {}
-    events: List[Any] = []
-    for name in ["trace.trace", "trace.network"]:
-        for line in resources[name].decode().splitlines():
-            if not line:
-                continue
-            event = json.loads(line)
-            if event["type"] == "before":
-                event["type"] = "action"
-                action_map[event["callId"]] = event
-                events.append(event)
-            elif event["type"] == "input":
-                pass
-            elif event["type"] == "after":
-                existing = action_map[event["callId"]]
-                existing["error"] = event.get("error", None)
-            else:
-                events.append(event)
-    return (resources, events)
-
-
-def get_actions(events: List[Any]) -> List[str]:
-    action_events = sorted(
-        list(
-            filter(
-                lambda e: e["type"] == "action",
-                events,
-            )
-        ),
-        key=lambda e: e["startTime"],
-    )
-    return [e["apiName"] for e in action_events]
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index 61e67009d..eaef24e00 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -12,14 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import json
 import re
-import zipfile
 from pathlib import Path
-from typing import Any, Dict, List, Tuple
+from typing import Any, Dict, List
 
 from playwright.sync_api import Browser, BrowserContext, BrowserType, Page
 from tests.server import Server
+from tests.utils import get_trace_actions, parse_trace
 
 
 def test_browser_context_output_trace(
@@ -103,7 +102,7 @@ def test_should_collect_trace_with_resources_but_no_js(
 
     (_, events) = parse_trace(trace_file_path)
     assert events[0]["type"] == "context-options"
-    assert get_actions(events) == [
+    assert get_trace_actions(events) == [
         "Page.goto",
         "Page.set_content",
         "Page.click",
@@ -158,7 +157,7 @@ def test_should_collect_two_traces(
 
     (_, events) = parse_trace(tracing1_path)
     assert events[0]["type"] == "context-options"
-    assert get_actions(events) == [
+    assert get_trace_actions(events) == [
         "Page.goto",
         "Page.set_content",
         "Page.click",
@@ -166,7 +165,7 @@ def test_should_collect_two_traces(
 
     (_, events) = parse_trace(tracing2_path)
     assert events[0]["type"] == "context-options"
-    assert get_actions(events) == ["Page.dblclick", "Page.close"]
+    assert get_trace_actions(events) == ["Page.dblclick", "Page.close"]
 
 
 def test_should_not_throw_when_stopping_without_start_but_not_exporting(
@@ -193,7 +192,7 @@ def test_should_work_with_playwright_context_managers(
 
     (_, events) = parse_trace(trace_file_path)
     assert events[0]["type"] == "context-options"
-    assert get_actions(events) == [
+    assert get_trace_actions(events) == [
         "Page.goto",
         "Page.set_content",
         "Page.expect_console_message",
@@ -217,7 +216,7 @@ def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
     context.tracing.stop(path=trace_file_path)
 
     (_, events) = parse_trace(trace_file_path)
-    assert get_actions(events) == [
+    assert get_trace_actions(events) == [
         "Page.goto",
         "Page.wait_for_load_state",
         "Page.wait_for_load_state",
@@ -258,7 +257,7 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
         )
 
     (resources, events) = parse_trace(tmpdir / "trace1.zip")
-    assert get_actions(events) == ["Page.goto"]
+    assert get_trace_actions(events) == ["Page.goto"]
     assert resource_names(resources) == [
         "resources/XXX.css",
         "resources/XXX.html",
@@ -268,7 +267,7 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
     ]
 
     (resources, events) = parse_trace(tmpdir / "trace2.zip")
-    assert get_actions(events) == ["Page.goto"]
+    assert get_trace_actions(events) == ["Page.goto"]
     assert resource_names(resources) == [
         "resources/XXX.css",
         "resources/XXX.html",
@@ -277,42 +276,3 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
         "trace.stacks",
         "trace.trace",
     ]
-
-
-def parse_trace(path: Path) -> Tuple[Dict[str, bytes], List[Any]]:
-    resources: Dict[str, bytes] = {}
-    with zipfile.ZipFile(path, "r") as zip:
-        for name in zip.namelist():
-            resources[name] = zip.read(name)
-    action_map: Dict[str, Any] = {}
-    events: List[Any] = []
-    for name in ["trace.trace", "trace.network"]:
-        for line in resources[name].decode().splitlines():
-            if not line:
-                continue
-            event = json.loads(line)
-            if event["type"] == "before":
-                event["type"] = "action"
-                action_map[event["callId"]] = event
-                events.append(event)
-            elif event["type"] == "input":
-                pass
-            elif event["type"] == "after":
-                existing = action_map[event["callId"]]
-                existing["error"] = event.get("error", None)
-            else:
-                events.append(event)
-    return (resources, events)
-
-
-def get_actions(events: List[Any]) -> List[str]:
-    action_events = sorted(
-        list(
-            filter(
-                lambda e: e["type"] == "action",
-                events,
-            )
-        ),
-        key=lambda e: e["startTime"],
-    )
-    return [e["apiName"] for e in action_events]
diff --git a/tests/utils.py b/tests/utils.py
new file mode 100644
index 000000000..287900faa
--- /dev/null
+++ b/tests/utils.py
@@ -0,0 +1,57 @@
+# 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 json
+import zipfile
+from pathlib import Path
+from typing import Any, Dict, List, Tuple
+
+
+def parse_trace(path: Path) -> Tuple[Dict[str, bytes], List[Any]]:
+    resources: Dict[str, bytes] = {}
+    with zipfile.ZipFile(path, "r") as zip:
+        for name in zip.namelist():
+            resources[name] = zip.read(name)
+    action_map: Dict[str, Any] = {}
+    events: List[Any] = []
+    for name in ["trace.trace", "trace.network"]:
+        for line in resources[name].decode().splitlines():
+            if not line:
+                continue
+            event = json.loads(line)
+            if event["type"] == "before":
+                event["type"] = "action"
+                action_map[event["callId"]] = event
+                events.append(event)
+            elif event["type"] == "input":
+                pass
+            elif event["type"] == "after":
+                existing = action_map[event["callId"]]
+                existing["error"] = event.get("error", None)
+            else:
+                events.append(event)
+    return (resources, events)
+
+
+def get_trace_actions(events: List[Any]) -> List[str]:
+    action_events = sorted(
+        list(
+            filter(
+                lambda e: e["type"] == "action",
+                events,
+            )
+        ),
+        key=lambda e: e["startTime"],
+    )
+    return [e["apiName"] for e in action_events]

From 64efac3c41d10023dab1f0ede950a4d54fa404e9 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 7 Nov 2023 17:49:12 +0100
Subject: [PATCH 111/438] devops: remove pinned conda-version (#2148)

Co-authored-by: Yury Semikhatsky <yurys@chromium.org>
---
 .github/workflows/ci.yml      | 2 --
 .github/workflows/publish.yml | 2 --
 2 files changed, 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a8e7c7cec..c37bf348e 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -168,8 +168,6 @@ jobs:
         with:
           python-version: 3.9
           channels: conda-forge
-          # TODO: Can be removed after https://github.com/conda/conda/issues/12955 is fixed
-          conda-version: 23.5.2
       - name: Prepare
         run: conda install conda-build conda-verify
       - name: Build
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 5ef512838..cc729ae1e 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -17,8 +17,6 @@ jobs:
         with:
           python-version: 3.9
           channels: conda-forge
-          # TODO: Can be removed after https://github.com/conda/conda/issues/12955 is fixed
-          conda-version: 23.5.2
       - name: Prepare
         run: conda install anaconda-client conda-build conda-verify
       - name: Build and Upload

From 9060038770d19256d08ec29fab82086f07a3cce9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 9 Nov 2023 00:39:14 +0100
Subject: [PATCH 112/438] build(deps): bump twisted from 23.8.0 to 23.10.0
 (#2150)

Bumps [twisted](https://github.com/twisted/twisted) from 23.8.0 to 23.10.0.
- [Release notes](https://github.com/twisted/twisted/releases)
- [Changelog](https://github.com/twisted/twisted/blob/trunk/NEWS.rst)
- [Commits](https://github.com/twisted/twisted/compare/twisted-23.8.0...twisted-23.10.0)

---
updated-dependencies:
- dependency-name: twisted
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index caffb929c..68edf4cb1 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -18,6 +18,6 @@ pytest-xdist==3.3.1
 requests==2.31.0
 service_identity==23.1.0
 setuptools==68.2.2
-twisted==23.8.0
+twisted==23.10.0
 types-pyOpenSSL==23.2.0.2
 wheel==0.41.2

From 8229ee5814866b219a58eaa4dfd2ec6a5d99c0d0 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 13 Nov 2023 17:45:14 +0100
Subject: [PATCH 113/438] fix: page.pause() timeout reset (#2157)

---
 playwright/_impl/_browser_context.py |  7 +++++--
 tests/async/test_page.py             | 30 ++++++++++++++++++++++++++++
 tests/conftest.py                    | 19 ++++++++++--------
 tests/sync/test_page.py              | 30 ++++++++++++++++++++++++++++
 4 files changed, 76 insertions(+), 10 deletions(-)

diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 6681e0852..bfcae8c29 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -248,7 +248,8 @@ def set_default_navigation_timeout(self, timeout: float) -> None:
     def _set_default_navigation_timeout_impl(self, timeout: Optional[float]) -> None:
         self._timeout_settings.set_default_navigation_timeout(timeout)
         self._channel.send_no_reply(
-            "setDefaultNavigationTimeoutNoReply", dict(timeout=timeout)
+            "setDefaultNavigationTimeoutNoReply",
+            {} if timeout is None else {"timeout": timeout},
         )
 
     def set_default_timeout(self, timeout: float) -> None:
@@ -256,7 +257,9 @@ def set_default_timeout(self, timeout: float) -> None:
 
     def _set_default_timeout_impl(self, timeout: Optional[float]) -> None:
         self._timeout_settings.set_default_timeout(timeout)
-        self._channel.send_no_reply("setDefaultTimeoutNoReply", dict(timeout=timeout))
+        self._channel.send_no_reply(
+            "setDefaultTimeoutNoReply", {} if timeout is None else {"timeout": timeout}
+        )
 
     @property
     def pages(self) -> List[Page]:
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index b92516c3c..b983b631e 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -1294,3 +1294,33 @@ def binding(source, o):
     await page.expose_binding("log", lambda source, o: binding(source, o))
     await page.evaluate("const a = {}; a.b = a; window.log(a)")
     assert binding_values[0]["b"] == binding_values[0]
+
+
+async def test_page_pause_should_reset_default_timeouts(
+    page: Page, headless: bool, server: Server
+) -> None:
+    if not headless:
+        pytest.skip()
+
+    await page.goto(server.EMPTY_PAGE)
+    page.pause()
+    with pytest.raises(Error, match="Timeout 30000ms exceeded."):
+        await page.get_by_text("foo").click()
+
+
+async def test_page_pause_should_reset_custom_timeouts(
+    page: Page, headless: bool, server: Server
+) -> None:
+    if not headless:
+        pytest.skip()
+
+    page.set_default_timeout(123)
+    page.set_default_navigation_timeout(456)
+    await page.goto(server.EMPTY_PAGE)
+    page.pause()
+    with pytest.raises(Error, match="Timeout 123ms exceeded."):
+        await page.get_by_text("foo").click()
+
+    server.set_route("/empty.html", lambda route: None)
+    with pytest.raises(Error, match="Timeout 456ms exceeded."):
+        await page.goto(server.EMPTY_PAGE)
diff --git a/tests/conftest.py b/tests/conftest.py
index a3b8e9992..80ec8e0fb 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -35,7 +35,7 @@
 _dirname = get_file_dirname()
 
 
-def pytest_generate_tests(metafunc: Any) -> None:
+def pytest_generate_tests(metafunc: pytest.Metafunc) -> None:
     if "browser_name" in metafunc.fixturenames:
         browsers = metafunc.config.option.browser or ["chromium", "firefox", "webkit"]
         metafunc.parametrize("browser_name", browsers, scope="session")
@@ -54,11 +54,14 @@ def assetdir() -> Path:
 
 
 @pytest.fixture(scope="session")
-def launch_arguments(pytestconfig: Any) -> Dict:
+def headless(pytestconfig: pytest.Config) -> bool:
+    return not (pytestconfig.getoption("--headed") or os.getenv("HEADFUL", False))
+
+
+@pytest.fixture(scope="session")
+def launch_arguments(pytestconfig: pytest.Config, headless: bool) -> Dict:
     return {
-        "headless": not (
-            pytestconfig.getoption("--headed") or os.getenv("HEADFUL", False)
-        ),
+        "headless": headless,
         "channel": pytestconfig.getoption("--browser-channel"),
     }
 
@@ -92,12 +95,12 @@ def after_each_hook() -> Generator[None, None, None]:
 
 
 @pytest.fixture(scope="session")
-def browser_name(pytestconfig: Any) -> None:
+def browser_name(pytestconfig: pytest.Config) -> None:
     return pytestconfig.getoption("browser")
 
 
 @pytest.fixture(scope="session")
-def browser_channel(pytestconfig: Any) -> None:
+def browser_channel(pytestconfig: pytest.Config) -> None:
     return pytestconfig.getoption("--browser-channel")
 
 
@@ -169,7 +172,7 @@ def skip_by_platform(request: pytest.FixtureRequest) -> None:
         pytest.skip(f"skipped on this platform: {sys.platform}")
 
 
-def pytest_addoption(parser: Any) -> None:
+def pytest_addoption(parser: pytest.Parser) -> None:
     group = parser.getgroup("playwright", "Playwright")
     group.addoption(
         "--browser",
diff --git a/tests/sync/test_page.py b/tests/sync/test_page.py
index ccb229196..7550a80d1 100644
--- a/tests/sync/test_page.py
+++ b/tests/sync/test_page.py
@@ -84,3 +84,33 @@ def test_emitted_for_domcontentloaded_and_load(page: Page, server: Server) -> No
             page.goto(server.EMPTY_PAGE)
     assert isinstance(dom_info.value, Page)
     assert isinstance(load_info.value, Page)
+
+
+def test_page_pause_should_reset_default_timeouts(
+    page: Page, headless: bool, server: Server
+) -> None:
+    if not headless:
+        pytest.skip()
+
+    page.goto(server.EMPTY_PAGE)
+    page.pause()
+    with pytest.raises(Error, match="Timeout 30000ms exceeded."):
+        page.get_by_text("foo").click()
+
+
+def test_page_pause_should_reset_custom_timeouts(
+    page: Page, headless: bool, server: Server
+) -> None:
+    if not headless:
+        pytest.skip()
+
+    page.set_default_timeout(123)
+    page.set_default_navigation_timeout(456)
+    page.goto(server.EMPTY_PAGE)
+    page.pause()
+    with pytest.raises(Error, match="Timeout 123ms exceeded."):
+        page.get_by_text("foo").click()
+
+    server.set_route("/empty.html", lambda route: None)
+    with pytest.raises(Error, match="Timeout 456ms exceeded."):
+        page.goto(server.EMPTY_PAGE)

From 8e120e4558a0dfae1157a9f8a20868d3976cd8de Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 15 Nov 2023 19:53:42 +0100
Subject: [PATCH 114/438] chore: fix Ubuntu 22.04 WebKit on 20.04 host (#2161)

---
 utils/docker/Dockerfile.jammy | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/utils/docker/Dockerfile.jammy b/utils/docker/Dockerfile.jammy
index 8e6498381..273187d6e 100644
--- a/utils/docker/Dockerfile.jammy
+++ b/utils/docker/Dockerfile.jammy
@@ -43,6 +43,15 @@ RUN mkdir /ms-playwright && \
     # if its arm64 then install the manylinux1_aarch64 pip package
     if [ "$(uname -m)" = "aarch64" ]; then pip install /tmp/*manylinux_2_17_aarch64*.whl; fi && \
     playwright mark-docker-image "${DOCKER_IMAGE_NAME_TEMPLATE}" && \
+    # Workaround for https://github.com/microsoft/playwright/issues/27313
+    # While the gstreamer plugin load process can be in-process, it ended up throwing
+    # an error that it can't have libsoup2 and libsoup3 in the same process because
+    # libgstwebrtc is linked against libsoup2. So we just remove the plugin.
+    if [ "$(uname -m)" = "aarch64" ]; then \
+        rm /usr/lib/aarch64-linux-gnu/gstreamer-1.0/libgstwebrtc.so; \
+    else \
+        rm /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstwebrtc.so; \
+    fi && \
     playwright install --with-deps && rm -rf /var/lib/apt/lists/* && \
     rm /tmp/*.whl && \
     rm -rf /ms-playwright-agent && \

From fc91dfdccc90d0962c35cfab91683e6284ef419d Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 15 Nov 2023 19:54:24 +0100
Subject: [PATCH 115/438] chore: bump greenlet to v3.0.1 (#2158)

---
 meta.yaml | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/meta.yaml b/meta.yaml
index 32413e8c0..8eb97274f 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -23,7 +23,7 @@ requirements:
     - setuptools_scm
   run:
     - python
-    - greenlet ==3.0.0
+    - greenlet ==3.0.1
     - pyee ==11.0.1
     - typing_extensions # [py<39]
 test:
diff --git a/setup.py b/setup.py
index 98b2dc854..e7a40794f 100644
--- a/setup.py
+++ b/setup.py
@@ -218,7 +218,7 @@ def _download_and_extract_local_driver(
     ],
     include_package_data=True,
     install_requires=[
-        "greenlet==3.0.0",
+        "greenlet==3.0.1",
         "pyee==11.0.1",
         "typing-extensions;python_version<='3.8'",
     ],

From f5f145f1e2169c965a81010096f2fa99d4685834 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 16 Nov 2023 18:33:44 +0100
Subject: [PATCH 116/438] devops: fix Docker canary publishing/building (#2168)

---
 utils/docker/Dockerfile.jammy  | 2 +-
 utils/docker/publish_docker.sh | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/utils/docker/Dockerfile.jammy b/utils/docker/Dockerfile.jammy
index 273187d6e..8dab1e1d1 100644
--- a/utils/docker/Dockerfile.jammy
+++ b/utils/docker/Dockerfile.jammy
@@ -43,6 +43,7 @@ RUN mkdir /ms-playwright && \
     # if its arm64 then install the manylinux1_aarch64 pip package
     if [ "$(uname -m)" = "aarch64" ]; then pip install /tmp/*manylinux_2_17_aarch64*.whl; fi && \
     playwright mark-docker-image "${DOCKER_IMAGE_NAME_TEMPLATE}" && \
+    playwright install --with-deps && rm -rf /var/lib/apt/lists/* && \
     # Workaround for https://github.com/microsoft/playwright/issues/27313
     # While the gstreamer plugin load process can be in-process, it ended up throwing
     # an error that it can't have libsoup2 and libsoup3 in the same process because
@@ -52,7 +53,6 @@ RUN mkdir /ms-playwright && \
     else \
         rm /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstwebrtc.so; \
     fi && \
-    playwright install --with-deps && rm -rf /var/lib/apt/lists/* && \
     rm /tmp/*.whl && \
     rm -rf /ms-playwright-agent && \
     chmod -R 777 /ms-playwright
diff --git a/utils/docker/publish_docker.sh b/utils/docker/publish_docker.sh
index 23208e01b..e5bba0eb9 100755
--- a/utils/docker/publish_docker.sh
+++ b/utils/docker/publish_docker.sh
@@ -16,7 +16,7 @@ if [[ "${RELEASE_CHANNEL}" == "stable" ]]; then
     exit 1
   fi
 elif [[ "${RELEASE_CHANNEL}" == "canary" ]]; then
-  if [[ "${PW_VERSION}" != *post* ]]; then
+  if [[ "${PW_VERSION}" != *dev* ]]; then
     echo "ERROR: cannot publish canary docker with Playwright version '${PW_VERSION}'"
     exit 1
   fi

From 9271ab9ddb2736ef1ed9f4ef55c2ab4bd2069106 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 16 Nov 2023 19:44:35 +0100
Subject: [PATCH 117/438] chore(roll): roll Playwright to
 1.40.0-alpha-oct-18-2023 (#2167)

---
 README.md                                     |  2 +-
 playwright/_impl/_artifact.py                 |  4 +-
 playwright/_impl/_assertions.py               | 13 ++----
 playwright/_impl/_browser.py                  | 23 ++++------
 playwright/_impl/_browser_context.py          | 30 ++++++++----
 playwright/_impl/_browser_type.py             |  7 ++-
 playwright/_impl/_connection.py               | 34 +++++++++-----
 playwright/_impl/_download.py                 |  2 +-
 .../_impl/{_api_types.py => _errors.py}       |  9 ++++
 playwright/_impl/_fetch.py                    | 18 ++++++--
 playwright/_impl/_frame.py                    | 46 +++++++++----------
 playwright/_impl/_helper.py                   | 15 ++----
 playwright/_impl/_impl_to_api_mapping.py      |  2 +-
 playwright/_impl/_network.py                  | 24 +++++-----
 playwright/_impl/_page.py                     | 38 +++++++++------
 playwright/_impl/_selectors.py                |  2 +-
 .../_impl/{_wait_helper.py => _waiter.py}     | 10 ++--
 playwright/async_api/__init__.py              |  6 +--
 playwright/async_api/_generated.py            | 35 ++++++++++----
 playwright/sync_api/__init__.py               |  6 +--
 playwright/sync_api/_context_manager.py       |  2 +-
 playwright/sync_api/_generated.py             | 37 +++++++++++----
 scripts/documentation_provider.py             |  8 +---
 scripts/generate_api.py                       |  2 +-
 setup.py                                      |  2 +-
 tests/async/test_asyncio.py                   |  6 +--
 tests/async/test_browsercontext.py            |  3 +-
 tests/async/test_cdp_session.py               |  3 +-
 tests/async/test_defaultbrowsercontext.py     |  3 +-
 tests/async/test_download.py                  |  3 +-
 tests/async/test_fetch_browser_context.py     |  8 +---
 tests/async/test_fetch_global.py              |  8 ++--
 tests/async/test_keyboard.py                  |  3 +-
 tests/async/test_launcher.py                  |  6 +--
 tests/async/test_page.py                      |  7 +--
 tests/async/test_page_request_intercept.py    |  2 +-
 tests/async/test_worker.py                    |  5 +-
 tests/sync/test_cdp_session.py                |  3 +-
 tests/sync/test_fetch_browser_context.py      |  8 +---
 tests/sync/test_fetch_global.py               |  2 +-
 tests/sync/test_sync.py                       |  3 +-
 tests/utils.py                                |  3 ++
 42 files changed, 256 insertions(+), 197 deletions(-)
 rename playwright/_impl/{_api_types.py => _errors.py} (81%)
 rename playwright/_impl/{_wait_helper.py => _waiter.py} (95%)

diff --git a/README.md b/README.md
index 988c74e29..6191d6535 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->119.0.6045.9<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->119.0.6045.21<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->118.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/playwright/_impl/_artifact.py b/playwright/_impl/_artifact.py
index 78985a774..63833fe04 100644
--- a/playwright/_impl/_artifact.py
+++ b/playwright/_impl/_artifact.py
@@ -28,13 +28,13 @@ def __init__(
         super().__init__(parent, type, guid, initializer)
         self.absolute_path = initializer["absolutePath"]
 
-    async def path_after_finished(self) -> Optional[pathlib.Path]:
+    async def path_after_finished(self) -> pathlib.Path:
         if self._connection.is_remote:
             raise Error(
                 "Path is not available when using browser_type.connect(). Use save_as() to save a local copy."
             )
         path = await self._channel.send("pathAfterFinished")
-        return pathlib.Path(path) if path else None
+        return pathlib.Path(path)
 
     async def save_as(self, path: Union[str, Path]) -> None:
         stream = cast(Stream, from_channel(await self._channel.send("saveAsStream")))
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index f54a672e1..730e1e294 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -16,6 +16,7 @@
 from urllib.parse import urljoin
 
 from playwright._impl._api_structures import ExpectedTextValue, FrameExpectOptions
+from playwright._impl._connection import format_call_log
 from playwright._impl._fetch import APIResponse
 from playwright._impl._helper import is_textual_mime_type
 from playwright._impl._locator import Locator
@@ -56,9 +57,6 @@ async def _expect_impl(
         result = await self._actual_locator._expect(expression, expect_options)
         if result["matches"] == self._is_not:
             actual = result.get("received")
-            log = "\n".join(result.get("log", "")).strip()
-            if log:
-                log = "\nCall log:\n" + log
             if self._custom_message:
                 out_message = self._custom_message
                 if expected is not None:
@@ -67,7 +65,9 @@ async def _expect_impl(
                 out_message = (
                     f"{message} '{expected}'" if expected is not None else f"{message}"
                 )
-            raise AssertionError(f"{out_message}\nActual value: {actual} {log}")
+            raise AssertionError(
+                f"{out_message}\nActual value: {actual} {format_call_log(result.get('log'))}"
+            )
 
 
 class PageAssertions(AssertionsBase):
@@ -720,10 +720,7 @@ async def to_be_ok(
         if self._is_not:
             message = message.replace("expected to", "expected not to")
         out_message = self._custom_message or message
-        log_list = await self._actual._fetch_log()
-        log = "\n".join(log_list).strip()
-        if log:
-            out_message += f"\n Call log:\n{log}"
+        out_message += format_call_log(await self._actual._fetch_log())
 
         content_type = self._actual.headers.get("content-type")
         is_text_encoding = content_type and is_textual_mime_type(content_type)
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index 2649d75ea..5fbc841db 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -27,9 +27,9 @@
 from playwright._impl._artifact import Artifact
 from playwright._impl._browser_context import BrowserContext
 from playwright._impl._cdp_session import CDPSession
-from playwright._impl._connection import ChannelOwner, from_channel
+from playwright._impl._connection import ChannelOwner, filter_none, from_channel
+from playwright._impl._errors import is_target_closed_error
 from playwright._impl._helper import (
-    BROWSER_CLOSED_ERROR,
     ColorScheme,
     ForcedColors,
     HarContentPolicy,
@@ -37,7 +37,6 @@
     ReducedMotion,
     ServiceWorkersPolicy,
     async_readfile,
-    is_safe_close_error,
     locals_to_params,
     make_dirs_for_file,
     prepare_record_har_options,
@@ -60,12 +59,12 @@ def __init__(
         super().__init__(parent, type, guid, initializer)
         self._browser_type = parent
         self._is_connected = True
-        self._is_closed_or_closing = False
         self._should_close_connection_on_close = False
         self._cr_tracing_path: Optional[str] = None
 
         self._contexts: List[BrowserContext] = []
         self._channel.on("close", lambda _: self._on_close())
+        self._close_reason: Optional[str] = None
 
     def __repr__(self) -> str:
         return f"<Browser type={self._browser_type} version={self.version}>"
@@ -73,7 +72,6 @@ def __repr__(self) -> str:
     def _on_close(self) -> None:
         self._is_connected = False
         self.emit(Browser.Events.Disconnected, self)
-        self._is_closed_or_closing = True
 
     @property
     def contexts(self) -> List[BrowserContext]:
@@ -179,17 +177,16 @@ async def inner() -> Page:
 
         return await self._connection.wrap_api_call(inner)
 
-    async def close(self) -> None:
-        if self._is_closed_or_closing:
-            return
-        self._is_closed_or_closing = True
+    async def close(self, reason: str = None) -> None:
+        self._close_reason = reason
         try:
-            await self._channel.send("close")
+            if self._should_close_connection_on_close:
+                await self._connection.stop_async()
+            else:
+                await self._channel.send("close", filter_none({"reason": reason}))
         except Exception as e:
-            if not is_safe_close_error(e):
+            if not is_target_closed_error(e):
                 raise e
-        if self._should_close_connection_on_close:
-            await self._connection.stop_async(BROWSER_CLOSED_ERROR)
 
     @property
     def version(self) -> str:
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index bfcae8c29..60c4166e8 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -36,16 +36,17 @@
     SetCookieParam,
     StorageState,
 )
-from playwright._impl._api_types import Error
 from playwright._impl._artifact import Artifact
 from playwright._impl._cdp_session import CDPSession
 from playwright._impl._connection import (
     ChannelOwner,
+    filter_none,
     from_channel,
     from_nullable_channel,
 )
 from playwright._impl._console_message import ConsoleMessage
 from playwright._impl._dialog import Dialog
+from playwright._impl._errors import Error, TargetClosedError
 from playwright._impl._event_context_manager import EventContextManagerImpl
 from playwright._impl._fetch import APIRequestContext
 from playwright._impl._frame import Frame
@@ -70,7 +71,7 @@
 from playwright._impl._network import Request, Response, Route, serialize_headers
 from playwright._impl._page import BindingCall, Page, Worker
 from playwright._impl._tracing import Tracing
-from playwright._impl._wait_helper import WaitHelper
+from playwright._impl._waiter import Waiter
 from playwright._impl._web_error import WebError
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -194,6 +195,7 @@ def __init__(
         self.once(
             self.Events.Close, lambda context: self._closed_future.set_result(True)
         )
+        self._close_reason: Optional[str] = None
         self._set_event_to_subscription_mapping(
             {
                 BrowserContext.Events.Console: "console",
@@ -433,16 +435,16 @@ def expect_event(
     ) -> EventContextManagerImpl:
         if timeout is None:
             timeout = self._timeout_settings.timeout()
-        wait_helper = WaitHelper(self, f"browser_context.expect_event({event})")
-        wait_helper.reject_on_timeout(
+        waiter = Waiter(self, f"browser_context.expect_event({event})")
+        waiter.reject_on_timeout(
             timeout, f'Timeout {timeout}ms exceeded while waiting for event "{event}"'
         )
         if event != BrowserContext.Events.Close:
-            wait_helper.reject_on_event(
-                self, BrowserContext.Events.Close, Error("Context closed")
+            waiter.reject_on_event(
+                self, BrowserContext.Events.Close, lambda: TargetClosedError()
             )
-        wait_helper.wait_for_event(self, event, predicate)
-        return EventContextManagerImpl(wait_helper.result())
+        waiter.wait_for_event(self, event, predicate)
+        return EventContextManagerImpl(waiter.result())
 
     def _on_close(self) -> None:
         if self._browser:
@@ -450,9 +452,10 @@ def _on_close(self) -> None:
 
         self.emit(BrowserContext.Events.Close, self)
 
-    async def close(self) -> None:
+    async def close(self, reason: str = None) -> None:
         if self._close_was_called:
             return
+        self._close_reason = reason
         self._close_was_called = True
 
         async def _inner_close() -> None:
@@ -479,7 +482,7 @@ async def _inner_close() -> None:
                 await har.delete()
 
         await self._channel._connection.wrap_api_call(_inner_close, True)
-        await self._channel.send("close")
+        await self._channel.send("close", filter_none({"reason": reason}))
         await self._closed_future
 
     async def storage_state(self, path: Union[str, Path] = None) -> StorageState:
@@ -488,6 +491,13 @@ async def storage_state(self, path: Union[str, Path] = None) -> StorageState:
             await async_writefile(path, json.dumps(result))
         return result
 
+    def _effective_close_reason(self) -> Optional[str]:
+        if self._close_reason:
+            return self._close_reason
+        if self._browser:
+            return self._browser._close_reason
+        return None
+
     async def wait_for_event(
         self, event: str, predicate: Callable = None, timeout: float = None
     ) -> Any:
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 4d93a9b14..4a916171a 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -23,7 +23,6 @@
     ProxySettings,
     ViewportSize,
 )
-from playwright._impl._api_types import Error
 from playwright._impl._browser import Browser, prepare_browser_context_params
 from playwright._impl._browser_context import BrowserContext
 from playwright._impl._connection import (
@@ -33,8 +32,8 @@
     from_channel,
     from_nullable_channel,
 )
+from playwright._impl._errors import Error
 from playwright._impl._helper import (
-    BROWSER_CLOSED_ERROR,
     ColorScheme,
     Env,
     ForcedColors,
@@ -46,7 +45,7 @@
 )
 from playwright._impl._json_pipe import JsonPipeTransport
 from playwright._impl._network import serialize_headers
-from playwright._impl._wait_helper import throw_on_timeout
+from playwright._impl._waiter import throw_on_timeout
 
 if TYPE_CHECKING:
     from playwright._impl._playwright import Playwright
@@ -249,7 +248,7 @@ def handle_transport_close() -> None:
                     page._on_close()
                 context._on_close()
             browser._on_close()
-            connection.cleanup(BROWSER_CLOSED_ERROR)
+            connection.cleanup()
 
         transport.once("close", handle_transport_close)
 
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 7f58c214e..479f908f0 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -36,6 +36,7 @@
 from pyee.asyncio import AsyncIOEventEmitter
 
 import playwright
+from playwright._impl._errors import TargetClosedError
 from playwright._impl._helper import Error, ParsedMessagePayload, parse_error
 from playwright._impl._transport import Transport
 
@@ -250,7 +251,7 @@ def __init__(
         ] = contextvars.ContextVar("ApiZone", default=None)
         self._local_utils: Optional["LocalUtils"] = local_utils
         self._tracing_count = 0
-        self._closed_error_message: Optional[str] = None
+        self._closed_error: Optional[Exception] = None
 
     @property
     def local_utils(self) -> "LocalUtils":
@@ -281,21 +282,21 @@ def stop_sync(self) -> None:
         self._loop.run_until_complete(self._transport.wait_until_stopped())
         self.cleanup()
 
-    async def stop_async(self, error_message: str = None) -> None:
+    async def stop_async(self) -> None:
         self._transport.request_stop()
         await self._transport.wait_until_stopped()
-        self.cleanup(error_message)
+        self.cleanup()
 
-    def cleanup(self, error_message: str = None) -> None:
-        if not error_message:
-            error_message = "Connection closed"
-        self._closed_error_message = error_message
+    def cleanup(self, cause: Exception = None) -> None:
+        self._closed_error = (
+            TargetClosedError(str(cause)) if cause else TargetClosedError()
+        )
         if self._init_task and not self._init_task.done():
             self._init_task.cancel()
         for ws_connection in self._child_ws_connections:
             ws_connection._transport.dispose()
         for callback in self._callbacks.values():
-            callback.future.set_exception(Error(error_message))
+            callback.future.set_exception(self._closed_error)
         self._callbacks.clear()
         self.emit("close")
 
@@ -313,8 +314,8 @@ def set_in_tracing(self, is_tracing: bool) -> None:
     def _send_message_to_server(
         self, object: ChannelOwner, method: str, params: Dict, no_reply: bool = False
     ) -> ProtocolCallback:
-        if self._closed_error_message:
-            raise Error(self._closed_error_message)
+        if self._closed_error:
+            raise self._closed_error
         if object._was_collected:
             raise Error(
                 "The object has been collected to prevent unbounded heap growth."
@@ -361,7 +362,7 @@ def _send_message_to_server(
         return callback
 
     def dispatch(self, msg: ParsedMessagePayload) -> None:
-        if self._closed_error_message:
+        if self._closed_error:
             return
         id = msg.get("id")
         if id:
@@ -373,11 +374,12 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
             if callback.no_reply:
                 return
             error = msg.get("error")
-            if error:
+            if error and not msg.get("result"):
                 parsed_error = parse_error(error["error"])  # type: ignore
                 parsed_error._stack = "".join(
                     traceback.format_list(callback.stack_trace)[-10:]
                 )
+                parsed_error._message += format_call_log(msg.get("log"))  # type: ignore
                 callback.future.set_exception(parsed_error)
             else:
                 result = self._replace_guids_with_channels(msg.get("result"))
@@ -565,3 +567,11 @@ def _extract_stack_trace_information_from_stack(
 
 def filter_none(d: Mapping) -> Dict:
     return {k: v for k, v in d.items() if v is not None}
+
+
+def format_call_log(log: Optional[List[str]]) -> str:
+    if not log:
+        return ""
+    if len(list(filter(lambda x: x.strip(), log))) == 0:
+        return ""
+    return "\nCall log:\n" + "\n  - ".join(log) + "\n"
diff --git a/playwright/_impl/_download.py b/playwright/_impl/_download.py
index 1b93850ba..ffaf5cacd 100644
--- a/playwright/_impl/_download.py
+++ b/playwright/_impl/_download.py
@@ -54,7 +54,7 @@ async def delete(self) -> None:
     async def failure(self) -> Optional[str]:
         return await self._artifact.failure()
 
-    async def path(self) -> Optional[pathlib.Path]:
+    async def path(self) -> pathlib.Path:
         return await self._artifact.path_after_finished()
 
     async def save_as(self, path: Union[str, Path]) -> None:
diff --git a/playwright/_impl/_api_types.py b/playwright/_impl/_errors.py
similarity index 81%
rename from playwright/_impl/_api_types.py
rename to playwright/_impl/_errors.py
index e921e9867..9bd6ab901 100644
--- a/playwright/_impl/_api_types.py
+++ b/playwright/_impl/_errors.py
@@ -19,6 +19,10 @@
 from typing import Optional
 
 
+def is_target_closed_error(error: Exception) -> bool:
+    return isinstance(error, TargetClosedError)
+
+
 class Error(Exception):
     def __init__(self, message: str) -> None:
         self._message = message
@@ -41,3 +45,8 @@ def stack(self) -> Optional[str]:
 
 class TimeoutError(Error):
     pass
+
+
+class TargetClosedError(Error):
+    def __init__(self, message: str = None) -> None:
+        super().__init__(message or "Target page, context or browser has been closed")
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index 997133227..27fab09c1 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -30,13 +30,13 @@
     StorageState,
 )
 from playwright._impl._connection import ChannelOwner, filter_none, from_channel
+from playwright._impl._errors import is_target_closed_error
 from playwright._impl._helper import (
     Error,
     NameValue,
     async_readfile,
     async_writefile,
     is_file_payload,
-    is_safe_close_error,
     locals_to_params,
     object_to_array,
     to_impl,
@@ -330,13 +330,13 @@ async def _inner_fetch(
         if data:
             if isinstance(data, str):
                 if is_json_content_type(serialized_headers):
-                    json_data = data
+                    json_data = data if is_json_parsable(data) else json.dumps(data)
                 else:
                     post_data_buffer = data.encode()
             elif isinstance(data, bytes):
                 post_data_buffer = data
             elif isinstance(data, (dict, list, int, bool)):
-                json_data = data
+                json_data = json.dumps(data)
             else:
                 raise Error(f"Unsupported 'data' type: {type(data)}")
         elif form:
@@ -451,7 +451,7 @@ async def body(self) -> bytes:
                 raise Error("Response has been disposed")
             return base64.b64decode(result["binary"])
         except Error as exc:
-            if is_safe_close_error(exc):
+            if is_target_closed_error(exc):
                 raise Error("Response has been disposed")
             raise exc
 
@@ -491,3 +491,13 @@ def is_json_content_type(headers: network.HeadersArray = None) -> bool:
         if header["name"] == "Content-Type":
             return header["value"].startswith("application/json")
     return False
+
+
+def is_json_parsable(value: Any) -> bool:
+    if not isinstance(value, str):
+        return False
+    try:
+        json.loads(value)
+        return True
+    except json.JSONDecodeError:
+        return False
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index b004d3cbc..d8836e3bb 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -20,13 +20,13 @@
 from pyee import EventEmitter
 
 from playwright._impl._api_structures import AriaRole, FilePayload, Position
-from playwright._impl._api_types import Error
 from playwright._impl._connection import (
     ChannelOwner,
     from_channel,
     from_nullable_channel,
 )
 from playwright._impl._element_handle import ElementHandle, convert_select_option_values
+from playwright._impl._errors import Error
 from playwright._impl._event_context_manager import EventContextManagerImpl
 from playwright._impl._helper import (
     DocumentLoadState,
@@ -59,7 +59,7 @@
 )
 from playwright._impl._network import Response
 from playwright._impl._set_input_files_helpers import convert_input_files
-from playwright._impl._wait_helper import WaitHelper
+from playwright._impl._waiter import Waiter
 
 if sys.version_info >= (3, 8):  # pragma: no cover
     from typing import Literal
@@ -139,18 +139,18 @@ async def goto(
             ),
         )
 
-    def _setup_navigation_wait_helper(
-        self, wait_name: str, timeout: float = None
-    ) -> WaitHelper:
+    def _setup_navigation_waiter(self, wait_name: str, timeout: float = None) -> Waiter:
         assert self._page
-        wait_helper = WaitHelper(self._page, f"frame.{wait_name}")
-        wait_helper.reject_on_event(
-            self._page, "close", Error("Navigation failed because page was closed!")
+        waiter = Waiter(self._page, f"frame.{wait_name}")
+        waiter.reject_on_event(
+            self._page,
+            "close",
+            lambda: cast(Page, self._page)._close_error_with_reason(),
         )
-        wait_helper.reject_on_event(
+        waiter.reject_on_event(
             self._page, "crash", Error("Navigation failed because page crashed!")
         )
-        wait_helper.reject_on_event(
+        waiter.reject_on_event(
             self._page,
             "framedetached",
             Error("Navigating frame was detached!"),
@@ -158,8 +158,8 @@ def _setup_navigation_wait_helper(
         )
         if timeout is None:
             timeout = self._page._timeout_settings.navigation_timeout()
-        wait_helper.reject_on_timeout(timeout, f"Timeout {timeout}ms exceeded.")
-        return wait_helper
+        waiter.reject_on_timeout(timeout, f"Timeout {timeout}ms exceeded.")
+        return waiter
 
     def expect_navigation(
         self,
@@ -174,10 +174,10 @@ def expect_navigation(
         if timeout is None:
             timeout = self._page._timeout_settings.navigation_timeout()
         deadline = monotonic_time() + timeout
-        wait_helper = self._setup_navigation_wait_helper("expect_navigation", timeout)
+        waiter = self._setup_navigation_waiter("expect_navigation", timeout)
 
         to_url = f' to "{url}"' if url else ""
-        wait_helper.log(f"waiting for navigation{to_url} until '{wait_until}'")
+        waiter.log(f"waiting for navigation{to_url} until '{wait_until}'")
         matcher = (
             URLMatcher(self._page._browser_context._options.get("baseURL"), url)
             if url
@@ -188,17 +188,17 @@ def predicate(event: Any) -> bool:
             # Any failed navigation results in a rejection.
             if event.get("error"):
                 return True
-            wait_helper.log(f'  navigated to "{event["url"]}"')
+            waiter.log(f'  navigated to "{event["url"]}"')
             return not matcher or matcher.matches(event["url"])
 
-        wait_helper.wait_for_event(
+        waiter.wait_for_event(
             self._event_emitter,
             "navigated",
             predicate=predicate,
         )
 
         async def continuation() -> Optional[Response]:
-            event = await wait_helper.result()
+            event = await waiter.result()
             if "error" in event:
                 raise Error(event["error"])
             if wait_until not in self._load_states:
@@ -244,24 +244,24 @@ async def _wait_for_load_state_impl(
             raise Error(
                 "state: expected one of (load|domcontentloaded|networkidle|commit)"
             )
-        wait_helper = self._setup_navigation_wait_helper("wait_for_load_state", timeout)
+        waiter = self._setup_navigation_waiter("wait_for_load_state", timeout)
 
         if state in self._load_states:
-            wait_helper.log(f'  not waiting, "{state}" event already fired')
+            waiter.log(f'  not waiting, "{state}" event already fired')
             # TODO: align with upstream
-            wait_helper._fulfill(None)
+            waiter._fulfill(None)
         else:
 
             def handle_load_state_event(actual_state: str) -> bool:
-                wait_helper.log(f'"{actual_state}" event fired')
+                waiter.log(f'"{actual_state}" event fired')
                 return actual_state == state
 
-            wait_helper.wait_for_event(
+            waiter.wait_for_event(
                 self._event_emitter,
                 "loadstate",
                 handle_load_state_event,
             )
-        await wait_helper.result()
+        await waiter.result()
 
     async def frame_element(self) -> ElementHandle:
         return from_channel(await self._channel.send("frameElement"))
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 5f8031127..1b4902613 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -40,7 +40,7 @@
 from greenlet import greenlet
 
 from playwright._impl._api_structures import NameValue
-from playwright._impl._api_types import Error, TimeoutError
+from playwright._impl._errors import Error, TargetClosedError, TimeoutError
 from playwright._impl._str_utils import escape_regex_flags
 
 if sys.version_info >= (3, 8):  # pragma: no cover
@@ -221,6 +221,8 @@ def parse_error(error: ErrorPayload) -> Error:
     base_error_class = Error
     if error.get("name") == "TimeoutError":
         base_error_class = TimeoutError
+    if error.get("name") == "TargetClosedError":
+        base_error_class = TargetClosedError
     exc = base_error_class(cast(str, patch_error_message(error.get("message"))))
     exc._name = error["name"]
     exc._stack = error["stack"]
@@ -322,17 +324,6 @@ def prepare_interception_patterns(
         return patterns
 
 
-BROWSER_CLOSED_ERROR = "Browser has been closed"
-BROWSER_OR_CONTEXT_CLOSED_ERROR = "Target page, context or browser has been closed"
-
-
-def is_safe_close_error(error: Exception) -> bool:
-    message = str(error)
-    return message.endswith(BROWSER_CLOSED_ERROR) or message.endswith(
-        BROWSER_OR_CONTEXT_CLOSED_ERROR
-    )
-
-
 to_snake_case_regex = re.compile("((?<=[a-z0-9])[A-Z]|(?!^)[A-Z](?=[a-z]))")
 
 
diff --git a/playwright/_impl/_impl_to_api_mapping.py b/playwright/_impl/_impl_to_api_mapping.py
index 332d9a4d9..60a748fdc 100644
--- a/playwright/_impl/_impl_to_api_mapping.py
+++ b/playwright/_impl/_impl_to_api_mapping.py
@@ -15,7 +15,7 @@
 import inspect
 from typing import Any, Callable, Dict, List, Optional, Union
 
-from playwright._impl._api_types import Error
+from playwright._impl._errors import Error
 from playwright._impl._map import Map
 
 API_ATTR = "_pw_api_instance_"
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 35234d286..9eba30e0d 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -49,16 +49,16 @@
     ResourceTiming,
     SecurityDetails,
 )
-from playwright._impl._api_types import Error
 from playwright._impl._connection import (
     ChannelOwner,
     filter_none,
     from_channel,
     from_nullable_channel,
 )
+from playwright._impl._errors import Error
 from playwright._impl._event_context_manager import EventContextManagerImpl
 from playwright._impl._helper import locals_to_params
-from playwright._impl._wait_helper import WaitHelper
+from playwright._impl._waiter import Waiter
 
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._browser_context import BrowserContext
@@ -641,22 +641,20 @@ def expect_event(
     ) -> EventContextManagerImpl:
         if timeout is None:
             timeout = cast(Any, self._parent)._timeout_settings.timeout()
-        wait_helper = WaitHelper(self, f"web_socket.expect_event({event})")
-        wait_helper.reject_on_timeout(
+        waiter = Waiter(self, f"web_socket.expect_event({event})")
+        waiter.reject_on_timeout(
             cast(float, timeout),
             f'Timeout {timeout}ms exceeded while waiting for event "{event}"',
         )
         if event != WebSocket.Events.Close:
-            wait_helper.reject_on_event(
-                self, WebSocket.Events.Close, Error("Socket closed")
-            )
+            waiter.reject_on_event(self, WebSocket.Events.Close, Error("Socket closed"))
         if event != WebSocket.Events.Error:
-            wait_helper.reject_on_event(
-                self, WebSocket.Events.Error, Error("Socket error")
-            )
-        wait_helper.reject_on_event(self._page, "close", Error("Page closed"))
-        wait_helper.wait_for_event(self, event, predicate)
-        return EventContextManagerImpl(wait_helper.result())
+            waiter.reject_on_event(self, WebSocket.Events.Error, Error("Socket error"))
+        waiter.reject_on_event(
+            self._page, "close", lambda: self._page._close_error_with_reason()
+        )
+        waiter.wait_for_event(self, event, predicate)
+        return EventContextManagerImpl(waiter.result())
 
     async def wait_for_event(
         self, event: str, predicate: Callable = None, timeout: float = None
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 99944be41..8c9f4557a 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -40,7 +40,6 @@
     Position,
     ViewportSize,
 )
-from playwright._impl._api_types import Error
 from playwright._impl._artifact import Artifact
 from playwright._impl._connection import (
     ChannelOwner,
@@ -50,6 +49,7 @@
 from playwright._impl._console_message import ConsoleMessage
 from playwright._impl._download import Download
 from playwright._impl._element_handle import ElementHandle
+from playwright._impl._errors import Error, TargetClosedError, is_target_closed_error
 from playwright._impl._event_context_manager import EventContextManagerImpl
 from playwright._impl._file_chooser import FileChooser
 from playwright._impl._frame import Frame
@@ -72,7 +72,6 @@
     URLMatchResponse,
     async_readfile,
     async_writefile,
-    is_safe_close_error,
     locals_to_params,
     make_dirs_for_file,
     serialize_error,
@@ -86,7 +85,7 @@
 )
 from playwright._impl._network import Request, Response, Route, serialize_headers
 from playwright._impl._video import Video
-from playwright._impl._wait_helper import WaitHelper
+from playwright._impl._waiter import Waiter
 
 if sys.version_info >= (3, 8):  # pragma: no cover
     from typing import Literal
@@ -151,6 +150,7 @@ def __init__(
         )
         self._video: Optional[Video] = None
         self._opener = cast("Page", from_nullable_channel(initializer.get("opener")))
+        self._close_reason: Optional[str] = None
 
         self._channel.on(
             "bindingCall",
@@ -195,13 +195,15 @@ def __init__(
         self._closed_or_crashed_future: asyncio.Future = asyncio.Future()
         self.on(
             Page.Events.Close,
-            lambda _: self._closed_or_crashed_future.set_result(True)
+            lambda _: self._closed_or_crashed_future.set_result(
+                self._close_error_with_reason()
+            )
             if not self._closed_or_crashed_future.done()
             else None,
         )
         self.on(
             Page.Events.Crash,
-            lambda _: self._closed_or_crashed_future.set_result(True)
+            lambda _: self._closed_or_crashed_future.set_result(TargetClosedError())
             if not self._closed_or_crashed_future.done()
             else None,
         )
@@ -662,13 +664,14 @@ async def screenshot(
     async def title(self) -> str:
         return await self._main_frame.title()
 
-    async def close(self, runBeforeUnload: bool = None) -> None:
+    async def close(self, runBeforeUnload: bool = None, reason: str = None) -> None:
+        self._close_reason = reason
         try:
             await self._channel.send("close", locals_to_params(locals()))
             if self._owned_context:
                 await self._owned_context.close()
         except Exception as e:
-            if not is_safe_close_error(e) and not runBeforeUnload:
+            if not is_target_closed_error(e) and not runBeforeUnload:
                 raise e
 
     def is_closed(self) -> bool:
@@ -1006,6 +1009,11 @@ def video(
             self._video = Video(self)
         return self._video
 
+    def _close_error_with_reason(self) -> TargetClosedError:
+        return TargetClosedError(
+            self._close_reason or self._browser_context._effective_close_reason()
+        )
+
     def expect_event(
         self,
         event: str,
@@ -1025,18 +1033,20 @@ def _expect_event(
     ) -> EventContextManagerImpl:
         if timeout is None:
             timeout = self._timeout_settings.timeout()
-        wait_helper = WaitHelper(self, f"page.expect_event({event})")
-        wait_helper.reject_on_timeout(
+        waiter = Waiter(self, f"page.expect_event({event})")
+        waiter.reject_on_timeout(
             timeout, f'Timeout {timeout}ms exceeded while waiting for event "{event}"'
         )
         if log_line:
-            wait_helper.log(log_line)
+            waiter.log(log_line)
         if event != Page.Events.Crash:
-            wait_helper.reject_on_event(self, Page.Events.Crash, Error("Page crashed"))
+            waiter.reject_on_event(self, Page.Events.Crash, Error("Page crashed"))
         if event != Page.Events.Close:
-            wait_helper.reject_on_event(self, Page.Events.Close, Error("Page closed"))
-        wait_helper.wait_for_event(self, event, predicate)
-        return EventContextManagerImpl(wait_helper.result())
+            waiter.reject_on_event(
+                self, Page.Events.Close, lambda: self._close_error_with_reason()
+            )
+        waiter.wait_for_event(self, event, predicate)
+        return EventContextManagerImpl(waiter.result())
 
     def expect_console_message(
         self,
diff --git a/playwright/_impl/_selectors.py b/playwright/_impl/_selectors.py
index 409b0921d..729e17254 100644
--- a/playwright/_impl/_selectors.py
+++ b/playwright/_impl/_selectors.py
@@ -16,8 +16,8 @@
 from pathlib import Path
 from typing import Any, Dict, List, Set, Union
 
-from playwright._impl._api_types import Error
 from playwright._impl._connection import ChannelOwner
+from playwright._impl._errors import Error
 from playwright._impl._helper import async_readfile
 from playwright._impl._locator import set_test_id_attribute_name, test_id_attribute_name
 
diff --git a/playwright/_impl/_wait_helper.py b/playwright/_impl/_waiter.py
similarity index 95%
rename from playwright/_impl/_wait_helper.py
rename to playwright/_impl/_waiter.py
index 783ac3689..7b0ad2cc6 100644
--- a/playwright/_impl/_wait_helper.py
+++ b/playwright/_impl/_waiter.py
@@ -16,15 +16,15 @@
 import math
 import uuid
 from asyncio.tasks import Task
-from typing import Any, Callable, List, Tuple
+from typing import Any, Callable, List, Tuple, Union
 
 from pyee import EventEmitter
 
-from playwright._impl._api_types import Error, TimeoutError
 from playwright._impl._connection import ChannelOwner
+from playwright._impl._errors import Error, TimeoutError
 
 
-class WaitHelper:
+class Waiter:
     def __init__(self, channel_owner: ChannelOwner, event: str) -> None:
         self._result: asyncio.Future = asyncio.Future()
         self._wait_id = uuid.uuid4().hex
@@ -66,12 +66,12 @@ def reject_on_event(
         self,
         emitter: EventEmitter,
         event: str,
-        error: Error,
+        error: Union[Error, Callable[..., Error]],
         predicate: Callable = None,
     ) -> None:
         def listener(event_data: Any = None) -> None:
             if not predicate or predicate(event_data):
-                self._reject(error)
+                self._reject(error() if callable(error) else error)
 
         emitter.on(event, listener)
         self._registered_listeners.append((emitter, event, listener))
diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index e63e27b8d..554e83927 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.py
@@ -21,7 +21,7 @@
 from typing import Any, Optional, Union, overload
 
 import playwright._impl._api_structures
-import playwright._impl._api_types
+import playwright._impl._errors
 import playwright.async_api._generated
 from playwright._impl._assertions import (
     APIResponseAssertions as APIResponseAssertionsImpl,
@@ -79,8 +79,8 @@
 StorageState = playwright._impl._api_structures.StorageState
 ViewportSize = playwright._impl._api_structures.ViewportSize
 
-Error = playwright._impl._api_types.Error
-TimeoutError = playwright._impl._api_types.TimeoutError
+Error = playwright._impl._errors.Error
+TimeoutError = playwright._impl._errors.TimeoutError
 
 
 def async_playwright() -> PlaywrightContextManager:
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 0b08eb102..426c24822 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -42,7 +42,6 @@
     StorageState,
     ViewportSize,
 )
-from playwright._impl._api_types import Error
 from playwright._impl._assertions import (
     APIResponseAssertions as APIResponseAssertionsImpl,
 )
@@ -62,6 +61,7 @@
 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
+from playwright._impl._errors import Error
 from playwright._impl._fetch import APIRequest as APIRequestImpl
 from playwright._impl._fetch import APIRequestContext as APIRequestContextImpl
 from playwright._impl._fetch import APIResponse as APIResponseImpl
@@ -7241,7 +7241,7 @@ async def failure(self) -> typing.Optional[str]:
 
         return mapping.from_maybe_impl(await self._impl_obj.failure())
 
-    async def path(self) -> typing.Optional[pathlib.Path]:
+    async def path(self) -> pathlib.Path:
         """Download.path
 
         Returns path to the downloaded file in case of successful download. The method will wait for the download to finish
@@ -7252,7 +7252,7 @@ async def path(self) -> typing.Optional[pathlib.Path]:
 
         Returns
         -------
-        Union[pathlib.Path, None]
+        pathlib.Path
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.path())
@@ -9999,7 +9999,12 @@ async def title(self) -> str:
 
         return mapping.from_maybe_impl(await self._impl_obj.title())
 
-    async def close(self, *, run_before_unload: typing.Optional[bool] = None) -> None:
+    async def close(
+        self,
+        *,
+        run_before_unload: typing.Optional[bool] = None,
+        reason: typing.Optional[str] = None
+    ) -> None:
         """Page.close
 
         If `runBeforeUnload` is `false`, does not run any unload handlers and waits for the page to be closed. If
@@ -10015,10 +10020,12 @@ async def close(self, *, run_before_unload: typing.Optional[bool] = None) -> Non
         run_before_unload : Union[bool, None]
             Defaults to `false`. Whether to run the
             [before unload](https://developer.mozilla.org/en-US/docs/Web/Events/beforeunload) page handlers.
+        reason : Union[str, None]
+            The reason to be reported to the operations interrupted by the page closure.
         """
 
         return mapping.from_maybe_impl(
-            await self._impl_obj.close(runBeforeUnload=run_before_unload)
+            await self._impl_obj.close(runBeforeUnload=run_before_unload, reason=reason)
         )
 
     def is_closed(self) -> bool:
@@ -13726,15 +13733,20 @@ def expect_event(
             ).future
         )
 
-    async def close(self) -> None:
+    async def close(self, *, reason: typing.Optional[str] = None) -> None:
         """BrowserContext.close
 
         Closes the browser context. All the pages that belong to the browser context will be closed.
 
         **NOTE** The default browser context cannot be closed.
+
+        Parameters
+        ----------
+        reason : Union[str, None]
+            The reason to be reported to the operations interrupted by the context closure.
         """
 
-        return mapping.from_maybe_impl(await self._impl_obj.close())
+        return mapping.from_maybe_impl(await self._impl_obj.close(reason=reason))
 
     async def storage_state(
         self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
@@ -14462,7 +14474,7 @@ async def new_page(
             )
         )
 
-    async def close(self) -> None:
+    async def close(self, *, reason: typing.Optional[str] = None) -> None:
         """Browser.close
 
         In case this browser is obtained using `browser_type.launch()`, closes the browser and all of its pages (if
@@ -14476,9 +14488,14 @@ async def close(self) -> None:
         `browser.close()`.
 
         The `Browser` object itself is considered to be disposed and cannot be used anymore.
+
+        Parameters
+        ----------
+        reason : Union[str, None]
+            The reason to be reported to the operations interrupted by the browser closure.
         """
 
-        return mapping.from_maybe_impl(await self._impl_obj.close())
+        return mapping.from_maybe_impl(await self._impl_obj.close(reason=reason))
 
     async def new_browser_cdp_session(self) -> "CDPSession":
         """Browser.new_browser_cdp_session
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index 8553aaf2f..e17c0e305 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -21,7 +21,7 @@
 from typing import Any, Optional, Union, overload
 
 import playwright._impl._api_structures
-import playwright._impl._api_types
+import playwright._impl._errors
 import playwright.sync_api._generated
 from playwright._impl._assertions import (
     APIResponseAssertions as APIResponseAssertionsImpl,
@@ -79,8 +79,8 @@
 StorageState = playwright._impl._api_structures.StorageState
 ViewportSize = playwright._impl._api_structures.ViewportSize
 
-Error = playwright._impl._api_types.Error
-TimeoutError = playwright._impl._api_types.TimeoutError
+Error = playwright._impl._errors.Error
+TimeoutError = playwright._impl._errors.TimeoutError
 
 
 def sync_playwright() -> PlaywrightContextManager:
diff --git a/playwright/sync_api/_context_manager.py b/playwright/sync_api/_context_manager.py
index 9813f8920..3efc01e91 100644
--- a/playwright/sync_api/_context_manager.py
+++ b/playwright/sync_api/_context_manager.py
@@ -17,9 +17,9 @@
 
 from greenlet import greenlet
 
-from playwright._impl._api_types import Error
 from playwright._impl._connection import ChannelOwner, Connection
 from playwright._impl._driver import compute_driver_executable
+from playwright._impl._errors import Error
 from playwright._impl._object_factory import create_remote_object
 from playwright._impl._playwright import Playwright
 from playwright._impl._transport import PipeTransport
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index ce7df8109..182d31874 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -42,7 +42,6 @@
     StorageState,
     ViewportSize,
 )
-from playwright._impl._api_types import Error
 from playwright._impl._assertions import (
     APIResponseAssertions as APIResponseAssertionsImpl,
 )
@@ -56,6 +55,7 @@
 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
+from playwright._impl._errors import Error
 from playwright._impl._fetch import APIRequest as APIRequestImpl
 from playwright._impl._fetch import APIRequestContext as APIRequestContextImpl
 from playwright._impl._fetch import APIResponse as APIResponseImpl
@@ -7361,7 +7361,7 @@ def failure(self) -> typing.Optional[str]:
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.failure()))
 
-    def path(self) -> typing.Optional[pathlib.Path]:
+    def path(self) -> pathlib.Path:
         """Download.path
 
         Returns path to the downloaded file in case of successful download. The method will wait for the download to finish
@@ -7372,7 +7372,7 @@ def path(self) -> typing.Optional[pathlib.Path]:
 
         Returns
         -------
-        Union[pathlib.Path, None]
+        pathlib.Path
         """
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.path()))
@@ -10069,7 +10069,12 @@ def title(self) -> str:
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.title()))
 
-    def close(self, *, run_before_unload: typing.Optional[bool] = None) -> None:
+    def close(
+        self,
+        *,
+        run_before_unload: typing.Optional[bool] = None,
+        reason: typing.Optional[str] = None
+    ) -> None:
         """Page.close
 
         If `runBeforeUnload` is `false`, does not run any unload handlers and waits for the page to be closed. If
@@ -10085,10 +10090,14 @@ def close(self, *, run_before_unload: typing.Optional[bool] = None) -> None:
         run_before_unload : Union[bool, None]
             Defaults to `false`. Whether to run the
             [before unload](https://developer.mozilla.org/en-US/docs/Web/Events/beforeunload) page handlers.
+        reason : Union[str, None]
+            The reason to be reported to the operations interrupted by the page closure.
         """
 
         return mapping.from_maybe_impl(
-            self._sync(self._impl_obj.close(runBeforeUnload=run_before_unload))
+            self._sync(
+                self._impl_obj.close(runBeforeUnload=run_before_unload, reason=reason)
+            )
         )
 
     def is_closed(self) -> bool:
@@ -13784,15 +13793,20 @@ def expect_event(
             ).future,
         )
 
-    def close(self) -> None:
+    def close(self, *, reason: typing.Optional[str] = None) -> None:
         """BrowserContext.close
 
         Closes the browser context. All the pages that belong to the browser context will be closed.
 
         **NOTE** The default browser context cannot be closed.
+
+        Parameters
+        ----------
+        reason : Union[str, None]
+            The reason to be reported to the operations interrupted by the context closure.
         """
 
-        return mapping.from_maybe_impl(self._sync(self._impl_obj.close()))
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.close(reason=reason)))
 
     def storage_state(
         self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
@@ -14524,7 +14538,7 @@ def new_page(
             )
         )
 
-    def close(self) -> None:
+    def close(self, *, reason: typing.Optional[str] = None) -> None:
         """Browser.close
 
         In case this browser is obtained using `browser_type.launch()`, closes the browser and all of its pages (if
@@ -14538,9 +14552,14 @@ def close(self) -> None:
         `browser.close()`.
 
         The `Browser` object itself is considered to be disposed and cannot be used anymore.
+
+        Parameters
+        ----------
+        reason : Union[str, None]
+            The reason to be reported to the operations interrupted by the browser closure.
         """
 
-        return mapping.from_maybe_impl(self._sync(self._impl_obj.close()))
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.close(reason=reason)))
 
     def new_browser_cdp_session(self) -> "CDPSession":
         """Browser.new_browser_cdp_session
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index f625143ea..506d522fb 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -323,7 +323,7 @@ def serialize_python_type(self, value: Any) -> str:
         str_value = str(value)
         if isinstance(value, list):
             return f"[{', '.join(list(map(lambda a: self.serialize_python_type(a), value)))}]"
-        if str_value == "<class 'playwright._impl._api_types.Error'>":
+        if str_value == "<class 'playwright._impl._errors.Error'>":
             return "Error"
         if str_value == "<class 'NoneType'>":
             return "None"
@@ -337,11 +337,7 @@ def serialize_python_type(self, value: Any) -> str:
         if match:
             return "EventContextManager[" + match.group(1) + "]"
         match = re.match(r"^<class 'playwright\._impl\.[\w_]+\.([^']+)'>$", str_value)
-        if (
-            match
-            and "_api_structures" not in str_value
-            and "_api_types" not in str_value
-        ):
+        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)
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index da5cc8ed2..3045c1e61 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -246,7 +246,7 @@ def return_value(value: Any) -> List[str]:
 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
-from playwright._impl._api_types import Error
+from playwright._impl._errors import Error
 from playwright._impl._fetch import APIRequest as APIRequestImpl, APIResponse as APIResponseImpl, APIRequestContext as APIRequestContextImpl
 from playwright._impl._assertions import PageAssertions as PageAssertionsImpl, LocatorAssertions as LocatorAssertionsImpl, APIResponseAssertions as APIResponseAssertionsImpl
 """
diff --git a/setup.py b/setup.py
index e7a40794f..4ae0a85e5 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.39.0"
+driver_version = "1.40.0-alpha-oct-18-2023"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_asyncio.py b/tests/async/test_asyncio.py
index f82081276..f1def84d3 100644
--- a/tests/async/test_asyncio.py
+++ b/tests/async/test_asyncio.py
@@ -18,8 +18,8 @@
 import pytest
 
 from playwright.async_api import Page, async_playwright
-
-from ..server import Server
+from tests.server import Server
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
 async def test_should_cancel_underlying_protocol_calls(
@@ -66,7 +66,7 @@ async def test_cancel_pending_protocol_call_on_playwright_stop(server: Server) -
     await playwright.stop()
     with pytest.raises(Exception) as exc_info:
         await pending_task
-    assert "Connection closed" in str(exc_info.value)
+    assert TARGET_CLOSED_ERROR_MESSAGE in str(exc_info.value)
 
 
 async def test_should_collect_stale_handles(page: Page, server: Server) -> None:
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index ec3b7e230..59670340a 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -20,6 +20,7 @@
 
 from playwright.async_api import Browser, Error
 from tests.server import Server
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
 async def test_page_event_should_create_new_context(browser):
@@ -133,7 +134,7 @@ async def test_close_should_abort_wait_for_event(browser):
     with pytest.raises(Error) as exc_info:
         async with context.expect_page():
             await context.close()
-    assert "Context closed" in exc_info.value.message
+    assert TARGET_CLOSED_ERROR_MESSAGE in exc_info.value.message
 
 
 async def test_close_should_be_callable_twice(browser):
diff --git a/tests/async/test_cdp_session.py b/tests/async/test_cdp_session.py
index 43a7900b8..af8f0715d 100644
--- a/tests/async/test_cdp_session.py
+++ b/tests/async/test_cdp_session.py
@@ -15,6 +15,7 @@
 import pytest
 
 from playwright.async_api import Browser, Error
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
 @pytest.mark.only_browser("chromium")
@@ -56,7 +57,7 @@ async def test_should_be_able_to_detach_session(page):
         await client.send(
             "Runtime.evaluate", {"expression": "3 + 1", "returnByValue": True}
         )
-    assert "Target page, context or browser has been closed" in exc_info.value.message
+    assert TARGET_CLOSED_ERROR_MESSAGE in exc_info.value.message
 
 
 @pytest.mark.only_browser("chromium")
diff --git a/tests/async/test_defaultbrowsercontext.py b/tests/async/test_defaultbrowsercontext.py
index 07c183a27..ea4b77eb7 100644
--- a/tests/async/test_defaultbrowsercontext.py
+++ b/tests/async/test_defaultbrowsercontext.py
@@ -17,8 +17,7 @@
 
 import pytest
 
-from playwright._impl._api_types import Error
-from playwright.async_api import expect
+from playwright.async_api import Error, expect
 
 
 @pytest.fixture()
diff --git a/tests/async/test_download.py b/tests/async/test_download.py
index 29d1f766d..a0f9f1ab5 100644
--- a/tests/async/test_download.py
+++ b/tests/async/test_download.py
@@ -19,6 +19,7 @@
 import pytest
 
 from playwright.async_api import Browser, Error, Page
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
 def assert_file_content(path, content):
@@ -185,7 +186,7 @@ async def test_should_error_when_saving_after_deletion(tmpdir, browser, server):
     await download.delete()
     with pytest.raises(Error) as exc:
         await download.save_as(user_path)
-    assert "Target page, context or browser has been closed" in exc.value.message
+    assert TARGET_CLOSED_ERROR_MESSAGE in exc.value.message
     await page.close()
 
 
diff --git a/tests/async/test_fetch_browser_context.py b/tests/async/test_fetch_browser_context.py
index 6022f55c3..fbd3130f3 100644
--- a/tests/async/test_fetch_browser_context.py
+++ b/tests/async/test_fetch_browser_context.py
@@ -165,12 +165,8 @@ async def support_post_data(fetch_data, request_post_data):
 
     await support_post_data("My request", "My request".encode())
     await support_post_data(b"My request", "My request".encode())
-    await support_post_data(
-        ["my", "request"], json.dumps(["my", "request"], separators=(",", ":")).encode()
-    )
-    await support_post_data(
-        {"my": "request"}, json.dumps({"my": "request"}, separators=(",", ":")).encode()
-    )
+    await support_post_data(["my", "request"], json.dumps(["my", "request"]).encode())
+    await support_post_data({"my": "request"}, json.dumps({"my": "request"}).encode())
     with pytest.raises(Error, match="Unsupported 'data' type: <class 'function'>"):
         await support_post_data(lambda: None, None)
 
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index d5eec7d9d..430547df8 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -300,7 +300,7 @@ async def test_should_json_stringify_body_when_content_type_is_application_json(
         ),
     )
     body = req.post_body
-    assert body.decode() == json.dumps(serialization, separators=(",", ":"))
+    assert body.decode() == json.dumps(serialization)
     await request.dispose()
 
 
@@ -309,7 +309,7 @@ async def test_should_not_double_stringify_body_when_content_type_is_application
     playwright: Playwright, server: Server, serialization: Any
 ):
     request = await playwright.request.new_context()
-    stringified_value = json.dumps(serialization, separators=(",", ":"))
+    stringified_value = json.dumps(serialization)
     [req, _] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
         request.post(
@@ -328,7 +328,7 @@ async def test_should_accept_already_serialized_data_as_bytes_when_content_type_
     playwright: Playwright, server: Server
 ):
     request = await playwright.request.new_context()
-    stringified_value = json.dumps({"foo": "bar"}, separators=(",", ":")).encode()
+    stringified_value = json.dumps({"foo": "bar"}).encode()
     [req, _] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
         request.post(
@@ -410,5 +410,5 @@ async def test_should_serialize_null_values_in_json(
     server.set_route("/echo", lambda req: (req.write(req.post_body), req.finish()))
     response = await request.post(server.PREFIX + "/echo", data={"foo": None})
     assert response.status == 200
-    assert await response.text() == '{"foo":null}'
+    assert await response.text() == '{"foo": null}'
     await request.dispose()
diff --git a/tests/async/test_keyboard.py b/tests/async/test_keyboard.py
index 6aee344eb..761fe977c 100644
--- a/tests/async/test_keyboard.py
+++ b/tests/async/test_keyboard.py
@@ -13,8 +13,7 @@
 # limitations under the License.
 import pytest
 
-from playwright._impl._api_types import Error
-from playwright.async_api import Page
+from playwright.async_api import Error, Page
 
 
 async def captureLastKeydown(page):
diff --git a/tests/async/test_launcher.py b/tests/async/test_launcher.py
index a3c0b5721..a1f3f1480 100644
--- a/tests/async/test_launcher.py
+++ b/tests/async/test_launcher.py
@@ -18,6 +18,7 @@
 import pytest
 
 from playwright.async_api import BrowserType, Error
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
 async def test_browser_type_launch_should_reject_all_promises_when_browser_is_closed(
@@ -29,10 +30,7 @@ async def test_browser_type_launch_should_reject_all_promises_when_browser_is_cl
     await page.close()
     with pytest.raises(Error) as exc:
         await never_resolves
-    assert (
-        "Target closed" in exc.value.message
-        or "Target page, context or browser has been closed" in exc.value.message
-    )
+    assert TARGET_CLOSED_ERROR_MESSAGE in exc.value.message
 
 
 @pytest.mark.skip_browser("firefox")
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index b983b631e..117c8009a 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -20,6 +20,7 @@
 
 from playwright.async_api import BrowserContext, Error, Page, Route, TimeoutError
 from tests.server import Server
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
 async def test_close_should_reject_all_promises(context):
@@ -28,7 +29,7 @@ async def test_close_should_reject_all_promises(context):
         await asyncio.gather(
             new_page.evaluate("() => new Promise(r => {})"), new_page.close()
         )
-    assert "Target closed" in exc_info.value.message
+    assert " closed" in exc_info.value.message
 
 
 async def test_closed_should_not_visible_in_context_pages(context):
@@ -112,7 +113,7 @@ async def wait_for_response():
     )
     for i in range(2):
         error = results[i]
-        assert "Page closed" in error.message
+        assert TARGET_CLOSED_ERROR_MESSAGE in error.message
         assert "Timeout" not in error.message
 
 
@@ -269,7 +270,7 @@ async def test_wait_for_event_should_fail_with_error_upon_disconnect(page):
     with pytest.raises(Error) as exc_info:
         async with page.expect_download():
             await page.close()
-    assert "Page closed" in exc_info.value.message
+    assert TARGET_CLOSED_ERROR_MESSAGE in exc_info.value.message
 
 
 async def test_wait_for_response_should_work(page, server):
diff --git a/tests/async/test_page_request_intercept.py b/tests/async/test_page_request_intercept.py
index 2491645c6..39b07d4bc 100644
--- a/tests/async/test_page_request_intercept.py
+++ b/tests/async/test_page_request_intercept.py
@@ -78,7 +78,7 @@ async def handle(route: Route):
     await page.route("**/*.html", lambda route: handle(route))
     await page.goto(server.PREFIX + "/empty.html")
     request = await request_promise
-    assert request.post_body.decode("utf-8") == '{"foo":"bar"}'
+    assert request.post_body.decode("utf-8") == '{"foo": "bar"}'
 
 
 async def test_should_fulfill_popup_main_request_using_alias(
diff --git a/tests/async/test_worker.py b/tests/async/test_worker.py
index 08d6bd0cc..8b2e56f3f 100644
--- a/tests/async/test_worker.py
+++ b/tests/async/test_worker.py
@@ -19,6 +19,7 @@
 from flaky import flaky
 
 from playwright.async_api import Error, Page, Worker
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
 async def test_workers_page_workers(page: Page, server):
@@ -51,9 +52,7 @@ async def test_workers_should_emit_created_and_destroyed_events(page: Page):
     assert await worker_destroyed_promise == worker
     with pytest.raises(Error) as exc:
         await worker_this_obj.get_property("self")
-    assert (
-        "Worker was closed" in exc.value.message or "Target closed" in exc.value.message
-    )
+    assert TARGET_CLOSED_ERROR_MESSAGE in exc.value.message
 
 
 async def test_workers_should_report_console_logs(page):
diff --git a/tests/sync/test_cdp_session.py b/tests/sync/test_cdp_session.py
index c07dcb85f..ad4e1f8f2 100644
--- a/tests/sync/test_cdp_session.py
+++ b/tests/sync/test_cdp_session.py
@@ -16,6 +16,7 @@
 
 from playwright.sync_api import Browser, Error, Page
 from tests.server import Server
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
 @pytest.mark.only_browser("chromium")
@@ -55,7 +56,7 @@ def test_should_be_able_to_detach_session(page: Page) -> None:
     client.detach()
     with pytest.raises(Error) as exc_info:
         client.send("Runtime.evaluate", {"expression": "3 + 1", "returnByValue": True})
-    assert "Target page, context or browser has been closed" in exc_info.value.message
+    assert TARGET_CLOSED_ERROR_MESSAGE in exc_info.value.message
 
 
 @pytest.mark.only_browser("chromium")
diff --git a/tests/sync/test_fetch_browser_context.py b/tests/sync/test_fetch_browser_context.py
index 6f8276f7e..edb00993b 100644
--- a/tests/sync/test_fetch_browser_context.py
+++ b/tests/sync/test_fetch_browser_context.py
@@ -159,12 +159,8 @@ def support_post_data(fetch_data: Any, request_post_data: Any) -> None:
 
     support_post_data("My request", "My request".encode())
     support_post_data(b"My request", "My request".encode())
-    support_post_data(
-        ["my", "request"], json.dumps(["my", "request"], separators=(",", ":")).encode()
-    )
-    support_post_data(
-        {"my": "request"}, json.dumps({"my": "request"}, separators=(",", ":")).encode()
-    )
+    support_post_data(["my", "request"], json.dumps(["my", "request"]).encode())
+    support_post_data({"my": "request"}, json.dumps({"my": "request"}).encode())
     with pytest.raises(Error, match="Unsupported 'data' type: <class 'function'>"):
         support_post_data(lambda: None, None)
 
diff --git a/tests/sync/test_fetch_global.py b/tests/sync/test_fetch_global.py
index 300465aec..5c25d4059 100644
--- a/tests/sync/test_fetch_global.py
+++ b/tests/sync/test_fetch_global.py
@@ -321,5 +321,5 @@ def test_should_serialize_null_values_in_json(
     server.set_route("/echo", lambda req: (req.write(req.post_body), req.finish()))
     response = request.post(server.PREFIX + "/echo", data={"foo": None})
     assert response.status == 200
-    assert response.text() == '{"foo":null}'
+    assert response.text() == '{"foo": null}'
     request.dispose()
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index e2606dc8d..3f27a4140 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -28,6 +28,7 @@
     sync_playwright,
 )
 from tests.server import Server
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
 def test_sync_query_selector(page: Page) -> None:
@@ -272,7 +273,7 @@ def test_close_should_reject_all_promises(context: BrowserContext) -> None:
             lambda: new_page.evaluate("() => new Promise(r => {})"),
             lambda: new_page.close(),
         )
-    assert "Target closed" in exc_info.value.message
+    assert TARGET_CLOSED_ERROR_MESSAGE in exc_info.value.message
 
 
 def test_expect_response_should_work(page: Page, server: Server) -> None:
diff --git a/tests/utils.py b/tests/utils.py
index 287900faa..96886a305 100644
--- a/tests/utils.py
+++ b/tests/utils.py
@@ -55,3 +55,6 @@ def get_trace_actions(events: List[Any]) -> List[str]:
         key=lambda e: e["startTime"],
     )
     return [e["apiName"] for e in action_events]
+
+
+TARGET_CLOSED_ERROR_MESSAGE = "Target page, context or browser has been closed"

From d332719cbcbd07581899f8c7ab7386748c837491 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 21 Nov 2023 18:17:57 +0100
Subject: [PATCH 118/438] chore(roll): roll Playwright to 1.40.0 (#2170)

---
 README.md                                    |   4 +-
 playwright/_impl/_assertions.py              |   5 +-
 playwright/_impl/_browser_type.py            |   1 +
 playwright/_impl/_element_handle.py          |  35 +++----
 playwright/_impl/_frame.py                   |  25 +++--
 playwright/_impl/_set_input_files_helpers.py | 102 ++++++++-----------
 playwright/async_api/_generated.py           |  59 ++++++++---
 playwright/sync_api/_generated.py            |  59 ++++++++---
 setup.py                                     |   2 +-
 tests/assets/file-to-upload-2.txt            |   1 +
 tests/async/test_assertions.py               |   9 ++
 tests/async/test_browsertype_connect.py      |  29 ++++++
 tests/async/test_evaluate.py                 |   2 +-
 tests/async/test_input.py                    |  21 ++++
 tests/sync/test_assertions.py                |   9 ++
 tests/sync/test_browsertype_connect.py       |  30 +++++-
 tests/sync/test_input.py                     |  21 ++++
 17 files changed, 288 insertions(+), 126 deletions(-)
 create mode 100644 tests/assets/file-to-upload-2.txt

diff --git a/README.md b/README.md
index 6191d6535..fc5380287 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 -->119.0.6045.21<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->120.0.6099.28<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->118.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->119.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 730e1e294..cd60f1679 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -215,10 +215,11 @@ async def to_have_attribute(
         self,
         name: str,
         value: Union[str, Pattern[str]],
+        ignore_case: bool = None,
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
-        expected_text = to_expected_text_values([value])
+        expected_text = to_expected_text_values([value], ignore_case=ignore_case)
         await self._expect_impl(
             "to.have.attribute.value",
             FrameExpectOptions(
@@ -235,7 +236,7 @@ async def not_to_have_attribute(
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
-        await self._not.to_have_attribute(name, value, timeout)
+        await self._not.to_have_attribute(name, value, timeout=timeout)
 
     async def to_have_class(
         self,
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 4a916171a..6e712f4aa 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -137,6 +137,7 @@ async def launch_persistent_context(
         acceptDownloads: bool = None,
         tracesDir: Union[pathlib.Path, str] = None,
         chromiumSandbox: bool = None,
+        firefoxUserPrefs: Dict[str, Union[str, float, bool]] = None,
         recordHarPath: Union[Path, str] = None,
         recordHarOmitContent: bool = None,
         recordVideoDir: Union[Path, str] = None,
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 3b96c444e..9d9875193 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -18,7 +18,11 @@
 from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Union, cast
 
 from playwright._impl._api_structures import FilePayload, FloatRect, Position
-from playwright._impl._connection import ChannelOwner, from_nullable_channel
+from playwright._impl._connection import (
+    ChannelOwner,
+    filter_none,
+    from_nullable_channel,
+)
 from playwright._impl._helper import (
     Error,
     KeyboardModifier,
@@ -191,20 +195,17 @@ async def set_input_files(
         timeout: float = None,
         noWaitAfter: bool = None,
     ) -> None:
-        params = locals_to_params(locals())
         frame = await self.owner_frame()
         if not frame:
             raise Error("Cannot set input files to detached element")
         converted = await convert_input_files(files, frame.page.context)
-        if converted["files"] is not None:
-            await self._channel.send(
-                "setInputFiles", {**params, "files": converted["files"]}
-            )
-        else:
-            await self._channel.send(
-                "setInputFilePaths",
-                locals_to_params({**params, **converted, "files": None}),
-            )
+        await self._channel.send(
+            "setInputFiles",
+            {
+                **filter_none({"timeout": timeout, "noWaitAfter": noWaitAfter}),
+                **converted,
+            },
+        )
 
     async def focus(self) -> None:
         await self._channel.send("focus")
@@ -407,14 +408,4 @@ def convert_select_option_values(
             element = [element]
         elements = list(map(lambda e: e._channel, element))
 
-    return filter_out_none(dict(options=options, elements=elements))
-
-
-def filter_out_none(args: Dict) -> Any:
-    copy = {}
-    for key in args:
-        if key == "self":
-            continue
-        if args[key] is not None:
-            copy[key] = args[key]
-    return copy
+    return filter_none(dict(options=options, elements=elements))
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index d8836e3bb..124409681 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -22,6 +22,7 @@
 from playwright._impl._api_structures import AriaRole, FilePayload, Position
 from playwright._impl._connection import (
     ChannelOwner,
+    filter_none,
     from_channel,
     from_nullable_channel,
 )
@@ -689,17 +690,21 @@ async def set_input_files(
         timeout: float = None,
         noWaitAfter: bool = None,
     ) -> None:
-        params = locals_to_params(locals())
         converted = await convert_input_files(files, self.page.context)
-        if converted["files"] is not None:
-            await self._channel.send(
-                "setInputFiles", {**params, "files": converted["files"]}
-            )
-        else:
-            await self._channel.send(
-                "setInputFilePaths",
-                locals_to_params({**params, **converted, "files": None}),
-            )
+        await self._channel.send(
+            "setInputFiles",
+            {
+                **filter_none(
+                    {
+                        "selector": selector,
+                        "strict": strict,
+                        "timeout": timeout,
+                        "noWaitAfter": noWaitAfter,
+                    }
+                ),
+                **converted,
+            },
+        )
 
     async def type(
         self,
diff --git a/playwright/_impl/_set_input_files_helpers.py b/playwright/_impl/_set_input_files_helpers.py
index 8aabc4c61..b1e929252 100644
--- a/playwright/_impl/_set_input_files_helpers.py
+++ b/playwright/_impl/_set_input_files_helpers.py
@@ -15,7 +15,7 @@
 import os
 import sys
 from pathlib import Path
-from typing import TYPE_CHECKING, List, Optional, Union
+from typing import TYPE_CHECKING, Dict, List, Optional, Union, cast
 
 if sys.version_info >= (3, 8):  # pragma: no cover
     from typing import TypedDict
@@ -23,7 +23,7 @@
     from typing_extensions import TypedDict
 
 from playwright._impl._connection import Channel, from_channel
-from playwright._impl._helper import Error, async_readfile
+from playwright._impl._helper import Error
 from playwright._impl._writable_stream import WritableStream
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -34,81 +34,61 @@
 SIZE_LIMIT_IN_BYTES = 50 * 1024 * 1024
 
 
-class InputFilesList(TypedDict):
+class InputFilesList(TypedDict, total=False):
     streams: Optional[List[Channel]]
     localPaths: Optional[List[str]]
-    files: Optional[List[FilePayload]]
+    payloads: Optional[List[Dict[str, Union[str, bytes]]]]
 
 
 async def convert_input_files(
     files: Union[str, Path, FilePayload, List[Union[str, Path]], List[FilePayload]],
     context: "BrowserContext",
 ) -> InputFilesList:
-    file_list = files if isinstance(files, list) else [files]
+    items = files if isinstance(files, list) else [files]
 
-    total_buffer_size_exceeds_limit = (
-        sum(
-            [
-                len(f.get("buffer", ""))
-                for f in file_list
-                if not isinstance(f, (str, Path))
-            ]
-        )
-        > SIZE_LIMIT_IN_BYTES
-    )
-    if total_buffer_size_exceeds_limit:
-        raise Error(
-            "Cannot set buffer larger than 50Mb, please write it to a file and pass its path instead."
-        )
-
-    total_file_size_exceeds_limit = (
-        sum([os.stat(f).st_size for f in file_list if isinstance(f, (str, Path))])
-        > SIZE_LIMIT_IN_BYTES
-    )
-    if total_file_size_exceeds_limit:
+    if any([isinstance(item, (str, Path)) for item in items]):
+        if not all([isinstance(item, (str, Path)) for item in items]):
+            raise Error("File paths cannot be mixed with buffers")
         if context._channel._connection.is_remote:
             streams = []
-            for file in file_list:
-                assert isinstance(file, (str, Path))
+            for item in items:
+                assert isinstance(item, (str, Path))
+                last_modified_ms = int(os.path.getmtime(item) * 1000)
                 stream: WritableStream = from_channel(
                     await context._channel.send(
-                        "createTempFile", {"name": os.path.basename(file)}
+                        "createTempFile",
+                        {
+                            "name": os.path.basename(item),
+                            "lastModifiedMs": last_modified_ms,
+                        },
                     )
                 )
-                await stream.copy(file)
+                await stream.copy(item)
                 streams.append(stream._channel)
-            return InputFilesList(streams=streams, localPaths=None, files=None)
-        local_paths = []
-        for p in file_list:
-            assert isinstance(p, (str, Path))
-            local_paths.append(str(Path(p).absolute().resolve()))
-        return InputFilesList(streams=None, localPaths=local_paths, files=None)
+            return InputFilesList(streams=streams)
+        return InputFilesList(
+            localPaths=[
+                str(Path(cast(Union[str, Path], item)).absolute().resolve())
+                for item in items
+            ]
+        )
 
-    return InputFilesList(
-        streams=None, localPaths=None, files=await _normalize_file_payloads(files)
+    file_payload_exceeds_size_limit = (
+        sum([len(f.get("buffer", "")) for f in items if not isinstance(f, (str, Path))])
+        > SIZE_LIMIT_IN_BYTES
     )
+    if file_payload_exceeds_size_limit:
+        raise Error(
+            "Cannot set buffer larger than 50Mb, please write it to a file and pass its path instead."
+        )
 
-
-async def _normalize_file_payloads(
-    files: Union[str, Path, FilePayload, List[Union[str, Path]], List[FilePayload]]
-) -> List:
-    file_list = files if isinstance(files, list) else [files]
-    file_payloads: List = []
-    for item in file_list:
-        if isinstance(item, (str, Path)):
-            file_payloads.append(
-                {
-                    "name": os.path.basename(item),
-                    "buffer": base64.b64encode(await async_readfile(item)).decode(),
-                }
-            )
-        else:
-            file_payloads.append(
-                {
-                    "name": item["name"],
-                    "mimeType": item["mimeType"],
-                    "buffer": base64.b64encode(item["buffer"]).decode(),
-                }
-            )
-
-    return file_payloads
+    return InputFilesList(
+        payloads=[
+            {
+                "name": item["name"],
+                "mimeType": item["mimeType"],
+                "buffer": base64.b64encode(item["buffer"]).decode(),
+            }
+            for item in cast(List[FilePayload], items)
+        ]
+    )
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 426c24822..eba7560d2 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -1920,13 +1920,16 @@ async def dispatch_event(
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
+        - [DeviceMotionEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent)
+        - [DeviceOrientationEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent)
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
+        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
         - [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent)
         - [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent)
         - [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent)
         - [PointerEvent](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent)
         - [TouchEvent](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent)
-        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
+        - [WheelEvent](https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent)
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
@@ -4102,13 +4105,16 @@ async def dispatch_event(
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
+        - [DeviceMotionEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent)
+        - [DeviceOrientationEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent)
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
+        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
         - [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent)
         - [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent)
         - [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent)
         - [PointerEvent](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent)
         - [TouchEvent](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent)
-        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
+        - [WheelEvent](https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent)
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
@@ -7244,8 +7250,8 @@ async def failure(self) -> typing.Optional[str]:
     async def path(self) -> pathlib.Path:
         """Download.path
 
-        Returns path to the downloaded file in case of successful download. The method will wait for the download to finish
-        if necessary. The method throws when connected remotely.
+        Returns path to the downloaded file for a successful download, or throws for a failed/canceled download. The method
+        will wait for the download to finish if necessary. The method throws when connected remotely.
 
         Note that the download's file name is a random GUID, use `download.suggested_filename()` to get suggested
         file name.
@@ -8543,13 +8549,16 @@ async def dispatch_event(
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
+        - [DeviceMotionEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent)
+        - [DeviceOrientationEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent)
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
+        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
         - [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent)
         - [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent)
         - [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent)
         - [PointerEvent](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent)
         - [TouchEvent](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent)
-        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
+        - [WheelEvent](https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent)
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
@@ -9025,7 +9034,7 @@ async def expose_binding(
 
         async def run(playwright: Playwright):
             webkit = playwright.webkit
-            browser = await webkit.launch(headless=false)
+            browser = await webkit.launch(headless=False)
             context = await browser.new_context()
             page = await context.new_page()
             await page.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
@@ -9051,7 +9060,7 @@ async def main():
 
         def run(playwright: Playwright):
             webkit = playwright.webkit
-            browser = webkit.launch(headless=false)
+            browser = webkit.launch(headless=False)
             context = browser.new_context()
             page = context.new_page()
             page.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
@@ -13310,7 +13319,7 @@ async def expose_binding(
 
         async def run(playwright: Playwright):
             webkit = playwright.webkit
-            browser = await webkit.launch(headless=false)
+            browser = await webkit.launch(headless=False)
             context = await browser.new_context()
             await context.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
             page = await context.new_page()
@@ -13336,7 +13345,7 @@ async def main():
 
         def run(playwright: Playwright):
             webkit = playwright.webkit
-            browser = webkit.launch(headless=false)
+            browser = webkit.launch(headless=False)
             context = browser.new_context()
             context.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
             page = context.new_page()
@@ -14796,6 +14805,9 @@ async def launch_persistent_context(
         accept_downloads: typing.Optional[bool] = None,
         traces_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         chromium_sandbox: typing.Optional[bool] = None,
+        firefox_user_prefs: typing.Optional[
+            typing.Dict[str, typing.Union[str, float, bool]]
+        ] = None,
         record_har_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         record_har_omit_content: typing.Optional[bool] = None,
         record_video_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
@@ -14931,6 +14943,9 @@ async def launch_persistent_context(
             If specified, traces are saved into this directory.
         chromium_sandbox : Union[bool, None]
             Enable Chromium sandboxing. Defaults to `false`.
+        firefox_user_prefs : Union[Dict[str, Union[bool, float, str]], None]
+            Firefox user preferences. Learn more about the Firefox user preferences at
+            [`about:config`](https://support.mozilla.org/en-US/kb/about-config-editor-firefox).
         record_har_path : Union[pathlib.Path, str, None]
             Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
             on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
@@ -15018,6 +15033,7 @@ async def launch_persistent_context(
                 acceptDownloads=accept_downloads,
                 tracesDir=traces_dir,
                 chromiumSandbox=chromium_sandbox,
+                firefoxUserPrefs=mapping.to_impl(firefox_user_prefs),
                 recordHarPath=record_har_path,
                 recordHarOmitContent=record_har_omit_content,
                 recordVideoDir=record_video_dir,
@@ -15804,13 +15820,16 @@ async def dispatch_event(
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
+        - [DeviceMotionEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent)
+        - [DeviceOrientationEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent)
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
+        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
         - [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent)
         - [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent)
         - [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent)
         - [PointerEvent](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent)
         - [TouchEvent](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent)
-        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
+        - [WheelEvent](https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent)
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
@@ -18385,8 +18404,8 @@ async def dispose(self) -> None:
         """APIRequestContext.dispose
 
         All responses returned by `a_pi_request_context.get()` and similar methods are stored in the memory, so that
-        you can later call `a_pi_response.body()`. This method discards all stored responses, and makes
-        `a_pi_response.body()` throw \"Response disposed\" error.
+        you can later call `a_pi_response.body()`.This method discards all its resources, calling any method on
+        disposed `APIRequestContext` will throw an exception.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.dispose())
@@ -19277,6 +19296,11 @@ async def to_contain_text(
         Ensures the `Locator` points to an element that contains the given text. You can use regular expressions for the
         value as well.
 
+        **Details**
+
+        When `expected` parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+        text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
+
         **Usage**
 
         ```py
@@ -19416,6 +19440,7 @@ async def to_have_attribute(
         name: str,
         value: typing.Union[str, typing.Pattern[str]],
         *,
+        ignore_case: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None
     ) -> None:
         """LocatorAssertions.to_have_attribute
@@ -19444,6 +19469,9 @@ async def to_have_attribute(
             Attribute name.
         value : Union[Pattern[str], str]
             Expected attribute value.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
@@ -19451,7 +19479,7 @@ async def to_have_attribute(
 
         return mapping.from_maybe_impl(
             await self._impl_obj.to_have_attribute(
-                name=name, value=value, timeout=timeout
+                name=name, value=value, ignore_case=ignore_case, timeout=timeout
             )
         )
 
@@ -20010,6 +20038,11 @@ async def to_have_text(
         Ensures the `Locator` points to an element with the given text. You can use regular expressions for the value as
         well.
 
+        **Details**
+
+        When `expected` parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+        text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
+
         **Usage**
 
         ```py
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 182d31874..4059a6149 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -1926,13 +1926,16 @@ def dispatch_event(
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
+        - [DeviceMotionEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent)
+        - [DeviceOrientationEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent)
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
+        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
         - [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent)
         - [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent)
         - [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent)
         - [PointerEvent](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent)
         - [TouchEvent](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent)
-        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
+        - [WheelEvent](https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent)
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
@@ -4172,13 +4175,16 @@ def dispatch_event(
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
+        - [DeviceMotionEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent)
+        - [DeviceOrientationEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent)
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
+        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
         - [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent)
         - [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent)
         - [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent)
         - [PointerEvent](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent)
         - [TouchEvent](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent)
-        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
+        - [WheelEvent](https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent)
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
@@ -7364,8 +7370,8 @@ def failure(self) -> typing.Optional[str]:
     def path(self) -> pathlib.Path:
         """Download.path
 
-        Returns path to the downloaded file in case of successful download. The method will wait for the download to finish
-        if necessary. The method throws when connected remotely.
+        Returns path to the downloaded file for a successful download, or throws for a failed/canceled download. The method
+        will wait for the download to finish if necessary. The method throws when connected remotely.
 
         Note that the download's file name is a random GUID, use `download.suggested_filename()` to get suggested
         file name.
@@ -8577,13 +8583,16 @@ def dispatch_event(
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
+        - [DeviceMotionEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent)
+        - [DeviceOrientationEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent)
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
+        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
         - [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent)
         - [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent)
         - [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent)
         - [PointerEvent](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent)
         - [TouchEvent](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent)
-        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
+        - [WheelEvent](https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent)
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
@@ -9073,7 +9082,7 @@ def expose_binding(
 
         async def run(playwright: Playwright):
             webkit = playwright.webkit
-            browser = await webkit.launch(headless=false)
+            browser = await webkit.launch(headless=False)
             context = await browser.new_context()
             page = await context.new_page()
             await page.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
@@ -9099,7 +9108,7 @@ async def main():
 
         def run(playwright: Playwright):
             webkit = playwright.webkit
-            browser = webkit.launch(headless=false)
+            browser = webkit.launch(headless=False)
             context = browser.new_context()
             page = context.new_page()
             page.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
@@ -13360,7 +13369,7 @@ def expose_binding(
 
         async def run(playwright: Playwright):
             webkit = playwright.webkit
-            browser = await webkit.launch(headless=false)
+            browser = await webkit.launch(headless=False)
             context = await browser.new_context()
             await context.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
             page = await context.new_page()
@@ -13386,7 +13395,7 @@ async def main():
 
         def run(playwright: Playwright):
             webkit = playwright.webkit
-            browser = webkit.launch(headless=false)
+            browser = webkit.launch(headless=False)
             context = browser.new_context()
             context.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
             page = context.new_page()
@@ -14864,6 +14873,9 @@ def launch_persistent_context(
         accept_downloads: typing.Optional[bool] = None,
         traces_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         chromium_sandbox: typing.Optional[bool] = None,
+        firefox_user_prefs: typing.Optional[
+            typing.Dict[str, typing.Union[str, float, bool]]
+        ] = None,
         record_har_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         record_har_omit_content: typing.Optional[bool] = None,
         record_video_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
@@ -14999,6 +15011,9 @@ def launch_persistent_context(
             If specified, traces are saved into this directory.
         chromium_sandbox : Union[bool, None]
             Enable Chromium sandboxing. Defaults to `false`.
+        firefox_user_prefs : Union[Dict[str, Union[bool, float, str]], None]
+            Firefox user preferences. Learn more about the Firefox user preferences at
+            [`about:config`](https://support.mozilla.org/en-US/kb/about-config-editor-firefox).
         record_har_path : Union[pathlib.Path, str, None]
             Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
             on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
@@ -15087,6 +15102,7 @@ def launch_persistent_context(
                     acceptDownloads=accept_downloads,
                     tracesDir=traces_dir,
                     chromiumSandbox=chromium_sandbox,
+                    firefoxUserPrefs=mapping.to_impl(firefox_user_prefs),
                     recordHarPath=record_har_path,
                     recordHarOmitContent=record_har_omit_content,
                     recordVideoDir=record_video_dir,
@@ -15886,13 +15902,16 @@ def dispatch_event(
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
         Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:
+        - [DeviceMotionEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent)
+        - [DeviceOrientationEvent](https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent)
         - [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
+        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
         - [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent)
         - [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent)
         - [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent)
         - [PointerEvent](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent)
         - [TouchEvent](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent)
-        - [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)
+        - [WheelEvent](https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent)
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
@@ -18519,8 +18538,8 @@ def dispose(self) -> None:
         """APIRequestContext.dispose
 
         All responses returned by `a_pi_request_context.get()` and similar methods are stored in the memory, so that
-        you can later call `a_pi_response.body()`. This method discards all stored responses, and makes
-        `a_pi_response.body()` throw \"Response disposed\" error.
+        you can later call `a_pi_response.body()`.This method discards all its resources, calling any method on
+        disposed `APIRequestContext` will throw an exception.
         """
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.dispose()))
@@ -19435,6 +19454,11 @@ def to_contain_text(
         Ensures the `Locator` points to an element that contains the given text. You can use regular expressions for the
         value as well.
 
+        **Details**
+
+        When `expected` parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+        text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
+
         **Usage**
 
         ```py
@@ -19578,6 +19602,7 @@ def to_have_attribute(
         name: str,
         value: typing.Union[str, typing.Pattern[str]],
         *,
+        ignore_case: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None
     ) -> None:
         """LocatorAssertions.to_have_attribute
@@ -19606,6 +19631,9 @@ def to_have_attribute(
             Attribute name.
         value : Union[Pattern[str], str]
             Expected attribute value.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
@@ -19614,7 +19642,7 @@ def to_have_attribute(
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.to_have_attribute(
-                    name=name, value=value, timeout=timeout
+                    name=name, value=value, ignore_case=ignore_case, timeout=timeout
                 )
             )
         )
@@ -20190,6 +20218,11 @@ def to_have_text(
         Ensures the `Locator` points to an element with the given text. You can use regular expressions for the value as
         well.
 
+        **Details**
+
+        When `expected` parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+        text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
+
         **Usage**
 
         ```py
diff --git a/setup.py b/setup.py
index 4ae0a85e5..2bd953f32 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.40.0-alpha-oct-18-2023"
+driver_version = "1.40.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/assets/file-to-upload-2.txt b/tests/assets/file-to-upload-2.txt
new file mode 100644
index 000000000..2e2da2175
--- /dev/null
+++ b/tests/assets/file-to-upload-2.txt
@@ -0,0 +1 @@
+contents of the file
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 91d16b0c5..49b860309 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -112,6 +112,15 @@ async def test_assertions_locator_to_have_attribute(page: Page, server: Server)
         )
 
 
+async def test_assertions_locator_to_have_attribute_ignore_case(
+    page: Page, server: Page
+) -> None:
+    await page.set_content("<div id=NoDe>Text content</div>")
+    locator = page.locator("#NoDe")
+    await expect(locator).to_have_attribute("id", "node", ignore_case=True)
+    await expect(locator).not_to_have_attribute("id", "node")
+
+
 async def test_assertions_locator_to_have_class(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content("<div class=foobar>kek</div>")
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index cafdfaab3..ffb3fed31 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import asyncio
+import os
 import re
 from pathlib import Path
 from typing import Callable
@@ -359,3 +360,31 @@ async def test_should_record_trace_with_relative_trace_path(
         assert Path("trace1.zip").exists()
     finally:
         Path("trace1.zip").unlink()
+
+
+async def test_set_input_files_should_preserve_last_modified_timestamp(
+    browser_type: BrowserType,
+    launch_server: Callable[[], RemoteServer],
+    assetdir: Path,
+) -> None:
+    # Launch another server to not affect other tests.
+    remote = launch_server()
+
+    browser = await browser_type.connect(remote.ws_endpoint)
+    context = await browser.new_context()
+    page = await context.new_page()
+
+    await page.set_content("<input type=file multiple=true/>")
+    input = page.locator("input")
+    files = ["file-to-upload.txt", "file-to-upload-2.txt"]
+    await input.set_input_files([assetdir / file for file in files])
+    assert await input.evaluate("input => [...input.files].map(f => f.name)") == files
+    timestamps = await input.evaluate(
+        "input => [...input.files].map(f => f.lastModified)"
+    )
+    expected_timestamps = [os.path.getmtime(assetdir / file) * 1000 for file in files]
+
+    # On Linux browser sometimes reduces the timestamp by 1ms: 1696272058110.0715  -> 1696272058109 or even
+    # rounds it to seconds in WebKit: 1696272058110 -> 1696272058000.
+    for i in range(len(timestamps)):
+        assert abs(timestamps[i] - expected_timestamps[i]) < 1000
diff --git a/tests/async/test_evaluate.py b/tests/async/test_evaluate.py
index 95c528d33..eb647dc2d 100644
--- a/tests/async/test_evaluate.py
+++ b/tests/async/test_evaluate.py
@@ -197,7 +197,7 @@ async def test_evaluate_throw_if_underlying_element_was_disposed(page):
         await page.evaluate("e => e.textContent", element)
     except Error as e:
         error = e
-    assert "JSHandle is disposed" in error.message
+    assert "no object with guid" in error.message
 
 
 async def test_evaluate_evaluate_exception(page):
diff --git a/tests/async/test_input.py b/tests/async/test_input.py
index ead68ecb5..76a8acc4d 100644
--- a/tests/async/test_input.py
+++ b/tests/async/test_input.py
@@ -17,6 +17,7 @@
 import re
 import shutil
 import sys
+from pathlib import Path
 
 import pytest
 from flaky import flaky
@@ -351,6 +352,26 @@ async def test_should_upload_large_file(page, server, tmp_path):
     assert match.group("filename") == b"200MB.zip"
 
 
+async def test_set_input_files_should_preserve_last_modified_timestamp(
+    page: Page,
+    assetdir: Path,
+) -> None:
+    await page.set_content("<input type=file multiple=true/>")
+    input = page.locator("input")
+    files = ["file-to-upload.txt", "file-to-upload-2.txt"]
+    await input.set_input_files([assetdir / file for file in files])
+    assert await input.evaluate("input => [...input.files].map(f => f.name)") == files
+    timestamps = await input.evaluate(
+        "input => [...input.files].map(f => f.lastModified)"
+    )
+    expected_timestamps = [os.path.getmtime(assetdir / file) * 1000 for file in files]
+
+    # On Linux browser sometimes reduces the timestamp by 1ms: 1696272058110.0715  -> 1696272058109 or even
+    # rounds it to seconds in WebKit: 1696272058110 -> 1696272058000.
+    for i in range(len(timestamps)):
+        assert abs(timestamps[i] - expected_timestamps[i]) < 1000
+
+
 @flaky
 async def test_should_upload_multiple_large_file(page: Page, server, tmp_path):
     files_count = 10
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 3f83eec49..ef66e2af3 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -105,6 +105,15 @@ def test_assertions_locator_to_have_attribute(page: Page, server: Server) -> Non
         expect(page.locator("div#foobar")).to_have_attribute("id", "koko", timeout=100)
 
 
+def test_assertions_locator_to_have_attribute_ignore_case(
+    page: Page, server: Page
+) -> None:
+    page.set_content("<div id=NoDe>Text content</div>")
+    locator = page.locator("#NoDe")
+    expect(locator).to_have_attribute("id", "node", ignore_case=True)
+    expect(locator).not_to_have_attribute("id", "node")
+
+
 def test_assertions_locator_to_have_class(page: Page, server: Server) -> None:
     page.goto(server.EMPTY_PAGE)
     page.set_content("<div class=foobar>kek</div>")
diff --git a/tests/sync/test_browsertype_connect.py b/tests/sync/test_browsertype_connect.py
index 26ee44227..74970c545 100644
--- a/tests/sync/test_browsertype_connect.py
+++ b/tests/sync/test_browsertype_connect.py
@@ -12,8 +12,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import os
 import time
-from typing import Callable
+from pathlib import Path
+from typing import Any, Callable
 
 import pytest
 
@@ -221,3 +223,29 @@ def handle_request(route: Route) -> None:
     assert response.json() == {"foo": "bar"}
 
     remote.kill()
+
+
+def test_set_input_files_should_preserve_last_modified_timestamp(
+    browser_type: BrowserType,
+    launch_server: Callable[[], RemoteServer],
+    assetdir: Path,
+) -> None:
+    # Launch another server to not affect other tests.
+    remote = launch_server()
+
+    browser = browser_type.connect(remote.ws_endpoint)
+    context = browser.new_context()
+    page = context.new_page()
+
+    page.set_content("<input type=file multiple=true/>")
+    input = page.locator("input")
+    files: Any = ["file-to-upload.txt", "file-to-upload-2.txt"]
+    input.set_input_files([assetdir / file for file in files])
+    assert input.evaluate("input => [...input.files].map(f => f.name)") == files
+    timestamps = input.evaluate("input => [...input.files].map(f => f.lastModified)")
+    expected_timestamps = [os.path.getmtime(assetdir / file) * 1000 for file in files]
+
+    # On Linux browser sometimes reduces the timestamp by 1ms: 1696272058110.0715  -> 1696272058109 or even
+    # rounds it to seconds in WebKit: 1696272058110 -> 1696272058000.
+    for i in range(len(timestamps)):
+        assert abs(timestamps[i] - expected_timestamps[i]) < 1000
diff --git a/tests/sync/test_input.py b/tests/sync/test_input.py
index ff28f6a63..98b4fda55 100644
--- a/tests/sync/test_input.py
+++ b/tests/sync/test_input.py
@@ -12,6 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import os
+from pathlib import Path
+from typing import Any
 
 from playwright.sync_api import Page
 
@@ -24,3 +27,21 @@ def test_expect_file_chooser(page: Page) -> None:
     fc.set_files(
         {"name": "test.txt", "mimeType": "text/plain", "buffer": b"Hello World"}
     )
+
+
+def test_set_input_files_should_preserve_last_modified_timestamp(
+    page: Page,
+    assetdir: Path,
+) -> None:
+    page.set_content("<input type=file multiple=true/>")
+    input = page.locator("input")
+    files: Any = ["file-to-upload.txt", "file-to-upload-2.txt"]
+    input.set_input_files([assetdir / file for file in files])
+    assert input.evaluate("input => [...input.files].map(f => f.name)") == files
+    timestamps = input.evaluate("input => [...input.files].map(f => f.lastModified)")
+    expected_timestamps = [os.path.getmtime(assetdir / file) * 1000 for file in files]
+
+    # On Linux browser sometimes reduces the timestamp by 1ms: 1696272058110.0715  -> 1696272058109 or even
+    # rounds it to seconds in WebKit: 1696272058110 -> 1696272058000.
+    for i in range(len(timestamps)):
+        assert abs(timestamps[i] - expected_timestamps[i]) < 1000

From 8705b3555ad9f6268190ef383ad00bb80ffc907f Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 21 Nov 2023 21:25:27 +0100
Subject: [PATCH 119/438] chore(roll): roll Playwright to
 1.40.0-beta-1700587209000 (#2171)

---
 playwright/_impl/_assertions.py    | 5 ++++-
 playwright/async_api/_generated.py | 6 +++++-
 playwright/sync_api/_generated.py  | 6 +++++-
 setup.py                           | 2 +-
 4 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index cd60f1679..d3e3f9e03 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -233,10 +233,13 @@ async def not_to_have_attribute(
         self,
         name: str,
         value: Union[str, Pattern[str]],
+        ignore_case: bool = None,
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
-        await self._not.to_have_attribute(name, value, timeout=timeout)
+        await self._not.to_have_attribute(
+            name, value, ignore_case=ignore_case, timeout=timeout
+        )
 
     async def to_have_class(
         self,
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index eba7560d2..4f0fae513 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -19488,6 +19488,7 @@ async def not_to_have_attribute(
         name: str,
         value: typing.Union[str, typing.Pattern[str]],
         *,
+        ignore_case: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None
     ) -> None:
         """LocatorAssertions.not_to_have_attribute
@@ -19500,6 +19501,9 @@ async def not_to_have_attribute(
             Attribute name.
         value : Union[Pattern[str], str]
             Expected attribute value.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
@@ -19507,7 +19511,7 @@ async def not_to_have_attribute(
 
         return mapping.from_maybe_impl(
             await self._impl_obj.not_to_have_attribute(
-                name=name, value=value, timeout=timeout
+                name=name, value=value, ignore_case=ignore_case, timeout=timeout
             )
         )
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 4059a6149..a0c3ead75 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -19652,6 +19652,7 @@ def not_to_have_attribute(
         name: str,
         value: typing.Union[str, typing.Pattern[str]],
         *,
+        ignore_case: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None
     ) -> None:
         """LocatorAssertions.not_to_have_attribute
@@ -19664,6 +19665,9 @@ def not_to_have_attribute(
             Attribute name.
         value : Union[Pattern[str], str]
             Expected attribute value.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
         """
@@ -19672,7 +19676,7 @@ def not_to_have_attribute(
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.not_to_have_attribute(
-                    name=name, value=value, timeout=timeout
+                    name=name, value=value, ignore_case=ignore_case, timeout=timeout
                 )
             )
         )
diff --git a/setup.py b/setup.py
index 2bd953f32..7e77bf8ae 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.40.0"
+driver_version = "1.40.0-beta-1700587209000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 85df32c24e4d887f65fa0f1421d3d90c716fd90a Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 27 Nov 2023 20:37:21 +0100
Subject: [PATCH 120/438] chore: filter_none by default (#2173)

---
 playwright/_impl/_browser.py         |  4 ++--
 playwright/_impl/_browser_context.py |  3 +--
 playwright/_impl/_browser_type.py    | 17 ++++++---------
 playwright/_impl/_connection.py      |  4 ++--
 playwright/_impl/_element_handle.py  | 11 ++++------
 playwright/_impl/_fetch.py           | 32 +++++++++++++---------------
 playwright/_impl/_frame.py           | 13 ++++-------
 playwright/_impl/_locator.py         |  3 +--
 playwright/_impl/_network.py         | 11 ++++------
 playwright/_impl/_tracing.py         |  8 ++-----
 10 files changed, 42 insertions(+), 64 deletions(-)

diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index 5fbc841db..2fd9a8c50 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -27,7 +27,7 @@
 from playwright._impl._artifact import Artifact
 from playwright._impl._browser_context import BrowserContext
 from playwright._impl._cdp_session import CDPSession
-from playwright._impl._connection import ChannelOwner, filter_none, from_channel
+from playwright._impl._connection import ChannelOwner, from_channel
 from playwright._impl._errors import is_target_closed_error
 from playwright._impl._helper import (
     ColorScheme,
@@ -183,7 +183,7 @@ async def close(self, reason: str = None) -> None:
             if self._should_close_connection_on_close:
                 await self._connection.stop_async()
             else:
-                await self._channel.send("close", filter_none({"reason": reason}))
+                await self._channel.send("close", {"reason": reason})
         except Exception as e:
             if not is_target_closed_error(e):
                 raise e
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 60c4166e8..d978b1201 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -40,7 +40,6 @@
 from playwright._impl._cdp_session import CDPSession
 from playwright._impl._connection import (
     ChannelOwner,
-    filter_none,
     from_channel,
     from_nullable_channel,
 )
@@ -482,7 +481,7 @@ async def _inner_close() -> None:
                 await har.delete()
 
         await self._channel._connection.wrap_api_call(_inner_close, True)
-        await self._channel.send("close", filter_none({"reason": reason}))
+        await self._channel.send("close", {"reason": reason})
         await self._closed_future
 
     async def storage_state(self, path: Union[str, Path] = None) -> StorageState:
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 6e712f4aa..49013df29 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -28,7 +28,6 @@
 from playwright._impl._connection import (
     ChannelOwner,
     Connection,
-    filter_none,
     from_channel,
     from_nullable_channel,
 )
@@ -200,15 +199,13 @@ async def connect(
         pipe_channel = (
             await local_utils._channel.send_return_as_dict(
                 "connect",
-                filter_none(
-                    {
-                        "wsEndpoint": ws_endpoint,
-                        "headers": headers,
-                        "slowMo": slow_mo,
-                        "timeout": timeout,
-                        "exposeNetwork": expose_network,
-                    }
-                ),
+                {
+                    "wsEndpoint": ws_endpoint,
+                    "headers": headers,
+                    "slowMo": slow_mo,
+                    "timeout": timeout,
+                    "exposeNetwork": expose_network,
+                },
             )
         )["pipe"]
         transport = JsonPipeTransport(self._connection._loop, pipe_channel)
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 479f908f0..4c6bac00a 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -82,7 +82,7 @@ async def inner_send(
         if params is None:
             params = {}
         callback = self._connection._send_message_to_server(
-            self._object, method, params
+            self._object, method, _filter_none(params)
         )
         if self._connection._error:
             error = self._connection._error
@@ -565,7 +565,7 @@ def _extract_stack_trace_information_from_stack(
     }
 
 
-def filter_none(d: Mapping) -> Dict:
+def _filter_none(d: Mapping) -> Dict:
     return {k: v for k, v in d.items() if v is not None}
 
 
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 9d9875193..3636f3529 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -18,11 +18,7 @@
 from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Union, cast
 
 from playwright._impl._api_structures import FilePayload, FloatRect, Position
-from playwright._impl._connection import (
-    ChannelOwner,
-    filter_none,
-    from_nullable_channel,
-)
+from playwright._impl._connection import ChannelOwner, from_nullable_channel
 from playwright._impl._helper import (
     Error,
     KeyboardModifier,
@@ -202,7 +198,8 @@ async def set_input_files(
         await self._channel.send(
             "setInputFiles",
             {
-                **filter_none({"timeout": timeout, "noWaitAfter": noWaitAfter}),
+                "timeout": timeout,
+                "noWaitAfter": noWaitAfter,
                 **converted,
             },
         )
@@ -408,4 +405,4 @@ def convert_select_option_values(
             element = [element]
         elements = list(map(lambda e: e._channel, element))
 
-    return filter_none(dict(options=options, elements=elements))
+    return dict(options=options, elements=elements)
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index 27fab09c1..53c457ba7 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -29,7 +29,7 @@
     ServerFilePayload,
     StorageState,
 )
-from playwright._impl._connection import ChannelOwner, filter_none, from_channel
+from playwright._impl._connection import ChannelOwner, from_channel
 from playwright._impl._errors import is_target_closed_error
 from playwright._impl._helper import (
     Error,
@@ -368,22 +368,20 @@ async def _inner_fetch(
 
         response = await self._channel.send(
             "fetch",
-            filter_none(
-                {
-                    "url": url,
-                    "params": object_to_array(params),
-                    "method": method,
-                    "headers": serialized_headers,
-                    "postData": post_data,
-                    "jsonData": json_data,
-                    "formData": form_data,
-                    "multipartData": multipart_data,
-                    "timeout": timeout,
-                    "failOnStatusCode": failOnStatusCode,
-                    "ignoreHTTPSErrors": ignoreHTTPSErrors,
-                    "maxRedirects": maxRedirects,
-                }
-            ),
+            {
+                "url": url,
+                "params": object_to_array(params),
+                "method": method,
+                "headers": serialized_headers,
+                "postData": post_data,
+                "jsonData": json_data,
+                "formData": form_data,
+                "multipartData": multipart_data,
+                "timeout": timeout,
+                "failOnStatusCode": failOnStatusCode,
+                "ignoreHTTPSErrors": ignoreHTTPSErrors,
+                "maxRedirects": maxRedirects,
+            },
         )
         return APIResponse(self, response)
 
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 124409681..7fde8c4ef 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -22,7 +22,6 @@
 from playwright._impl._api_structures import AriaRole, FilePayload, Position
 from playwright._impl._connection import (
     ChannelOwner,
-    filter_none,
     from_channel,
     from_nullable_channel,
 )
@@ -694,14 +693,10 @@ async def set_input_files(
         await self._channel.send(
             "setInputFiles",
             {
-                **filter_none(
-                    {
-                        "selector": selector,
-                        "strict": strict,
-                        "timeout": timeout,
-                        "noWaitAfter": noWaitAfter,
-                    }
-                ),
+                "selector": selector,
+                "strict": strict,
+                "timeout": timeout,
+                "noWaitAfter": noWaitAfter,
                 **converted,
             },
         )
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 8a0c8282f..7591ff116 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -38,7 +38,6 @@
     FrameExpectResult,
     Position,
 )
-from playwright._impl._connection import filter_none
 from playwright._impl._element_handle import ElementHandle
 from playwright._impl._helper import (
     Error,
@@ -707,7 +706,7 @@ async def _expect(
             {
                 "selector": self._selector,
                 "expression": expression,
-                **(filter_none(options)),
+                **options,
             },
         )
         if result.get("received"):
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 9eba30e0d..67bd9d48d 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -51,7 +51,6 @@
 )
 from playwright._impl._connection import (
     ChannelOwner,
-    filter_none,
     from_channel,
     from_nullable_channel,
 )
@@ -303,12 +302,10 @@ async def abort(self, errorCode: str = None) -> None:
         await self._race_with_page_close(
             self._channel.send(
                 "abort",
-                filter_none(
-                    {
-                        "errorCode": errorCode,
-                        "requestUrl": self.request._initializer["url"],
-                    }
-                ),
+                {
+                    "errorCode": errorCode,
+                    "requestUrl": self.request._initializer["url"],
+                },
             )
         )
         self._report_handled(True)
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index 98f19cb69..7f7972372 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -16,11 +16,7 @@
 from typing import Dict, Optional, Union, cast
 
 from playwright._impl._artifact import Artifact
-from playwright._impl._connection import (
-    ChannelOwner,
-    filter_none,
-    from_nullable_channel,
-)
+from playwright._impl._connection import ChannelOwner, from_nullable_channel
 from playwright._impl._helper import locals_to_params
 
 
@@ -48,7 +44,7 @@ async def start(
         async def _inner_start() -> str:
             await self._channel.send("tracingStart", params)
             return await self._channel.send(
-                "tracingStartChunk", filter_none({"title": title, "name": name})
+                "tracingStartChunk", {"title": title, "name": name}
             )
 
         trace_name = await self._connection.wrap_api_call(_inner_start, True)

From 1bf55d781fe4a8a6fa8724a90c9ee713fee6cd3c Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 29 Nov 2023 10:47:36 -0800
Subject: [PATCH 121/438] chore: fix tests/async pyright linter issues (#2175)

---
 tests/async/conftest.py                       |  49 +-
 tests/async/test_accessibility.py             |  75 +--
 tests/async/test_add_init_script.py           |  36 +-
 tests/async/test_asyncio.py                   |   7 +-
 tests/async/test_browser.py                   |  12 +-
 tests/async/test_browsercontext.py            | 262 +++++++----
 .../async/test_browsercontext_add_cookies.py  |  93 ++--
 .../async/test_browsercontext_clearcookies.py |  11 +-
 tests/async/test_browsercontext_cookies.py    |  35 +-
 tests/async/test_browsercontext_events.py     |  14 +-
 tests/async/test_browsercontext_proxy.py      |  33 +-
 .../test_browsercontext_request_fallback.py   | 189 ++++----
 .../test_browsercontext_request_intercept.py  |  35 +-
 .../test_browsercontext_storage_state.py      |  11 +-
 tests/async/test_browsertype_connect.py       |  69 +--
 tests/async/test_browsertype_connect_cdp.py   |  10 +-
 tests/async/test_cdp_session.py               |  15 +-
 tests/async/test_check.py                     |  20 +-
 tests/async/test_chromium_tracing.py          |  25 +-
 tests/async/test_click.py                     | 248 ++++++----
 tests/async/test_console.py                   |  25 +-
 tests/async/test_context_manager.py           |   8 +-
 tests/async/test_defaultbrowsercontext.py     | 152 ++++--
 tests/async/test_device_descriptors.py        |   6 +-
 tests/async/test_dialog.py                    |  30 +-
 tests/async/test_dispatch_event.py            |  47 +-
 tests/async/test_download.py                  |  94 ++--
 tests/async/test_element_handle.py            | 261 +++++++----
 ...t_element_handle_wait_for_element_state.py |  51 ++-
 tests/async/test_emulation_focus.py           |  30 +-
 tests/async/test_evaluate.py                  |  79 ++--
 tests/async/test_fetch_browser_context.py     |  45 +-
 tests/async/test_fetch_global.py              |  68 +--
 tests/async/test_fill.py                      |  10 +-
 tests/async/test_focus.py                     |  14 +-
 tests/async/test_frames.py                    |  70 ++-
 tests/async/test_geolocation.py               |  29 +-
 tests/async/test_har.py                       |  43 +-
 tests/async/test_headful.py                   |  42 +-
 tests/async/test_ignore_https_errors.py       |  12 +-
 tests/async/test_input.py                     |  65 +--
 tests/async/test_interception.py              | 418 ++++++++++-------
 tests/async/test_issues.py                    |   9 +-
 tests/async/test_jshandle.py                  |  59 ++-
 tests/async/test_keyboard.py                  |  99 ++--
 tests/async/test_launcher.py                  |  46 +-
 tests/async/test_listeners.py                 |   7 +-
 tests/async/test_locators.py                  | 123 ++---
 tests/async/test_navigation.py                | 343 ++++++++------
 tests/async/test_network.py                   | 274 +++++++----
 tests/async/test_page.py                      | 433 +++++++++++-------
 tests/async/test_page_base_url.py             |  48 +-
 tests/async/test_page_network_request.py      |   3 +-
 tests/async/test_page_network_response.py     |  10 +-
 tests/async/test_page_request_fallback.py     | 192 ++++----
 tests/async/test_page_request_intercept.py    |  51 ++-
 tests/async/test_page_select_option.py        |  68 +--
 tests/async/test_pdf.py                       |   4 +-
 tests/async/test_popup.py                     | 110 +++--
 tests/async/test_proxy.py                     |  33 +-
 tests/async/test_queryselector.py             |  22 +-
 tests/async/test_request_continue.py          |  34 +-
 tests/async/test_request_fulfill.py           |   7 +-
 tests/async/test_request_intercept.py         |  37 +-
 tests/async/test_resource_timing.py           |  13 +-
 tests/async/test_screenshot.py                |   9 +-
 tests/async/test_selectors_misc.py            |   2 +-
 tests/async/test_selectors_text.py            |   2 +-
 tests/async/test_tap.py                       |  29 +-
 tests/async/test_tracing.py                   |  12 +-
 tests/async/test_video.py                     |  25 +-
 tests/async/test_wait_for_function.py         |  18 +-
 tests/async/test_wait_for_url.py              |  31 +-
 tests/async/test_websocket.py                 |  73 ++-
 tests/async/test_worker.py                    |  39 +-
 tests/async/utils.py                          |  14 +-
 tests/conftest.py                             |  10 +-
 tests/server.py                               |  16 +-
 tests/sync/test_page_request_intercept.py     |  13 +-
 tests/utils.py                                |   9 +-
 80 files changed, 3234 insertions(+), 1941 deletions(-)

diff --git a/tests/async/conftest.py b/tests/async/conftest.py
index ba141fcd5..490f4440a 100644
--- a/tests/async/conftest.py
+++ b/tests/async/conftest.py
@@ -12,45 +12,60 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import pytest
+import asyncio
+from typing import Any, AsyncGenerator, Awaitable, Callable, Dict, Generator, List
 
-from playwright.async_api import async_playwright
+import pytest
 
+from playwright.async_api import (
+    Browser,
+    BrowserContext,
+    BrowserType,
+    Page,
+    Playwright,
+    Selectors,
+    async_playwright,
+)
+
+from .utils import Utils
 from .utils import utils as utils_object
 
 
 @pytest.fixture
-def utils():
+def utils() -> Generator[Utils, None, None]:
     yield utils_object
 
 
 # Will mark all the tests as async
-def pytest_collection_modifyitems(items):
+def pytest_collection_modifyitems(items: List[pytest.Item]) -> None:
     for item in items:
         item.add_marker(pytest.mark.asyncio)
 
 
 @pytest.fixture(scope="session")
-async def playwright():
+async def playwright() -> AsyncGenerator[Playwright, None]:
     async with async_playwright() as playwright_object:
         yield playwright_object
 
 
 @pytest.fixture(scope="session")
-def browser_type(playwright, browser_name: str):
+def browser_type(playwright: Playwright, browser_name: str) -> BrowserType:
     if browser_name == "chromium":
         return playwright.chromium
     if browser_name == "firefox":
         return playwright.firefox
     if browser_name == "webkit":
         return playwright.webkit
+    raise Exception(f"Invalid browser_name: {browser_name}")
 
 
 @pytest.fixture(scope="session")
-async def browser_factory(launch_arguments, browser_type):
+async def browser_factory(
+    launch_arguments: Dict, browser_type: BrowserType
+) -> AsyncGenerator[Callable[..., Awaitable[Browser]], None]:
     browsers = []
 
-    async def launch(**kwargs):
+    async def launch(**kwargs: Any) -> Browser:
         browser = await browser_type.launch(**launch_arguments, **kwargs)
         browsers.append(browser)
         return browser
@@ -61,17 +76,21 @@ async def launch(**kwargs):
 
 
 @pytest.fixture(scope="session")
-async def browser(browser_factory):
+async def browser(
+    browser_factory: "Callable[..., asyncio.Future[Browser]]",
+) -> AsyncGenerator[Browser, None]:
     browser = await browser_factory()
     yield browser
     await browser.close()
 
 
 @pytest.fixture
-async def context_factory(browser):
+async def context_factory(
+    browser: Browser,
+) -> AsyncGenerator["Callable[..., Awaitable[BrowserContext]]", None]:
     contexts = []
 
-    async def launch(**kwargs):
+    async def launch(**kwargs: Any) -> BrowserContext:
         context = await browser.new_context(**kwargs)
         contexts.append(context)
         return context
@@ -82,19 +101,21 @@ async def launch(**kwargs):
 
 
 @pytest.fixture
-async def context(context_factory):
+async def context(
+    context_factory: "Callable[..., asyncio.Future[BrowserContext]]",
+) -> AsyncGenerator[BrowserContext, None]:
     context = await context_factory()
     yield context
     await context.close()
 
 
 @pytest.fixture
-async def page(context):
+async def page(context: BrowserContext) -> AsyncGenerator[Page, None]:
     page = await context.new_page()
     yield page
     await page.close()
 
 
 @pytest.fixture(scope="session")
-def selectors(playwright):
+def selectors(playwright: Playwright) -> Selectors:
     return playwright.selectors
diff --git a/tests/async/test_accessibility.py b/tests/async/test_accessibility.py
index fa9a54b97..201ba8483 100644
--- a/tests/async/test_accessibility.py
+++ b/tests/async/test_accessibility.py
@@ -17,8 +17,12 @@
 
 import pytest
 
+from playwright.async_api import Page
 
-async def test_accessibility_should_work(page, is_firefox, is_chromium):
+
+async def test_accessibility_should_work(
+    page: Page, is_firefox: bool, is_chromium: bool
+) -> None:
     await page.set_content(
         """<head>
       <title>Accessibility Test</title>
@@ -109,54 +113,62 @@ async def test_accessibility_should_work(page, is_firefox, is_chromium):
     assert await page.accessibility.snapshot() == golden
 
 
-async def test_accessibility_should_work_with_regular_text(page, is_firefox):
+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):
+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):
+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):
+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):
+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):
+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, is_firefox
-):
+    page: Page, is_firefox: bool
+) -> None:
     await page.set_content(
         """
     <div role="tablist">
@@ -179,13 +191,14 @@ async def test_accessibility_filtering_children_of_leaf_nodes_should_not_report_
 # 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, browser_channel
-):
+    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": "",
@@ -196,13 +209,14 @@ async def test_accessibility_plain_text_field_with_role_should_not_have_children
 
 @pytest.mark.only_browser("chromium")
 async def test_accessibility_plain_text_field_without_role_should_not_have_content(
-    page, browser_channel
-):
+    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",
@@ -212,13 +226,14 @@ async def test_accessibility_plain_text_field_without_role_should_not_have_conte
 
 @pytest.mark.only_browser("chromium")
 async def test_accessibility_plain_text_field_with_tabindex_and_without_role_should_not_have_content(
-    page, browser_channel
-):
+    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",
@@ -227,8 +242,8 @@ async def test_accessibility_plain_text_field_with_tabindex_and_without_role_sho
 
 
 async def test_accessibility_non_editable_textbox_with_role_and_tabIndex_and_label_should_not_have_children(
-    page, is_chromium, is_firefox
-):
+    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">
@@ -255,12 +270,13 @@ async def test_accessibility_non_editable_textbox_with_role_and_tabIndex_and_lab
             "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: Page,
+) -> None:
     await page.set_content(
         """
     <div role="checkbox" tabIndex=0 aria-checked="true" aria-label="my favorite checkbox">
@@ -270,12 +286,13 @@ async def test_accessibility_checkbox_with_and_tabIndex_and_label_should_not_hav
     )
     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, is_firefox
-):
+    page: Page, is_firefox: bool
+) -> None:
     await page.set_content(
         """
       <div role="checkbox" aria-checked="true">
@@ -289,10 +306,11 @@ async def test_accessibility_checkbox_without_label_should_not_have_children(
         "checked": True,
     }
     snapshot = await page.accessibility.snapshot()
+    assert snapshot
     assert snapshot["children"][0] == golden
 
 
-async def test_accessibility_should_work_a_button(page):
+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")
@@ -302,7 +320,7 @@ async def test_accessibility_should_work_a_button(page):
     }
 
 
-async def test_accessibility_should_work_an_input(page):
+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")
@@ -313,9 +331,7 @@ async def test_accessibility_should_work_an_input(page):
     }
 
 
-async def test_accessibility_should_work_on_a_menu(
-    page, is_webkit, is_chromium, browser_channel
-):
+async def test_accessibility_should_work_on_a_menu(page: Page) -> None:
     await page.set_content(
         """
         <div role="menu" title="My Menu">
@@ -345,15 +361,15 @@ async def test_accessibility_should_work_on_a_menu(
 
 
 async def test_accessibility_should_return_null_when_the_element_is_no_longer_in_DOM(
-    page,
-):
+    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):
+async def test_accessibility_should_show_uninteresting_nodes(page: Page) -> None:
     await page.set_content(
         """
         <div id="root" role="textbox">
@@ -369,6 +385,7 @@ async def test_accessibility_should_show_uninteresting_nodes(page):
 
     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"]
diff --git a/tests/async/test_add_init_script.py b/tests/async/test_add_init_script.py
index 07279f5a1..33853780a 100644
--- a/tests/async/test_add_init_script.py
+++ b/tests/async/test_add_init_script.py
@@ -12,37 +12,45 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from playwright.async_api import Error
+from pathlib import Path
+from typing import Optional
 
+from playwright.async_api import BrowserContext, Error, Page
 
-async def test_add_init_script_evaluate_before_anything_else_on_the_page(page):
+
+async def test_add_init_script_evaluate_before_anything_else_on_the_page(
+    page: Page,
+) -> None:
     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
 
 
-async def test_add_init_script_work_with_a_path(page, assetdir):
+async def test_add_init_script_work_with_a_path(page: Page, assetdir: Path) -> None:
     await page.add_init_script(path=assetdir / "injectedfile.js")
     await page.goto("data:text/html,<script>window.result = window.injected</script>")
     assert await page.evaluate("window.result") == 123
 
 
-async def test_add_init_script_work_with_content(page):
+async def test_add_init_script_work_with_content(page: Page) -> None:
     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
 
 
-async def test_add_init_script_throw_without_path_and_content(page):
-    error = None
+async def test_add_init_script_throw_without_path_and_content(page: Page) -> None:
+    error: Optional[Error] = None
     try:
-        await page.add_init_script({"foo": "bar"})
+        await page.add_init_script({"foo": "bar"})  # type: ignore
     except Error as e:
         error = e
+    assert error
     assert error.message == "Either path or script parameter must be specified"
 
 
-async def test_add_init_script_work_with_browser_context_scripts(page, context):
+async def test_add_init_script_work_with_browser_context_scripts(
+    page: Page, context: BrowserContext
+) -> None:
     await context.add_init_script("window.temp = 123")
     page = await context.new_page()
     await page.add_init_script("window.injected = window.temp")
@@ -51,8 +59,8 @@ async def test_add_init_script_work_with_browser_context_scripts(page, context):
 
 
 async def test_add_init_script_work_with_browser_context_scripts_with_a_path(
-    page, context, assetdir
-):
+    page: Page, context: BrowserContext, assetdir: Path
+) -> None:
     await context.add_init_script(path=assetdir / "injectedfile.js")
     page = await context.new_page()
     await page.goto("data:text/html,<script>window.result = window.injected</script>")
@@ -60,15 +68,15 @@ async def test_add_init_script_work_with_browser_context_scripts_with_a_path(
 
 
 async def test_add_init_script_work_with_browser_context_scripts_for_already_created_pages(
-    page, context
-):
+    page: Page, context: BrowserContext
+) -> None:
     await context.add_init_script("window.temp = 123")
     await page.add_init_script("window.injected = window.temp")
     await page.goto("data:text/html,<script>window.result = window.injected</script>")
     assert await page.evaluate("window.result") == 123
 
 
-async def test_add_init_script_support_multiple_scripts(page):
+async def test_add_init_script_support_multiple_scripts(page: Page) -> None:
     await page.add_init_script("window.script1 = 1")
     await page.add_init_script("window.script2 = 2")
     await page.goto("data:text/html,<script>window.result = window.injected</script>")
@@ -76,7 +84,7 @@ async def test_add_init_script_support_multiple_scripts(page):
     assert await page.evaluate("window.script2") == 2
 
 
-async def test_should_work_with_trailing_comments(page):
+async def test_should_work_with_trailing_comments(page: Page) -> None:
     await page.add_init_script("// comment")
     await page.add_init_script("window.secret = 42;")
     await page.goto("data:text/html,<html></html>")
diff --git a/tests/async/test_asyncio.py b/tests/async/test_asyncio.py
index f1def84d3..084d9eb41 100644
--- a/tests/async/test_asyncio.py
+++ b/tests/async/test_asyncio.py
@@ -24,10 +24,10 @@
 
 async def test_should_cancel_underlying_protocol_calls(
     browser_name: str, launch_arguments: Dict
-):
+) -> None:
     handler_exception = None
 
-    def exception_handlerdler(loop, context) -> None:
+    def exception_handlerdler(loop: asyncio.AbstractEventLoop, context: Dict) -> None:
         nonlocal handler_exception
         handler_exception = context["exception"]
 
@@ -70,8 +70,9 @@ async def test_cancel_pending_protocol_call_on_playwright_stop(server: Server) -
 
 
 async def test_should_collect_stale_handles(page: Page, server: Server) -> None:
-    page.on("request", lambda: None)
+    page.on("request", lambda _: None)
     response = await page.goto(server.PREFIX + "/title.html")
+    assert response
     for i in range(1000):
         await page.evaluate(
             """async () => {
diff --git a/tests/async/test_browser.py b/tests/async/test_browser.py
index 17bfb5b2f..e23b3439b 100644
--- a/tests/async/test_browser.py
+++ b/tests/async/test_browser.py
@@ -16,10 +16,10 @@
 
 import pytest
 
-from playwright.async_api import Browser, Error
+from playwright.async_api import Browser, BrowserType, Error
 
 
-async def test_should_create_new_page(browser):
+async def test_should_create_new_page(browser: Browser) -> None:
     page1 = await browser.new_page()
     assert len(browser.contexts) == 1
 
@@ -33,7 +33,7 @@ async def test_should_create_new_page(browser):
     assert len(browser.contexts) == 0
 
 
-async def test_should_throw_upon_second_create_new_page(browser):
+async def test_should_throw_upon_second_create_new_page(browser: Browser) -> None:
     page = await browser.new_page()
     with pytest.raises(Error) as exc:
         await page.context.new_page()
@@ -41,7 +41,7 @@ async def test_should_throw_upon_second_create_new_page(browser):
     assert "Please use browser.new_context()" in exc.value.message
 
 
-async def test_version_should_work(browser: Browser, is_chromium):
+async def test_version_should_work(browser: Browser, is_chromium: bool) -> None:
     version = browser.version
     if is_chromium:
         assert re.match(r"^\d+\.\d+\.\d+\.\d+$", version)
@@ -49,5 +49,7 @@ async def test_version_should_work(browser: Browser, is_chromium):
         assert re.match(r"^\d+\.\d+", version)
 
 
-async def test_should_return_browser_type(browser, browser_type):
+async def test_should_return_browser_type(
+    browser: Browser, browser_type: BrowserType
+) -> None:
     assert browser.browser_type is browser_type
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index 59670340a..23fbd27de 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -14,16 +14,28 @@
 
 import asyncio
 import re
+from typing import Any, List
 from urllib.parse import urlparse
 
 import pytest
 
-from playwright.async_api import Browser, Error
+from playwright.async_api import (
+    Browser,
+    BrowserContext,
+    Error,
+    JSHandle,
+    Page,
+    Playwright,
+    Request,
+    Route,
+)
 from tests.server import Server
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
+from .utils import Utils
 
-async def test_page_event_should_create_new_context(browser):
+
+async def test_page_event_should_create_new_context(browser: Browser) -> None:
     assert len(browser.contexts) == 0
     context = await browser.new_context()
     assert len(browser.contexts) == 1
@@ -33,7 +45,9 @@ async def test_page_event_should_create_new_context(browser):
     assert context.browser == browser
 
 
-async def test_window_open_should_use_parent_tab_context(browser, server):
+async def test_window_open_should_use_parent_tab_context(
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context()
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
@@ -44,7 +58,9 @@ async def test_window_open_should_use_parent_tab_context(browser, server):
     await context.close()
 
 
-async def test_page_event_should_isolate_localStorage_and_cookies(browser, server):
+async def test_page_event_should_isolate_localStorage_and_cookies(
+    browser: Browser, server: Server
+) -> None:
     # Create two incognito contexts.
     context1 = await browser.new_context()
     context2 = await browser.new_context()
@@ -90,14 +106,16 @@ async def test_page_event_should_isolate_localStorage_and_cookies(browser, serve
     assert browser.contexts == []
 
 
-async def test_page_event_should_propagate_default_viewport_to_the_page(browser, utils):
+async def test_page_event_should_propagate_default_viewport_to_the_page(
+    browser: Browser, utils: Utils
+) -> None:
     context = await browser.new_context(viewport={"width": 456, "height": 789})
     page = await context.new_page()
     await utils.verify_viewport(page, 456, 789)
     await context.close()
 
 
-async def test_page_event_should_respect_device_scale_factor(browser):
+async def test_page_event_should_respect_device_scale_factor(browser: Browser) -> None:
     context = await browser.new_context(device_scale_factor=3)
     page = await context.new_page()
     assert await page.evaluate("window.devicePixelRatio") == 3
@@ -105,8 +123,8 @@ async def test_page_event_should_respect_device_scale_factor(browser):
 
 
 async def test_page_event_should_not_allow_device_scale_factor_with_null_viewport(
-    browser,
-):
+    browser: Browser,
+) -> None:
     with pytest.raises(Error) as exc_info:
         await browser.new_context(no_viewport=True, device_scale_factor=1)
     assert (
@@ -115,7 +133,9 @@ async def test_page_event_should_not_allow_device_scale_factor_with_null_viewpor
     )
 
 
-async def test_page_event_should_not_allow_is_mobile_with_null_viewport(browser):
+async def test_page_event_should_not_allow_is_mobile_with_null_viewport(
+    browser: Browser,
+) -> None:
     with pytest.raises(Error) as exc_info:
         await browser.new_context(no_viewport=True, is_mobile=True)
     assert (
@@ -124,12 +144,12 @@ async def test_page_event_should_not_allow_is_mobile_with_null_viewport(browser)
     )
 
 
-async def test_close_should_work_for_empty_context(browser):
+async def test_close_should_work_for_empty_context(browser: Browser) -> None:
     context = await browser.new_context()
     await context.close()
 
 
-async def test_close_should_abort_wait_for_event(browser):
+async def test_close_should_abort_wait_for_event(browser: Browser) -> None:
     context = await browser.new_context()
     with pytest.raises(Error) as exc_info:
         async with context.expect_page():
@@ -137,7 +157,7 @@ async def test_close_should_abort_wait_for_event(browser):
     assert TARGET_CLOSED_ERROR_MESSAGE in exc_info.value.message
 
 
-async def test_close_should_be_callable_twice(browser):
+async def test_close_should_be_callable_twice(browser: Browser) -> None:
     context = await browser.new_context()
     await asyncio.gather(
         context.close(),
@@ -146,8 +166,8 @@ async def test_close_should_be_callable_twice(browser):
     await context.close()
 
 
-async def test_user_agent_should_work(browser, server):
-    async def baseline():
+async def test_user_agent_should_work(browser: Browser, server: Server) -> None:
+    async def baseline() -> None:
         context = await browser.new_context()
         page = await context.new_page()
         assert "Mozilla" in await page.evaluate("navigator.userAgent")
@@ -155,7 +175,7 @@ async def baseline():
 
     await baseline()
 
-    async def override():
+    async def override() -> None:
         context = await browser.new_context(user_agent="foobar")
         page = await context.new_page()
         [request, _] = await asyncio.gather(
@@ -168,7 +188,9 @@ async def override():
     await override()
 
 
-async def test_user_agent_should_work_for_subframes(browser, server, utils):
+async def test_user_agent_should_work_for_subframes(
+    browser: Browser, server: Server, utils: Utils
+) -> None:
     context = await browser.new_context(user_agent="foobar")
     page = await context.new_page()
     [request, _] = await asyncio.gather(
@@ -179,7 +201,9 @@ async def test_user_agent_should_work_for_subframes(browser, server, utils):
     await context.close()
 
 
-async def test_user_agent_should_emulate_device_user_agent(playwright, browser, server):
+async def test_user_agent_should_emulate_device_user_agent(
+    playwright: Playwright, browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(
         user_agent=playwright.devices["iPhone 6"]["user_agent"]
     )
@@ -189,8 +213,10 @@ async def test_user_agent_should_emulate_device_user_agent(playwright, browser,
     await context.close()
 
 
-async def test_user_agent_should_make_a_copy_of_default_options(browser, server):
-    options = {"user_agent": "foobar"}
+async def test_user_agent_should_make_a_copy_of_default_options(
+    browser: Browser, server: Server
+) -> None:
+    options: Any = {"user_agent": "foobar"}
     context = await browser.new_context(**options)
     options["user_agent"] = "wrong"
     page = await context.new_page()
@@ -202,8 +228,10 @@ async def test_user_agent_should_make_a_copy_of_default_options(browser, server)
     await context.close()
 
 
-async def test_page_event_should_bypass_csp_meta_tag(browser, server):
-    async def baseline():
+async def test_page_event_should_bypass_csp_meta_tag(
+    browser: Browser, server: Server
+) -> None:
+    async def baseline() -> None:
         context = await browser.new_context()
         page = await context.new_page()
         await page.goto(server.PREFIX + "/csp.html")
@@ -217,7 +245,7 @@ async def baseline():
     await baseline()
 
     # By-pass CSP and try one more time.
-    async def override():
+    async def override() -> None:
         context = await browser.new_context(bypass_csp=True)
         page = await context.new_page()
         await page.goto(server.PREFIX + "/csp.html")
@@ -228,11 +256,13 @@ async def override():
     await override()
 
 
-async def test_page_event_should_bypass_csp_header(browser, server):
+async def test_page_event_should_bypass_csp_header(
+    browser: Browser, server: Server
+) -> None:
     # Make sure CSP prohibits add_script_tag.
     server.set_csp("/empty.html", 'default-src "self"')
 
-    async def baseline():
+    async def baseline() -> None:
         context = await browser.new_context()
         page = await context.new_page()
         await page.goto(server.EMPTY_PAGE)
@@ -246,7 +276,7 @@ async def baseline():
     await baseline()
 
     # By-pass CSP and try one more time.
-    async def override():
+    async def override() -> None:
         context = await browser.new_context(bypass_csp=True)
         page = await context.new_page()
         await page.goto(server.EMPTY_PAGE)
@@ -257,7 +287,9 @@ async def override():
     await override()
 
 
-async def test_page_event_should_bypass_after_cross_process_navigation(browser, server):
+async def test_page_event_should_bypass_after_cross_process_navigation(
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(bypass_csp=True)
     page = await context.new_page()
     await page.goto(server.PREFIX + "/csp.html")
@@ -270,8 +302,10 @@ async def test_page_event_should_bypass_after_cross_process_navigation(browser,
     await context.close()
 
 
-async def test_page_event_should_bypass_csp_in_iframes_as_well(browser, server, utils):
-    async def baseline():
+async def test_page_event_should_bypass_csp_in_iframes_as_well(
+    browser: Browser, server: Server, utils: Utils
+) -> None:
+    async def baseline() -> None:
         # Make sure CSP prohibits add_script_tag in an iframe.
         context = await browser.new_context()
         page = await context.new_page()
@@ -287,7 +321,7 @@ async def baseline():
     await baseline()
 
     # By-pass CSP and try one more time.
-    async def override():
+    async def override() -> None:
         context = await browser.new_context(bypass_csp=True)
         page = await context.new_page()
         await page.goto(server.EMPTY_PAGE)
@@ -302,8 +336,8 @@ async def override():
     await override()
 
 
-async def test_csp_should_work(browser, is_webkit):
-    async def baseline():
+async def test_csp_should_work(browser: Browser, is_webkit: bool) -> None:
+    async def baseline() -> None:
         context = await browser.new_context(java_script_enabled=False)
         page = await context.new_page()
         await page.goto('data:text/html, <script>var something = "forbidden"</script>')
@@ -317,7 +351,7 @@ async def baseline():
 
     await baseline()
 
-    async def override():
+    async def override() -> None:
         context = await browser.new_context()
         page = await context.new_page()
         await page.goto('data:text/html, <script>var something = "forbidden"</script>')
@@ -328,15 +362,17 @@ async def override():
 
 
 async def test_csp_should_be_able_to_navigate_after_disabling_javascript(
-    browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(java_script_enabled=False)
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     await context.close()
 
 
-async def test_pages_should_return_all_of_the_pages(context, server):
+async def test_pages_should_return_all_of_the_pages(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     second = await context.new_page()
     all_pages = context.pages
@@ -345,17 +381,19 @@ async def test_pages_should_return_all_of_the_pages(context, server):
     assert second in all_pages
 
 
-async def test_pages_should_close_all_belonging_pages_once_closing_context(context):
+async def test_pages_should_close_all_belonging_pages_once_closing_context(
+    context: BrowserContext,
+) -> None:
     await context.new_page()
     assert len(context.pages) == 1
     await context.close()
     assert context.pages == []
 
 
-async def test_expose_binding_should_work(context):
+async def test_expose_binding_should_work(context: BrowserContext) -> None:
     binding_source = []
 
-    def binding(source, a, b):
+    def binding(source: Any, a: int, b: int) -> int:
         binding_source.append(source)
         return a + b
 
@@ -369,7 +407,7 @@ def binding(source, a, b):
     assert result == 11
 
 
-async def test_expose_function_should_work(context):
+async def test_expose_function_should_work(context: BrowserContext) -> None:
     await context.expose_function("add", lambda a, b: a + b)
     page = await context.new_page()
     await page.expose_function("mul", lambda a, b: a * b)
@@ -384,8 +422,8 @@ async def test_expose_function_should_work(context):
 
 
 async def test_expose_function_should_throw_for_duplicate_registrations(
-    context, server
-):
+    context: BrowserContext, server: Server
+) -> None:
     await context.expose_function("foo", lambda: None)
     await context.expose_function("bar", lambda: None)
     with pytest.raises(Error) as exc_info:
@@ -408,8 +446,8 @@ async def test_expose_function_should_throw_for_duplicate_registrations(
 
 
 async def test_expose_function_should_be_callable_from_inside_add_init_script(
-    context, server
-):
+    context: BrowserContext, server: Server
+) -> None:
     args = []
     await context.expose_function("woof", lambda arg: args.append(arg))
     await context.add_init_script("woof('context')")
@@ -422,10 +460,10 @@ async def test_expose_function_should_be_callable_from_inside_add_init_script(
     assert args == ["context", "page"]
 
 
-async def test_expose_bindinghandle_should_work(context):
-    targets = []
+async def test_expose_bindinghandle_should_work(context: BrowserContext) -> None:
+    targets: List[JSHandle] = []
 
-    def logme(t):
+    def logme(t: JSHandle) -> int:
         targets.append(t)
         return 17
 
@@ -436,16 +474,16 @@ def logme(t):
     assert result == 17
 
 
-async def test_route_should_intercept(context, server):
+async def test_route_should_intercept(context: BrowserContext, server: Server) -> None:
     intercepted = []
 
-    def handle(route, request):
+    def handle(route: Route, request: Request) -> None:
         intercepted.append(True)
         assert "empty.html" in request.url
         assert request.headers["user-agent"]
         assert request.method == "GET"
         assert request.post_data is None
-        assert request.is_navigation_request
+        assert request.is_navigation_request()
         assert request.resource_type == "document"
         assert request.frame == page.main_frame
         assert request.frame.url == "about:blank"
@@ -454,17 +492,18 @@ def handle(route, request):
     await context.route("**/empty.html", lambda route, request: handle(route, request))
     page = await context.new_page()
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.ok
     assert intercepted == [True]
     await context.close()
 
 
-async def test_route_should_unroute(context, server):
+async def test_route_should_unroute(context: BrowserContext, server: Server) -> None:
     page = await context.new_page()
 
-    intercepted = []
+    intercepted: List[int] = []
 
-    def handler(route, request, ordinal):
+    def handler(route: Route, request: Request, ordinal: int) -> None:
         intercepted.append(ordinal)
         asyncio.create_task(route.continue_())
 
@@ -476,7 +515,7 @@ def handler(route, request, ordinal):
         "**/empty.html", lambda route, request: handler(route, request, 3)
     )
 
-    def handler4(route, request):
+    def handler4(route: Route, request: Request) -> None:
         handler(route, request, 4)
 
     await context.route(re.compile("empty.html"), handler4)
@@ -495,7 +534,9 @@ def handler4(route, request):
     assert intercepted == [1]
 
 
-async def test_route_should_yield_to_page_route(context, server):
+async def test_route_should_yield_to_page_route(
+    context: BrowserContext, server: Server
+) -> None:
     await context.route(
         "**/empty.html",
         lambda route, request: asyncio.create_task(
@@ -512,11 +553,14 @@ async def test_route_should_yield_to_page_route(context, server):
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.ok
     assert await response.text() == "page"
 
 
-async def test_route_should_fall_back_to_context_route(context, server):
+async def test_route_should_fall_back_to_context_route(
+    context: BrowserContext, server: Server
+) -> None:
     await context.route(
         "**/empty.html",
         lambda route, request: asyncio.create_task(
@@ -533,46 +577,59 @@ async def test_route_should_fall_back_to_context_route(context, server):
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.ok
     assert await response.text() == "context"
 
 
-async def test_auth_should_fail_without_credentials(context, server):
+async def test_auth_should_fail_without_credentials(
+    context: BrowserContext, server: Server
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     page = await context.new_page()
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 401
 
 
-async def test_auth_should_work_with_correct_credentials(browser, server):
+async def test_auth_should_work_with_correct_credentials(
+    browser: Browser, server: Server
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     context = await browser.new_context(
         http_credentials={"username": "user", "password": "pass"}
     )
     page = await context.new_page()
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 200
     await context.close()
 
 
-async def test_auth_should_fail_with_wrong_credentials(browser, server):
+async def test_auth_should_fail_with_wrong_credentials(
+    browser: Browser, server: Server
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     context = await browser.new_context(
         http_credentials={"username": "foo", "password": "bar"}
     )
     page = await context.new_page()
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 401
     await context.close()
 
 
-async def test_auth_should_return_resource_body(browser, server):
+async def test_auth_should_return_resource_body(
+    browser: Browser, server: Server
+) -> None:
     server.set_auth("/playground.html", "user", "pass")
     context = await browser.new_context(
         http_credentials={"username": "user", "password": "pass"}
     )
     page = await context.new_page()
     response = await page.goto(server.PREFIX + "/playground.html")
+    assert response
     assert response.status == 200
     assert await page.title() == "Playground"
     assert "Playground" in await response.text()
@@ -580,8 +637,8 @@ async def test_auth_should_return_resource_body(browser, server):
 
 
 async def test_should_work_with_correct_credentials_and_matching_origin(
-    browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     context = await browser.new_context(
         http_credentials={
@@ -592,13 +649,14 @@ async def test_should_work_with_correct_credentials_and_matching_origin(
     )
     page = await context.new_page()
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 200
     await context.close()
 
 
 async def test_should_work_with_correct_credentials_and_matching_origin_case_insensitive(
-    browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     context = await browser.new_context(
         http_credentials={
@@ -609,13 +667,14 @@ async def test_should_work_with_correct_credentials_and_matching_origin_case_ins
     )
     page = await context.new_page()
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 200
     await context.close()
 
 
 async def test_should_fail_with_correct_credentials_and_mismatching_scheme(
-    browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     context = await browser.new_context(
         http_credentials={
@@ -626,28 +685,31 @@ async def test_should_fail_with_correct_credentials_and_mismatching_scheme(
     )
     page = await context.new_page()
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 401
     await context.close()
 
 
 async def test_should_fail_with_correct_credentials_and_mismatching_hostname(
-    browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     hostname = urlparse(server.PREFIX).hostname
+    assert hostname
     origin = server.PREFIX.replace(hostname, "mismatching-hostname")
     context = await browser.new_context(
         http_credentials={"username": "user", "password": "pass", "origin": origin}
     )
     page = await context.new_page()
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 401
     await context.close()
 
 
 async def test_should_fail_with_correct_credentials_and_mismatching_port(
-    browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     origin = server.PREFIX.replace(str(server.PORT), str(server.PORT + 1))
     context = await browser.new_context(
@@ -655,11 +717,14 @@ async def test_should_fail_with_correct_credentials_and_mismatching_port(
     )
     page = await context.new_page()
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 401
     await context.close()
 
 
-async def test_offline_should_work_with_initial_option(browser, server):
+async def test_offline_should_work_with_initial_option(
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(offline=True)
     page = await context.new_page()
     with pytest.raises(Error) as exc_info:
@@ -667,11 +732,14 @@ async def test_offline_should_work_with_initial_option(browser, server):
     assert exc_info.value
     await context.set_offline(False)
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 200
     await context.close()
 
 
-async def test_offline_should_emulate_navigator_online(context, server):
+async def test_offline_should_emulate_navigator_online(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     assert await page.evaluate("window.navigator.onLine")
     await context.set_offline(True)
@@ -680,7 +748,9 @@ async def test_offline_should_emulate_navigator_online(context, server):
     assert await page.evaluate("window.navigator.onLine")
 
 
-async def test_page_event_should_have_url(context, server):
+async def test_page_event_should_have_url(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     async with context.expect_page() as other_page_info:
         await page.evaluate("url => window.open(url)", server.EMPTY_PAGE)
@@ -688,7 +758,9 @@ async def test_page_event_should_have_url(context, server):
     assert other_page.url == server.EMPTY_PAGE
 
 
-async def test_page_event_should_have_url_after_domcontentloaded(context, server):
+async def test_page_event_should_have_url_after_domcontentloaded(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     async with context.expect_page() as other_page_info:
         await page.evaluate("url => window.open(url)", server.EMPTY_PAGE)
@@ -698,8 +770,8 @@ async def test_page_event_should_have_url_after_domcontentloaded(context, server
 
 
 async def test_page_event_should_have_about_blank_url_with_domcontentloaded(
-    context, server
-):
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     async with context.expect_page() as other_page_info:
         await page.evaluate("url => window.open(url)", "about:blank")
@@ -709,8 +781,8 @@ async def test_page_event_should_have_about_blank_url_with_domcontentloaded(
 
 
 async def test_page_event_should_have_about_blank_for_empty_url_with_domcontentloaded(
-    context, server
-):
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     async with context.expect_page() as other_page_info:
         await page.evaluate("window.open()")
@@ -720,8 +792,8 @@ async def test_page_event_should_have_about_blank_for_empty_url_with_domcontentl
 
 
 async def test_page_event_should_report_when_a_new_page_is_created_and_closed(
-    context, server
-):
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     async with context.expect_page() as page_info:
         await page.evaluate(
@@ -739,7 +811,7 @@ async def test_page_event_should_report_when_a_new_page_is_created_and_closed(
     assert other_page in all_pages
 
     close_event_received = []
-    other_page.once("close", lambda: close_event_received.append(True))
+    other_page.once("close", lambda _: close_event_received.append(True))
     await other_page.close()
     assert close_event_received == [True]
 
@@ -748,7 +820,9 @@ async def test_page_event_should_report_when_a_new_page_is_created_and_closed(
     assert other_page not in all_pages
 
 
-async def test_page_event_should_report_initialized_pages(context, server):
+async def test_page_event_should_report_initialized_pages(
+    context: BrowserContext, server: Server
+) -> None:
     async with context.expect_page() as page_info:
         await context.new_page()
     new_page = await page_info.value
@@ -760,7 +834,9 @@ async def test_page_event_should_report_initialized_pages(context, server):
     assert popup.url == "about:blank"
 
 
-async def test_page_event_should_have_an_opener(context, server):
+async def test_page_event_should_have_an_opener(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     async with context.expect_page() as page_info:
@@ -771,12 +847,14 @@ async def test_page_event_should_have_an_opener(context, server):
     assert await page.opener() is None
 
 
-async def test_page_event_should_fire_page_lifecycle_events(context, server):
-    events = []
+async def test_page_event_should_fire_page_lifecycle_events(
+    context: BrowserContext, server: Server
+) -> None:
+    events: List[str] = []
 
-    def handle_page(page):
+    def handle_page(page: Page) -> None:
         events.append("CREATED: " + page.url)
-        page.on("close", lambda: events.append("DESTROYED: " + page.url))
+        page.on("close", lambda _: events.append("DESTROYED: " + page.url))
 
     context.on("page", handle_page)
 
@@ -787,7 +865,9 @@ def handle_page(page):
 
 
 @pytest.mark.skip_browser("webkit")
-async def test_page_event_should_work_with_shift_clicking(context, server):
+async def test_page_event_should_work_with_shift_clicking(
+    context: BrowserContext, server: Server
+) -> None:
     # WebKit: Shift+Click does not open a new window.
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
@@ -799,7 +879,9 @@ async def test_page_event_should_work_with_shift_clicking(context, server):
 
 
 @pytest.mark.only_browser("chromium")
-async def test_page_event_should_work_with_ctrl_clicking(context, server, is_mac):
+async def test_page_event_should_work_with_ctrl_clicking(
+    context: BrowserContext, server: Server, is_mac: bool
+) -> None:
     # Firefox: reports an opener in this case.
     # WebKit: Ctrl+Click does not open a new tab.
     page = await context.new_page()
@@ -811,7 +893,7 @@ async def test_page_event_should_work_with_ctrl_clicking(context, server, is_mac
     assert await popup.opener() is None
 
 
-async def test_strict_selectors_on_context(browser: Browser, server: Server):
+async def test_strict_selectors_on_context(browser: Browser, server: Server) -> None:
     context = await browser.new_context(strict_selectors=True)
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
@@ -829,7 +911,7 @@ async def test_strict_selectors_on_context(browser: Browser, server: Server):
 
 
 @pytest.mark.skip_browser("webkit")  # https://bugs.webkit.org/show_bug.cgi?id=225281
-async def test_should_support_forced_colors(browser: Browser):
+async def test_should_support_forced_colors(browser: Browser) -> None:
     context = await browser.new_context(forced_colors="active")
     page = await context.new_page()
     assert await page.evaluate("matchMedia('(forced-colors: active)').matches")
diff --git a/tests/async/test_browsercontext_add_cookies.py b/tests/async/test_browsercontext_add_cookies.py
index 6ce2e6088..744e989d1 100644
--- a/tests/async/test_browsercontext_add_cookies.py
+++ b/tests/async/test_browsercontext_add_cookies.py
@@ -14,13 +14,16 @@
 
 import asyncio
 import datetime
+from typing import Callable, List
 
 import pytest
 
-from playwright.async_api import Error
+from playwright.async_api import Browser, BrowserContext, Error, Page
+from tests.server import HttpRequestWithPostBody, Server
+from tests.utils import must
 
 
-async def test_should_work(context, page, server):
+async def test_should_work(context: BrowserContext, page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await context.add_cookies(
         [{"url": server.EMPTY_PAGE, "name": "password", "value": "123456"}]
@@ -28,7 +31,9 @@ async def test_should_work(context, page, server):
     assert await page.evaluate("() => document.cookie") == "password=123456"
 
 
-async def test_should_roundtrip_cookie(context, page, server):
+async def test_should_roundtrip_cookie(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     # @see https://en.wikipedia.org/wiki/Year_2038_problem
     date = int(datetime.datetime(2038, 1, 1).timestamp() * 1000)
@@ -48,11 +53,13 @@ async def test_should_roundtrip_cookie(context, page, server):
     assert await context.cookies() == cookies
 
 
-async def test_should_send_cookie_header(server, context):
-    cookie = []
+async def test_should_send_cookie_header(
+    server: Server, context: BrowserContext
+) -> None:
+    cookie: List[str] = []
 
-    def handler(request):
-        cookie.extend(request.requestHeaders.getRawHeaders("cookie"))
+    def handler(request: HttpRequestWithPostBody) -> None:
+        cookie.extend(must(request.requestHeaders.getRawHeaders("cookie")))
         request.finish()
 
     server.set_route("/empty.html", handler)
@@ -64,7 +71,9 @@ def handler(request):
     assert cookie == ["cookie=value"]
 
 
-async def test_should_isolate_cookies_in_browser_contexts(context, server, browser):
+async def test_should_isolate_cookies_in_browser_contexts(
+    context: BrowserContext, server: Server, browser: Browser
+) -> None:
     another_context = await browser.new_context()
     await context.add_cookies(
         [{"url": server.EMPTY_PAGE, "name": "isolatecookie", "value": "page1value"}]
@@ -84,7 +93,9 @@ async def test_should_isolate_cookies_in_browser_contexts(context, server, brows
     await another_context.close()
 
 
-async def test_should_isolate_session_cookies(context, server, browser):
+async def test_should_isolate_session_cookies(
+    context: BrowserContext, server: Server, browser: Browser
+) -> None:
     server.set_route(
         "/setcookie.html",
         lambda r: (
@@ -110,7 +121,9 @@ async def test_should_isolate_session_cookies(context, server, browser):
     await context_b.close()
 
 
-async def test_should_isolate_persistent_cookies(context, server, browser):
+async def test_should_isolate_persistent_cookies(
+    context: BrowserContext, server: Server, browser: Browser
+) -> None:
     server.set_route(
         "/setcookie.html",
         lambda r: (
@@ -136,10 +149,12 @@ async def test_should_isolate_persistent_cookies(context, server, browser):
     await context_2.close()
 
 
-async def test_should_isolate_send_cookie_header(server, context, browser):
-    cookie = []
+async def test_should_isolate_send_cookie_header(
+    server: Server, context: BrowserContext, browser: Browser
+) -> None:
+    cookie: List[str] = []
 
-    def handler(request):
+    def handler(request: HttpRequestWithPostBody) -> None:
         cookie.extend(request.requestHeaders.getRawHeaders("cookie") or [])
         request.finish()
 
@@ -161,7 +176,9 @@ def handler(request):
     await context_2.close()
 
 
-async def test_should_isolate_cookies_between_launches(browser_factory, server):
+async def test_should_isolate_cookies_between_launches(
+    browser_factory: Callable[..., "asyncio.Future[Browser]"], server: Server
+) -> None:
     browser_1 = await browser_factory()
     context_1 = await browser_1.new_context()
     await context_1.add_cookies(
@@ -183,7 +200,9 @@ async def test_should_isolate_cookies_between_launches(browser_factory, server):
     await browser_2.close()
 
 
-async def test_should_set_multiple_cookies(context, page, server):
+async def test_should_set_multiple_cookies(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await context.add_cookies(
         [
@@ -202,7 +221,9 @@ async def test_should_set_multiple_cookies(context, page, server):
     )
 
 
-async def test_should_have_expires_set_to_neg_1_for_session_cookies(context, server):
+async def test_should_have_expires_set_to_neg_1_for_session_cookies(
+    context: BrowserContext, server: Server
+) -> None:
     await context.add_cookies(
         [{"url": server.EMPTY_PAGE, "name": "expires", "value": "123456"}]
     )
@@ -210,7 +231,9 @@ async def test_should_have_expires_set_to_neg_1_for_session_cookies(context, ser
     assert cookies[0]["expires"] == -1
 
 
-async def test_should_set_cookie_with_reasonable_defaults(context, server, is_chromium):
+async def test_should_set_cookie_with_reasonable_defaults(
+    context: BrowserContext, server: Server, is_chromium: bool
+) -> None:
     await context.add_cookies(
         [{"url": server.EMPTY_PAGE, "name": "defaults", "value": "123456"}]
     )
@@ -230,7 +253,9 @@ async def test_should_set_cookie_with_reasonable_defaults(context, server, is_ch
     ]
 
 
-async def test_should_set_a_cookie_with_a_path(context, page, server, is_chromium):
+async def test_should_set_a_cookie_with_a_path(
+    context: BrowserContext, page: Page, server: Server, is_chromium: bool
+) -> None:
     await page.goto(server.PREFIX + "/grid.html")
     await context.add_cookies(
         [
@@ -261,7 +286,9 @@ async def test_should_set_a_cookie_with_a_path(context, page, server, is_chromiu
     assert await page.evaluate("document.cookie") == "gridcookie=GRID"
 
 
-async def test_should_not_set_a_cookie_with_blank_page_url(context, server):
+async def test_should_not_set_a_cookie_with_blank_page_url(
+    context: BrowserContext, server: Server
+) -> None:
     with pytest.raises(Error) as exc_info:
         await context.add_cookies(
             [
@@ -275,7 +302,9 @@ async def test_should_not_set_a_cookie_with_blank_page_url(context, server):
     )
 
 
-async def test_should_not_set_a_cookie_on_a_data_url_page(context):
+async def test_should_not_set_a_cookie_on_a_data_url_page(
+    context: BrowserContext,
+) -> None:
     with pytest.raises(Error) as exc_info:
         await context.add_cookies(
             [
@@ -292,8 +321,8 @@ async def test_should_not_set_a_cookie_on_a_data_url_page(context):
 
 
 async def test_should_default_to_setting_secure_cookie_for_https_websites(
-    context, page, server
-):
+    context: BrowserContext, page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     SECURE_URL = "https://example.com"
     await context.add_cookies([{"url": SECURE_URL, "name": "foo", "value": "bar"}])
@@ -302,8 +331,8 @@ async def test_should_default_to_setting_secure_cookie_for_https_websites(
 
 
 async def test_should_be_able_to_set_unsecure_cookie_for_http_website(
-    context, page, server
-):
+    context: BrowserContext, page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     HTTP_URL = "http://example.com"
     await context.add_cookies([{"url": HTTP_URL, "name": "foo", "value": "bar"}])
@@ -312,8 +341,8 @@ async def test_should_be_able_to_set_unsecure_cookie_for_http_website(
 
 
 async def test_should_set_a_cookie_on_a_different_domain(
-    context, page, server, is_chromium
-):
+    context: BrowserContext, page: Page, server: Server, is_chromium: bool
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await context.add_cookies(
         [{"url": "https://www.example.com", "name": "example-cookie", "value": "best"}]
@@ -333,7 +362,9 @@ async def test_should_set_a_cookie_on_a_different_domain(
     ]
 
 
-async def test_should_set_cookies_for_a_frame(context, page, server):
+async def test_should_set_cookies_for_a_frame(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await context.add_cookies(
         [{"url": server.PREFIX, "name": "frame-cookie", "value": "value"}]
@@ -355,8 +386,12 @@ async def test_should_set_cookies_for_a_frame(context, page, server):
 
 
 async def test_should_not_block_third_party_cookies(
-    context, page, server, is_chromium, is_firefox
-):
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    is_chromium: bool,
+    is_firefox: bool,
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.evaluate(
         """src => {
diff --git a/tests/async/test_browsercontext_clearcookies.py b/tests/async/test_browsercontext_clearcookies.py
index 27e33126b..6b0f03283 100644
--- a/tests/async/test_browsercontext_clearcookies.py
+++ b/tests/async/test_browsercontext_clearcookies.py
@@ -12,8 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from playwright.async_api import Browser, BrowserContext, Page
+from tests.server import Server
 
-async def test_should_clear_cookies(context, page, server):
+
+async def test_should_clear_cookies(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await context.add_cookies(
         [{"url": server.EMPTY_PAGE, "name": "cookie1", "value": "1"}]
@@ -25,7 +30,9 @@ async def test_should_clear_cookies(context, page, server):
     assert await page.evaluate("document.cookie") == ""
 
 
-async def test_should_isolate_cookies_when_clearing(context, server, browser):
+async def test_should_isolate_cookies_when_clearing(
+    context: BrowserContext, server: Server, browser: Browser
+) -> None:
     another_context = await browser.new_context()
     await context.add_cookies(
         [{"url": server.EMPTY_PAGE, "name": "page1cookie", "value": "page1value"}]
diff --git a/tests/async/test_browsercontext_cookies.py b/tests/async/test_browsercontext_cookies.py
index b81037307..e99439507 100644
--- a/tests/async/test_browsercontext_cookies.py
+++ b/tests/async/test_browsercontext_cookies.py
@@ -16,12 +16,19 @@
 
 import pytest
 
+from playwright.async_api import BrowserContext, Page
+from tests.server import Server
 
-async def test_should_return_no_cookies_in_pristine_browser_context(context):
+
+async def test_should_return_no_cookies_in_pristine_browser_context(
+    context: BrowserContext,
+) -> None:
     assert await context.cookies() == []
 
 
-async def test_should_get_a_cookie(context, page, server, is_chromium):
+async def test_should_get_a_cookie(
+    context: BrowserContext, page: Page, server: Server, is_chromium: bool
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     document_cookie = await page.evaluate(
         """() => {
@@ -44,7 +51,9 @@ async def test_should_get_a_cookie(context, page, server, is_chromium):
     ]
 
 
-async def test_should_get_a_non_session_cookie(context, page, server, is_chromium):
+async def test_should_get_a_non_session_cookie(
+    context: BrowserContext, page: Page, server: Server, is_chromium: bool
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     # @see https://en.wikipedia.org/wiki/Year_2038_problem
     date = int(datetime.datetime(2038, 1, 1).timestamp() * 1000)
@@ -81,7 +90,9 @@ async def test_should_get_a_non_session_cookie(context, page, server, is_chromiu
     ]
 
 
-async def test_should_properly_report_httpOnly_cookie(context, page, server):
+async def test_should_properly_report_httpOnly_cookie(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
     server.set_route(
         "/empty.html",
         lambda r: (
@@ -97,8 +108,8 @@ async def test_should_properly_report_httpOnly_cookie(context, page, server):
 
 
 async def test_should_properly_report_strict_sameSite_cookie(
-    context, page, server, is_webkit, is_win
-):
+    context: BrowserContext, page: Page, server: Server, is_webkit: bool, is_win: bool
+) -> None:
     if is_webkit and is_win:
         pytest.skip()
 
@@ -116,8 +127,8 @@ async def test_should_properly_report_strict_sameSite_cookie(
 
 
 async def test_should_properly_report_lax_sameSite_cookie(
-    context, page, server, is_webkit, is_win
-):
+    context: BrowserContext, page: Page, server: Server, is_webkit: bool, is_win: bool
+) -> None:
     if is_webkit and is_win:
         pytest.skip()
 
@@ -134,7 +145,9 @@ async def test_should_properly_report_lax_sameSite_cookie(
     assert cookies[0]["sameSite"] == "Lax"
 
 
-async def test_should_get_multiple_cookies(context, page, server, is_chromium):
+async def test_should_get_multiple_cookies(
+    context: BrowserContext, page: Page, server: Server, is_chromium: bool
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     document_cookie = await page.evaluate(
         """() => {
@@ -170,7 +183,9 @@ async def test_should_get_multiple_cookies(context, page, server, is_chromium):
     ]
 
 
-async def test_should_get_cookies_from_multiple_urls(context, is_chromium):
+async def test_should_get_cookies_from_multiple_urls(
+    context: BrowserContext, is_chromium: bool
+) -> None:
     await context.add_cookies(
         [
             {"url": "https://foo.com", "name": "doggo", "value": "woofs"},
diff --git a/tests/async/test_browsercontext_events.py b/tests/async/test_browsercontext_events.py
index dd8642786..9cae739dc 100644
--- a/tests/async/test_browsercontext_events.py
+++ b/tests/async/test_browsercontext_events.py
@@ -13,10 +13,12 @@
 # limitations under the License.
 
 import asyncio
+from typing import Optional
 
 import pytest
 
-from playwright.sync_api import Page
+from playwright.async_api import Page
+from tests.utils import must
 
 from ..server import HttpRequestWithPostBody, Server
 
@@ -86,7 +88,7 @@ async def test_console_event_should_work_in_immediately_closed_popup(
 
 
 async def test_dialog_event_should_work1(page: Page) -> None:
-    prompt_task = None
+    prompt_task: Optional[asyncio.Future[str]] = None
 
     async def open_dialog() -> None:
         nonlocal prompt_task
@@ -101,11 +103,11 @@ async def open_dialog() -> None:
     assert dialog1.message == "hey?"
     assert dialog1.page == page
     await dialog1.accept("hello")
-    assert await prompt_task == "hello"
+    assert await must(prompt_task) == "hello"
 
 
 async def test_dialog_event_should_work_in_popup(page: Page) -> None:
-    prompt_task = None
+    prompt_task: Optional[asyncio.Future[str]] = None
 
     async def open_dialog() -> None:
         nonlocal prompt_task
@@ -121,7 +123,7 @@ async def open_dialog() -> None:
     assert dialog.message == "hey?"
     assert dialog.page == popup
     await dialog.accept("hello")
-    assert await prompt_task == "hello"
+    assert await must(prompt_task) == "hello"
 
 
 # console message from javascript: url is not reported at all
@@ -179,7 +181,7 @@ def handle_route(request: HttpRequestWithPostBody) -> None:
     assert dialog.page == popup
     await dialog.accept("hello")
     await promise
-    await popup.evaluate("window.result") == "hello"
+    assert await popup.evaluate("window.result") == "hello"
 
 
 async def test_console_event_should_work_with_context_manager(page: Page) -> None:
diff --git a/tests/async/test_browsercontext_proxy.py b/tests/async/test_browsercontext_proxy.py
index e76c59e1d..07f52a562 100644
--- a/tests/async/test_browsercontext_proxy.py
+++ b/tests/async/test_browsercontext_proxy.py
@@ -12,20 +12,29 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import asyncio
 import base64
+from typing import AsyncGenerator, Awaitable, Callable
 
 import pytest
 from flaky import flaky
 
+from playwright.async_api import Browser, BrowserContext
+from tests.server import HttpRequestWithPostBody, Server
+
 
 @pytest.fixture(scope="session")
-async def browser(browser_factory):
+async def browser(
+    browser_factory: "Callable[..., asyncio.Future[Browser]]",
+) -> AsyncGenerator[Browser, None]:
     browser = await browser_factory(proxy={"server": "dummy"})
     yield browser
     await browser.close()
 
 
-async def test_should_use_proxy(context_factory, server):
+async def test_should_use_proxy(
+    context_factory: "Callable[..., asyncio.Future[BrowserContext]]", server: Server
+) -> None:
     server.set_route(
         "/target.html",
         lambda r: (
@@ -39,7 +48,9 @@ async def test_should_use_proxy(context_factory, server):
     assert await page.title() == "Served by the proxy"
 
 
-async def test_should_use_proxy_for_second_page(context_factory, server):
+async def test_should_use_proxy_for_second_page(
+    context_factory: "Callable[..., Awaitable[BrowserContext]]", server: Server
+) -> None:
     server.set_route(
         "/target.html",
         lambda r: (
@@ -58,7 +69,9 @@ async def test_should_use_proxy_for_second_page(context_factory, server):
     assert await page2.title() == "Served by the proxy"
 
 
-async def test_should_work_with_ip_port_notion(context_factory, server):
+async def test_should_work_with_ip_port_notion(
+    context_factory: "Callable[..., Awaitable[BrowserContext]]", server: Server
+) -> None:
     server.set_route(
         "/target.html",
         lambda r: (
@@ -73,8 +86,10 @@ async def test_should_work_with_ip_port_notion(context_factory, server):
 
 
 @flaky  # Upstream flaky
-async def test_should_authenticate(context_factory, server):
-    def handler(req):
+async def test_should_authenticate(
+    context_factory: "Callable[..., Awaitable[BrowserContext]]", server: Server
+) -> None:
+    def handler(req: HttpRequestWithPostBody) -> None:
         auth = req.getHeader("proxy-authorization")
         if not auth:
             req.setHeader(
@@ -102,8 +117,10 @@ def handler(req):
 
 
 @flaky  # Upstream flaky
-async def test_should_authenticate_with_empty_password(context_factory, server):
-    def handler(req):
+async def test_should_authenticate_with_empty_password(
+    context_factory: "Callable[..., Awaitable[BrowserContext]]", server: Server
+) -> None:
+    def handler(req: HttpRequestWithPostBody) -> None:
         auth = req.getHeader("proxy-authorization")
         if not auth:
             req.setHeader(
diff --git a/tests/async/test_browsercontext_request_fallback.py b/tests/async/test_browsercontext_request_fallback.py
index 4407dc3f9..b003a9db9 100644
--- a/tests/async/test_browsercontext_request_fallback.py
+++ b/tests/async/test_browsercontext_request_fallback.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import asyncio
+from typing import Any, Callable, Coroutine, cast
 
 import pytest
 
@@ -29,28 +30,28 @@ async def test_should_fall_back(
     page: Page, context: BrowserContext, server: Server
 ) -> None:
     intercepted = []
+
+    def _handler1(route: Route) -> None:
+        intercepted.append(1)
+        asyncio.create_task(route.fallback())
+
+    await context.route("**/empty.html", _handler1)
+
+    def _handler2(route: Route) -> None:
+        intercepted.append(2)
+        asyncio.create_task(route.fallback())
+
     await context.route(
         "**/empty.html",
-        lambda route: (
-            intercepted.append(1),
-            asyncio.create_task(route.fallback()),
-        ),
-    )
-    await context.route(
-        "**/empty.html",
-        lambda route: (
-            intercepted.append(2),
-            asyncio.create_task(route.fallback()),
-        ),
-    )
-    await context.route(
-        "**/empty.html",
-        lambda route: (
-            intercepted.append(3),
-            asyncio.create_task(route.fallback()),
-        ),
+        _handler2,
     )
 
+    def _handler3(route: Route) -> None:
+        intercepted.append(3)
+        asyncio.create_task(route.fallback())
+
+    await context.route("**/empty.html", _handler3)
+
     await page.goto(server.EMPTY_PAGE)
     assert intercepted == [3, 2, 1]
 
@@ -60,8 +61,8 @@ async def test_should_fall_back_async_delayed(
 ) -> None:
     intercepted = []
 
-    def create_handler(i: int):
-        async def handler(route):
+    def create_handler(i: int) -> Callable[[Route], Coroutine]:
+        async def handler(route: Route) -> None:
             intercepted.append(i)
             await asyncio.sleep(0.1)
             await route.fallback()
@@ -90,6 +91,7 @@ async def test_should_chain_once(
     )
 
     resp = await page.goto(server.PREFIX + "/madeup.txt")
+    assert resp
     body = await resp.body()
     assert body == b"fulfilled one"
 
@@ -99,7 +101,7 @@ async def test_should_not_chain_fulfill(
 ) -> None:
     failed = [False]
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         failed[0] = True
 
     await context.route("**/empty.html", handler)
@@ -112,6 +114,7 @@ def handler(route: Route):
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     body = await response.body()
     assert body == b"fulfilled"
     assert not failed[0]
@@ -126,7 +129,7 @@ async def test_should_not_chain_abort(
 ) -> None:
     failed = [False]
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         failed[0] = True
 
     await context.route("**/empty.html", handler)
@@ -153,9 +156,9 @@ async def test_should_fall_back_after_exception(
 ) -> None:
     await context.route("**/empty.html", lambda route: route.continue_())
 
-    async def handler(route: Route):
+    async def handler(route: Route) -> None:
         try:
-            await route.fulfill(response=47)
+            await route.fulfill(response=cast(Any, {}))
         except Exception:
             await route.fallback()
 
@@ -169,14 +172,14 @@ async def test_should_amend_http_headers(
 ) -> None:
     values = []
 
-    async def handler(route: Route):
+    async def handler(route: Route) -> None:
         values.append(route.request.headers.get("foo"))
         values.append(await route.request.header_value("FOO"))
         await route.continue_()
 
     await context.route("**/sleep.zzz", handler)
 
-    async def handler_with_header_mods(route: Route):
+    async def handler_with_header_mods(route: Route) -> None:
         await route.fallback(headers={**route.request.headers, "FOO": "bar"})
 
     await context.route("**/*", handler_with_header_mods)
@@ -204,13 +207,13 @@ async def test_should_delete_header_with_undefined_value(
 
     intercepted_request = []
 
-    async def capture_and_continue(route: Route, request: Request):
+    async def capture_and_continue(route: Route, request: Request) -> None:
         intercepted_request.append(request)
         await route.continue_()
 
     await context.route("**/*", capture_and_continue)
 
-    async def delete_foo_header(route: Route, request: Request):
+    async def delete_foo_header(route: Route, request: Request) -> None:
         headers = await request.all_headers()
         await route.fallback(headers={**headers, "foo": None})
 
@@ -247,13 +250,12 @@ async def test_should_amend_method(
     await page.goto(server.EMPTY_PAGE)
 
     method = []
-    await context.route(
-        "**/*",
-        lambda route: (
-            method.append(route.request.method),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
+
+    def _handler1(route: Route) -> None:
+        method.append(route.request.method)
+        asyncio.create_task(route.continue_())
+
+    await context.route("**/*", _handler1)
     await context.route(
         "**/*", lambda route: asyncio.create_task(route.fallback(method="POST"))
     )
@@ -271,18 +273,22 @@ async def test_should_override_request_url(
     page: Page, context: BrowserContext, server: Server
 ) -> None:
     url = []
+
+    def _handler1(route: Route) -> None:
+        url.append(route.request.url)
+        asyncio.create_task(route.continue_())
+
     await context.route(
         "**/global-var.html",
-        lambda route: (
-            url.append(route.request.url),
-            asyncio.create_task(route.continue_()),
-        ),
+        _handler1,
     )
+
+    def _handler2(route: Route) -> None:
+        asyncio.create_task(route.fallback(url=server.PREFIX + "/global-var.html"))
+
     await context.route(
         "**/foo",
-        lambda route: asyncio.create_task(
-            route.fallback(url=server.PREFIX + "/global-var.html")
-        ),
+        _handler2,
     )
 
     [server_request, response, _] = await asyncio.gather(
@@ -304,13 +310,12 @@ async def test_should_amend_post_data(
 ) -> None:
     await page.goto(server.EMPTY_PAGE)
     post_data = []
-    await context.route(
-        "**/*",
-        lambda route: (
-            post_data.append(route.request.post_data),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
+
+    def _handler1(route: Route) -> None:
+        post_data.append(route.request.post_data)
+        asyncio.create_task(route.continue_())
+
+    await context.route("**/*", _handler1)
     await context.route(
         "**/*", lambda route: asyncio.create_task(route.fallback(post_data="doggo"))
     )
@@ -324,22 +329,20 @@ async def test_should_amend_post_data(
 
 async def test_should_amend_binary_post_data(
     page: Page, context: BrowserContext, server: Server
-):
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     post_data_buffer = []
-    await context.route(
-        "**/*",
-        lambda route: (
-            post_data_buffer.append(route.request.post_data),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
-    await context.route(
-        "**/*",
-        lambda route: asyncio.create_task(
-            route.fallback(post_data=b"\x00\x01\x02\x03\x04")
-        ),
-    )
+
+    def _handler1(route: Route) -> None:
+        post_data_buffer.append(route.request.post_data)
+        asyncio.create_task(route.continue_())
+
+    await context.route("**/*", _handler1)
+
+    def _handler2(route: Route) -> None:
+        asyncio.create_task(route.fallback(post_data=b"\x00\x01\x02\x03\x04"))
+
+    await context.route("**/*", _handler2)
 
     [server_request, result] = await asyncio.gather(
         server.wait_for_request("/sleep.zzz"),
@@ -355,30 +358,42 @@ async def test_should_chain_fallback_into_page(
     context: BrowserContext, page: Page, server: Server
 ) -> None:
     intercepted = []
-    await context.route(
-        "**/empty.html",
-        lambda route: (intercepted.append(1), asyncio.create_task(route.fallback())),
-    )
-    await context.route(
-        "**/empty.html",
-        lambda route: (intercepted.append(2), asyncio.create_task(route.fallback())),
-    )
-    await context.route(
-        "**/empty.html",
-        lambda route: (intercepted.append(3), asyncio.create_task(route.fallback())),
-    )
-    await page.route(
-        "**/empty.html",
-        lambda route: (intercepted.append(4), asyncio.create_task(route.fallback())),
-    )
-    await page.route(
-        "**/empty.html",
-        lambda route: (intercepted.append(5), asyncio.create_task(route.fallback())),
-    )
-    await page.route(
-        "**/empty.html",
-        lambda route: (intercepted.append(6), asyncio.create_task(route.fallback())),
-    )
+
+    def _handler1(route: Route) -> None:
+        intercepted.append(1)
+        asyncio.create_task(route.fallback())
+
+    await context.route("**/empty.html", _handler1)
+
+    def _handler2(route: Route) -> None:
+        intercepted.append(2)
+        asyncio.create_task(route.fallback())
+
+    await context.route("**/empty.html", _handler2)
+
+    def _handler3(route: Route) -> None:
+        intercepted.append(3)
+        asyncio.create_task(route.fallback())
+
+    await context.route("**/empty.html", _handler3)
+
+    def _handler4(route: Route) -> None:
+        intercepted.append(4)
+        asyncio.create_task(route.fallback())
+
+    await page.route("**/empty.html", _handler4)
+
+    def _handler5(route: Route) -> None:
+        intercepted.append(5)
+        asyncio.create_task(route.fallback())
+
+    await page.route("**/empty.html", _handler5)
+
+    def _handler6(route: Route) -> None:
+        intercepted.append(6)
+        asyncio.create_task(route.fallback())
+
+    await page.route("**/empty.html", _handler6)
 
     await page.goto(server.EMPTY_PAGE)
     assert intercepted == [6, 5, 4, 3, 2, 1]
diff --git a/tests/async/test_browsercontext_request_intercept.py b/tests/async/test_browsercontext_request_intercept.py
index 763073df0..ffb5103c1 100644
--- a/tests/async/test_browsercontext_request_intercept.py
+++ b/tests/async/test_browsercontext_request_intercept.py
@@ -23,8 +23,8 @@
 
 async def test_should_fulfill_intercepted_response(
     page: Page, context: BrowserContext, server: Server
-):
-    async def handle(route: Route):
+) -> None:
+    async def handle(route: Route) -> None:
         response = await page.request.fetch(route.request)
         await route.fulfill(
             response=response,
@@ -36,6 +36,7 @@ async def handle(route: Route):
 
     await context.route("**/*", handle)
     response = await page.goto(server.PREFIX + "/empty.html")
+    assert response
     assert response.status == 201
     assert response.headers["foo"] == "bar"
     assert response.headers["content-type"] == "text/plain"
@@ -44,8 +45,8 @@ async def handle(route: Route):
 
 async def test_should_fulfill_response_with_empty_body(
     page: Page, context: BrowserContext, server: Server
-):
-    async def handle(route: Route):
+) -> None:
+    async def handle(route: Route) -> None:
         response = await page.request.fetch(route.request)
         await route.fulfill(
             response=response, status=201, body="", headers={"content-length": "0"}
@@ -53,26 +54,28 @@ async def handle(route: Route):
 
     await context.route("**/*", handle)
     response = await page.goto(server.PREFIX + "/title.html")
+    assert response
     assert response.status == 201
     assert await response.text() == ""
 
 
 async def test_should_override_with_defaults_when_intercepted_response_not_provided(
     page: Page, context: BrowserContext, server: Server, browser_name: str
-):
-    def server_handler(request: http.Request):
+) -> None:
+    def server_handler(request: http.Request) -> None:
         request.setHeader("foo", "bar")
         request.write("my content".encode())
         request.finish()
 
     server.set_route("/empty.html", server_handler)
 
-    async def handle(route: Route):
+    async def handle(route: Route) -> None:
         await page.request.fetch(route.request)
         await route.fulfill(status=201)
 
     await context.route("**/*", handle)
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 201
     assert await response.text() == ""
     if browser_name == "webkit":
@@ -83,8 +86,8 @@ async def handle(route: Route):
 
 async def test_should_fulfill_with_any_response(
     page: Page, context: BrowserContext, server: Server
-):
-    def server_handler(request: http.Request):
+) -> None:
+    def server_handler(request: http.Request) -> None:
         request.setHeader("foo", "bar")
         request.write("Woo-hoo".encode())
         request.finish()
@@ -98,6 +101,7 @@ def server_handler(request: http.Request):
         ),
     )
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 201
     assert await response.text() == "Woo-hoo"
     assert response.headers["foo"] == "bar"
@@ -105,15 +109,16 @@ def server_handler(request: http.Request):
 
 async def test_should_support_fulfill_after_intercept(
     page: Page, context: BrowserContext, server: Server, assetdir: Path
-):
+) -> None:
     request_future = asyncio.create_task(server.wait_for_request("/title.html"))
 
-    async def handle_route(route: Route):
+    async def handle_route(route: Route) -> None:
         response = await page.request.fetch(route.request)
         await route.fulfill(response=response)
 
     await context.route("**", handle_route)
     response = await page.goto(server.PREFIX + "/title.html")
+    assert response
     request = await request_future
     assert request.uri.decode() == "/title.html"
     original = (assetdir / "title.html").read_text()
@@ -122,10 +127,10 @@ async def handle_route(route: Route):
 
 async def test_should_give_access_to_the_intercepted_response(
     page: Page, context: BrowserContext, server: Server
-):
+) -> None:
     await page.goto(server.EMPTY_PAGE)
 
-    route_task = asyncio.Future()
+    route_task: "asyncio.Future[Route]" = asyncio.Future()
     await context.route("**/title.html", lambda route: route_task.set_result(route))
 
     eval_task = asyncio.create_task(
@@ -155,10 +160,10 @@ async def test_should_give_access_to_the_intercepted_response(
 
 async def test_should_give_access_to_the_intercepted_response_body(
     page: Page, context: BrowserContext, server: Server
-):
+) -> None:
     await page.goto(server.EMPTY_PAGE)
 
-    route_task = asyncio.Future()
+    route_task: "asyncio.Future[Route]" = asyncio.Future()
     await context.route("**/simple.json", lambda route: route_task.set_result(route))
 
     eval_task = asyncio.create_task(
diff --git a/tests/async/test_browsercontext_storage_state.py b/tests/async/test_browsercontext_storage_state.py
index b4214e310..4a00da1c3 100644
--- a/tests/async/test_browsercontext_storage_state.py
+++ b/tests/async/test_browsercontext_storage_state.py
@@ -14,9 +14,12 @@
 
 import asyncio
 import json
+from pathlib import Path
 
+from playwright.async_api import Browser, BrowserContext
 
-async def test_should_capture_local_storage(context, is_webkit, is_win):
+
+async def test_should_capture_local_storage(context: BrowserContext) -> None:
     page1 = await context.new_page()
     await page1.route(
         "**/*", lambda route: asyncio.create_task(route.fulfill(body="<html></html>"))
@@ -39,7 +42,7 @@ async def test_should_capture_local_storage(context, is_webkit, is_win):
     }
 
 
-async def test_should_set_local_storage(browser, is_webkit, is_win):
+async def test_should_set_local_storage(browser: Browser) -> None:
     context = await browser.new_context(
         storage_state={
             "origins": [
@@ -61,7 +64,9 @@ async def test_should_set_local_storage(browser, is_webkit, is_win):
     await context.close()
 
 
-async def test_should_round_trip_through_the_file(browser, context, tmpdir):
+async def test_should_round_trip_through_the_file(
+    browser: Browser, context: BrowserContext, tmpdir: Path
+) -> None:
     page1 = await context.new_page()
     await page1.route(
         "**/*",
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index ffb3fed31..556e8eefd 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -23,13 +23,13 @@
 
 from playwright.async_api import BrowserType, Error, Playwright, Route
 from tests.conftest import RemoteServer
-from tests.server import Server
+from tests.server import HttpRequestWithPostBody, Server
 from tests.utils import parse_trace
 
 
 async def test_browser_type_connect_should_be_able_to_reconnect_to_a_browser(
-    server: Server, browser_type: BrowserType, launch_server
-):
+    server: Server, browser_type: BrowserType, launch_server: Callable[[], RemoteServer]
+) -> None:
     remote_server = launch_server()
     browser = await browser_type.connect(remote_server.ws_endpoint)
     browser_context = await browser.new_context()
@@ -48,8 +48,8 @@ async def test_browser_type_connect_should_be_able_to_reconnect_to_a_browser(
 
 
 async def test_browser_type_connect_should_be_able_to_connect_two_browsers_at_the_same_time(
-    browser_type: BrowserType, launch_server
-):
+    browser_type: BrowserType, launch_server: Callable[[], RemoteServer]
+) -> None:
     remote_server = launch_server()
     browser1 = await browser_type.connect(remote_server.ws_endpoint)
     assert len(browser1.contexts) == 0
@@ -71,8 +71,8 @@ async def test_browser_type_connect_should_be_able_to_connect_two_browsers_at_th
 
 
 async def test_browser_type_connect_disconnected_event_should_be_emitted_when_browser_is_closed_or_server_is_closed(
-    browser_type: BrowserType, launch_server
-):
+    browser_type: BrowserType, launch_server: Callable[[], RemoteServer]
+) -> None:
     # Launch another server to not affect other tests.
     remote = launch_server()
 
@@ -81,8 +81,8 @@ async def test_browser_type_connect_disconnected_event_should_be_emitted_when_br
 
     disconnected1 = []
     disconnected2 = []
-    browser1.on("disconnected", lambda: disconnected1.append(True))
-    browser2.on("disconnected", lambda: disconnected2.append(True))
+    browser1.on("disconnected", lambda _: disconnected1.append(True))
+    browser2.on("disconnected", lambda _: disconnected2.append(True))
 
     page2 = await browser2.new_page()
 
@@ -100,15 +100,15 @@ async def test_browser_type_connect_disconnected_event_should_be_emitted_when_br
 
 
 async def test_browser_type_connect_disconnected_event_should_be_emitted_when_remote_killed_connection(
-    browser_type: BrowserType, launch_server
-):
+    browser_type: BrowserType, launch_server: Callable[[], RemoteServer]
+) -> None:
     # Launch another server to not affect other tests.
     remote = launch_server()
 
     browser = await browser_type.connect(remote.ws_endpoint)
 
     disconnected = []
-    browser.on("disconnected", lambda: disconnected.append(True))
+    browser.on("disconnected", lambda _: disconnected.append(True))
     page = await browser.new_page()
     remote.kill()
     with pytest.raises(Error):
@@ -117,8 +117,8 @@ async def test_browser_type_connect_disconnected_event_should_be_emitted_when_re
 
 
 async def test_browser_type_disconnected_event_should_have_browser_as_argument(
-    browser_type: BrowserType, launch_server
-):
+    browser_type: BrowserType, launch_server: Callable[[], RemoteServer]
+) -> None:
     remote_server = launch_server()
     browser = await browser_type.connect(remote_server.ws_endpoint)
     event_payloads = []
@@ -128,8 +128,8 @@ async def test_browser_type_disconnected_event_should_have_browser_as_argument(
 
 
 async def test_browser_type_connect_set_browser_connected_state(
-    browser_type: BrowserType, launch_server
-):
+    browser_type: BrowserType, launch_server: Callable[[], RemoteServer]
+) -> None:
     remote_server = launch_server()
     browser = await browser_type.connect(remote_server.ws_endpoint)
     assert browser.is_connected()
@@ -138,8 +138,8 @@ async def test_browser_type_connect_set_browser_connected_state(
 
 
 async def test_browser_type_connect_should_throw_when_used_after_is_connected_returns_false(
-    browser_type: BrowserType, launch_server
-):
+    browser_type: BrowserType, launch_server: Callable[[], RemoteServer]
+) -> None:
     remote_server = launch_server()
     browser = await browser_type.connect(remote_server.ws_endpoint)
     page = await browser.new_page()
@@ -153,8 +153,8 @@ async def test_browser_type_connect_should_throw_when_used_after_is_connected_re
 
 
 async def test_browser_type_connect_should_reject_navigation_when_browser_closes(
-    server: Server, browser_type: BrowserType, launch_server
-):
+    server: Server, browser_type: BrowserType, launch_server: Callable[[], RemoteServer]
+) -> None:
     remote_server = launch_server()
     browser = await browser_type.connect(remote_server.ws_endpoint)
     page = await browser.new_page()
@@ -166,9 +166,9 @@ async def test_browser_type_connect_should_reject_navigation_when_browser_closes
 
 
 async def test_should_not_allow_getting_the_path(
-    browser_type: BrowserType, launch_server, server: Server
-):
-    def handle_download(request):
+    browser_type: BrowserType, launch_server: Callable[[], RemoteServer], server: Server
+) -> None:
+    def handle_download(request: HttpRequestWithPostBody) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.setHeader("Content-Disposition", "attachment")
         request.write(b"Hello world")
@@ -193,8 +193,11 @@ def handle_download(request):
 
 
 async def test_prevent_getting_video_path(
-    browser_type: BrowserType, launch_server, tmpdir, server
-):
+    browser_type: BrowserType,
+    launch_server: Callable[[], RemoteServer],
+    tmpdir: Path,
+    server: Server,
+) -> None:
     remote_server = launch_server()
     browser = await browser_type.connect(remote_server.ws_endpoint)
     page = await browser.new_page(record_video_dir=tmpdir)
@@ -211,8 +214,8 @@ async def test_prevent_getting_video_path(
 
 
 async def test_connect_to_closed_server_without_hangs(
-    browser_type: BrowserType, launch_server
-):
+    browser_type: BrowserType, launch_server: Callable[[], RemoteServer]
+) -> None:
     remote_server = launch_server()
     remote_server.kill()
     with pytest.raises(Error) as exc:
@@ -253,10 +256,9 @@ async def handle_request(route: Route) -> None:
 async def test_should_upload_large_file(
     browser_type: BrowserType,
     launch_server: Callable[[], RemoteServer],
-    playwright: Playwright,
     server: Server,
-    tmp_path,
-):
+    tmp_path: Path,
+) -> None:
     remote = launch_server()
 
     browser = await browser_type.connect(remote.ws_endpoint)
@@ -295,11 +297,13 @@ async def test_should_upload_large_file(
     assert contents[:1024] == data
     # flake8: noqa: E203
     assert contents[len(contents) - 1024 :] == data
+    assert request.post_body
     match = re.search(
         rb'^.*Content-Disposition: form-data; name="(?P<name>.*)"; filename="(?P<filename>.*)".*$',
         request.post_body,
         re.MULTILINE,
     )
+    assert match
     assert match.group("name") == b"file1"
     assert match.group("filename") == b"200MB.zip"
 
@@ -309,7 +313,7 @@ async def test_should_record_trace_with_source(
     server: Server,
     tmp_path: Path,
     browser_type: BrowserType,
-):
+) -> None:
     remote = launch_server()
     browser = await browser_type.connect(remote.ws_endpoint)
     context = await browser.new_context()
@@ -338,9 +342,8 @@ async def test_should_record_trace_with_source(
 async def test_should_record_trace_with_relative_trace_path(
     launch_server: Callable[[], RemoteServer],
     server: Server,
-    tmp_path: Path,
     browser_type: BrowserType,
-):
+) -> None:
     remote = launch_server()
     browser = await browser_type.connect(remote.ws_endpoint)
     context = await browser.new_context()
diff --git a/tests/async/test_browsertype_connect_cdp.py b/tests/async/test_browsertype_connect_cdp.py
index 0e1e94009..de3d96e77 100644
--- a/tests/async/test_browsertype_connect_cdp.py
+++ b/tests/async/test_browsertype_connect_cdp.py
@@ -26,7 +26,7 @@
 
 async def test_connect_to_an_existing_cdp_session(
     launch_arguments: Dict, browser_type: BrowserType
-):
+) -> None:
     port = find_free_port()
     browser_server = await browser_type.launch(
         **launch_arguments, args=[f"--remote-debugging-port={port}"]
@@ -39,7 +39,7 @@ async def test_connect_to_an_existing_cdp_session(
 
 async def test_connect_to_an_existing_cdp_session_twice(
     launch_arguments: Dict, browser_type: BrowserType, server: Server
-):
+) -> None:
     port = find_free_port()
     browser_server = await browser_type.launch(
         **launch_arguments, args=[f"--remote-debugging-port={port}"]
@@ -72,7 +72,7 @@ def _ws_endpoint_from_url(url: str) -> str:
 
 async def test_conect_over_a_ws_endpoint(
     launch_arguments: Dict, browser_type: BrowserType, server: Server
-):
+) -> None:
     port = find_free_port()
     browser_server = await browser_type.launch(
         **launch_arguments, args=[f"--remote-debugging-port={port}"]
@@ -90,8 +90,8 @@ async def test_conect_over_a_ws_endpoint(
 
 
 async def test_connect_over_cdp_passing_header_works(
-    launch_arguments: Dict, browser_type: BrowserType, server: Server
-):
+    browser_type: BrowserType, server: Server
+) -> None:
     request = asyncio.create_task(server.wait_for_request("/ws"))
     with pytest.raises(Error):
         await browser_type.connect_over_cdp(
diff --git a/tests/async/test_cdp_session.py b/tests/async/test_cdp_session.py
index af8f0715d..5118ab9fa 100644
--- a/tests/async/test_cdp_session.py
+++ b/tests/async/test_cdp_session.py
@@ -14,12 +14,13 @@
 
 import pytest
 
-from playwright.async_api import Browser, Error
+from playwright.async_api import Browser, Error, Page
+from tests.server import Server
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
 @pytest.mark.only_browser("chromium")
-async def test_should_work(page):
+async def test_should_work(page: Page) -> None:
     client = await page.context.new_cdp_session(page)
     events = []
     client.on("Runtime.consoleAPICalled", lambda params: events.append(params))
@@ -35,7 +36,7 @@ async def test_should_work(page):
 
 
 @pytest.mark.only_browser("chromium")
-async def test_should_receive_events(page, server):
+async def test_should_receive_events(page: Page, server: Server) -> None:
     client = await page.context.new_cdp_session(page)
     await client.send("Network.enable")
     events = []
@@ -45,7 +46,7 @@ async def test_should_receive_events(page, server):
 
 
 @pytest.mark.only_browser("chromium")
-async def test_should_be_able_to_detach_session(page):
+async def test_should_be_able_to_detach_session(page: Page) -> None:
     client = await page.context.new_cdp_session(page)
     await client.send("Runtime.enable")
     eval_response = await client.send(
@@ -61,7 +62,7 @@ async def test_should_be_able_to_detach_session(page):
 
 
 @pytest.mark.only_browser("chromium")
-async def test_should_not_break_page_close(browser):
+async def test_should_not_break_page_close(browser: Browser) -> None:
     context = await browser.new_context()
     page = await context.new_page()
     session = await page.context.new_cdp_session(page)
@@ -71,7 +72,7 @@ async def test_should_not_break_page_close(browser):
 
 
 @pytest.mark.only_browser("chromium")
-async def test_should_detach_when_page_closes(browser):
+async def test_should_detach_when_page_closes(browser: Browser) -> None:
     context = await browser.new_context()
     page = await context.new_page()
     session = await context.new_cdp_session(page)
@@ -82,7 +83,7 @@ async def test_should_detach_when_page_closes(browser):
 
 
 @pytest.mark.only_browser("chromium")
-async def test_should_work_with_main_frame(browser: Browser):
+async def test_should_work_with_main_frame(browser: Browser) -> None:
     context = await browser.new_context()
     page = await context.new_page()
     client = await context.new_cdp_session(page.main_frame)
diff --git a/tests/async/test_check.py b/tests/async/test_check.py
index d4fcf43f0..428ca2a7b 100644
--- a/tests/async/test_check.py
+++ b/tests/async/test_check.py
@@ -12,32 +12,34 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from playwright.async_api import Page
 
-async def test_check_the_box(page):
+
+async def test_check_the_box(page: Page) -> None:
     await page.set_content('<input id="checkbox" type="checkbox"></input>')
     await page.check("input")
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_not_check_the_checked_box(page):
+async def test_not_check_the_checked_box(page: Page) -> None:
     await page.set_content('<input id="checkbox" type="checkbox" checked></input>')
     await page.check("input")
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_uncheck_the_box(page):
+async def test_uncheck_the_box(page: Page) -> None:
     await page.set_content('<input id="checkbox" type="checkbox" checked></input>')
     await page.uncheck("input")
     assert await page.evaluate("checkbox.checked") is False
 
 
-async def test_not_uncheck_the_unchecked_box(page):
+async def test_not_uncheck_the_unchecked_box(page: Page) -> None:
     await page.set_content('<input id="checkbox" type="checkbox"></input>')
     await page.uncheck("input")
     assert await page.evaluate("checkbox.checked") is False
 
 
-async def test_check_the_box_by_label(page):
+async def test_check_the_box_by_label(page: Page) -> None:
     await page.set_content(
         '<label for="checkbox"><input id="checkbox" type="checkbox"></input></label>'
     )
@@ -45,7 +47,7 @@ async def test_check_the_box_by_label(page):
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_check_the_box_outside_label(page):
+async def test_check_the_box_outside_label(page: Page) -> None:
     await page.set_content(
         '<label for="checkbox">Text</label><div><input id="checkbox" type="checkbox"></input></div>'
     )
@@ -53,7 +55,7 @@ async def test_check_the_box_outside_label(page):
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_check_the_box_inside_label_without_id(page):
+async def test_check_the_box_inside_label_without_id(page: Page) -> None:
     await page.set_content(
         '<label>Text<span><input id="checkbox" type="checkbox"></input></span></label>'
     )
@@ -61,7 +63,7 @@ async def test_check_the_box_inside_label_without_id(page):
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_check_radio(page):
+async def test_check_radio(page: Page) -> None:
     await page.set_content(
         """
       <input type='radio'>one</input>
@@ -72,7 +74,7 @@ async def test_check_radio(page):
     assert await page.evaluate("two.checked")
 
 
-async def test_check_the_box_by_aria_role(page):
+async def test_check_the_box_by_aria_role(page: Page) -> None:
     await page.set_content(
         """<div role='checkbox' id='checkbox'>CHECKBOX</div>
       <script>
diff --git a/tests/async/test_chromium_tracing.py b/tests/async/test_chromium_tracing.py
index f1c34b5ba..4cbd77a21 100644
--- a/tests/async/test_chromium_tracing.py
+++ b/tests/async/test_chromium_tracing.py
@@ -19,12 +19,13 @@
 import pytest
 
 from playwright.async_api import Browser, Page
+from tests.server import Server
 
 
 @pytest.mark.only_browser("chromium")
 async def test_should_output_a_trace(
-    browser: Browser, page: Page, server, tmpdir: Path
-):
+    browser: Browser, page: Page, server: Server, tmpdir: Path
+) -> None:
     output_file = tmpdir / "trace.json"
     await browser.start_tracing(page=page, screenshots=True, path=output_file)
     await page.goto(server.PREFIX + "/grid.html")
@@ -34,8 +35,8 @@ async def test_should_output_a_trace(
 
 @pytest.mark.only_browser("chromium")
 async def test_should_create_directories_as_needed(
-    browser: Browser, page: Page, server, tmpdir
-):
+    browser: Browser, page: Page, server: Server, tmpdir: Path
+) -> None:
     output_file = tmpdir / "these" / "are" / "directories" / "trace.json"
     await browser.start_tracing(page=page, screenshots=True, path=output_file)
     await page.goto(server.PREFIX + "/grid.html")
@@ -46,7 +47,7 @@ async def test_should_create_directories_as_needed(
 @pytest.mark.only_browser("chromium")
 async def test_should_run_with_custom_categories_if_provided(
     browser: Browser, page: Page, tmpdir: Path
-):
+) -> None:
     output_file = tmpdir / "trace.json"
     await browser.start_tracing(
         page=page,
@@ -66,7 +67,7 @@ async def test_should_run_with_custom_categories_if_provided(
 @pytest.mark.only_browser("chromium")
 async def test_should_throw_if_tracing_on_two_pages(
     browser: Browser, page: Page, tmpdir: Path
-):
+) -> None:
     output_file_1 = tmpdir / "trace1.json"
     await browser.start_tracing(page=page, screenshots=True, path=output_file_1)
     output_file_2 = tmpdir / "trace2.json"
@@ -77,8 +78,8 @@ async def test_should_throw_if_tracing_on_two_pages(
 
 @pytest.mark.only_browser("chromium")
 async def test_should_return_a_buffer(
-    browser: Browser, page: Page, server, tmpdir: Path
-):
+    browser: Browser, page: Page, server: Server, tmpdir: Path
+) -> None:
     output_file = tmpdir / "trace.json"
     await browser.start_tracing(page=page, path=output_file, screenshots=True)
     await page.goto(server.PREFIX + "/grid.html")
@@ -88,7 +89,9 @@ async def test_should_return_a_buffer(
 
 
 @pytest.mark.only_browser("chromium")
-async def test_should_work_without_options(browser: Browser, page: Page, server):
+async def test_should_work_without_options(
+    browser: Browser, page: Page, server: Server
+) -> None:
     await browser.start_tracing()
     await page.goto(server.PREFIX + "/grid.html")
     trace = await browser.stop_tracing()
@@ -97,8 +100,8 @@ async def test_should_work_without_options(browser: Browser, page: Page, server)
 
 @pytest.mark.only_browser("chromium")
 async def test_should_support_a_buffer_without_a_path(
-    browser: Browser, page: Page, server
-):
+    browser: Browser, page: Page, server: Server
+) -> None:
     await browser.start_tracing(page=page, screenshots=True)
     await page.goto(server.PREFIX + "/grid.html")
     trace = await browser.stop_tracing()
diff --git a/tests/async/test_click.py b/tests/async/test_click.py
index 19a8dae6d..8143a6b3d 100644
--- a/tests/async/test_click.py
+++ b/tests/async/test_click.py
@@ -13,26 +13,30 @@
 # limitations under the License.
 
 import asyncio
+from typing import Optional
 
 import pytest
 
-from playwright.async_api import Error, TimeoutError
+from playwright.async_api import Browser, Error, Page, Playwright, TimeoutError
+from tests.server import Server
 
+from .utils import Utils
 
-async def give_it_a_chance_to_click(page):
+
+async def give_it_a_chance_to_click(page: Page) -> None:
     for _ in range(5):
         await page.evaluate(
             "() => new Promise(f => requestAnimationFrame(() => requestAnimationFrame(f)))"
         )
 
 
-async def test_click_the_button(page, server):
+async def test_click_the_button(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.click("button")
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_click_svg(page, server):
+async def test_click_svg(page: Page, server: Server) -> None:
     await page.set_content(
         """
         <svg height="100" width="100">
@@ -44,14 +48,18 @@ async def test_click_svg(page, server):
     assert await page.evaluate("window.__CLICKED") == 42
 
 
-async def test_click_the_button_if_window_node_is_removed(page, server):
+async def test_click_the_button_if_window_node_is_removed(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.evaluate("() => delete window.Node")
     await page.click("button")
     assert await page.evaluate("() => result") == "Clicked"
 
 
-async def test_click_on_a_span_with_an_inline_element_inside(page, server):
+async def test_click_on_a_span_with_an_inline_element_inside(
+    page: Page, server: Server
+) -> None:
     await page.set_content(
         """
         <style>
@@ -66,7 +74,7 @@ async def test_click_on_a_span_with_an_inline_element_inside(page, server):
     assert await page.evaluate("window.CLICKED") == 42
 
 
-async def test_click_not_throw_when_page_closes(browser, server):
+async def test_click_not_throw_when_page_closes(browser: Browser) -> None:
     context = await browser.new_context()
     page = await context.new_page()
     try:
@@ -79,7 +87,7 @@ async def test_click_not_throw_when_page_closes(browser, server):
     await context.close()
 
 
-async def test_click_the_button_after_navigation(page, server):
+async def test_click_the_button_after_navigation(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.click("button")
     await page.goto(server.PREFIX + "/input/button.html")
@@ -87,7 +95,9 @@ async def test_click_the_button_after_navigation(page, server):
     assert await page.evaluate("() => result") == "Clicked"
 
 
-async def test_click_the_button_after_a_cross_origin_navigation_(page, server):
+async def test_click_the_button_after_a_cross_origin_navigation_(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.click("button")
     await page.goto(server.CROSS_PROCESS_PREFIX + "/input/button.html")
@@ -95,7 +105,7 @@ async def test_click_the_button_after_a_cross_origin_navigation_(page, server):
     assert await page.evaluate("() => result") == "Clicked"
 
 
-async def test_click_with_disabled_javascript(browser, server):
+async def test_click_with_disabled_javascript(browser: Browser, server: Server) -> None:
     context = await browser.new_context(java_script_enabled=False)
     page = await context.new_page()
     await page.goto(server.PREFIX + "/wrappedlink.html")
@@ -106,8 +116,8 @@ async def test_click_with_disabled_javascript(browser, server):
 
 
 async def test_click_when_one_of_inline_box_children_is_outside_of_viewport(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.set_content(
         """
         <style>
@@ -123,7 +133,7 @@ async def test_click_when_one_of_inline_box_children_is_outside_of_viewport(
     assert await page.evaluate("() => window.CLICKED") == 42
 
 
-async def test_select_the_text_by_triple_clicking(page, server):
+async def test_select_the_text_by_triple_clicking(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     text = "This is the text that we are going to try to select. Let's see how it goes."
     await page.fill("textarea", text)
@@ -139,7 +149,7 @@ async def test_select_the_text_by_triple_clicking(page, server):
     )
 
 
-async def test_click_offscreen_buttons(page, server):
+async def test_click_offscreen_buttons(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/offscreenbuttons.html")
     messages = []
     page.on("console", lambda msg: messages.append(msg.text))
@@ -162,30 +172,31 @@ async def test_click_offscreen_buttons(page, server):
     ]
 
 
-async def test_waitFor_visible_when_already_visible(page, server):
+async def test_waitFor_visible_when_already_visible(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.click("button")
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_wait_with_force(page, server):
-    error = None
+async def test_wait_with_force(page: Page, server: Server) -> None:
+    error: Optional[Error] = None
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector("button", "b => b.style.display = 'none'")
     try:
         await page.click("button", force=True)
     except Error as e:
         error = e
+    assert error
     assert "Element is not visible" in error.message
     assert await page.evaluate("result") == "Was not clicked"
 
 
-async def test_wait_for_display_none_to_be_gone(page, server):
+async def test_wait_for_display_none_to_be_gone(page: Page, server: Server) -> None:
     done = []
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector("button", "b => b.style.display = 'none'")
 
-    async def click():
+    async def click() -> None:
         await page.click("button", timeout=0)
         done.append(True)
 
@@ -199,12 +210,14 @@ async def click():
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_wait_for_visibility_hidden_to_be_gone(page, server):
+async def test_wait_for_visibility_hidden_to_be_gone(
+    page: Page, server: Server
+) -> None:
     done = []
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector("button", "b => b.style.visibility = 'hidden'")
 
-    async def click():
+    async def click() -> None:
         await page.click("button", timeout=0)
         done.append(True)
 
@@ -218,7 +231,9 @@ async def click():
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_timeout_waiting_for_display_none_to_be_gone(page, server):
+async def test_timeout_waiting_for_display_none_to_be_gone(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector("button", "b => b.style.display = 'none'")
     try:
@@ -230,7 +245,9 @@ async def test_timeout_waiting_for_display_none_to_be_gone(page, server):
     assert "element is not visible - waiting" in error.message
 
 
-async def test_timeout_waiting_for_visbility_hidden_to_be_gone(page, server):
+async def test_timeout_waiting_for_visbility_hidden_to_be_gone(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector("button", "b => b.style.visibility = 'hidden'")
     try:
@@ -242,12 +259,14 @@ async def test_timeout_waiting_for_visbility_hidden_to_be_gone(page, server):
     assert "element is not visible - waiting" in error.message
 
 
-async def test_waitFor_visible_when_parent_is_hidden(page, server):
+async def test_waitFor_visible_when_parent_is_hidden(
+    page: Page, server: Server
+) -> None:
     done = []
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector("button", "b => b.parentElement.style.display = 'none'")
 
-    async def click():
+    async def click() -> None:
         await page.click("button", timeout=0)
         done.append(True)
 
@@ -262,13 +281,13 @@ async def click():
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_click_wrapped_links(page, server):
+async def test_click_wrapped_links(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/wrappedlink.html")
     await page.click("a")
     assert await page.evaluate("window.__clicked")
 
 
-async def test_click_on_checkbox_input_and_toggle(page, server):
+async def test_click_on_checkbox_input_and_toggle(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/checkbox.html")
     assert await page.evaluate("() => result.check") is None
     await page.click("input#agree")
@@ -287,7 +306,7 @@ async def test_click_on_checkbox_input_and_toggle(page, server):
     assert await page.evaluate("result.check") is False
 
 
-async def test_click_on_checkbox_label_and_toggle(page, server):
+async def test_click_on_checkbox_label_and_toggle(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/checkbox.html")
     assert await page.evaluate("result.check") is None
     await page.click('label[for="agree"]')
@@ -301,7 +320,9 @@ async def test_click_on_checkbox_label_and_toggle(page, server):
     assert await page.evaluate("result.check") is False
 
 
-async def test_not_hang_with_touch_enabled_viewports(playwright, server, browser):
+async def test_not_hang_with_touch_enabled_viewports(
+    playwright: Playwright, browser: Browser
+) -> None:
     iphone_6 = playwright.devices["iPhone 6"]
     context = await browser.new_context(
         viewport=iphone_6["viewport"], has_touch=iphone_6["has_touch"]
@@ -313,7 +334,7 @@ async def test_not_hang_with_touch_enabled_viewports(playwright, server, browser
     await context.close()
 
 
-async def test_scroll_and_click_the_button(page, server):
+async def test_scroll_and_click_the_button(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/scrollable.html")
     await page.click("#button-5")
     assert (
@@ -327,7 +348,7 @@ async def test_scroll_and_click_the_button(page, server):
     )
 
 
-async def test_double_click_the_button(page, server):
+async def test_double_click_the_button(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.evaluate(
         """() => {
@@ -342,7 +363,7 @@ async def test_double_click_the_button(page, server):
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_click_a_partially_obscured_button(page, server):
+async def test_click_a_partially_obscured_button(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.evaluate(
         """() => {
@@ -357,13 +378,15 @@ async def test_click_a_partially_obscured_button(page, server):
     assert await page.evaluate("() => window.result") == "Clicked"
 
 
-async def test_click_a_rotated_button(page, server):
+async def test_click_a_rotated_button(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/rotatedButton.html")
     await page.click("button")
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_fire_contextmenu_event_on_right_click(page, server):
+async def test_fire_contextmenu_event_on_right_click(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/scrollable.html")
     await page.click("#button-8", button="right")
     assert (
@@ -372,23 +395,28 @@ async def test_fire_contextmenu_event_on_right_click(page, server):
     )
 
 
-async def test_click_links_which_cause_navigation(page, server):
+async def test_click_links_which_cause_navigation(page: Page, server: Server) -> None:
     await page.set_content(f'<a href="{server.EMPTY_PAGE}">empty.html</a>')
     # This await should not hang.
     await page.click("a")
 
 
-async def test_click_the_button_inside_an_iframe(page, server, utils):
+async def test_click_the_button_inside_an_iframe(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content('<div style="width:100px;height:100px">spacer</div>')
     await utils.attach_frame(page, "button-test", server.PREFIX + "/input/button.html")
     frame = page.frames[1]
     button = await frame.query_selector("button")
+    assert button
     await button.click()
     assert await frame.evaluate("window.result") == "Clicked"
 
 
-async def test_click_the_button_with_device_scale_factor_set(browser, server, utils):
+async def test_click_the_button_with_device_scale_factor_set(
+    browser: Browser, server: Server, utils: Utils
+) -> None:
     context = await browser.new_context(
         viewport={"width": 400, "height": 400}, device_scale_factor=5
     )
@@ -398,12 +426,15 @@ async def test_click_the_button_with_device_scale_factor_set(browser, server, ut
     await utils.attach_frame(page, "button-test", server.PREFIX + "/input/button.html")
     frame = page.frames[1]
     button = await frame.query_selector("button")
+    assert button
     await button.click()
     assert await frame.evaluate("window.result") == "Clicked"
     await context.close()
 
 
-async def test_click_the_button_with_px_border_with_offset(page, server, is_webkit):
+async def test_click_the_button_with_px_border_with_offset(
+    page: Page, server: Server, is_webkit: bool
+) -> 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})
@@ -413,7 +444,9 @@ async def test_click_the_button_with_px_border_with_offset(page, server, is_webk
     assert await page.evaluate("offsetY") == 10 + 8 if is_webkit else 10
 
 
-async def test_click_the_button_with_em_border_with_offset(page, server, is_webkit):
+async def test_click_the_button_with_em_border_with_offset(
+    page: Page, server: Server, is_webkit: bool
+) -> 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'")
@@ -424,7 +457,9 @@ async def test_click_the_button_with_em_border_with_offset(page, server, is_webk
     assert await page.evaluate("offsetY") == 12 * 2 + 10 if is_webkit else 10
 
 
-async def test_click_a_very_large_button_with_offset(page, server, is_webkit):
+async def test_click_a_very_large_button_with_offset(
+    page: Page, server: Server, is_webkit: bool
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector("button", "button => button.style.borderWidth = '8px'")
     await page.eval_on_selector(
@@ -438,8 +473,8 @@ async def test_click_a_very_large_button_with_offset(page, server, is_webkit):
 
 
 async def test_click_a_button_in_scrolling_container_with_offset(
-    page, server, is_webkit
-):
+    page: Page, server: Server, is_webkit: bool
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector(
         "button",
@@ -465,8 +500,8 @@ async def test_click_a_button_in_scrolling_container_with_offset(
 
 @pytest.mark.skip_browser("firefox")
 async def test_click_the_button_with_offset_with_page_scale(
-    browser, server, is_chromium, is_webkit
-):
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(
         viewport={"width": 400, "height": 400}, is_mobile=True
     )
@@ -494,7 +529,7 @@ def _assert_close_to(expected: int, actual: int) -> None:
     await context.close()
 
 
-async def test_wait_for_stable_position(page, server):
+async def test_wait_for_stable_position(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector(
         "button",
@@ -517,9 +552,10 @@ async def test_wait_for_stable_position(page, server):
     assert await page.evaluate("pageY") == 10
 
 
-async def test_timeout_waiting_for_stable_position(page, server):
+async def test_timeout_waiting_for_stable_position(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = await page.query_selector("button")
+    assert button
     await button.evaluate(
         """button => {
             button.style.transition = 'margin 5s linear 0s'
@@ -535,7 +571,7 @@ async def test_timeout_waiting_for_stable_position(page, server):
     assert "element is not stable - waiting" in error.message
 
 
-async def test_wait_for_becoming_hit_target(page, server):
+async def test_wait_for_becoming_hit_target(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector(
         "button",
@@ -559,7 +595,7 @@ async def test_wait_for_becoming_hit_target(page, server):
 
     clicked = [False]
 
-    async def click():
+    async def click() -> None:
         await page.click("button")
         clicked.append(True)
 
@@ -576,9 +612,10 @@ async def click():
     assert await page.evaluate("() => window.result") == "Clicked"
 
 
-async def test_timeout_waiting_for_hit_target(page, server):
+async def test_timeout_waiting_for_hit_target(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = await page.query_selector("button")
+    assert button
     await page.evaluate(
         """() => {
       document.body.style.position = 'relative'
@@ -597,14 +634,18 @@ async def test_timeout_waiting_for_hit_target(page, server):
         await button.click(timeout=5000)
     except TimeoutError as e:
         error = e
+    assert error
     assert "Timeout 5000ms exceeded." in error.message
     assert '<div id="blocker"></div> intercepts pointer events' in error.message
     assert "retrying click action" in error.message
 
 
-async def test_fail_when_obscured_and_not_waiting_for_hit_target(page, server):
+async def test_fail_when_obscured_and_not_waiting_for_hit_target(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = await page.query_selector("button")
+    assert button
     await page.evaluate(
         """() => {
             document.body.style.position = 'relative'
@@ -622,13 +663,13 @@ async def test_fail_when_obscured_and_not_waiting_for_hit_target(page, server):
     assert await page.evaluate("window.result") == "Was not clicked"
 
 
-async def test_wait_for_button_to_be_enabled(page, server):
+async def test_wait_for_button_to_be_enabled(page: Page, server: Server) -> None:
     await page.set_content(
         '<button onclick="javascript:window.__CLICKED=true;" disabled><span>Click target</span></button>'
     )
     done = []
 
-    async def click():
+    async def click() -> None:
         await page.click("text=Click target")
         done.append(True)
 
@@ -641,27 +682,30 @@ async def click():
     assert await page.evaluate("window.__CLICKED")
 
 
-async def test_timeout_waiting_for_button_to_be_enabled(page, server):
+async def test_timeout_waiting_for_button_to_be_enabled(
+    page: Page, server: Server
+) -> None:
     await page.set_content(
         '<button onclick="javascript:window.__CLICKED=true;" disabled><span>Click target</span></button>'
     )
-    error = None
+    error: Optional[Error] = None
     try:
         await page.click("text=Click target", timeout=3000)
     except TimeoutError as e:
         error = e
     assert await page.evaluate("window.__CLICKED") is None
+    assert error
     assert "Timeout 3000ms exceeded" in error.message
     assert "element is not enabled - waiting" in error.message
 
 
-async def test_wait_for_input_to_be_enabled(page, server):
+async def test_wait_for_input_to_be_enabled(page: Page, server: Server) -> None:
     await page.set_content(
         '<input onclick="javascript:window.__CLICKED=true;" disabled>'
     )
     done = []
 
-    async def click():
+    async def click() -> None:
         await page.click("input")
         done.append(True)
 
@@ -674,7 +718,7 @@ async def click():
     assert await page.evaluate("window.__CLICKED")
 
 
-async def test_wait_for_select_to_be_enabled(page, server):
+async def test_wait_for_select_to_be_enabled(page: Page, server: Server) -> None:
     await page.set_content(
         """
         <select disabled><option selected>Hello</option></select>
@@ -688,7 +732,7 @@ async def test_wait_for_select_to_be_enabled(page, server):
     )
     done = []
 
-    async def click():
+    async def click() -> None:
         await page.click("select")
         done.append(True)
 
@@ -701,7 +745,7 @@ async def click():
     assert await page.evaluate("window.__CLICKED")
 
 
-async def test_click_disabled_div(page, server):
+async def test_click_disabled_div(page: Page, server: Server) -> None:
     await page.set_content(
         '<div onclick="javascript:window.__CLICKED=true;" disabled>Click target</div>'
     )
@@ -709,7 +753,9 @@ async def test_click_disabled_div(page, server):
     assert await page.evaluate("window.__CLICKED")
 
 
-async def test_climb_dom_for_inner_label_with_pointer_events_none(page, server):
+async def test_climb_dom_for_inner_label_with_pointer_events_none(
+    page: Page, server: Server
+) -> None:
     await page.set_content(
         '<button onclick="javascript:window.__CLICKED=true;"><label style="pointer-events:none">Click target</label></button>'
     )
@@ -717,7 +763,7 @@ async def test_climb_dom_for_inner_label_with_pointer_events_none(page, server):
     assert await page.evaluate("window.__CLICKED")
 
 
-async def test_climb_up_to_role_button(page, server):
+async def test_climb_up_to_role_button(page: Page, server: Server) -> None:
     await page.set_content(
         '<div role=button onclick="javascript:window.__CLICKED=true;"><div style="pointer-events:none"><span><div>Click target</div></span></div>'
     )
@@ -726,14 +772,14 @@ async def test_climb_up_to_role_button(page, server):
 
 
 async def test_wait_for_BUTTON_to_be_clickable_when_it_has_pointer_events_none(
-    page, server
-):
+    page: Page,
+) -> None:
     await page.set_content(
         '<button onclick="javascript:window.__CLICKED=true;" style="pointer-events:none"><span>Click target</span></button>'
     )
     done = []
 
-    async def click():
+    async def click() -> None:
         await page.click("text=Click target")
         done.append(True)
 
@@ -749,8 +795,8 @@ async def click():
 
 
 async def test_wait_for_LABEL_to_be_clickable_when_it_has_pointer_events_none(
-    page, server
-):
+    page: Page,
+) -> None:
     await page.set_content(
         '<label onclick="javascript:window.__CLICKED=true;" style="pointer-events:none"><span>Click target</span></label>'
     )
@@ -766,7 +812,7 @@ async def test_wait_for_LABEL_to_be_clickable_when_it_has_pointer_events_none(
     assert await page.evaluate("window.__CLICKED")
 
 
-async def test_update_modifiers_correctly(page, server):
+async def test_update_modifiers_correctly(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.click("button", modifiers=["Shift"])
     assert await page.evaluate("shiftKey")
@@ -783,7 +829,9 @@ async def test_update_modifiers_correctly(page, server):
     assert await page.evaluate("shiftKey") is False
 
 
-async def test_click_an_offscreen_element_when_scroll_behavior_is_smooth(page):
+async def test_click_an_offscreen_element_when_scroll_behavior_is_smooth(
+    page: Page,
+) -> None:
     await page.set_content(
         """
         <div style="border: 1px solid black; height: 500px; overflow: auto; width: 500px; scroll-behavior: smooth">
@@ -796,25 +844,30 @@ async def test_click_an_offscreen_element_when_scroll_behavior_is_smooth(page):
 
 
 async def test_report_nice_error_when_element_is_detached_and_force_clicked(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/animating-button.html")
     await page.evaluate("addButton()")
     handle = await page.query_selector("button")
+    assert handle
     await page.evaluate("stopButton(true)")
-    error = None
+    error: Optional[Error] = None
     try:
         await handle.click(force=True)
     except Error as e:
         error = e
     assert await page.evaluate("window.clicked") is None
+    assert error
     assert "Element is not attached to the DOM" in error.message
 
 
-async def test_fail_when_element_detaches_after_animation(page, server):
+async def test_fail_when_element_detaches_after_animation(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/animating-button.html")
     await page.evaluate("addButton()")
     handle = await page.query_selector("button")
+    assert handle
     promise = asyncio.create_task(handle.click())
     await asyncio.sleep(0)  # execute scheduled tasks, but don't await them
     await page.evaluate("stopButton(true)")
@@ -824,12 +877,14 @@ async def test_fail_when_element_detaches_after_animation(page, server):
     assert "Element is not attached to the DOM" in exc_info.value.message
 
 
-async def test_retry_when_element_detaches_after_animation(page, server):
+async def test_retry_when_element_detaches_after_animation(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/animating-button.html")
     await page.evaluate("addButton()")
     clicked = []
 
-    async def click():
+    async def click() -> None:
         await page.click("button")
         clicked.append(True)
 
@@ -851,7 +906,9 @@ async def click():
     assert await page.evaluate("window.clicked")
 
 
-async def test_retry_when_element_is_animating_from_outside_the_viewport(page, server):
+async def test_retry_when_element_is_animating_from_outside_the_viewport(
+    page: Page, server: Server
+) -> None:
     await page.set_content(
         """<style>
         @keyframes move {
@@ -875,6 +932,7 @@ async def test_retry_when_element_is_animating_from_outside_the_viewport(page, s
         """
     )
     handle = await page.query_selector("button")
+    assert handle
     promise = asyncio.create_task(handle.click())
     await asyncio.sleep(0)  # execute scheduled tasks, but don't await them
     await handle.evaluate("button => button.className = 'animated'")
@@ -883,8 +941,8 @@ async def test_retry_when_element_is_animating_from_outside_the_viewport(page, s
 
 
 async def test_fail_when_element_is_animating_from_outside_the_viewport_with_force(
-    page, server
-):
+    page: Page,
+) -> None:
     await page.set_content(
         """<style>
         @keyframes move {
@@ -908,19 +966,23 @@ async def test_fail_when_element_is_animating_from_outside_the_viewport_with_for
         """
     )
     handle = await page.query_selector("button")
+    assert handle
     promise = asyncio.create_task(handle.click(force=True))
     await asyncio.sleep(0)  # execute scheduled tasks, but don't await them
     await handle.evaluate("button => button.className = 'animated'")
-    error = None
+    error: Optional[Error] = None
     try:
         await promise
     except Error as e:
         error = e
     assert await page.evaluate("window.clicked") is None
+    assert error
     assert "Element is outside of the viewport" in error.message
 
 
-async def test_not_retarget_when_element_changes_on_hover(page, server):
+async def test_not_retarget_when_element_changes_on_hover(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/react.html")
     await page.evaluate(
         """() => {
@@ -932,7 +994,9 @@ async def test_not_retarget_when_element_changes_on_hover(page, server):
     assert await page.evaluate("window.button2") is None
 
 
-async def test_not_retarget_when_element_is_recycled_on_hover(page, server):
+async def test_not_retarget_when_element_is_recycled_on_hover(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/react.html")
     await page.evaluate(
         """() => {
@@ -948,14 +1012,16 @@ async def test_not_retarget_when_element_is_recycled_on_hover(page, server):
     assert await page.evaluate("window.button2")
 
 
-async def test_click_the_button_when_window_inner_width_is_corrupted(page, server):
+async def test_click_the_button_when_window_inner_width_is_corrupted(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.evaluate("window.innerWidth = 0")
     await page.click("button")
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_timeout_when_click_opens_alert(page, server):
+async def test_timeout_when_click_opens_alert(page: Page, server: Server) -> None:
     await page.set_content('<div onclick="window.alert(123)">Click me</div>')
     async with page.expect_event("dialog") as dialog_info:
         with pytest.raises(Error) as exc_info:
@@ -965,31 +1031,31 @@ async def test_timeout_when_click_opens_alert(page, server):
     await dialog.dismiss()
 
 
-async def test_check_the_box(page):
+async def test_check_the_box(page: Page) -> None:
     await page.set_content('<input id="checkbox" type="checkbox"></input>')
     await page.check("input")
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_not_check_the_checked_box(page):
+async def test_not_check_the_checked_box(page: Page) -> None:
     await page.set_content('<input id="checkbox" type="checkbox" checked></input>')
     await page.check("input")
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_uncheck_the_box(page):
+async def test_uncheck_the_box(page: Page) -> None:
     await page.set_content('<input id="checkbox" type="checkbox" checked></input>')
     await page.uncheck("input")
     assert await page.evaluate("checkbox.checked") is False
 
 
-async def test_not_uncheck_the_unchecked_box(page):
+async def test_not_uncheck_the_unchecked_box(page: Page) -> None:
     await page.set_content('<input id="checkbox" type="checkbox"></input>')
     await page.uncheck("input")
     assert await page.evaluate("checkbox.checked") is False
 
 
-async def test_check_the_box_by_label(page):
+async def test_check_the_box_by_label(page: Page) -> None:
     await page.set_content(
         '<label for="checkbox"><input id="checkbox" type="checkbox"></input></label>'
     )
@@ -997,7 +1063,7 @@ async def test_check_the_box_by_label(page):
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_check_the_box_outside_label(page):
+async def test_check_the_box_outside_label(page: Page) -> None:
     await page.set_content(
         '<label for="checkbox">Text</label><div><input id="checkbox" type="checkbox"></input></div>'
     )
@@ -1005,7 +1071,7 @@ async def test_check_the_box_outside_label(page):
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_check_the_box_inside_label_without_id(page):
+async def test_check_the_box_inside_label_without_id(page: Page) -> None:
     await page.set_content(
         '<label>Text<span><input id="checkbox" type="checkbox"></input></span></label>'
     )
@@ -1013,7 +1079,7 @@ async def test_check_the_box_inside_label_without_id(page):
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_check_radio(page):
+async def test_check_radio(page: Page) -> None:
     await page.set_content(
         """
         <input type='radio'>one</input>
@@ -1024,7 +1090,7 @@ async def test_check_radio(page):
     assert await page.evaluate("two.checked")
 
 
-async def test_check_the_box_by_aria_role(page):
+async def test_check_the_box_by_aria_role(page: Page) -> None:
     await page.set_content(
         """<div role='checkbox' id='checkbox'>CHECKBOX</div>
         <script>
diff --git a/tests/async/test_console.py b/tests/async/test_console.py
index 82b262633..b9a4102a8 100644
--- a/tests/async/test_console.py
+++ b/tests/async/test_console.py
@@ -17,9 +17,10 @@
 import pytest
 
 from playwright.async_api import ConsoleMessage, Page
+from tests.server import Server
 
 
-async def test_console_should_work(page: Page, browser_name):
+async def test_console_should_work(page: Page, browser_name: str) -> None:
     messages: List[ConsoleMessage] = []
     page.once("console", lambda m: messages.append(m))
     async with page.expect_console_message() as message_info:
@@ -37,14 +38,14 @@ async def test_console_should_work(page: Page, browser_name):
     assert await message.args[2].json_value() == {"foo": "bar"}
 
 
-async def test_console_should_emit_same_log_twice(page):
+async def test_console_should_emit_same_log_twice(page: Page) -> None:
     messages = []
     page.on("console", lambda m: messages.append(m.text))
     await page.evaluate('() => { for (let i = 0; i < 2; ++i ) console.log("hello"); } ')
     assert messages == ["hello", "hello"]
 
 
-async def test_console_should_use_text_for__str__(page):
+async def test_console_should_use_text_for__str__(page: Page) -> None:
     messages = []
     page.on("console", lambda m: messages.append(m))
     await page.evaluate('() => console.log("Hello world")')
@@ -52,8 +53,8 @@ async def test_console_should_use_text_for__str__(page):
     assert str(messages[0]) == "Hello world"
 
 
-async def test_console_should_work_for_different_console_api_calls(page, server):
-    messages = []
+async def test_console_should_work_for_different_console_api_calls(page: Page) -> None:
+    messages: List[ConsoleMessage] = []
     page.on("console", lambda m: messages.append(m))
     # All console events will be reported before 'page.evaluate' is finished.
     await page.evaluate(
@@ -87,7 +88,9 @@ async def test_console_should_work_for_different_console_api_calls(page, server)
     ]
 
 
-async def test_console_should_not_fail_for_window_object(page, browser_name):
+async def test_console_should_not_fail_for_window_object(
+    page: Page, browser_name: str
+) -> None:
     async with page.expect_console_message() as message_info:
         await page.evaluate("console.error(window)")
     message = await message_info.value
@@ -99,7 +102,7 @@ async def test_console_should_not_fail_for_window_object(page, browser_name):
 
 # Upstream issue https://bugs.webkit.org/show_bug.cgi?id=229515
 @pytest.mark.skip_browser("webkit")
-async def test_console_should_trigger_correct_log(page, server):
+async def test_console_should_trigger_correct_log(page: Page, server: Server) -> None:
     await page.goto("about:blank")
     async with page.expect_console_message() as message_info:
         await page.evaluate("async url => fetch(url).catch(e => {})", server.EMPTY_PAGE)
@@ -108,7 +111,9 @@ async def test_console_should_trigger_correct_log(page, server):
     assert message.type == "error"
 
 
-async def test_console_should_have_location_for_console_api_calls(page, server):
+async def test_console_should_have_location_for_console_api_calls(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_console_message() as message_info:
         await page.goto(server.PREFIX + "/consolelog.html")
@@ -122,8 +127,8 @@ async def test_console_should_have_location_for_console_api_calls(page, server):
 
 
 async def test_console_should_not_throw_when_there_are_console_messages_in_detached_iframes(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_popup() as page_info:
         await page.evaluate(
diff --git a/tests/async/test_context_manager.py b/tests/async/test_context_manager.py
index 059ed5eb8..f54263157 100644
--- a/tests/async/test_context_manager.py
+++ b/tests/async/test_context_manager.py
@@ -12,12 +12,16 @@
 # 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 BrowserContext, BrowserType
 
 
-async def test_context_managers(browser_type: BrowserType, launch_arguments):
+async def test_context_managers(
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
     async with await browser_type.launch(**launch_arguments) as browser:
         async with await browser.new_context() as context:
             async with await context.new_page():
@@ -28,7 +32,7 @@ async def test_context_managers(browser_type: BrowserType, launch_arguments):
     assert not browser.is_connected()
 
 
-async def test_context_managers_not_hang(context: BrowserContext):
+async def test_context_managers_not_hang(context: BrowserContext) -> None:
     with pytest.raises(Exception, match="Oops!"):
         async with await context.new_page():
             raise Exception("Oops!")
diff --git a/tests/async/test_defaultbrowsercontext.py b/tests/async/test_defaultbrowsercontext.py
index ea4b77eb7..e5d06ff96 100644
--- a/tests/async/test_defaultbrowsercontext.py
+++ b/tests/async/test_defaultbrowsercontext.py
@@ -14,30 +14,43 @@
 
 import asyncio
 import os
+from pathlib import Path
+from typing import Any, AsyncGenerator, Awaitable, Callable, Dict, Optional, Tuple
 
 import pytest
 
-from playwright.async_api import Error, expect
+from playwright.async_api import BrowserContext, BrowserType, Error, Page, expect
+from tests.server import Server
+from tests.utils import must
+
+from .utils import Utils
 
 
 @pytest.fixture()
-async def launch_persistent(tmpdir, launch_arguments, browser_type):
-    context = None
+async def launch_persistent(
+    tmpdir: Path, launch_arguments: Dict, browser_type: BrowserType
+) -> AsyncGenerator[Callable[..., Awaitable[Tuple[Page, BrowserContext]]], None]:
+    context: Optional[BrowserContext] = None
 
-    async def _launch(**options):
+    async def _launch(**options: Any) -> Tuple[Page, BrowserContext]:
         nonlocal context
         if context:
             raise ValueError("can only launch one persistent context")
         context = await browser_type.launch_persistent_context(
             str(tmpdir), **{**launch_arguments, **options}
         )
+        assert context
         return (context.pages[0], context)
 
     yield _launch
-    await context.close()
+    await must(context).close()
 
 
-async def test_context_cookies_should_work(server, launch_persistent, is_chromium):
+async def test_context_cookies_should_work(
+    server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+    is_chromium: bool,
+) -> None:
     (page, context) = await launch_persistent()
     await page.goto(server.EMPTY_PAGE)
     document_cookie = await page.evaluate(
@@ -62,7 +75,11 @@ async def test_context_cookies_should_work(server, launch_persistent, is_chromiu
     ]
 
 
-async def test_context_add_cookies_should_work(server, launch_persistent, is_chromium):
+async def test_context_add_cookies_should_work(
+    server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+    is_chromium: bool,
+) -> None:
     (page, context) = await launch_persistent()
     await page.goto(server.EMPTY_PAGE)
     await page.context.add_cookies(
@@ -83,7 +100,10 @@ async def test_context_add_cookies_should_work(server, launch_persistent, is_chr
     ]
 
 
-async def test_context_clear_cookies_should_work(server, launch_persistent):
+async def test_context_clear_cookies_should_work(
+    server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent()
     await page.goto(server.EMPTY_PAGE)
     await page.context.add_cookies(
@@ -100,8 +120,10 @@ async def test_context_clear_cookies_should_work(server, launch_persistent):
 
 
 async def test_should_not_block_third_party_cookies(
-    server, launch_persistent, is_chromium, is_firefox
-):
+    server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+    is_firefox: bool,
+) -> None:
     (page, context) = await launch_persistent()
     await page.goto(server.EMPTY_PAGE)
     await page.evaluate(
@@ -144,19 +166,27 @@ async def test_should_not_block_third_party_cookies(
         assert cookies == []
 
 
-async def test_should_support_viewport_option(launch_persistent, utils):
+async def test_should_support_viewport_option(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+    utils: Utils,
+) -> None:
     (page, context) = await launch_persistent(viewport={"width": 456, "height": 789})
     await utils.verify_viewport(page, 456, 789)
     page2 = await context.new_page()
     await utils.verify_viewport(page2, 456, 789)
 
 
-async def test_should_support_device_scale_factor_option(launch_persistent, utils):
+async def test_should_support_device_scale_factor_option(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(device_scale_factor=3)
     assert await page.evaluate("window.devicePixelRatio") == 3
 
 
-async def test_should_support_user_agent_option(launch_persistent, server):
+async def test_should_support_user_agent_option(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+    server: Server,
+) -> None:
     (page, context) = await launch_persistent(user_agent="foobar")
     assert await page.evaluate("() => navigator.userAgent") == "foobar"
     [request, _] = await asyncio.gather(
@@ -166,14 +196,20 @@ async def test_should_support_user_agent_option(launch_persistent, server):
     assert request.getHeader("user-agent") == "foobar"
 
 
-async def test_should_support_bypass_csp_option(launch_persistent, server):
+async def test_should_support_bypass_csp_option(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+    server: Server,
+) -> None:
     (page, context) = await launch_persistent(bypass_csp=True)
     await page.goto(server.PREFIX + "/csp.html")
     await page.add_script_tag(content="window.__injected = 42;")
     assert await page.evaluate("() => window.__injected") == 42
 
 
-async def test_should_support_javascript_enabled_option(launch_persistent, is_webkit):
+async def test_should_support_javascript_enabled_option(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+    is_webkit: bool,
+) -> None:
     (page, context) = await launch_persistent(java_script_enabled=False)
     await page.goto('data:text/html, <script>var something = "forbidden"</script>')
     with pytest.raises(Error) as exc:
@@ -184,29 +220,42 @@ async def test_should_support_javascript_enabled_option(launch_persistent, is_we
         assert "something is not defined" in exc.value.message
 
 
-async def test_should_support_http_credentials_option(server, launch_persistent):
+async def test_should_support_http_credentials_option(
+    server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(
         http_credentials={"username": "user", "password": "pass"}
     )
     server.set_auth("/playground.html", "user", "pass")
     response = await page.goto(server.PREFIX + "/playground.html")
+    assert response
     assert response.status == 200
 
 
-async def test_should_support_offline_option(server, launch_persistent):
+async def test_should_support_offline_option(
+    server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(offline=True)
     with pytest.raises(Error):
         await page.goto(server.EMPTY_PAGE)
 
 
-async def test_should_support_has_touch_option(server, launch_persistent):
+async def test_should_support_has_touch_option(
+    server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(has_touch=True)
     await page.goto(server.PREFIX + "/mobile.html")
     assert await page.evaluate('() => "ontouchstart" in window')
 
 
 @pytest.mark.skip_browser("firefox")
-async def test_should_work_in_persistent_context(server, launch_persistent):
+async def test_should_work_in_persistent_context(
+    server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     # Firefox does not support mobile.
     (page, context) = await launch_persistent(
         viewport={"width": 320, "height": 480}, is_mobile=True
@@ -215,7 +264,9 @@ async def test_should_work_in_persistent_context(server, launch_persistent):
     assert await page.evaluate("() => window.innerWidth") == 980
 
 
-async def test_should_support_color_scheme_option(server, launch_persistent):
+async def test_should_support_color_scheme_option(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(color_scheme="dark")
     assert (
         await page.evaluate('() => matchMedia("(prefers-color-scheme: light)").matches')
@@ -226,7 +277,9 @@ async def test_should_support_color_scheme_option(server, launch_persistent):
     )
 
 
-async def test_should_support_timezone_id_option(launch_persistent):
+async def test_should_support_timezone_id_option(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(timezone_id="America/Jamaica")
     assert (
         await page.evaluate("() => new Date(1479579154987).toString()")
@@ -234,14 +287,17 @@ async def test_should_support_timezone_id_option(launch_persistent):
     )
 
 
-async def test_should_support_locale_option(launch_persistent):
+async def test_should_support_locale_option(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(locale="fr-FR")
     assert await page.evaluate("() => navigator.language") == "fr-FR"
 
 
 async def test_should_support_geolocation_and_permission_option(
-    server, launch_persistent
-):
+    server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(
         geolocation={"longitude": 10, "latitude": 10}, permissions=["geolocation"]
     )
@@ -255,14 +311,19 @@ async def test_should_support_geolocation_and_permission_option(
 
 
 async def test_should_support_ignore_https_errors_option(
-    https_server, launch_persistent
-):
+    https_server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(ignore_https_errors=True)
     response = await page.goto(https_server.EMPTY_PAGE)
+    assert response
     assert response.ok
 
 
-async def test_should_support_extra_http_headers_option(server, launch_persistent):
+async def test_should_support_extra_http_headers_option(
+    server: Server,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(extra_http_headers={"foo": "bar"})
     [request, _] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
@@ -271,7 +332,10 @@ async def test_should_support_extra_http_headers_option(server, launch_persisten
     assert request.getHeader("foo") == "bar"
 
 
-async def test_should_accept_user_data_dir(server, tmpdir, launch_persistent):
+async def test_should_accept_user_data_dir(
+    tmpdir: Path,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent()
     # Note: we need an open page to make sure its functional.
     assert len(os.listdir(tmpdir)) > 0
@@ -280,8 +344,11 @@ async def test_should_accept_user_data_dir(server, tmpdir, launch_persistent):
 
 
 async def test_should_restore_state_from_userDataDir(
-    browser_type, launch_arguments, server, tmp_path_factory
-):
+    browser_type: BrowserType,
+    launch_arguments: Dict,
+    server: Server,
+    tmp_path_factory: pytest.TempPathFactory,
+) -> None:
     user_data_dir1 = tmp_path_factory.mktemp("test")
     browser_context = await browser_type.launch_persistent_context(
         user_data_dir1, **launch_arguments
@@ -309,7 +376,9 @@ async def test_should_restore_state_from_userDataDir(
     await browser_context3.close()
 
 
-async def test_should_have_default_url_when_launching_browser(launch_persistent):
+async def test_should_have_default_url_when_launching_browser(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent()
     urls = list(map(lambda p: p.url, context.pages))
     assert urls == ["about:blank"]
@@ -317,28 +386,35 @@ async def test_should_have_default_url_when_launching_browser(launch_persistent)
 
 @pytest.mark.skip_browser("firefox")
 async def test_should_throw_if_page_argument_is_passed(
-    browser_type, server, tmpdir, launch_arguments
-):
+    browser_type: BrowserType, server: Server, tmpdir: Path, launch_arguments: Dict
+) -> None:
     options = {**launch_arguments, "args": [server.EMPTY_PAGE]}
     with pytest.raises(Error) as exc:
         await browser_type.launch_persistent_context(tmpdir, **options)
     assert "can not specify page" in exc.value.message
 
 
-async def test_should_fire_close_event_for_a_persistent_context(launch_persistent):
+async def test_should_fire_close_event_for_a_persistent_context(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent()
-    fired_event = asyncio.Future()
-    context.on("close", lambda: fired_event.set_result(True))
+    fired_event: "asyncio.Future[bool]" = asyncio.Future()
+    context.on("close", lambda _: fired_event.set_result(True))
     await context.close()
     await fired_event
 
 
-async def test_should_support_reduced_motion(launch_persistent):
+async def test_should_support_reduced_motion(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent(reduced_motion="reduce")
     assert await page.evaluate("matchMedia('(prefers-reduced-motion: reduce)').matches")
 
 
-async def test_should_support_har_option(browser, server, assetdir, launch_persistent):
+async def test_should_support_har_option(
+    assetdir: Path,
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
     (page, context) = await launch_persistent()
     await page.route_from_har(har=assetdir / "har-fulfill.har")
     await page.goto("http://no.playwright/")
diff --git a/tests/async/test_device_descriptors.py b/tests/async/test_device_descriptors.py
index ee2e72cdd..f14fc1ffd 100644
--- a/tests/async/test_device_descriptors.py
+++ b/tests/async/test_device_descriptors.py
@@ -11,11 +11,15 @@
 # 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
+
 import pytest
 
+from playwright.async_api import Playwright
+
 
 @pytest.mark.only_browser("chromium")
-async def test_should_work(playwright, launch_arguments) -> None:
+async def test_should_work(playwright: Playwright, launch_arguments: Dict) -> None:
     device_descriptor = playwright.devices["Pixel 2"]
     device_type = device_descriptor["default_browser_type"]
     browser = await playwright[device_type].launch(**launch_arguments)
diff --git a/tests/async/test_dialog.py b/tests/async/test_dialog.py
index 41028d134..7ad32f8bc 100644
--- a/tests/async/test_dialog.py
+++ b/tests/async/test_dialog.py
@@ -12,13 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from playwright.async_api import Dialog, Page
+from playwright.async_api import Browser, Dialog, Page
 
 
-async def test_should_fire(page: Page, server):
+async def test_should_fire(page: Page) -> None:
     result = []
 
-    async def on_dialog(dialog: Dialog):
+    async def on_dialog(dialog: Dialog) -> None:
         result.append(True)
         assert dialog.type == "alert"
         assert dialog.default_value == ""
@@ -30,10 +30,10 @@ async def on_dialog(dialog: Dialog):
     assert result
 
 
-async def test_should_allow_accepting_prompts(page: Page, server):
+async def test_should_allow_accepting_prompts(page: Page) -> None:
     result = []
 
-    async def on_dialog(dialog: Dialog):
+    async def on_dialog(dialog: Dialog) -> None:
         result.append(True)
         assert dialog.type == "prompt"
         assert dialog.default_value == "yes."
@@ -45,10 +45,10 @@ async def on_dialog(dialog: Dialog):
     assert result
 
 
-async def test_should_dismiss_the_prompt(page: Page, server):
+async def test_should_dismiss_the_prompt(page: Page) -> None:
     result = []
 
-    async def on_dialog(dialog: Dialog):
+    async def on_dialog(dialog: Dialog) -> None:
         result.append(True)
         await dialog.dismiss()
 
@@ -57,10 +57,10 @@ async def on_dialog(dialog: Dialog):
     assert result
 
 
-async def test_should_accept_the_confirm_prompt(page: Page, server):
+async def test_should_accept_the_confirm_prompt(page: Page) -> None:
     result = []
 
-    async def on_dialog(dialog: Dialog):
+    async def on_dialog(dialog: Dialog) -> None:
         result.append(True)
         await dialog.accept()
 
@@ -69,10 +69,10 @@ async def on_dialog(dialog: Dialog):
     assert result
 
 
-async def test_should_dismiss_the_confirm_prompt(page: Page, server):
+async def test_should_dismiss_the_confirm_prompt(page: Page) -> None:
     result = []
 
-    async def on_dialog(dialog: Dialog):
+    async def on_dialog(dialog: Dialog) -> None:
         result.append(True)
         await dialog.dismiss()
 
@@ -81,7 +81,9 @@ async def on_dialog(dialog: Dialog):
     assert result
 
 
-async def test_should_be_able_to_close_context_with_open_alert(browser):
+async def test_should_be_able_to_close_context_with_open_alert(
+    browser: Browser,
+) -> None:
     context = await browser.new_context()
     page = await context.new_page()
     async with page.expect_event("dialog"):
@@ -89,12 +91,12 @@ async def test_should_be_able_to_close_context_with_open_alert(browser):
     await context.close()
 
 
-async def test_should_auto_dismiss_the_prompt_without_listeners(page):
+async def test_should_auto_dismiss_the_prompt_without_listeners(page: Page) -> None:
     result = await page.evaluate('() => prompt("question?")')
     assert not result
 
 
-async def test_should_auto_dismiss_the_alert_without_listeners(page):
+async def test_should_auto_dismiss_the_alert_without_listeners(page: Page) -> None:
     await page.set_content(
         '<div onclick="window.alert(123); window._clicked=true">Click me</div>'
     )
diff --git a/tests/async/test_dispatch_event.py b/tests/async/test_dispatch_event.py
index 897d797ef..50b02ba2e 100644
--- a/tests/async/test_dispatch_event.py
+++ b/tests/async/test_dispatch_event.py
@@ -13,13 +13,21 @@
 # limitations under the License.
 
 
-async def test_should_dispatch_click_event(page, server):
+from playwright.async_api import Page, Selectors
+from tests.server import Server
+
+from .utils import Utils
+
+
+async def test_should_dispatch_click_event(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.dispatch_event("button", "click")
     assert await page.evaluate("() => result") == "Clicked"
 
 
-async def test_should_dispatch_click_event_properties(page, server):
+async def test_should_dispatch_click_event_properties(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.dispatch_event("button", "click")
     assert await page.evaluate("() => bubbles")
@@ -27,7 +35,7 @@ async def test_should_dispatch_click_event_properties(page, server):
     assert await page.evaluate("() => composed")
 
 
-async def test_should_dispatch_click_svg(page):
+async def test_should_dispatch_click_svg(page: Page) -> None:
     await page.set_content(
         """
       <svg height="100" width="100">
@@ -39,7 +47,9 @@ async def test_should_dispatch_click_svg(page):
     assert await page.evaluate("() => window.__CLICKED") == 42
 
 
-async def test_should_dispatch_click_on_a_span_with_an_inline_element_inside(page):
+async def test_should_dispatch_click_on_a_span_with_an_inline_element_inside(
+    page: Page,
+) -> None:
     await page.set_content(
         """
       <style>
@@ -54,7 +64,9 @@ async def test_should_dispatch_click_on_a_span_with_an_inline_element_inside(pag
     assert await page.evaluate("() => window.CLICKED") == 42
 
 
-async def test_should_dispatch_click_after_navigation(page, server):
+async def test_should_dispatch_click_after_navigation(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.dispatch_event("button", "click")
     await page.goto(server.PREFIX + "/input/button.html")
@@ -62,7 +74,9 @@ async def test_should_dispatch_click_after_navigation(page, server):
     assert await page.evaluate("() => result") == "Clicked"
 
 
-async def test_should_dispatch_click_after_a_cross_origin_navigation(page, server):
+async def test_should_dispatch_click_after_a_cross_origin_navigation(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.dispatch_event("button", "click")
     await page.goto(server.CROSS_PROCESS_PREFIX + "/input/button.html")
@@ -70,7 +84,7 @@ async def test_should_dispatch_click_after_a_cross_origin_navigation(page, serve
     assert await page.evaluate("() => result") == "Clicked"
 
 
-async def test_should_not_fail_when_element_is_blocked_on_hover(page, server):
+async def test_should_not_fail_when_element_is_blocked_on_hover(page: Page) -> None:
     await page.set_content(
         """<style>
       container { display: block; position: relative; width: 200px; height: 50px; }
@@ -87,7 +101,9 @@ async def test_should_not_fail_when_element_is_blocked_on_hover(page, server):
     assert await page.evaluate("() => window.clicked")
 
 
-async def test_should_dispatch_click_when_node_is_added_in_shadow_dom(page, server):
+async def test_should_dispatch_click_when_node_is_added_in_shadow_dom(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     watchdog = page.dispatch_event("span", "click")
     await page.evaluate(
@@ -110,7 +126,7 @@ async def test_should_dispatch_click_when_node_is_added_in_shadow_dom(page, serv
     assert await page.evaluate("() => window.clicked")
 
 
-async def test_should_be_atomic(selectors, page, utils):
+async def test_should_be_atomic(selectors: Selectors, page: Page, utils: Utils) -> None:
     await utils.register_selector_engine(
         selectors,
         "dispatch_event",
@@ -135,7 +151,7 @@ async def test_should_be_atomic(selectors, page, utils):
     assert await page.evaluate("() => window._clicked")
 
 
-async def test_should_dispatch_drag_drop_events(page, server):
+async def test_should_dispatch_drag_drop_events(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/drag-n-drop.html")
     dataTransfer = await page.evaluate_handle("() => new DataTransfer()")
     await page.dispatch_event("#source", "dragstart", {"dataTransfer": dataTransfer})
@@ -147,12 +163,16 @@ async def test_should_dispatch_drag_drop_events(page, server):
     )
 
 
-async def test_should_dispatch_drag_and_drop_events_element_handle(page, server):
+async def test_should_dispatch_drag_and_drop_events_element_handle(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/drag-n-drop.html")
     dataTransfer = await page.evaluate_handle("() => new DataTransfer()")
     source = await page.query_selector("#source")
+    assert source
     await source.dispatch_event("dragstart", {"dataTransfer": dataTransfer})
     target = await page.query_selector("#target")
+    assert target
     await target.dispatch_event("drop", {"dataTransfer": dataTransfer})
     assert await page.evaluate(
         """() => {
@@ -161,8 +181,11 @@ async def test_should_dispatch_drag_and_drop_events_element_handle(page, server)
     )
 
 
-async def test_should_dispatch_click_event_element_handle(page, server):
+async def test_should_dispatch_click_event_element_handle(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = await page.query_selector("button")
+    assert button
     await button.dispatch_event("click")
     assert await page.evaluate("() => result") == "Clicked"
diff --git a/tests/async/test_download.py b/tests/async/test_download.py
index a0f9f1ab5..94a329606 100644
--- a/tests/async/test_download.py
+++ b/tests/async/test_download.py
@@ -15,27 +15,29 @@
 import os
 from asyncio.futures import Future
 from pathlib import Path
+from typing import Callable, Generator
 
 import pytest
 
-from playwright.async_api import Browser, Error, Page
+from playwright.async_api import Browser, Download, Error, Page
+from tests.server import HttpRequestWithPostBody, Server
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
-def assert_file_content(path, content):
+def assert_file_content(path: Path, content: str) -> None:
     with open(path, "r") as fd:
         assert fd.read() == content
 
 
 @pytest.fixture(autouse=True)
-def after_each_hook(server):
-    def handle_download(request):
+def after_each_hook(server: Server) -> Generator[None, None, None]:
+    def handle_download(request: HttpRequestWithPostBody) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.setHeader("Content-Disposition", "attachment")
         request.write(b"Hello world")
         request.finish()
 
-    def handle_download_with_file_name(request):
+    def handle_download_with_file_name(request: HttpRequestWithPostBody) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.setHeader("Content-Disposition", "attachment; filename=file.txt")
         request.write(b"Hello world")
@@ -46,7 +48,9 @@ def handle_download_with_file_name(request):
     yield
 
 
-async def test_should_report_downloads_with_accept_downloads_false(page: Page, server):
+async def test_should_report_downloads_with_accept_downloads_false(
+    page: Page, server: Server
+) -> None:
     await page.set_content(
         f'<a href="{server.PREFIX}/downloadWithFilename">download</a>'
     )
@@ -63,7 +67,9 @@ async def test_should_report_downloads_with_accept_downloads_false(page: Page, s
     assert await download.path()
 
 
-async def test_should_report_downloads_with_accept_downloads_true(browser, server):
+async def test_should_report_downloads_with_accept_downloads_true(
+    browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
@@ -75,7 +81,9 @@ async def test_should_report_downloads_with_accept_downloads_true(browser, serve
     await page.close()
 
 
-async def test_should_save_to_user_specified_path(tmpdir: Path, browser, server):
+async def test_should_save_to_user_specified_path(
+    tmpdir: Path, browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
@@ -89,8 +97,8 @@ async def test_should_save_to_user_specified_path(tmpdir: Path, browser, server)
 
 
 async def test_should_save_to_user_specified_path_without_updating_original_path(
-    tmpdir, browser, server
-):
+    tmpdir: Path, browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
@@ -108,8 +116,8 @@ async def test_should_save_to_user_specified_path_without_updating_original_path
 
 
 async def test_should_save_to_two_different_paths_with_multiple_save_as_calls(
-    tmpdir, browser, server
-):
+    tmpdir: Path, browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
@@ -127,7 +135,9 @@ async def test_should_save_to_two_different_paths_with_multiple_save_as_calls(
     await page.close()
 
 
-async def test_should_save_to_overwritten_filepath(tmpdir: Path, browser, server):
+async def test_should_save_to_overwritten_filepath(
+    tmpdir: Path, browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
@@ -144,8 +154,8 @@ async def test_should_save_to_overwritten_filepath(tmpdir: Path, browser, server
 
 
 async def test_should_create_subdirectories_when_saving_to_non_existent_user_specified_path(
-    tmpdir, browser, server
-):
+    tmpdir: Path, browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
@@ -159,8 +169,8 @@ async def test_should_create_subdirectories_when_saving_to_non_existent_user_spe
 
 
 async def test_should_error_when_saving_with_downloads_disabled(
-    tmpdir, browser, server
-):
+    tmpdir: Path, browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=False)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
@@ -176,7 +186,9 @@ async def test_should_error_when_saving_with_downloads_disabled(
     await page.close()
 
 
-async def test_should_error_when_saving_after_deletion(tmpdir, browser, server):
+async def test_should_error_when_saving_after_deletion(
+    tmpdir: Path, browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
@@ -190,9 +202,11 @@ async def test_should_error_when_saving_after_deletion(tmpdir, browser, server):
     await page.close()
 
 
-async def test_should_report_non_navigation_downloads(browser, server):
+async def test_should_report_non_navigation_downloads(
+    browser: Browser, server: Server
+) -> None:
     # Mac WebKit embedder does not download in this case, although Safari does.
-    def handle_download(request):
+    def handle_download(request: HttpRequestWithPostBody) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.write(b"Hello world")
         request.finish()
@@ -215,12 +229,12 @@ def handle_download(request):
 
 
 async def test_report_download_path_within_page_on_download_handler_for_files(
-    browser: Browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
-    on_download_path: Future[str] = asyncio.Future()
+    on_download_path: Future[Path] = asyncio.Future()
 
-    async def on_download(download):
+    async def on_download(download: Download) -> None:
         on_download_path.set_result(await download.path())
 
     page.once(
@@ -235,12 +249,12 @@ async def on_download(download):
 
 
 async def test_download_report_download_path_within_page_on_handle_for_blobs(
-    browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
-    on_download_path = asyncio.Future()
+    on_download_path: "asyncio.Future[Path]" = asyncio.Future()
 
-    async def on_download(download):
+    async def on_download(download: Download) -> None:
         on_download_path.set_result(await download.path())
 
     page.once(
@@ -256,10 +270,12 @@ async def on_download(download):
 
 
 @pytest.mark.only_browser("chromium")
-async def test_should_report_alt_click_downloads(browser, server):
+async def test_should_report_alt_click_downloads(
+    browser: Browser, server: Server
+) -> None:
     # Firefox does not download on alt-click by default.
     # Our WebKit embedder does not download on alt-click, although Safari does.
-    def handle_download(request):
+    def handle_download(request: HttpRequestWithPostBody) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.write(b"Hello world")
         request.finish()
@@ -278,7 +294,9 @@ def handle_download(request):
     await page.close()
 
 
-async def test_should_report_new_window_downloads(browser, server):
+async def test_should_report_new_window_downloads(
+    browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(
         f'<a target=_blank href="{server.PREFIX}/download">download</a>'
@@ -291,7 +309,7 @@ async def test_should_report_new_window_downloads(browser, server):
     await page.close()
 
 
-async def test_should_delete_file(browser, server):
+async def test_should_delete_file(browser: Browser, server: Server) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
@@ -304,7 +322,9 @@ async def test_should_delete_file(browser, server):
     await page.close()
 
 
-async def test_should_delete_downloads_on_context_destruction(browser, server):
+async def test_should_delete_downloads_on_context_destruction(
+    browser: Browser, server: Server
+) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
@@ -322,7 +342,9 @@ async def test_should_delete_downloads_on_context_destruction(browser, server):
     assert os.path.exists(path2) is False
 
 
-async def test_should_delete_downloads_on_browser_gone(browser_factory, server):
+async def test_should_delete_downloads_on_browser_gone(
+    browser_factory: "Callable[..., asyncio.Future[Browser]]", server: Server
+) -> None:
     browser = await browser_factory()
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
@@ -342,8 +364,8 @@ async def test_should_delete_downloads_on_browser_gone(browser_factory, server):
     assert os.path.exists(os.path.join(path1, "..")) is False
 
 
-async def test_download_cancel_should_work(browser, server):
-    def handle_download(request):
+async def test_download_cancel_should_work(browser: Browser, server: Server) -> None:
+    def handle_download(request: HttpRequestWithPostBody) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.setHeader("Content-Disposition", "attachment")
         # Chromium requires a large enough payload to trigger the download event soon enough
diff --git a/tests/async/test_element_handle.py b/tests/async/test_element_handle.py
index f5abad03c..3de959186 100644
--- a/tests/async/test_element_handle.py
+++ b/tests/async/test_element_handle.py
@@ -13,52 +13,63 @@
 # limitations under the License.
 
 import asyncio
+from typing import Optional, cast
 
 import pytest
 
-from playwright.async_api import Error, Page
+from playwright.async_api import Browser, ElementHandle, Error, FloatRect, Page
 from tests.server import Server
 
+from .utils import Utils
 
-async def test_bounding_box(page, server):
+
+async def test_bounding_box(page: Page, server: Server) -> None:
     await page.set_viewport_size({"width": 500, "height": 500})
     await page.goto(server.PREFIX + "/grid.html")
     element_handle = await page.query_selector(".box:nth-of-type(13)")
+    assert element_handle
     box = await element_handle.bounding_box()
     assert box == {"x": 100, "y": 50, "width": 50, "height": 50}
 
 
-async def test_bounding_box_handle_nested_frames(page, server):
+async def test_bounding_box_handle_nested_frames(page: Page, server: Server) -> None:
     await page.set_viewport_size({"width": 500, "height": 500})
     await page.goto(server.PREFIX + "/frames/nested-frames.html")
     nested_frame = page.frame(name="dos")
+    assert nested_frame
     element_handle = await nested_frame.query_selector("div")
+    assert element_handle
     box = await element_handle.bounding_box()
     assert box == {"x": 24, "y": 224, "width": 268, "height": 18}
 
 
-async def test_bounding_box_return_null_for_invisible_elements(page, server):
+async def test_bounding_box_return_null_for_invisible_elements(
+    page: Page, server: Server
+) -> None:
     await page.set_content('<div style="display:none">hi</div>')
     element = await page.query_selector("div")
+    assert element
     assert await element.bounding_box() is None
 
 
-async def test_bounding_box_force_a_layout(page, server):
+async def test_bounding_box_force_a_layout(page: Page, server: Server) -> None:
     await page.set_viewport_size({"width": 500, "height": 500})
     await page.set_content('<div style="width: 100px; height: 100px">hello</div>')
     element_handle = await page.query_selector("div")
+    assert element_handle
     await page.evaluate('element => element.style.height = "200px"', element_handle)
     box = await element_handle.bounding_box()
     assert box == {"x": 8, "y": 8, "width": 100, "height": 200}
 
 
-async def test_bounding_box_with_SVG_nodes(page, server):
+async def test_bounding_box_with_SVG_nodes(page: Page, server: Server) -> None:
     await page.set_content(
         """<svg xmlns="http://www.w3.org/2000/svg" width="500" height="500">
              <rect id="theRect" x="30" y="50" width="200" height="300"></rect>
            </svg>"""
     )
     element = await page.query_selector("#therect")
+    assert element
     pw_bounding_box = await element.bounding_box()
     web_bounding_box = await page.evaluate(
         """e => {
@@ -71,13 +82,14 @@ async def test_bounding_box_with_SVG_nodes(page, server):
 
 
 @pytest.mark.skip_browser("firefox")
-async def test_bounding_box_with_page_scale(browser, server):
+async def test_bounding_box_with_page_scale(browser: Browser, server: Server) -> None:
     context = await browser.new_context(
         viewport={"width": 400, "height": 400}, is_mobile=True
     )
     page = await context.new_page()
     await page.goto(server.PREFIX + "/input/button.html")
     button = await page.query_selector("button")
+    assert button
     await button.evaluate(
         """button => {
             document.body.style.margin = '0'
@@ -90,6 +102,7 @@ async def test_bounding_box_with_page_scale(browser, server):
     )
 
     box = await button.bounding_box()
+    assert box
     assert round(box["x"] * 100) == 17 * 100
     assert round(box["y"] * 100) == 23 * 100
     assert round(box["width"] * 100) == 200 * 100
@@ -97,7 +110,9 @@ async def test_bounding_box_with_page_scale(browser, server):
     await context.close()
 
 
-async def test_bounding_box_when_inline_box_child_is_outside_of_viewport(page, server):
+async def test_bounding_box_when_inline_box_child_is_outside_of_viewport(
+    page: Page,
+) -> None:
     await page.set_content(
         """
             <style>
@@ -114,6 +129,7 @@ async def test_bounding_box_when_inline_box_child_is_outside_of_viewport(page, s
         """
     )
     handle = await page.query_selector("span")
+    assert handle
     box = await handle.bounding_box()
     web_bounding_box = await handle.evaluate(
         """e => {
@@ -122,7 +138,8 @@ async def test_bounding_box_when_inline_box_child_is_outside_of_viewport(page, s
     }"""
     )
 
-    def roundbox(b):
+    def roundbox(b: Optional[FloatRect]) -> FloatRect:
+        assert b
         return {
             "x": round(b["x"] * 100),
             "y": round(b["y"] * 100),
@@ -133,83 +150,107 @@ def roundbox(b):
     assert roundbox(box) == roundbox(web_bounding_box)
 
 
-async def test_content_frame(page, server, utils):
+async def test_content_frame(page: Page, server: Server, utils: Utils) -> None:
     await page.goto(server.EMPTY_PAGE)
     await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     element_handle = await page.query_selector("#frame1")
+    assert element_handle
     frame = await element_handle.content_frame()
     assert frame == page.frames[1]
 
 
-async def test_content_frame_for_non_iframes(page, server, utils):
+async def test_content_frame_for_non_iframes(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     frame = page.frames[1]
-    element_handle = await frame.evaluate_handle("document.body")
+    element_handle = cast(ElementHandle, await frame.evaluate_handle("document.body"))
     assert await element_handle.content_frame() is None
 
 
-async def test_content_frame_for_document_element(page, server, utils):
+async def test_content_frame_for_document_element(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     frame = page.frames[1]
-    element_handle = await frame.evaluate_handle("document.documentElement")
+    element_handle = cast(
+        ElementHandle, await frame.evaluate_handle("document.documentElement")
+    )
     assert await element_handle.content_frame() is None
 
 
-async def test_owner_frame(page, server, utils):
+async def test_owner_frame(page: Page, server: Server, utils: Utils) -> None:
     await page.goto(server.EMPTY_PAGE)
     await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     frame = page.frames[1]
-    element_handle = await frame.evaluate_handle("document.body")
+    element_handle = cast(ElementHandle, await frame.evaluate_handle("document.body"))
     assert await element_handle.owner_frame() == frame
 
 
-async def test_owner_frame_for_cross_process_iframes(page, server, utils):
+async def test_owner_frame_for_cross_process_iframes(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await utils.attach_frame(
         page, "frame1", server.CROSS_PROCESS_PREFIX + "/empty.html"
     )
     frame = page.frames[1]
-    element_handle = await frame.evaluate_handle("document.body")
+    element_handle = cast(ElementHandle, await frame.evaluate_handle("document.body"))
     assert await element_handle.owner_frame() == frame
 
 
-async def test_owner_frame_for_document(page, server, utils):
+async def test_owner_frame_for_document(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     frame = page.frames[1]
-    element_handle = await frame.evaluate_handle("document")
+    element_handle = cast(ElementHandle, await frame.evaluate_handle("document"))
     assert await element_handle.owner_frame() == frame
 
 
-async def test_owner_frame_for_iframe_elements(page, server, utils):
+async def test_owner_frame_for_iframe_elements(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     frame = page.main_frame
-    element_handle = await frame.evaluate_handle('document.querySelector("#frame1")')
+    element_handle = cast(
+        ElementHandle, await frame.evaluate_handle('document.querySelector("#frame1")')
+    )
     assert await element_handle.owner_frame() == frame
 
 
-async def test_owner_frame_for_cross_frame_evaluations(page, server, utils):
+async def test_owner_frame_for_cross_frame_evaluations(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     frame = page.main_frame
-    element_handle = await frame.evaluate_handle(
-        'document.querySelector("#frame1").contentWindow.document.body'
+    element_handle = cast(
+        ElementHandle,
+        await frame.evaluate_handle(
+            'document.querySelector("#frame1").contentWindow.document.body'
+        ),
     )
     assert await element_handle.owner_frame() == frame.child_frames[0]
 
 
-async def test_owner_frame_for_detached_elements(page, server):
+async def test_owner_frame_for_detached_elements(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
-    div_handle = await page.evaluate_handle(
-        """() => {
+    div_handle = cast(
+        ElementHandle,
+        await page.evaluate_handle(
+            """() => {
             div = document.createElement('div');
             document.body.appendChild(div);
             return div;
         }"""
+        ),
     )
+    assert div_handle
 
     assert await div_handle.owner_frame() == page.main_frame
     await page.evaluate(
@@ -221,20 +262,24 @@ async def test_owner_frame_for_detached_elements(page, server):
     assert await div_handle.owner_frame() == page.main_frame
 
 
-async def test_owner_frame_for_adopted_elements(page, server):
+async def test_owner_frame_for_adopted_elements(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_popup() as popup_info:
         await page.evaluate(
             "url => window.__popup = window.open(url)", server.EMPTY_PAGE
         )
     popup = await popup_info.value
-    div_handle = await page.evaluate_handle(
-        """() => {
+    div_handle = cast(
+        ElementHandle,
+        await page.evaluate_handle(
+            """() => {
             div = document.createElement('div');
             document.body.appendChild(div);
             return div;
         }"""
+        ),
     )
+    assert div_handle
     assert await div_handle.owner_frame() == page.main_frame
     await popup.wait_for_load_state("domcontentloaded")
     await page.evaluate(
@@ -246,73 +291,86 @@ async def test_owner_frame_for_adopted_elements(page, server):
     assert await div_handle.owner_frame() == popup.main_frame
 
 
-async def test_click(page, server):
+async def test_click(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = await page.query_selector("button")
+    assert button
     await button.click()
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_click_with_node_removed(page, server):
+async def test_click_with_node_removed(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.evaluate('delete window["Node"]')
     button = await page.query_selector("button")
+    assert button
     await button.click()
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_click_for_shadow_dom_v1(page, server):
+async def test_click_for_shadow_dom_v1(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/shadow.html")
-    button_handle = await page.evaluate_handle("button")
+    button_handle = cast(ElementHandle, await page.evaluate_handle("button"))
     await button_handle.click()
     assert await page.evaluate("clicked")
 
 
-async def test_click_for_TextNodes(page, server):
+async def test_click_for_TextNodes(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
-    buttonTextNode = await page.evaluate_handle(
-        'document.querySelector("button").firstChild'
+    buttonTextNode = cast(
+        ElementHandle,
+        await page.evaluate_handle('document.querySelector("button").firstChild'),
     )
     await buttonTextNode.click()
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_click_throw_for_detached_nodes(page, server):
+async def test_click_throw_for_detached_nodes(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = await page.query_selector("button")
+    assert button
     await page.evaluate("button => button.remove()", button)
     with pytest.raises(Error) as exc_info:
         await button.click()
     assert "Element is not attached to the DOM" in exc_info.value.message
 
 
-async def test_click_throw_for_hidden_nodes_with_force(page, server):
+async def test_click_throw_for_hidden_nodes_with_force(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = await page.query_selector("button")
+    assert button
     await page.evaluate('button => button.style.display = "none"', button)
     with pytest.raises(Error) as exc_info:
         await button.click(force=True)
     assert "Element is not visible" in exc_info.value.message
 
 
-async def test_click_throw_for_recursively_hidden_nodes_with_force(page, server):
+async def test_click_throw_for_recursively_hidden_nodes_with_force(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = await page.query_selector("button")
+    assert button
     await page.evaluate('button => button.parentElement.style.display = "none"', button)
     with pytest.raises(Error) as exc_info:
         await button.click(force=True)
     assert "Element is not visible" in exc_info.value.message
 
 
-async def test_click_throw_for__br__elements_with_force(page, server):
+async def test_click_throw_for__br__elements_with_force(
+    page: Page, server: Server
+) -> None:
     await page.set_content("hello<br>goodbye")
     br = await page.query_selector("br")
+    assert br
     with pytest.raises(Error) as exc_info:
         await br.click(force=True)
     assert "Element is outside of the viewport" in exc_info.value.message
 
 
-async def test_double_click_the_button(page, server):
+async def test_double_click_the_button(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.evaluate(
         """() => {
@@ -324,34 +382,38 @@ async def test_double_click_the_button(page, server):
         }"""
     )
     button = await page.query_selector("button")
+    assert button
     await button.dblclick()
     assert await page.evaluate("double")
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_hover(page, server):
+async def test_hover(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/scrollable.html")
     button = await page.query_selector("#button-6")
+    assert button
     await button.hover()
     assert (
         await page.evaluate('document.querySelector("button:hover").id') == "button-6"
     )
 
 
-async def test_hover_when_node_is_removed(page, server):
+async def test_hover_when_node_is_removed(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/scrollable.html")
     await page.evaluate('delete window["Node"]')
     button = await page.query_selector("#button-6")
+    assert button
     await button.hover()
     assert (
         await page.evaluate('document.querySelector("button:hover").id') == "button-6"
     )
 
 
-async def test_scroll(page, server):
+async def test_scroll(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/offscreenbuttons.html")
     for i in range(11):
         button = await page.query_selector(f"#btn{i}")
+        assert button
         before = await button.evaluate(
             """button => {
                 return button.getBoundingClientRect().right - window.innerWidth
@@ -370,20 +432,24 @@ async def test_scroll(page, server):
         await page.evaluate("() => window.scrollTo(0, 0)")
 
 
-async def test_scroll_should_throw_for_detached_element(page, server):
+async def test_scroll_should_throw_for_detached_element(
+    page: Page, server: Server
+) -> None:
     await page.set_content("<div>Hello</div>")
     div = await page.query_selector("div")
+    assert div
     await div.evaluate("div => div.remove()")
     with pytest.raises(Error) as exc_info:
         await div.scroll_into_view_if_needed()
     assert "Element is not attached to the DOM" in exc_info.value.message
 
 
-async def waiting_helper(page, after):
+async def waiting_helper(page: Page, after: str) -> None:
     div = await page.query_selector("div")
+    assert div
     done = []
 
-    async def scroll():
+    async def scroll() -> None:
         done.append(False)
         await div.scroll_into_view_if_needed()
         done.append(True)
@@ -397,54 +463,64 @@ async def scroll():
     assert done == [False, True]
 
 
-async def test_should_wait_for_display_none_to_become_visible(page):
+async def test_should_wait_for_display_none_to_become_visible(page: Page) -> None:
     await page.set_content('<div style="display:none">Hello</div>')
     await waiting_helper(page, 'div => div.style.display = "block"')
 
 
-async def test_should_work_for_visibility_hidden_element(page):
+async def test_should_work_for_visibility_hidden_element(page: Page) -> None:
     await page.set_content('<div style="visibility:hidden">Hello</div>')
     div = await page.query_selector("div")
+    assert div
     await div.scroll_into_view_if_needed()
 
 
-async def test_should_work_for_zero_sized_element(page):
+async def test_should_work_for_zero_sized_element(page: Page) -> None:
     await page.set_content('<div style="height:0">Hello</div>')
     div = await page.query_selector("div")
+    assert div
     await div.scroll_into_view_if_needed()
 
 
-async def test_should_wait_for_nested_display_none_to_become_visible(page):
+async def test_should_wait_for_nested_display_none_to_become_visible(
+    page: Page,
+) -> None:
     await page.set_content('<span style="display:none"><div>Hello</div></span>')
     await waiting_helper(page, 'div => div.parentElement.style.display = "block"')
 
 
-async def test_should_timeout_waiting_for_visible(page):
+async def test_should_timeout_waiting_for_visible(page: Page) -> None:
     await page.set_content('<div style="display:none">Hello</div>')
     div = await page.query_selector("div")
+    assert div
     with pytest.raises(Error) as exc_info:
         await div.scroll_into_view_if_needed(timeout=3000)
     assert "element is not displayed, retrying in 100ms" in exc_info.value.message
 
 
-async def test_fill_input(page, server):
+async def test_fill_input(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     handle = await page.query_selector("input")
+    assert handle
     await handle.fill("some value")
     assert await page.evaluate("result") == "some value"
 
 
-async def test_fill_input_when_Node_is_removed(page, server):
+async def test_fill_input_when_Node_is_removed(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.evaluate('delete window["Node"]')
     handle = await page.query_selector("input")
+    assert handle
     await handle.fill("some value")
     assert await page.evaluate("result") == "some value"
 
 
-async def test_select_textarea(page, server, is_firefox, is_webkit):
+async def test_select_textarea(
+    page: Page, server: Server, is_firefox: bool, is_webkit: bool
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
+    assert textarea
     await textarea.evaluate('textarea => textarea.value = "some value"')
     await textarea.select_text()
     if is_firefox or is_webkit:
@@ -457,9 +533,12 @@ async def test_select_textarea(page, server, is_firefox, is_webkit):
         )
 
 
-async def test_select_input(page, server, is_firefox, is_webkit):
+async def test_select_input(
+    page: Page, server: Server, is_firefox: bool, is_webkit: bool
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     input = await page.query_selector("input")
+    assert input
     await input.evaluate('input => input.value = "some value"')
     await input.select_text()
     if is_firefox or is_webkit:
@@ -472,30 +551,35 @@ async def test_select_input(page, server, is_firefox, is_webkit):
         )
 
 
-async def test_select_text_select_plain_div(page, server):
+async def test_select_text_select_plain_div(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     div = await page.query_selector("div.plain")
+    assert div
     await div.select_text()
     assert await page.evaluate("() => window.getSelection().toString()") == "Plain div"
 
 
-async def test_select_text_timeout_waiting_for_invisible_element(page, server):
+async def test_select_text_timeout_waiting_for_invisible_element(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
+    assert textarea
     await textarea.evaluate('e => e.style.display = "none"')
     with pytest.raises(Error) as exc_info:
         await textarea.select_text(timeout=3000)
     assert "element is not visible" in exc_info.value.message
 
 
-async def test_select_text_wait_for_visible(page, server):
+async def test_select_text_wait_for_visible(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
+    assert textarea
     await textarea.evaluate('textarea => textarea.value = "some value"')
     await textarea.evaluate('e => e.style.display = "none"')
     done = []
 
-    async def select_text():
+    async def select_text() -> None:
         done.append(False)
         await textarea.select_text(timeout=3000)
         done.append(True)
@@ -508,10 +592,11 @@ async def select_text():
     assert done == [False, True]
 
 
-async def test_a_nice_preview(page, server):
+async def test_a_nice_preview(page: Page, server: Server) -> None:
     await page.goto(f"{server.PREFIX}/dom.html")
     outer = await page.query_selector("#outer")
     inner = await page.query_selector("#inner")
+    assert inner
     check = await page.query_selector("#check")
     text = await inner.evaluate_handle("e => e.firstChild")
     await page.evaluate("1")  # Give them a chance to calculate the preview.
@@ -523,91 +608,102 @@ async def test_a_nice_preview(page, server):
     )
 
 
-async def test_get_attribute(page, server):
+async def test_get_attribute(page: Page, server: Server) -> None:
     await page.goto(f"{server.PREFIX}/dom.html")
     handle = await page.query_selector("#outer")
+    assert handle
     assert await handle.get_attribute("name") == "value"
     assert await page.get_attribute("#outer", "name") == "value"
 
 
-async def test_inner_html(page, server):
+async def test_inner_html(page: Page, server: Server) -> None:
     await page.goto(f"{server.PREFIX}/dom.html")
     handle = await page.query_selector("#outer")
+    assert handle
     assert await handle.inner_html() == '<div id="inner">Text,\nmore text</div>'
     assert await page.inner_html("#outer") == '<div id="inner">Text,\nmore text</div>'
 
 
-async def test_inner_text(page, server):
+async def test_inner_text(page: Page, server: Server) -> None:
     await page.goto(f"{server.PREFIX}/dom.html")
     handle = await page.query_selector("#inner")
+    assert handle
     assert await handle.inner_text() == "Text, more text"
     assert await page.inner_text("#inner") == "Text, more text"
 
 
-async def test_inner_text_should_throw(page, server):
+async def test_inner_text_should_throw(page: Page, server: Server) -> None:
     await page.set_content("<svg>text</svg>")
     with pytest.raises(Error) as exc_info1:
         await page.inner_text("svg")
     assert " Node is not an HTMLElement" in exc_info1.value.message
 
     handle = await page.query_selector("svg")
+    assert handle
     with pytest.raises(Error) as exc_info2:
         await handle.inner_text()
     assert " Node is not an HTMLElement" in exc_info2.value.message
 
 
-async def test_text_content(page, server):
+async def test_text_content(page: Page, server: Server) -> None:
     await page.goto(f"{server.PREFIX}/dom.html")
     handle = await page.query_selector("#inner")
+    assert handle
     assert await handle.text_content() == "Text,\nmore text"
     assert await page.text_content("#inner") == "Text,\nmore text"
 
 
-async def test_check_the_box(page):
+async def test_check_the_box(page: Page) -> None:
     await page.set_content('<input id="checkbox" type="checkbox"></input>')
     input = await page.query_selector("input")
+    assert input
     await input.check()
     assert await page.evaluate("checkbox.checked")
 
 
-async def test_uncheck_the_box(page):
+async def test_uncheck_the_box(page: Page) -> None:
     await page.set_content('<input id="checkbox" type="checkbox" checked></input>')
     input = await page.query_selector("input")
+    assert input
     await input.uncheck()
     assert await page.evaluate("checkbox.checked") is False
 
 
-async def test_select_single_option(page, server):
+async def test_select_single_option(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     select = await page.query_selector("select")
+    assert select
     await select.select_option(value="blue")
     assert await page.evaluate("result.onInput") == ["blue"]
     assert await page.evaluate("result.onChange") == ["blue"]
 
 
-async def test_focus_a_button(page, server):
+async def test_focus_a_button(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = await page.query_selector("button")
+    assert button
     assert await button.evaluate("button => document.activeElement === button") is False
     await button.focus()
     assert await button.evaluate("button => document.activeElement === button")
 
 
-async def test_is_visible_and_is_hidden_should_work(page):
+async def test_is_visible_and_is_hidden_should_work(page: Page) -> None:
     await page.set_content("<div>Hi</div><span></span>")
     div = await page.query_selector("div")
+    assert div
     assert await div.is_visible()
     assert await div.is_hidden() is False
     assert await page.is_visible("div")
     assert await page.is_hidden("div") is False
     span = await page.query_selector("span")
+    assert span
     assert await span.is_visible() is False
     assert await span.is_hidden()
     assert await page.is_visible("span") is False
     assert await page.is_hidden("span")
 
 
-async def test_is_enabled_and_is_disabled_should_work(page):
+async def test_is_enabled_and_is_disabled_should_work(page: Page) -> None:
     await page.set_content(
         """
         <button disabled>button1</button>
@@ -616,41 +712,48 @@ async def test_is_enabled_and_is_disabled_should_work(page):
     """
     )
     div = await page.query_selector("div")
+    assert div
     assert await div.is_enabled()
     assert await div.is_disabled() is False
     assert await page.is_enabled("div")
     assert await page.is_disabled("div") is False
     button1 = await page.query_selector(":text('button1')")
+    assert button1
     assert await button1.is_enabled() is False
     assert await button1.is_disabled()
     assert await page.is_enabled(":text('button1')") is False
     assert await page.is_disabled(":text('button1')")
     button2 = await page.query_selector(":text('button2')")
+    assert button2
     assert await button2.is_enabled()
     assert await button2.is_disabled() is False
     assert await page.is_enabled(":text('button2')")
     assert await page.is_disabled(":text('button2')") is False
 
 
-async def test_is_editable_should_work(page):
+async def test_is_editable_should_work(page: Page) -> None:
     await page.set_content(
         "<input id=input1 disabled><textarea></textarea><input id=input2>"
     )
     await page.eval_on_selector("textarea", "t => t.readOnly = true")
     input1 = await page.query_selector("#input1")
+    assert input1
     assert await input1.is_editable() is False
     assert await page.is_editable("#input1") is False
     input2 = await page.query_selector("#input2")
+    assert input2
     assert await input2.is_editable()
     assert await page.is_editable("#input2")
     textarea = await page.query_selector("textarea")
+    assert textarea
     assert await textarea.is_editable() is False
     assert await page.is_editable("textarea") is False
 
 
-async def test_is_checked_should_work(page):
+async def test_is_checked_should_work(page: Page) -> None:
     await page.set_content('<input type="checkbox" checked><div>Not a checkbox</div>')
     handle = await page.query_selector("input")
+    assert handle
     assert await handle.is_checked()
     assert await page.is_checked("input")
     await handle.evaluate("input => input.checked = false")
@@ -661,9 +764,10 @@ async def test_is_checked_should_work(page):
     assert "Not a checkbox or radio button" in exc_info.value.message
 
 
-async def test_input_value(page: Page, server: Server):
+async def test_input_value(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     element = await page.query_selector("input")
+    assert element
     await element.fill("my-text-content")
     assert await element.input_value() == "my-text-content"
 
@@ -671,9 +775,10 @@ async def test_input_value(page: Page, server: Server):
     assert await element.input_value() == ""
 
 
-async def test_set_checked(page: Page):
+async def test_set_checked(page: Page) -> None:
     await page.set_content("`<input id='checkbox' type='checkbox'></input>`")
     input = await page.query_selector("input")
+    assert input
     await input.set_checked(True)
     assert await page.evaluate("checkbox.checked")
     await input.set_checked(False)
diff --git a/tests/async/test_element_handle_wait_for_element_state.py b/tests/async/test_element_handle_wait_for_element_state.py
index 34e1c7493..80019de45 100644
--- a/tests/async/test_element_handle_wait_for_element_state.py
+++ b/tests/async/test_element_handle_wait_for_element_state.py
@@ -13,67 +13,77 @@
 # limitations under the License.
 
 import asyncio
+from typing import List
 
 import pytest
 
-from playwright.async_api import Error
+from playwright.async_api import ElementHandle, Error, Page
+from tests.server import Server
 
 
-async def give_it_a_chance_to_resolve(page):
+async def give_it_a_chance_to_resolve(page: Page) -> None:
     for i in range(5):
         await page.evaluate(
             "() => new Promise(f => requestAnimationFrame(() => requestAnimationFrame(f)))"
         )
 
 
-async def wait_for_state(div, state, done):
-    await div.wait_for_element_state(state)
+async def wait_for_state(div: ElementHandle, state: str, done: List[bool]) -> None:
+    await div.wait_for_element_state(state)  # type: ignore
     done[0] = True
 
 
-async def wait_for_state_to_throw(div, state):
+async def wait_for_state_to_throw(
+    div: ElementHandle, state: str
+) -> pytest.ExceptionInfo[Error]:
     with pytest.raises(Error) as exc_info:
-        await div.wait_for_element_state(state)
+        await div.wait_for_element_state(state)  # type: ignore
     return exc_info
 
 
-async def test_should_wait_for_visible(page):
+async def test_should_wait_for_visible(page: Page) -> None:
     await page.set_content('<div style="display:none">content</div>')
     div = await page.query_selector("div")
+    assert div
     done = [False]
     promise = asyncio.create_task(wait_for_state(div, "visible", done))
     await give_it_a_chance_to_resolve(page)
     assert done[0] is False
+    assert div
     await div.evaluate('div => div.style.display = "block"')
     await promise
 
 
-async def test_should_wait_for_already_visible(page):
+async def test_should_wait_for_already_visible(page: Page) -> None:
     await page.set_content("<div>content</div>")
     div = await page.query_selector("div")
+    assert div
     await div.wait_for_element_state("visible")
 
 
-async def test_should_timeout_waiting_for_visible(page):
+async def test_should_timeout_waiting_for_visible(page: Page) -> None:
     await page.set_content('<div style="display:none">content</div>')
     div = await page.query_selector("div")
+    assert div
     with pytest.raises(Error) as exc_info:
         await div.wait_for_element_state("visible", timeout=1000)
     assert "Timeout 1000ms exceeded" in exc_info.value.message
 
 
-async def test_should_throw_waiting_for_visible_when_detached(page):
+async def test_should_throw_waiting_for_visible_when_detached(page: Page) -> None:
     await page.set_content('<div style="display:none">content</div>')
     div = await page.query_selector("div")
+    assert div
     promise = asyncio.create_task(wait_for_state_to_throw(div, "visible"))
     await div.evaluate("div => div.remove()")
     exc_info = await promise
     assert "Element is not attached to the DOM" in exc_info.value.message
 
 
-async def test_should_wait_for_hidden(page):
+async def test_should_wait_for_hidden(page: Page) -> None:
     await page.set_content("<div>content</div>")
     div = await page.query_selector("div")
+    assert div
     done = [False]
     promise = asyncio.create_task(wait_for_state(div, "hidden", done))
     await give_it_a_chance_to_resolve(page)
@@ -82,26 +92,30 @@ async def test_should_wait_for_hidden(page):
     await promise
 
 
-async def test_should_wait_for_already_hidden(page):
+async def test_should_wait_for_already_hidden(page: Page) -> None:
     await page.set_content("<div></div>")
     div = await page.query_selector("div")
+    assert div
     await div.wait_for_element_state("hidden")
 
 
-async def test_should_wait_for_hidden_when_detached(page):
+async def test_should_wait_for_hidden_when_detached(page: Page) -> None:
     await page.set_content("<div>content</div>")
     div = await page.query_selector("div")
+    assert div
     done = [False]
     promise = asyncio.create_task(wait_for_state(div, "hidden", done))
     await give_it_a_chance_to_resolve(page)
     assert done[0] is False
+    assert div
     await div.evaluate("div => div.remove()")
     await promise
 
 
-async def test_should_wait_for_enabled_button(page, server):
+async def test_should_wait_for_enabled_button(page: Page, server: Server) -> None:
     await page.set_content("<button disabled><span>Target</span></button>")
     span = await page.query_selector("text=Target")
+    assert span
     done = [False]
     promise = asyncio.create_task(wait_for_state(span, "enabled", done))
     await give_it_a_chance_to_resolve(page)
@@ -110,18 +124,20 @@ async def test_should_wait_for_enabled_button(page, server):
     await promise
 
 
-async def test_should_throw_waiting_for_enabled_when_detached(page):
+async def test_should_throw_waiting_for_enabled_when_detached(page: Page) -> None:
     await page.set_content("<button disabled>Target</button>")
     button = await page.query_selector("button")
+    assert button
     promise = asyncio.create_task(wait_for_state_to_throw(button, "enabled"))
     await button.evaluate("button => button.remove()")
     exc_info = await promise
     assert "Element is not attached to the DOM" in exc_info.value.message
 
 
-async def test_should_wait_for_disabled_button(page):
+async def test_should_wait_for_disabled_button(page: Page) -> None:
     await page.set_content("<button><span>Target</span></button>")
     span = await page.query_selector("text=Target")
+    assert span
     done = [False]
     promise = asyncio.create_task(wait_for_state(span, "disabled", done))
     await give_it_a_chance_to_resolve(page)
@@ -130,9 +146,10 @@ async def test_should_wait_for_disabled_button(page):
     await promise
 
 
-async def test_should_wait_for_editable_input(page, server):
+async def test_should_wait_for_editable_input(page: Page, server: Server) -> None:
     await page.set_content("<input readonly>")
     input = await page.query_selector("input")
+    assert input
     done = [False]
     promise = asyncio.create_task(wait_for_state(input, "editable", done))
     await give_it_a_chance_to_resolve(page)
diff --git a/tests/async/test_emulation_focus.py b/tests/async/test_emulation_focus.py
index 0f068a37b..a59d549f4 100644
--- a/tests/async/test_emulation_focus.py
+++ b/tests/async/test_emulation_focus.py
@@ -12,20 +12,26 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 import asyncio
+from typing import Callable
 
+from playwright.async_api import Page
+from tests.server import Server
 
-async def test_should_think_that_it_is_focused_by_default(page):
+from .utils import Utils
+
+
+async def test_should_think_that_it_is_focused_by_default(page: Page) -> None:
     assert await page.evaluate("document.hasFocus()")
 
 
-async def test_should_think_that_all_pages_are_focused(page):
+async def test_should_think_that_all_pages_are_focused(page: Page) -> None:
     page2 = await page.context.new_page()
     assert await page.evaluate("document.hasFocus()")
     assert await page2.evaluate("document.hasFocus()")
     await page2.close()
 
 
-async def test_should_focus_popups_by_default(page, server):
+async def test_should_focus_popups_by_default(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_popup() as popup_info:
         await page.evaluate("url => { window.open(url); }", server.EMPTY_PAGE)
@@ -34,7 +40,9 @@ async def test_should_focus_popups_by_default(page, server):
     assert await page.evaluate("document.hasFocus()")
 
 
-async def test_should_provide_target_for_keyboard_events(page, server):
+async def test_should_provide_target_for_keyboard_events(
+    page: Page, server: Server
+) -> None:
     page2 = await page.context.new_page()
     await asyncio.gather(
         page.goto(server.PREFIX + "/input/textarea.html"),
@@ -57,7 +65,9 @@ async def test_should_provide_target_for_keyboard_events(page, server):
     assert results == [text, text2]
 
 
-async def test_should_not_affect_mouse_event_target_page(page, server):
+async def test_should_not_affect_mouse_event_target_page(
+    page: Page, server: Server
+) -> None:
     page2 = await page.context.new_page()
     click_counter = """() => {
       document.onclick = () => window.click_count = (window.click_count || 0) + 1;
@@ -79,7 +89,7 @@ async def test_should_not_affect_mouse_event_target_page(page, server):
     assert counters == [1, 1]
 
 
-async def test_should_change_document_activeElement(page, server):
+async def test_should_change_document_activeElement(page: Page, server: Server) -> None:
     page2 = await page.context.new_page()
     await asyncio.gather(
         page.goto(server.PREFIX + "/input/textarea.html"),
@@ -96,7 +106,9 @@ async def test_should_change_document_activeElement(page, server):
     assert active == ["INPUT", "TEXTAREA"]
 
 
-async def test_should_not_affect_screenshots(page, server, assert_to_be_golden):
+async def test_should_not_affect_screenshots(
+    page: Page, server: Server, assert_to_be_golden: Callable[[bytes, str], None]
+) -> None:
     # Firefox headed produces a different image.
     page2 = await page.context.new_page()
     await asyncio.gather(
@@ -117,7 +129,9 @@ async def test_should_not_affect_screenshots(page, server, assert_to_be_golden):
     assert_to_be_golden(screenshots[1], "grid-cell-0.png")
 
 
-async def test_should_change_focused_iframe(page, server, utils):
+async def test_should_change_focused_iframe(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     [frame1, frame2] = await asyncio.gather(
         utils.attach_frame(page, "frame1", server.PREFIX + "/input/textarea.html"),
diff --git a/tests/async/test_evaluate.py b/tests/async/test_evaluate.py
index eb647dc2d..cafeac61d 100644
--- a/tests/async/test_evaluate.py
+++ b/tests/async/test_evaluate.py
@@ -14,42 +14,43 @@
 
 import math
 from datetime import datetime
+from typing import Optional
 from urllib.parse import ParseResult, urlparse
 
 from playwright.async_api import Error, Page
 
 
-async def test_evaluate_work(page):
+async def test_evaluate_work(page: Page) -> None:
     result = await page.evaluate("7 * 3")
     assert result == 21
 
 
-async def test_evaluate_return_none_for_null(page):
+async def test_evaluate_return_none_for_null(page: Page) -> None:
     result = await page.evaluate("a => a", None)
     assert result is None
 
 
-async def test_evaluate_transfer_nan(page):
+async def test_evaluate_transfer_nan(page: Page) -> None:
     result = await page.evaluate("a => a", float("nan"))
     assert math.isnan(result)
 
 
-async def test_evaluate_transfer_neg_zero(page):
+async def test_evaluate_transfer_neg_zero(page: Page) -> None:
     result = await page.evaluate("a => a", -0)
     assert result == float("-0")
 
 
-async def test_evaluate_transfer_infinity(page):
+async def test_evaluate_transfer_infinity(page: Page) -> None:
     result = await page.evaluate("a => a", float("Infinity"))
     assert result == float("Infinity")
 
 
-async def test_evaluate_transfer_neg_infinity(page):
+async def test_evaluate_transfer_neg_infinity(page: Page) -> None:
     result = await page.evaluate("a => a", float("-Infinity"))
     assert result == float("-Infinity")
 
 
-async def test_evaluate_roundtrip_unserializable_values(page):
+async def test_evaluate_roundtrip_unserializable_values(page: Page) -> None:
     value = {
         "infinity": float("Infinity"),
         "nInfinity": float("-Infinity"),
@@ -59,7 +60,7 @@ async def test_evaluate_roundtrip_unserializable_values(page):
     assert result == value
 
 
-async def test_evaluate_transfer_arrays(page):
+async def test_evaluate_transfer_arrays(page: Page) -> None:
     result = await page.evaluate("a => a", [1, 2, 3])
     assert result == [1, 2, 3]
 
@@ -69,7 +70,7 @@ async def test_evaluate_transfer_bigint(page: Page) -> None:
     assert await page.evaluate("a => a", 17) == 17
 
 
-async def test_evaluate_return_undefined_for_objects_with_symbols(page):
+async def test_evaluate_return_undefined_for_objects_with_symbols(page: Page) -> None:
     assert await page.evaluate('[Symbol("foo4")]') == [None]
     assert (
         await page.evaluate(
@@ -91,62 +92,66 @@ async def test_evaluate_return_undefined_for_objects_with_symbols(page):
     )
 
 
-async def test_evaluate_work_with_unicode_chars(page):
+async def test_evaluate_work_with_unicode_chars(page: Page) -> None:
     result = await page.evaluate('a => a["中文字符"]', {"中文字符": 42})
     assert result == 42
 
 
-async def test_evaluate_throw_when_evaluation_triggers_reload(page):
-    error = None
+async def test_evaluate_throw_when_evaluation_triggers_reload(page: Page) -> None:
+    error: Optional[Error] = None
     try:
         await page.evaluate(
             "() => { location.reload(); return new Promise(() => {}); }"
         )
     except Error as e:
         error = e
+    assert error
     assert "navigation" in error.message
 
 
-async def test_evaluate_work_with_exposed_function(page):
+async def test_evaluate_work_with_exposed_function(page: Page) -> None:
     await page.expose_function("callController", lambda a, b: a * b)
     result = await page.evaluate("callController(9, 3)")
     assert result == 27
 
 
-async def test_evaluate_reject_promise_with_exception(page):
-    error = None
+async def test_evaluate_reject_promise_with_exception(page: Page) -> None:
+    error: Optional[Error] = None
     try:
         await page.evaluate("not_existing_object.property")
     except Error as e:
         error = e
+    assert error
     assert "not_existing_object" in error.message
 
 
-async def test_evaluate_support_thrown_strings(page):
-    error = None
+async def test_evaluate_support_thrown_strings(page: Page) -> None:
+    error: Optional[Error] = None
     try:
         await page.evaluate('throw "qwerty"')
     except Error as e:
         error = e
+    assert error
     assert "qwerty" in error.message
 
 
-async def test_evaluate_support_thrown_numbers(page):
-    error = None
+async def test_evaluate_support_thrown_numbers(page: Page) -> None:
+    error: Optional[Error] = None
     try:
         await page.evaluate("throw 100500")
     except Error as e:
         error = e
+    assert error
     assert "100500" in error.message
 
 
-async def test_evaluate_return_complex_objects(page):
+async def test_evaluate_return_complex_objects(page: Page) -> None:
     obj = {"foo": "bar!"}
     result = await page.evaluate("a => a", obj)
     assert result == obj
 
 
-async def test_evaluate_accept_none_as_one_of_multiple_parameters(page):
+async def test_evaluate_accept_none_as_one_of_multiple_parameters(page: Page) -> None:
     result = await page.evaluate(
         '({ a, b }) => Object.is(a, null) && Object.is(b, "foo")',
         {"a": None, "b": "foo"},
@@ -154,16 +159,16 @@ async def test_evaluate_accept_none_as_one_of_multiple_parameters(page):
     assert result
 
 
-async def test_evaluate_properly_serialize_none_arguments(page):
+async def test_evaluate_properly_serialize_none_arguments(page: Page) -> None:
     assert await page.evaluate("x => ({a: x})", None) == {"a": None}
 
 
-async def test_should_alias_window_document_and_node(page):
+async def test_should_alias_window_document_and_node(page: Page) -> None:
     object = await page.evaluate("[window, document, document.body]")
     assert object == ["ref: <Window>", "ref: <Document>", "ref: <Node>"]
 
 
-async def test_evaluate_should_work_for_circular_object(page):
+async def test_evaluate_should_work_for_circular_object(page: Page) -> None:
     a = await page.evaluate(
         """() => {
                 const a = {x: 47};
@@ -177,48 +182,50 @@ async def test_evaluate_should_work_for_circular_object(page):
     assert a["b"]["a"] == a
 
 
-async def test_evaluate_accept_string(page):
+async def test_evaluate_accept_string(page: Page) -> None:
     assert await page.evaluate("1 + 2") == 3
 
 
-async def test_evaluate_accept_element_handle_as_an_argument(page):
+async def test_evaluate_accept_element_handle_as_an_argument(page: Page) -> None:
     await page.set_content("<section>42</section>")
     element = await page.query_selector("section")
     text = await page.evaluate("e => e.textContent", element)
     assert text == "42"
 
 
-async def test_evaluate_throw_if_underlying_element_was_disposed(page):
+async def test_evaluate_throw_if_underlying_element_was_disposed(page: Page) -> None:
     await page.set_content("<section>39</section>")
     element = await page.query_selector("section")
+    assert element
     await element.dispose()
-    error = None
+    error: Optional[Error] = None
     try:
         await page.evaluate("e => e.textContent", element)
     except Error as e:
         error = e
+    assert error
     assert "no object with guid" in error.message
 
 
-async def test_evaluate_evaluate_exception(page):
+async def test_evaluate_evaluate_exception(page: Page) -> None:
     error = await page.evaluate('new Error("error message")')
     assert "Error: error message" in error
 
 
-async def test_evaluate_evaluate_date(page):
+async def test_evaluate_evaluate_date(page: Page) -> None:
     result = await page.evaluate(
         '() => ({ date: new Date("2020-05-27T01:31:38.506Z") })'
     )
     assert result == {"date": datetime.fromisoformat("2020-05-27T01:31:38.506")}
 
 
-async def test_evaluate_roundtrip_date(page):
+async def test_evaluate_roundtrip_date(page: Page) -> None:
     date = datetime.fromisoformat("2020-05-27T01:31:38.506")
     result = await page.evaluate("date => date", date)
     assert result == date
 
 
-async def test_evaluate_jsonvalue_date(page):
+async def test_evaluate_jsonvalue_date(page: Page) -> None:
     date = datetime.fromisoformat("2020-05-27T01:31:38.506")
     result = await page.evaluate(
         '() => ({ date: new Date("2020-05-27T01:31:38.506Z") })'
@@ -226,7 +233,7 @@ async def test_evaluate_jsonvalue_date(page):
     assert result == {"date": date}
 
 
-async def test_should_evaluate_url(page):
+async def test_should_evaluate_url(page: Page) -> None:
     out = await page.evaluate(
         "() => ({ someKey: new URL('https://user:pass@example.com/?foo=bar#hi') })"
     )
@@ -240,13 +247,13 @@ async def test_should_evaluate_url(page):
     )
 
 
-async def test_should_roundtrip_url(page):
+async def test_should_roundtrip_url(page: Page) -> None:
     in_ = urlparse("https://user:pass@example.com/?foo=bar#hi")
     out = await page.evaluate("url => url", in_)
     assert in_ == out
 
 
-async def test_should_roundtrip_complex_url(page):
+async def test_should_roundtrip_complex_url(page: Page) -> None:
     in_ = urlparse(
         "https://user:password@www.contoso.com:80/Home/Index.htm?q1=v1&q2=v2#FragmentName"
     )
@@ -254,7 +261,7 @@ async def test_should_roundtrip_complex_url(page):
     assert in_ == out
 
 
-async def test_evaluate_jsonvalue_url(page):
+async def test_evaluate_jsonvalue_url(page: Page) -> None:
     url = urlparse("https://example.com/")
     result = await page.evaluate('() => ({ someKey: new URL("https://example.com/") })')
     assert result == {"someKey": url}
diff --git a/tests/async/test_fetch_browser_context.py b/tests/async/test_fetch_browser_context.py
index fbd3130f3..999becf47 100644
--- a/tests/async/test_fetch_browser_context.py
+++ b/tests/async/test_fetch_browser_context.py
@@ -14,15 +14,17 @@
 
 import asyncio
 import json
+from typing import Any
 from urllib.parse import parse_qs
 
 import pytest
 
-from playwright.async_api import BrowserContext, Error, Page
+from playwright.async_api import BrowserContext, Error, FilePayload, Page
 from tests.server import Server
+from tests.utils import must
 
 
-async def test_get_should_work(context: BrowserContext, server: Server):
+async def test_get_should_work(context: BrowserContext, server: Server) -> None:
     response = await context.request.get(server.PREFIX + "/simple.json")
     assert response.url == server.PREFIX + "/simple.json"
     assert response.status == 200
@@ -36,7 +38,7 @@ async def test_get_should_work(context: BrowserContext, server: Server):
     assert await response.text() == '{"foo": "bar"}\n'
 
 
-async def test_fetch_should_work(context: BrowserContext, server: Server):
+async def test_fetch_should_work(context: BrowserContext, server: Server) -> None:
     response = await context.request.fetch(server.PREFIX + "/simple.json")
     assert response.url == server.PREFIX + "/simple.json"
     assert response.status == 200
@@ -50,7 +52,9 @@ async def test_fetch_should_work(context: BrowserContext, server: Server):
     assert await response.text() == '{"foo": "bar"}\n'
 
 
-async def test_should_throw_on_network_error(context: BrowserContext, server: Server):
+async def test_should_throw_on_network_error(
+    context: BrowserContext, server: Server
+) -> None:
     server.set_route("/test", lambda request: request.transport.loseConnection())
     with pytest.raises(Error, match="socket hang up"):
         await context.request.fetch(server.PREFIX + "/test")
@@ -58,7 +62,7 @@ async def test_should_throw_on_network_error(context: BrowserContext, server: Se
 
 async def test_should_add_session_cookies_to_request(
     context: BrowserContext, server: Server
-):
+) -> None:
     await context.add_cookies(
         [
             {
@@ -84,7 +88,7 @@ async def test_should_add_session_cookies_to_request(
 )
 async def test_should_support_query_params(
     context: BrowserContext, server: Server, method: str
-):
+) -> None:
     expected_params = {"p1": "v1", "парам2": "знач2"}
     [server_req, _] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
@@ -102,7 +106,7 @@ async def test_should_support_query_params(
 )
 async def test_should_support_fail_on_status_code(
     context: BrowserContext, server: Server, method: str
-):
+) -> None:
     with pytest.raises(Error, match="404 Not Found"):
         await getattr(context.request, method)(
             server.PREFIX + "/this-does-clearly-not-exist.html",
@@ -115,7 +119,7 @@ async def test_should_support_fail_on_status_code(
 )
 async def test_should_support_ignore_https_errors_option(
     context: BrowserContext, https_server: Server, method: str
-):
+) -> None:
     response = await getattr(context.request, method)(
         https_server.EMPTY_PAGE, ignore_https_errors=True
     )
@@ -125,7 +129,7 @@ async def test_should_support_ignore_https_errors_option(
 
 async def test_should_not_add_context_cookie_if_cookie_header_passed_as_parameter(
     context: BrowserContext, server: Server
-):
+) -> None:
     await context.add_cookies(
         [
             {
@@ -149,8 +153,8 @@ async def test_should_not_add_context_cookie_if_cookie_header_passed_as_paramete
 @pytest.mark.parametrize("method", ["delete", "patch", "post", "put"])
 async def test_should_support_post_data(
     context: BrowserContext, method: str, server: Server
-):
-    async def support_post_data(fetch_data, request_post_data):
+) -> None:
+    async def support_post_data(fetch_data: Any, request_post_data: Any) -> None:
         [request, response] = await asyncio.gather(
             server.wait_for_request("/simple.json"),
             getattr(context.request, method)(
@@ -161,7 +165,7 @@ async def support_post_data(fetch_data, request_post_data):
         assert request.post_body == request_post_data
         assert response.status == 200
         assert response.url == server.PREFIX + "/simple.json"
-        assert request.getHeader("Content-Length") == str(len(request.post_body))
+        assert request.getHeader("Content-Length") == str(len(must(request.post_body)))
 
     await support_post_data("My request", "My request".encode())
     await support_post_data(b"My request", "My request".encode())
@@ -173,7 +177,7 @@ async def support_post_data(fetch_data, request_post_data):
 
 async def test_should_support_application_x_www_form_urlencoded(
     context: BrowserContext, server: Server
-):
+) -> None:
     [request, response] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
         context.request.post(
@@ -187,6 +191,7 @@ async def test_should_support_application_x_www_form_urlencoded(
     )
     assert request.method == b"POST"
     assert request.getHeader("Content-Type") == "application/x-www-form-urlencoded"
+    assert request.post_body
     body = request.post_body.decode()
     assert request.getHeader("Content-Length") == str(len(body))
     params = parse_qs(request.post_body)
@@ -197,13 +202,13 @@ async def test_should_support_application_x_www_form_urlencoded(
 
 async def test_should_support_multipart_form_data(
     context: BrowserContext, server: Server
-):
-    file = {
+) -> None:
+    file: FilePayload = {
         "name": "f.js",
         "mimeType": "text/javascript",
         "buffer": b"var x = 10;\r\n;console.log(x);",
     }
-    [request, response] = await asyncio.gather(
+    [request, _] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
         context.request.post(
             server.PREFIX + "/empty.html",
@@ -215,8 +220,10 @@ async def test_should_support_multipart_form_data(
         ),
     )
     assert request.method == b"POST"
-    assert request.getHeader("Content-Type").startswith("multipart/form-data; ")
-    assert request.getHeader("Content-Length") == str(len(request.post_body))
+    assert must(request.getHeader("Content-Type")).startswith("multipart/form-data; ")
+    assert must(request.getHeader("Content-Length")) == str(
+        len(must(request.post_body))
+    )
     assert request.args[b"firstName"] == [b"John"]
     assert request.args[b"lastName"] == [b"Doe"]
     assert request.args[b"file"][0] == file["buffer"]
@@ -224,7 +231,7 @@ async def test_should_support_multipart_form_data(
 
 async def test_should_add_default_headers(
     context: BrowserContext, page: Page, server: Server
-):
+) -> None:
     [request, response] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
         context.request.get(server.EMPTY_PAGE),
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index 430547df8..5e26f4550 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -21,14 +21,14 @@
 
 import pytest
 
-from playwright.async_api import APIResponse, Error, Playwright
+from playwright.async_api import APIResponse, Error, Playwright, StorageState
 from tests.server import Server
 
 
 @pytest.mark.parametrize(
     "method", ["fetch", "delete", "get", "head", "patch", "post", "put"]
 )
-async def test_should_work(playwright: Playwright, method: str, server: Server):
+async def test_should_work(playwright: Playwright, method: str, server: Server) -> None:
     request = await playwright.request.new_context()
     response: APIResponse = await getattr(request, method)(
         server.PREFIX + "/simple.json"
@@ -45,7 +45,9 @@ async def test_should_work(playwright: Playwright, method: str, server: Server):
     assert await response.text() == ("" if method == "head" else '{"foo": "bar"}\n')
 
 
-async def test_should_dispose_global_request(playwright: Playwright, server: Server):
+async def test_should_dispose_global_request(
+    playwright: Playwright, server: Server
+) -> None:
     request = await playwright.request.new_context()
     response = await request.get(server.PREFIX + "/simple.json")
     assert await response.json() == {"foo": "bar"}
@@ -56,12 +58,12 @@ async def test_should_dispose_global_request(playwright: Playwright, server: Ser
 
 async def test_should_support_global_user_agent_option(
     playwright: Playwright, server: Server
-):
-    request = await playwright.request.new_context(user_agent="My Agent")
-    response = await request.get(server.PREFIX + "/empty.html")
+) -> None:
+    api_request_context = await playwright.request.new_context(user_agent="My Agent")
+    response = await api_request_context.get(server.PREFIX + "/empty.html")
     [request, _] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
-        request.get(server.EMPTY_PAGE),
+        api_request_context.get(server.EMPTY_PAGE),
     )
     assert response.ok is True
     assert response.url == server.EMPTY_PAGE
@@ -70,7 +72,7 @@ async def test_should_support_global_user_agent_option(
 
 async def test_should_support_global_timeout_option(
     playwright: Playwright, server: Server
-):
+) -> None:
     request = await playwright.request.new_context(timeout=100)
     server.set_route("/empty.html", lambda req: None)
     with pytest.raises(Error, match="Request timed out after 100ms"):
@@ -79,7 +81,7 @@ async def test_should_support_global_timeout_option(
 
 async def test_should_propagate_extra_http_headers_with_redirects(
     playwright: Playwright, server: Server
-):
+) -> None:
     server.set_redirect("/a/redirect1", "/b/c/redirect2")
     server.set_redirect("/b/c/redirect2", "/simple.json")
     request = await playwright.request.new_context(
@@ -98,7 +100,7 @@ async def test_should_propagate_extra_http_headers_with_redirects(
 
 async def test_should_support_global_http_credentials_option(
     playwright: Playwright, server: Server
-):
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     request1 = await playwright.request.new_context()
     response1 = await request1.get(server.EMPTY_PAGE)
@@ -116,7 +118,7 @@ async def test_should_support_global_http_credentials_option(
 
 async def test_should_return_error_with_wrong_credentials(
     playwright: Playwright, server: Server
-):
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     request = await playwright.request.new_context(
         http_credentials={"username": "user", "password": "wrong"}
@@ -128,7 +130,7 @@ async def test_should_return_error_with_wrong_credentials(
 
 async def test_should_work_with_correct_credentials_and_matching_origin(
     playwright: Playwright, server: Server
-):
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     request = await playwright.request.new_context(
         http_credentials={
@@ -144,7 +146,7 @@ async def test_should_work_with_correct_credentials_and_matching_origin(
 
 async def test_should_work_with_correct_credentials_and_matching_origin_case_insensitive(
     playwright: Playwright, server: Server
-):
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     request = await playwright.request.new_context(
         http_credentials={
@@ -160,7 +162,7 @@ async def test_should_work_with_correct_credentials_and_matching_origin_case_ins
 
 async def test_should_return_error_with_correct_credentials_and_mismatching_scheme(
     playwright: Playwright, server: Server
-):
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     request = await playwright.request.new_context(
         http_credentials={
@@ -176,9 +178,10 @@ async def test_should_return_error_with_correct_credentials_and_mismatching_sche
 
 async def test_should_return_error_with_correct_credentials_and_mismatching_hostname(
     playwright: Playwright, server: Server
-):
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     hostname = urlparse(server.PREFIX).hostname
+    assert hostname
     origin = server.PREFIX.replace(hostname, "mismatching-hostname")
     request = await playwright.request.new_context(
         http_credentials={"username": "user", "password": "pass", "origin": origin}
@@ -190,7 +193,7 @@ async def test_should_return_error_with_correct_credentials_and_mismatching_host
 
 async def test_should_return_error_with_correct_credentials_and_mismatching_port(
     playwright: Playwright, server: Server
-):
+) -> None:
     server.set_auth("/empty.html", "user", "pass")
     origin = server.PREFIX.replace(str(server.PORT), str(server.PORT + 1))
     request = await playwright.request.new_context(
@@ -203,7 +206,7 @@ async def test_should_return_error_with_correct_credentials_and_mismatching_port
 
 async def test_should_support_global_ignore_https_errors_option(
     playwright: Playwright, https_server: Server
-):
+) -> None:
     request = await playwright.request.new_context(ignore_https_errors=True)
     response = await request.get(https_server.EMPTY_PAGE)
     assert response.status == 200
@@ -214,7 +217,7 @@ async def test_should_support_global_ignore_https_errors_option(
 
 async def test_should_resolve_url_relative_to_global_base_url_option(
     playwright: Playwright, server: Server
-):
+) -> None:
     request = await playwright.request.new_context(base_url=server.PREFIX)
     response = await request.get("/empty.html")
     assert response.status == 200
@@ -225,7 +228,7 @@ async def test_should_resolve_url_relative_to_global_base_url_option(
 
 async def test_should_use_playwright_as_a_user_agent(
     playwright: Playwright, server: Server
-):
+) -> None:
     request = await playwright.request.new_context()
     [server_req, _] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
@@ -235,7 +238,7 @@ async def test_should_use_playwright_as_a_user_agent(
     await request.dispose()
 
 
-async def test_should_return_empty_body(playwright: Playwright, server: Server):
+async def test_should_return_empty_body(playwright: Playwright, server: Server) -> None:
     request = await playwright.request.new_context()
     response = await request.get(server.EMPTY_PAGE)
     body = await response.body()
@@ -248,8 +251,8 @@ async def test_should_return_empty_body(playwright: Playwright, server: Server):
 
 async def test_storage_state_should_round_trip_through_file(
     playwright: Playwright, tmpdir: Path
-):
-    expected = {
+) -> None:
+    expected: StorageState = {
         "cookies": [
             {
                 "name": "a",
@@ -289,7 +292,7 @@ async def test_storage_state_should_round_trip_through_file(
 @pytest.mark.parametrize("serialization", serialization_data)
 async def test_should_json_stringify_body_when_content_type_is_application_json(
     playwright: Playwright, server: Server, serialization: Any
-):
+) -> None:
     request = await playwright.request.new_context()
     [req, _] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
@@ -300,6 +303,7 @@ async def test_should_json_stringify_body_when_content_type_is_application_json(
         ),
     )
     body = req.post_body
+    assert body
     assert body.decode() == json.dumps(serialization)
     await request.dispose()
 
@@ -307,7 +311,7 @@ async def test_should_json_stringify_body_when_content_type_is_application_json(
 @pytest.mark.parametrize("serialization", serialization_data)
 async def test_should_not_double_stringify_body_when_content_type_is_application_json(
     playwright: Playwright, server: Server, serialization: Any
-):
+) -> None:
     request = await playwright.request.new_context()
     stringified_value = json.dumps(serialization)
     [req, _] = await asyncio.gather(
@@ -320,13 +324,14 @@ async def test_should_not_double_stringify_body_when_content_type_is_application
     )
 
     body = req.post_body
+    assert body
     assert body.decode() == stringified_value
     await request.dispose()
 
 
 async def test_should_accept_already_serialized_data_as_bytes_when_content_type_is_application_json(
     playwright: Playwright, server: Server
-):
+) -> None:
     request = await playwright.request.new_context()
     stringified_value = json.dumps({"foo": "bar"}).encode()
     [req, _] = await asyncio.gather(
@@ -344,20 +349,21 @@ async def test_should_accept_already_serialized_data_as_bytes_when_content_type_
 
 async def test_should_contain_default_user_agent(
     playwright: Playwright, server: Server
-):
+) -> None:
     request = await playwright.request.new_context()
-    [request, _] = await asyncio.gather(
+    [server_request, _] = await asyncio.gather(
         server.wait_for_request("/empty.html"),
         request.get(server.EMPTY_PAGE),
     )
-    user_agent = request.getHeader("user-agent")
+    user_agent = server_request.getHeader("user-agent")
+    assert user_agent
     assert "python" in user_agent
     assert f"{sys.version_info.major}.{sys.version_info.minor}" in user_agent
 
 
 async def test_should_throw_an_error_when_max_redirects_is_exceeded(
     playwright: Playwright, server: Server
-):
+) -> None:
     server.set_redirect("/a/redirect1", "/b/c/redirect2")
     server.set_redirect("/b/c/redirect2", "/b/c/redirect3")
     server.set_redirect("/b/c/redirect3", "/b/c/redirect4")
@@ -377,7 +383,7 @@ async def test_should_throw_an_error_when_max_redirects_is_exceeded(
 
 async def test_should_not_follow_redirects_when_max_redirects_is_set_to_0(
     playwright: Playwright, server: Server
-):
+) -> None:
     server.set_redirect("/a/redirect1", "/b/c/redirect2")
     server.set_redirect("/b/c/redirect2", "/simple.json")
 
@@ -393,7 +399,7 @@ async def test_should_not_follow_redirects_when_max_redirects_is_set_to_0(
 async def test_should_throw_an_error_when_max_redirects_is_less_than_0(
     playwright: Playwright,
     server: Server,
-):
+) -> None:
     request = await playwright.request.new_context()
     for method in ["GET", "PUT", "POST", "OPTIONS", "HEAD", "PATCH"]:
         with pytest.raises(AssertionError) as exc_info:
diff --git a/tests/async/test_fill.py b/tests/async/test_fill.py
index 9e5d252f0..4dd6db321 100644
--- a/tests/async/test_fill.py
+++ b/tests/async/test_fill.py
@@ -12,14 +12,20 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from playwright.async_api import Page
+from tests.server import Server
 
-async def test_fill_textarea(page, server):
+
+async def test_fill_textarea(page: Page, server: Server) -> None:
     await page.goto(f"{server.PREFIX}/input/textarea.html")
     await page.fill("textarea", "some value")
     assert await page.evaluate("result") == "some value"
 
 
-async def test_fill_input(page, server):
+#
+
+
+async def test_fill_input(page: Page, server: Server) -> None:
     await page.goto(f"{server.PREFIX}/input/textarea.html")
     await page.fill("input", "some value")
     assert await page.evaluate("result") == "some value"
diff --git a/tests/async/test_focus.py b/tests/async/test_focus.py
index 3728521c4..72698ea85 100644
--- a/tests/async/test_focus.py
+++ b/tests/async/test_focus.py
@@ -14,15 +14,17 @@
 
 import pytest
 
+from playwright.async_api import Page
 
-async def test_should_work(page):
+
+async def test_should_work(page: Page) -> None:
     await page.set_content("<div id=d1 tabIndex=0></div>")
     assert await page.evaluate("() => document.activeElement.nodeName") == "BODY"
     await page.focus("#d1")
     assert await page.evaluate("() => document.activeElement.id") == "d1"
 
 
-async def test_should_emit_focus_event(page):
+async def test_should_emit_focus_event(page: Page) -> None:
     await page.set_content("<div id=d1 tabIndex=0></div>")
     focused = []
     await page.expose_function("focusEvent", lambda: focused.append(True))
@@ -31,7 +33,7 @@ async def test_should_emit_focus_event(page):
     assert focused == [True]
 
 
-async def test_should_emit_blur_event(page):
+async def test_should_emit_blur_event(page: Page) -> None:
     await page.set_content(
         "<div id=d1 tabIndex=0>DIV1</div><div id=d2 tabIndex=0>DIV2</div>"
     )
@@ -47,7 +49,7 @@ async def test_should_emit_blur_event(page):
     assert blurred == [True]
 
 
-async def test_should_traverse_focus(page):
+async def test_should_traverse_focus(page: Page) -> None:
     await page.set_content('<input id="i1"><input id="i2">')
     focused = []
     await page.expose_function("focusEvent", lambda: focused.append(True))
@@ -63,7 +65,7 @@ async def test_should_traverse_focus(page):
     assert await page.eval_on_selector("#i2", "e => e.value") == "Last"
 
 
-async def test_should_traverse_focus_in_all_directions(page):
+async def test_should_traverse_focus_in_all_directions(page: Page) -> None:
     await page.set_content('<input value="1"><input value="2"><input value="3">')
     await page.keyboard.press("Tab")
     assert await page.evaluate("() => document.activeElement.value") == "1"
@@ -79,7 +81,7 @@ async def test_should_traverse_focus_in_all_directions(page):
 
 @pytest.mark.only_platform("darwin")
 @pytest.mark.only_browser("webkit")
-async def test_should_traverse_only_form_elements(page):
+async def test_should_traverse_only_form_elements(page: Page) -> None:
     await page.set_content(
         """
       <input id="input-1">
diff --git a/tests/async/test_frames.py b/tests/async/test_frames.py
index 3070913c7..73c363f23 100644
--- a/tests/async/test_frames.py
+++ b/tests/async/test_frames.py
@@ -13,14 +13,17 @@
 # limitations under the License.
 
 import asyncio
+from typing import Optional
 
 import pytest
 
 from playwright.async_api import Error, Page
 from tests.server import Server
 
+from .utils import Utils
 
-async def test_evaluate_handle(page, server):
+
+async def test_evaluate_handle(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     main_frame = page.main_frame
     assert main_frame.page == page
@@ -28,21 +31,27 @@ async def test_evaluate_handle(page, server):
     assert window_handle
 
 
-async def test_frame_element(page, server, utils):
+async def test_frame_element(page: Page, server: Server, utils: Utils) -> None:
     await page.goto(server.EMPTY_PAGE)
     frame1 = await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
+    assert frame1
     await utils.attach_frame(page, "frame2", server.EMPTY_PAGE)
     frame3 = await utils.attach_frame(page, "frame3", server.EMPTY_PAGE)
+    assert frame3
     frame1handle1 = await page.query_selector("#frame1")
+    assert frame1handle1
     frame1handle2 = await frame1.frame_element()
     frame3handle1 = await page.query_selector("#frame3")
+    assert frame3handle1
     frame3handle2 = await frame3.frame_element()
     assert await frame1handle1.evaluate("(a, b) => a === b", frame1handle2)
     assert await frame3handle1.evaluate("(a, b) => a === b", frame3handle2)
     assert await frame1handle1.evaluate("(a, b) => a === b", frame3handle1) is False
 
 
-async def test_frame_element_with_content_frame(page, server, utils):
+async def test_frame_element_with_content_frame(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     frame = await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     handle = await frame.frame_element()
@@ -50,30 +59,39 @@ async def test_frame_element_with_content_frame(page, server, utils):
     assert content_frame == frame
 
 
-async def test_frame_element_throw_when_detached(page, server, utils):
+async def test_frame_element_throw_when_detached(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     frame1 = await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     await page.eval_on_selector("#frame1", "e => e.remove()")
-    error = None
+    error: Optional[Error] = None
     try:
         await frame1.frame_element()
     except Error as e:
         error = e
+    assert error
     assert error.message == "Frame has been detached."
 
 
-async def test_evaluate_throw_for_detached_frames(page, server, utils):
+async def test_evaluate_throw_for_detached_frames(
+    page: Page, server: Server, utils: Utils
+) -> None:
     frame1 = await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
+    assert frame1
     await utils.detach_frame(page, "frame1")
-    error = None
+    error: Optional[Error] = None
     try:
         await frame1.evaluate("7 * 8")
     except Error as e:
         error = e
+    assert error
     assert "Frame was detached" in error.message
 
 
-async def test_evaluate_isolated_between_frames(page, server, utils):
+async def test_evaluate_isolated_between_frames(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     assert len(page.frames) == 2
@@ -90,7 +108,9 @@ async def test_evaluate_isolated_between_frames(page, server, utils):
     assert a2 == 2
 
 
-async def test_should_handle_nested_frames(page, server, utils):
+async def test_should_handle_nested_frames(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.PREFIX + "/frames/nested-frames.html")
     assert utils.dump_frames(page.main_frame) == [
         "http://localhost:<PORT>/frames/nested-frames.html",
@@ -102,8 +122,8 @@ async def test_should_handle_nested_frames(page, server, utils):
 
 
 async def test_should_send_events_when_frames_are_manipulated_dynamically(
-    page, server, utils
-):
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     # validate frameattached events
     attached_frames = []
@@ -134,21 +154,27 @@ async def test_should_send_events_when_frames_are_manipulated_dynamically(
     assert detached_frames[0].is_detached()
 
 
-async def test_framenavigated_when_navigating_on_anchor_urls(page, server):
+async def test_framenavigated_when_navigating_on_anchor_urls(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_event("framenavigated"):
         await page.goto(server.EMPTY_PAGE + "#foo")
     assert page.url == server.EMPTY_PAGE + "#foo"
 
 
-async def test_persist_main_frame_on_cross_process_navigation(page, server):
+async def test_persist_main_frame_on_cross_process_navigation(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     main_frame = page.main_frame
     await page.goto(server.CROSS_PROCESS_PREFIX + "/empty.html")
     assert page.main_frame == main_frame
 
 
-async def test_should_not_send_attach_detach_events_for_main_frame(page, server):
+async def test_should_not_send_attach_detach_events_for_main_frame(
+    page: Page, server: Server
+) -> None:
     has_events = []
     page.on("frameattached", lambda frame: has_events.append(True))
     page.on("framedetached", lambda frame: has_events.append(True))
@@ -156,7 +182,7 @@ async def test_should_not_send_attach_detach_events_for_main_frame(page, server)
     assert has_events == []
 
 
-async def test_detach_child_frames_on_navigation(page, server):
+async def test_detach_child_frames_on_navigation(page: Page, server: Server) -> None:
     attached_frames = []
     detached_frames = []
     navigated_frames = []
@@ -177,7 +203,7 @@ async def test_detach_child_frames_on_navigation(page, server):
     assert len(navigated_frames) == 1
 
 
-async def test_framesets(page, server):
+async def test_framesets(page: Page, server: Server) -> None:
     attached_frames = []
     detached_frames = []
     navigated_frames = []
@@ -198,7 +224,7 @@ async def test_framesets(page, server):
     assert len(navigated_frames) == 1
 
 
-async def test_frame_from_inside_shadow_dom(page, server):
+async def test_frame_from_inside_shadow_dom(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/shadow.html")
     await page.evaluate(
         """async url => {
@@ -213,7 +239,7 @@ async def test_frame_from_inside_shadow_dom(page, server):
     assert page.frames[1].url == server.EMPTY_PAGE
 
 
-async def test_frame_name(page, server, utils):
+async def test_frame_name(page: Page, server: Server, utils: Utils) -> None:
     await utils.attach_frame(page, "theFrameId", server.EMPTY_PAGE)
     await page.evaluate(
         """url => {
@@ -230,7 +256,7 @@ async def test_frame_name(page, server, utils):
     assert page.frames[2].name == "theFrameName"
 
 
-async def test_frame_parent(page, server, utils):
+async def test_frame_parent(page: Page, server: Server, utils: Utils) -> None:
     await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     await utils.attach_frame(page, "frame2", server.EMPTY_PAGE)
     assert page.frames[0].parent_frame is None
@@ -239,8 +265,8 @@ async def test_frame_parent(page, server, utils):
 
 
 async def test_should_report_different_frame_instance_when_frame_re_attaches(
-    page, server, utils
-):
+    page: Page, server: Server, utils: Utils
+) -> None:
     frame1 = await utils.attach_frame(page, "frame1", server.EMPTY_PAGE)
     await page.evaluate(
         """() => {
@@ -258,7 +284,7 @@ async def test_should_report_different_frame_instance_when_frame_re_attaches(
     assert frame1 != frame2
 
 
-async def test_strict_mode(page: Page, server: Server):
+async def test_strict_mode(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
         """
diff --git a/tests/async/test_geolocation.py b/tests/async/test_geolocation.py
index 40b166ee2..5791b5984 100644
--- a/tests/async/test_geolocation.py
+++ b/tests/async/test_geolocation.py
@@ -15,10 +15,11 @@
 
 import pytest
 
-from playwright.async_api import BrowserContext, Error, Page
+from playwright.async_api import Browser, BrowserContext, Error, Page
+from tests.server import Server
 
 
-async def test_should_work(page: Page, server, context: BrowserContext):
+async def test_should_work(page: Page, server: Server, context: BrowserContext) -> None:
     await context.grant_permissions(["geolocation"])
     await page.goto(server.EMPTY_PAGE)
     await context.set_geolocation({"latitude": 10, "longitude": 10})
@@ -30,7 +31,7 @@ async def test_should_work(page: Page, server, context: BrowserContext):
     assert geolocation == {"latitude": 10, "longitude": 10}
 
 
-async def test_should_throw_when_invalid_longitude(context):
+async def test_should_throw_when_invalid_longitude(context: BrowserContext) -> None:
     with pytest.raises(Error) as exc:
         await context.set_geolocation({"latitude": 10, "longitude": 200})
     assert (
@@ -39,7 +40,9 @@ async def test_should_throw_when_invalid_longitude(context):
     )
 
 
-async def test_should_isolate_contexts(page, server, context, browser):
+async def test_should_isolate_contexts(
+    page: Page, server: Server, context: BrowserContext, browser: Browser
+) -> None:
     await context.grant_permissions(["geolocation"])
     await context.set_geolocation({"latitude": 10, "longitude": 10})
     await page.goto(server.EMPTY_PAGE)
@@ -68,12 +71,10 @@ async def test_should_isolate_contexts(page, server, context, browser):
     await context2.close()
 
 
-async def test_should_use_context_options(browser, server):
-    options = {
-        "geolocation": {"latitude": 10, "longitude": 10},
-        "permissions": ["geolocation"],
-    }
-    context = await browser.new_context(**options)
+async def test_should_use_context_options(browser: Browser, server: Server) -> None:
+    context = await browser.new_context(
+        geolocation={"latitude": 10, "longitude": 10}, permissions=["geolocation"]
+    )
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
 
@@ -86,7 +87,9 @@ async def test_should_use_context_options(browser, server):
     await context.close()
 
 
-async def test_watch_position_should_be_notified(page, server, context):
+async def test_watch_position_should_be_notified(
+    page: Page, server: Server, context: BrowserContext
+) -> None:
     await context.grant_permissions(["geolocation"])
     await page.goto(server.EMPTY_PAGE)
     messages = []
@@ -117,7 +120,9 @@ async def test_watch_position_should_be_notified(page, server, context):
     assert "lat=40 lng=50" in all_messages
 
 
-async def test_should_use_context_options_for_popup(page, context, server):
+async def test_should_use_context_options_for_popup(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
     await context.grant_permissions(["geolocation"])
     await context.set_geolocation({"latitude": 10, "longitude": 10})
     async with page.expect_popup() as popup_info:
diff --git a/tests/async/test_har.py b/tests/async/test_har.py
index ce0b228c4..b0978894b 100644
--- a/tests/async/test_har.py
+++ b/tests/async/test_har.py
@@ -23,9 +23,10 @@
 
 from playwright.async_api import Browser, BrowserContext, Error, Page, Route, expect
 from tests.server import Server
+from tests.utils import must
 
 
-async def test_should_work(browser, server, tmpdir):
+async def test_should_work(browser: Browser, server: Server, tmpdir: Path) -> None:
     path = os.path.join(tmpdir, "log.har")
     context = await browser.new_context(record_har_path=path)
     page = await context.new_page()
@@ -36,7 +37,9 @@ async def test_should_work(browser, server, tmpdir):
         assert "log" in data
 
 
-async def test_should_omit_content(browser, server, tmpdir):
+async def test_should_omit_content(
+    browser: Browser, server: Server, tmpdir: Path
+) -> None:
     path = os.path.join(tmpdir, "log.har")
     context = await browser.new_context(
         record_har_path=path,
@@ -54,7 +57,9 @@ async def test_should_omit_content(browser, server, tmpdir):
         assert "encoding" not in content1
 
 
-async def test_should_omit_content_legacy(browser, server, tmpdir):
+async def test_should_omit_content_legacy(
+    browser: Browser, server: Server, tmpdir: Path
+) -> None:
     path = os.path.join(tmpdir, "log.har")
     context = await browser.new_context(
         record_har_path=path, record_har_omit_content=True
@@ -71,7 +76,9 @@ async def test_should_omit_content_legacy(browser, server, tmpdir):
         assert "encoding" not in content1
 
 
-async def test_should_attach_content(browser, server, tmpdir, is_firefox):
+async def test_should_attach_content(
+    browser: Browser, server: Server, tmpdir: Path
+) -> None:
     path = os.path.join(tmpdir, "log.har.zip")
     context = await browser.new_context(
         record_har_path=path,
@@ -128,7 +135,9 @@ async def test_should_attach_content(browser, server, tmpdir, is_firefox):
                 assert len(f.read()) == entries[2]["response"]["content"]["size"]
 
 
-async def test_should_not_omit_content(browser, server, tmpdir):
+async def test_should_not_omit_content(
+    browser: Browser, server: Server, tmpdir: Path
+) -> None:
     path = os.path.join(tmpdir, "log.har")
     context = await browser.new_context(
         record_har_path=path, record_har_omit_content=False
@@ -142,7 +151,9 @@ async def test_should_not_omit_content(browser, server, tmpdir):
         assert "text" in content1
 
 
-async def test_should_include_content(browser, server, tmpdir):
+async def test_should_include_content(
+    browser: Browser, server: Server, tmpdir: Path
+) -> None:
     path = os.path.join(tmpdir, "log.har")
     context = await browser.new_context(record_har_path=path)
     page = await context.new_page()
@@ -158,7 +169,9 @@ async def test_should_include_content(browser, server, tmpdir):
         assert "HAR Page" in content1["text"]
 
 
-async def test_should_default_to_full_mode(browser, server, tmpdir):
+async def test_should_default_to_full_mode(
+    browser: Browser, server: Server, tmpdir: Path
+) -> None:
     path = os.path.join(tmpdir, "log.har")
     context = await browser.new_context(
         record_har_path=path,
@@ -173,7 +186,9 @@ async def test_should_default_to_full_mode(browser, server, tmpdir):
         assert log["entries"][0]["request"]["bodySize"] >= 0
 
 
-async def test_should_support_minimal_mode(browser, server, tmpdir):
+async def test_should_support_minimal_mode(
+    browser: Browser, server: Server, tmpdir: Path
+) -> None:
     path = os.path.join(tmpdir, "log.har")
     context = await browser.new_context(
         record_har_path=path,
@@ -308,7 +323,7 @@ async def test_should_only_handle_requests_matching_url_filter(
     )
     page = await context.new_page()
 
-    async def handler(route: Route):
+    async def handler(route: Route) -> None:
         assert route.request.url == "http://no.playwright/"
         await route.fulfill(
             status=200,
@@ -330,7 +345,7 @@ async def test_should_only_handle_requests_matching_url_filter_no_fallback(
     await context.route_from_har(har=assetdir / "har-fulfill.har", url="**/*.js")
     page = await context.new_page()
 
-    async def handler(route: Route):
+    async def handler(route: Route) -> None:
         assert route.request.url == "http://no.playwright/"
         await route.fulfill(
             status=200,
@@ -351,7 +366,7 @@ async def test_should_only_handle_requests_matching_url_filter_no_fallback_page(
 ) -> None:
     await page.route_from_har(har=assetdir / "har-fulfill.har", url="**/*.js")
 
-    async def handler(route: Route):
+    async def handler(route: Route) -> None:
         assert route.request.url == "http://no.playwright/"
         await route.fulfill(
             status=200,
@@ -431,6 +446,7 @@ async def test_should_go_back_to_redirected_navigation(
     await expect(page).to_have_url(server.EMPTY_PAGE)
 
     response = await page.go_back()
+    assert response
     await expect(page).to_have_url("https://www.theverge.com/")
     assert response.request.url == "https://www.theverge.com/"
     assert await page.evaluate("window.location.href") == "https://www.theverge.com/"
@@ -454,6 +470,7 @@ async def test_should_go_forward_to_redirected_navigation(
     await page.go_back()
     await expect(page).to_have_url(server.EMPTY_PAGE)
     response = await page.go_forward()
+    assert response
     await expect(page).to_have_url("https://www.theverge.com/")
     assert response.request.url == "https://www.theverge.com/"
     assert await page.evaluate("window.location.href") == "https://www.theverge.com/"
@@ -469,6 +486,7 @@ async def test_should_reload_redirected_navigation(
     await page.goto("https://theverge.com/")
     await expect(page).to_have_url("https://www.theverge.com/")
     response = await page.reload()
+    assert response
     await expect(page).to_have_url("https://www.theverge.com/")
     assert response.request.url == "https://www.theverge.com/"
     assert await page.evaluate("window.location.href") == "https://www.theverge.com/"
@@ -541,7 +559,8 @@ async def test_should_disambiguate_by_header(
     browser: Browser, server: Server, tmpdir: Path
 ) -> None:
     server.set_route(
-        "/echo", lambda req: (req.write(req.getHeader("baz").encode()), req.finish())
+        "/echo",
+        lambda req: (req.write(must(req.getHeader("baz")).encode()), req.finish()),
     )
     fetch_function = """
         async (bazValue) => {
diff --git a/tests/async/test_headful.py b/tests/async/test_headful.py
index bc1df9b69..2e0dd026f 100644
--- a/tests/async/test_headful.py
+++ b/tests/async/test_headful.py
@@ -13,12 +13,18 @@
 # limitations under the License.
 
 
+from pathlib import Path
+from typing import Dict
+
 import pytest
 
+from playwright.async_api import BrowserType
+from tests.server import Server
+
 
 async def test_should_have_default_url_when_launching_browser(
-    browser_type, launch_arguments, tmpdir
-):
+    browser_type: BrowserType, launch_arguments: Dict, tmpdir: Path
+) -> None:
     browser_context = await browser_type.launch_persistent_context(
         tmpdir, **{**launch_arguments, "headless": False}
     )
@@ -28,8 +34,8 @@ async def test_should_have_default_url_when_launching_browser(
 
 
 async def test_should_close_browser_with_beforeunload_page(
-    browser_type, launch_arguments, server, tmpdir
-):
+    browser_type: BrowserType, launch_arguments: Dict, server: Server, tmpdir: Path
+) -> None:
     browser_context = await browser_type.launch_persistent_context(
         tmpdir, **{**launch_arguments, "headless": False}
     )
@@ -42,8 +48,8 @@ async def test_should_close_browser_with_beforeunload_page(
 
 
 async def test_should_not_crash_when_creating_second_context(
-    browser_type, launch_arguments, server
-):
+    browser_type: BrowserType, launch_arguments: Dict, server: Server
+) -> None:
     browser = await browser_type.launch(**{**launch_arguments, "headless": False})
     browser_context = await browser.new_context()
     await browser_context.new_page()
@@ -54,7 +60,9 @@ async def test_should_not_crash_when_creating_second_context(
     await browser.close()
 
 
-async def test_should_click_background_tab(browser_type, launch_arguments, server):
+async def test_should_click_background_tab(
+    browser_type: BrowserType, launch_arguments: Dict, server: Server
+) -> None:
     browser = await browser_type.launch(**{**launch_arguments, "headless": False})
     page = await browser.new_page()
     await page.set_content(
@@ -66,8 +74,8 @@ async def test_should_click_background_tab(browser_type, launch_arguments, serve
 
 
 async def test_should_close_browser_after_context_menu_was_triggered(
-    browser_type, launch_arguments, server
-):
+    browser_type: BrowserType, launch_arguments: Dict, server: Server
+) -> None:
     browser = await browser_type.launch(**{**launch_arguments, "headless": False})
     page = await browser.new_page()
     await page.goto(server.PREFIX + "/grid.html")
@@ -76,8 +84,12 @@ async def test_should_close_browser_after_context_menu_was_triggered(
 
 
 async def test_should_not_block_third_party_cookies(
-    browser_type, launch_arguments, server, is_chromium, is_firefox
-):
+    browser_type: BrowserType,
+    launch_arguments: Dict,
+    server: Server,
+    is_chromium: bool,
+    is_firefox: bool,
+) -> None:
     browser = await browser_type.launch(**{**launch_arguments, "headless": False})
     page = await browser.new_page()
     await page.goto(server.EMPTY_PAGE)
@@ -125,8 +137,8 @@ async def test_should_not_block_third_party_cookies(
 
 @pytest.mark.skip_browser("webkit")
 async def test_should_not_override_viewport_size_when_passed_null(
-    browser_type, launch_arguments, server
-):
+    browser_type: BrowserType, launch_arguments: Dict, server: Server
+) -> None:
     # Our WebKit embedder does not respect window features.
     browser = await browser_type.launch(**{**launch_arguments, "headless": False})
     context = await browser.new_context(no_viewport=True)
@@ -148,7 +160,9 @@ async def test_should_not_override_viewport_size_when_passed_null(
     await browser.close()
 
 
-async def test_page_bring_to_front_should_work(browser_type, launch_arguments):
+async def test_page_bring_to_front_should_work(
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
     browser = await browser_type.launch(**{**launch_arguments, "headless": False})
     page1 = await browser.new_page()
     await page1.set_content("Page1")
diff --git a/tests/async/test_ignore_https_errors.py b/tests/async/test_ignore_https_errors.py
index e9092aa94..53a6eabb1 100644
--- a/tests/async/test_ignore_https_errors.py
+++ b/tests/async/test_ignore_https_errors.py
@@ -14,18 +14,24 @@
 
 import pytest
 
-from playwright.async_api import Error
+from playwright.async_api import Browser, Error
+from tests.server import Server
 
 
-async def test_ignore_https_error_should_work(browser, https_server):
+async def test_ignore_https_error_should_work(
+    browser: Browser, https_server: Server
+) -> None:
     context = await browser.new_context(ignore_https_errors=True)
     page = await context.new_page()
     response = await page.goto(https_server.EMPTY_PAGE)
+    assert response
     assert response.ok
     await context.close()
 
 
-async def test_ignore_https_error_should_work_negative_case(browser, https_server):
+async def test_ignore_https_error_should_work_negative_case(
+    browser: Browser, https_server: Server
+) -> None:
     context = await browser.new_context()
     page = await context.new_page()
     with pytest.raises(Error):
diff --git a/tests/async/test_input.py b/tests/async/test_input.py
index 76a8acc4d..5898d1a6f 100644
--- a/tests/async/test_input.py
+++ b/tests/async/test_input.py
@@ -18,21 +18,25 @@
 import shutil
 import sys
 from pathlib import Path
+from typing import Any
 
 import pytest
 from flaky import flaky
 
 from playwright._impl._path_utils import get_file_dirname
-from playwright.async_api import Page
+from playwright.async_api import FilePayload, Page
+from tests.server import Server
+from tests.utils import must
 
 _dirname = get_file_dirname()
 FILE_TO_UPLOAD = _dirname / ".." / "assets/file-to-upload.txt"
 
 
-async def test_should_upload_the_file(page, server):
+async def test_should_upload_the_file(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/fileupload.html")
     file_path = os.path.relpath(FILE_TO_UPLOAD, os.getcwd())
     input = await page.query_selector("input")
+    assert input
     await input.set_input_files(file_path)
     assert await page.evaluate("e => e.files[0].name", input) == "file-to-upload.txt"
     assert (
@@ -49,7 +53,7 @@ async def test_should_upload_the_file(page, server):
     )
 
 
-async def test_should_work(page, assetdir):
+async def test_should_work(page: Page, assetdir: Path) -> None:
     await page.set_content("<input type=file>")
     await page.set_input_files("input", assetdir / "file-to-upload.txt")
     assert await page.eval_on_selector("input", "input => input.files.length") == 1
@@ -59,13 +63,16 @@ async def test_should_work(page, assetdir):
     )
 
 
-async def test_should_set_from_memory(page):
+async def test_should_set_from_memory(page: Page) -> None:
     await page.set_content("<input type=file>")
+    file: FilePayload = {
+        "name": "test.txt",
+        "mimeType": "text/plain",
+        "buffer": b"this is a test",
+    }
     await page.set_input_files(
         "input",
-        files=[
-            {"name": "test.txt", "mimeType": "text/plain", "buffer": b"this is a test"}
-        ],
+        files=[file],
     )
     assert await page.eval_on_selector("input", "input => input.files.length") == 1
     assert (
@@ -74,7 +81,7 @@ async def test_should_set_from_memory(page):
     )
 
 
-async def test_should_emit_event(page: Page):
+async def test_should_emit_event(page: Page) -> None:
     await page.set_content("<input type=file>")
     fc_done: asyncio.Future = asyncio.Future()
     page.once("filechooser", lambda file_chooser: fc_done.set_result(file_chooser))
@@ -87,7 +94,7 @@ async def test_should_emit_event(page: Page):
     )
 
 
-async def test_should_work_when_file_input_is_attached_to_dom(page: Page):
+async def test_should_work_when_file_input_is_attached_to_dom(page: Page) -> None:
     await page.set_content("<input type=file>")
     async with page.expect_file_chooser() as fc_info:
         await page.click("input")
@@ -95,7 +102,7 @@ async def test_should_work_when_file_input_is_attached_to_dom(page: Page):
     assert file_chooser
 
 
-async def test_should_work_when_file_input_is_not_attached_to_DOM(page):
+async def test_should_work_when_file_input_is_not_attached_to_DOM(page: Page) -> None:
     async with page.expect_file_chooser() as fc_info:
         await page.evaluate(
             """() => {
@@ -110,7 +117,7 @@ async def test_should_work_when_file_input_is_not_attached_to_DOM(page):
 
 async def test_should_return_the_same_file_chooser_when_there_are_many_watchdogs_simultaneously(
     page: Page,
-):
+) -> None:
     await page.set_content("<input type=file>")
     results = await asyncio.gather(
         page.wait_for_event("filechooser"),
@@ -120,7 +127,7 @@ async def test_should_return_the_same_file_chooser_when_there_are_many_watchdogs
     assert results[0] == results[1]
 
 
-async def test_should_accept_single_file(page: Page):
+async def test_should_accept_single_file(page: Page) -> None:
     await page.set_content('<input type=file oninput="javascript:console.timeStamp()">')
     async with page.expect_file_chooser() as fc_info:
         await page.click("input")
@@ -135,7 +142,7 @@ async def test_should_accept_single_file(page: Page):
     )
 
 
-async def test_should_be_able_to_read_selected_file(page: Page):
+async def test_should_be_able_to_read_selected_file(page: Page) -> None:
     page.once(
         "filechooser", lambda file_chooser: file_chooser.set_files(FILE_TO_UPLOAD)
     )
@@ -155,8 +162,8 @@ async def test_should_be_able_to_read_selected_file(page: Page):
 
 
 async def test_should_be_able_to_reset_selected_files_with_empty_file_list(
-    page: Page, server
-):
+    page: Page,
+) -> None:
     await page.set_content("<input type=file>")
     page.once(
         "filechooser", lambda file_chooser: file_chooser.set_files(FILE_TO_UPLOAD)
@@ -187,8 +194,8 @@ async def test_should_be_able_to_reset_selected_files_with_empty_file_list(
 
 
 async def test_should_not_accept_multiple_files_for_single_file_input(
-    page, server, assetdir
-):
+    page: Page, assetdir: Path
+) -> None:
     await page.set_content("<input type=file>")
     async with page.expect_file_chooser() as fc_info:
         await page.click("input")
@@ -203,7 +210,7 @@ async def test_should_not_accept_multiple_files_for_single_file_input(
     assert exc_info.value
 
 
-async def test_should_emit_input_and_change_events(page):
+async def test_should_emit_input_and_change_events(page: Page) -> None:
     events = []
     await page.expose_function("eventHandled", lambda e: events.append(e))
     await page.set_content(
@@ -215,13 +222,13 @@ async def test_should_emit_input_and_change_events(page):
             </script>
         """
     )
-    await (await page.query_selector("input")).set_input_files(FILE_TO_UPLOAD)
+    await must(await page.query_selector("input")).set_input_files(FILE_TO_UPLOAD)
     assert len(events) == 2
     assert events[0]["type"] == "input"
     assert events[1]["type"] == "change"
 
 
-async def test_should_work_for_single_file_pick(page):
+async def test_should_work_for_single_file_pick(page: Page) -> None:
     await page.set_content("<input type=file>")
     async with page.expect_file_chooser() as fc_info:
         await page.click("input")
@@ -229,7 +236,7 @@ async def test_should_work_for_single_file_pick(page):
     assert file_chooser.is_multiple() is False
 
 
-async def test_should_work_for_multiple(page):
+async def test_should_work_for_multiple(page: Page) -> None:
     await page.set_content("<input multiple type=file>")
     async with page.expect_file_chooser() as fc_info:
         await page.click("input")
@@ -237,7 +244,7 @@ async def test_should_work_for_multiple(page):
     assert file_chooser.is_multiple()
 
 
-async def test_should_work_for_webkitdirectory(page):
+async def test_should_work_for_webkitdirectory(page: Page) -> None:
     await page.set_content("<input multiple webkitdirectory type=file>")
     async with page.expect_file_chooser() as fc_info:
         await page.click("input")
@@ -245,7 +252,7 @@ async def test_should_work_for_webkitdirectory(page):
     assert file_chooser.is_multiple()
 
 
-def _assert_wheel_event(expected, received, browser_name):
+def _assert_wheel_event(expected: Any, received: Any, browser_name: str) -> None:
     # Chromium reports deltaX/deltaY scaled by host device scale factor.
     # https://bugs.chromium.org/p/chromium/issues/detail?id=1324819
     # https://github.com/microsoft/playwright/issues/7362
@@ -259,7 +266,7 @@ def _assert_wheel_event(expected, received, browser_name):
     assert received == expected
 
 
-async def test_wheel_should_work(page: Page, server, browser_name: str):
+async def test_wheel_should_work(page: Page, browser_name: str) -> None:
     await page.set_content(
         """
         <div style="width: 5000px; height: 5000px;"></div>
@@ -310,7 +317,9 @@ async def _listen_for_wheel_events(page: Page, selector: str) -> None:
 
 
 @flaky
-async def test_should_upload_large_file(page, server, tmp_path):
+async def test_should_upload_large_file(
+    page: Page, server: Server, tmp_path: Path
+) -> None:
     await page.goto(server.PREFIX + "/input/fileupload.html")
     large_file_path = tmp_path / "200MB.zip"
     data = b"A" * 1024
@@ -343,11 +352,13 @@ async def test_should_upload_large_file(page, server, tmp_path):
     assert contents[:1024] == data
     # flake8: noqa: E203
     assert contents[len(contents) - 1024 :] == data
+    assert request.post_body
     match = re.search(
         rb'^.*Content-Disposition: form-data; name="(?P<name>.*)"; filename="(?P<filename>.*)".*$',
         request.post_body,
         re.MULTILINE,
     )
+    assert match
     assert match.group("name") == b"file1"
     assert match.group("filename") == b"200MB.zip"
 
@@ -373,7 +384,9 @@ async def test_set_input_files_should_preserve_last_modified_timestamp(
 
 
 @flaky
-async def test_should_upload_multiple_large_file(page: Page, server, tmp_path):
+async def test_should_upload_multiple_large_file(
+    page: Page, server: Server, tmp_path: Path
+) -> None:
     files_count = 10
     await page.goto(server.PREFIX + "/input/fileupload-multi.html")
     upload_file = tmp_path / "50MB_1.zip"
diff --git a/tests/async/test_interception.py b/tests/async/test_interception.py
index 08a24273a..68f749d42 100644
--- a/tests/async/test_interception.py
+++ b/tests/async/test_interception.py
@@ -15,17 +15,28 @@
 import asyncio
 import json
 import re
+from pathlib import Path
+from typing import Callable, List
 
 import pytest
 
-from playwright.async_api import Browser, BrowserContext, Error, Page, Playwright, Route
-from tests.server import Server
+from playwright.async_api import (
+    Browser,
+    BrowserContext,
+    Error,
+    Page,
+    Playwright,
+    Request,
+    Route,
+)
+from tests.server import HttpRequestWithPostBody, Server
+from tests.utils import must
 
 
-async def test_page_route_should_intercept(page, server):
+async def test_page_route_should_intercept(page: Page, server: Server) -> None:
     intercepted = []
 
-    async def handle_request(route, request):
+    async def handle_request(route: Route, request: Request) -> None:
         assert route.request == request
         assert "empty.html" in request.url
         assert request.headers["user-agent"]
@@ -41,38 +52,36 @@ async def handle_request(route, request):
     await page.route("**/empty.html", handle_request)
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.ok
     assert len(intercepted) == 1
 
 
-async def test_page_route_should_unroute(page: Page, server):
+async def test_page_route_should_unroute(page: Page, server: Server) -> None:
     intercepted = []
 
-    await page.route(
-        "**/*",
-        lambda route: (
-            intercepted.append(1),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
+    def _handle1(route: Route) -> None:
+        intercepted.append(1)
+        asyncio.create_task(route.continue_())
 
-    await page.route(
-        "**/empty.html",
-        lambda route: (
-            intercepted.append(2),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
+    await page.route("**/*", _handle1)
+
+    def _handle2(route: Route, request: Request) -> None:
+        intercepted.append(2)
+        asyncio.create_task(route.continue_())
+
+    await page.route("**/empty.html", _handle2)
+
+    def _handle3(route: Route, request: Request) -> None:
+        intercepted.append(3)
+        asyncio.create_task(route.continue_())
 
     await page.route(
         "**/empty.html",
-        lambda route: (
-            intercepted.append(3),
-            asyncio.create_task(route.continue_()),
-        ),
+        _handle3,
     )
 
-    def handler4(route):
+    def handler4(route: Route) -> None:
         intercepted.append(4)
         asyncio.create_task(route.continue_())
 
@@ -92,7 +101,9 @@ def handler4(route):
     assert intercepted == [1]
 
 
-async def test_page_route_should_work_when_POST_is_redirected_with_302(page, server):
+async def test_page_route_should_work_when_POST_is_redirected_with_302(
+    page: Page, server: Server
+) -> None:
     server.set_redirect("/rredirect", "/empty.html")
     await page.goto(server.EMPTY_PAGE)
     await page.route("**/*", lambda route: route.continue_())
@@ -109,8 +120,8 @@ async def test_page_route_should_work_when_POST_is_redirected_with_302(page, ser
 
 # @see https://github.com/GoogleChrome/puppeteer/issues/3973
 async def test_page_route_should_work_when_header_manipulation_headers_with_redirect(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     server.set_redirect("/rrredirect", "/empty.html")
     await page.route(
         "**/*",
@@ -121,8 +132,10 @@ async def test_page_route_should_work_when_header_manipulation_headers_with_redi
 
 
 # @see https://github.com/GoogleChrome/puppeteer/issues/4743
-async def test_page_route_should_be_able_to_remove_headers(page, server):
-    async def handle_request(route):
+async def test_page_route_should_be_able_to_remove_headers(
+    page: Page, server: Server
+) -> None:
+    async def handle_request(route: Route) -> None:
         headers = route.request.headers
         if "origin" in headers:
             del headers["origin"]
@@ -139,14 +152,18 @@ async def handle_request(route):
     assert serverRequest.getHeader("origin") is None
 
 
-async def test_page_route_should_contain_referer_header(page, server):
+async def test_page_route_should_contain_referer_header(
+    page: Page, server: Server
+) -> None:
     requests = []
+
+    def _handle(route: Route, request: Request) -> None:
+        requests.append(route.request)
+        asyncio.create_task(route.continue_())
+
     await page.route(
         "**/*",
-        lambda route: (
-            requests.append(route.request),
-            asyncio.create_task(route.continue_()),
-        ),
+        _handle,
     )
 
     await page.goto(server.PREFIX + "/one-style.html")
@@ -155,8 +172,8 @@ async def test_page_route_should_contain_referer_header(page, server):
 
 
 async def test_page_route_should_properly_return_navigation_response_when_URL_has_cookies(
-    context, page, server
-):
+    context: BrowserContext, page: Page, server: Server
+) -> None:
     # Setup cookie.
     await page.goto(server.EMPTY_PAGE)
     await context.add_cookies(
@@ -166,29 +183,36 @@ async def test_page_route_should_properly_return_navigation_response_when_URL_ha
     # Setup request interception.
     await page.route("**/*", lambda route: route.continue_())
     response = await page.reload()
+    assert response
     assert response.status == 200
 
 
-async def test_page_route_should_show_custom_HTTP_headers(page, server):
+async def test_page_route_should_show_custom_HTTP_headers(
+    page: Page, server: Server
+) -> None:
     await page.set_extra_http_headers({"foo": "bar"})
 
-    def assert_headers(request):
+    def assert_headers(request: Request) -> None:
         assert request.headers["foo"] == "bar"
 
+    def _handle(route: Route) -> None:
+        assert_headers(route.request)
+        asyncio.create_task(route.continue_())
+
     await page.route(
         "**/*",
-        lambda route: (
-            assert_headers(route.request),
-            asyncio.create_task(route.continue_()),
-        ),
+        _handle,
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.ok
 
 
 # @see https://github.com/GoogleChrome/puppeteer/issues/4337
-async def test_page_route_should_work_with_redirect_inside_sync_XHR(page, server):
+async def test_page_route_should_work_with_redirect_inside_sync_XHR(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     server.set_redirect("/logo.png", "/pptr.png")
     await page.route("**/*", lambda route: route.continue_())
@@ -204,43 +228,48 @@ async def test_page_route_should_work_with_redirect_inside_sync_XHR(page, server
     assert status == 200
 
 
-async def test_page_route_should_work_with_custom_referer_headers(page, server):
+async def test_page_route_should_work_with_custom_referer_headers(
+    page: Page, server: Server
+) -> None:
     await page.set_extra_http_headers({"referer": server.EMPTY_PAGE})
 
-    def assert_headers(route):
+    def assert_headers(route: Route) -> None:
         assert route.request.headers["referer"] == server.EMPTY_PAGE
 
+    def _handle(route: Route, request: Request) -> None:
+        assert_headers(route)
+        asyncio.create_task(route.continue_())
+
     await page.route(
         "**/*",
-        lambda route: (
-            assert_headers(route),
-            asyncio.create_task(route.continue_()),
-        ),
+        _handle,
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.ok
 
 
-async def test_page_route_should_be_abortable(page, server):
+async def test_page_route_should_be_abortable(page: Page, server: Server) -> None:
     await page.route(r"/\.css$/", lambda route: asyncio.create_task(route.abort()))
     failed = []
 
-    def handle_request(request):
-        if request.url.includes(".css"):
+    def handle_request(request: Request) -> None:
+        if ".css" in request.url:
             failed.append(True)
 
     page.on("requestfailed", handle_request)
 
     response = await page.goto(server.PREFIX + "/one-style.html")
+    assert response
     assert response.ok
     assert response.request.failure is None
     assert len(failed) == 0
 
 
 async def test_page_route_should_be_abortable_with_custom_error_codes(
-    page: Page, server, is_webkit, is_firefox
-):
+    page: Page, server: Server, is_webkit: bool, is_firefox: bool
+) -> None:
     await page.route(
         "**/*",
         lambda route: route.abort("internetdisconnected"),
@@ -259,7 +288,7 @@ async def test_page_route_should_be_abortable_with_custom_error_codes(
         assert failed_request.failure == "net::ERR_INTERNET_DISCONNECTED"
 
 
-async def test_page_route_should_send_referer(page, server):
+async def test_page_route_should_send_referer(page: Page, server: Server) -> None:
     await page.set_extra_http_headers({"referer": "http://google.com/"})
 
     await page.route("**/*", lambda route: route.continue_())
@@ -271,8 +300,8 @@ async def test_page_route_should_send_referer(page, server):
 
 
 async def test_page_route_should_fail_navigation_when_aborting_main_resource(
-    page, server, is_webkit, is_firefox
-):
+    page: Page, server: Server, is_webkit: bool, is_firefox: bool
+) -> None:
     await page.route("**/*", lambda route: route.abort())
     with pytest.raises(Error) as exc:
         await page.goto(server.EMPTY_PAGE)
@@ -285,14 +314,18 @@ async def test_page_route_should_fail_navigation_when_aborting_main_resource(
         assert "net::ERR_FAILED" in exc.value.message
 
 
-async def test_page_route_should_not_work_with_redirects(page, server):
+async def test_page_route_should_not_work_with_redirects(
+    page: Page, server: Server
+) -> None:
     intercepted = []
+
+    def _handle(route: Route, request: Request) -> None:
+        asyncio.create_task(route.continue_())
+        intercepted.append(route.request)
+
     await page.route(
         "**/*",
-        lambda route: (
-            asyncio.create_task(route.continue_()),
-            intercepted.append(route.request),
-        ),
+        _handle,
     )
 
     server.set_redirect("/non-existing-page.html", "/non-existing-page-2.html")
@@ -301,6 +334,7 @@ async def test_page_route_should_not_work_with_redirects(page, server):
     server.set_redirect("/non-existing-page-4.html", "/empty.html")
 
     response = await page.goto(server.PREFIX + "/non-existing-page.html")
+    assert response
     assert response.status == 200
     assert "empty.html" in response.url
 
@@ -326,14 +360,18 @@ async def test_page_route_should_not_work_with_redirects(page, server):
         assert chain[idx].redirected_to == (chain[idx - 1] if idx > 0 else None)
 
 
-async def test_page_route_should_work_with_redirects_for_subresources(page, server):
-    intercepted = []
+async def test_page_route_should_work_with_redirects_for_subresources(
+    page: Page, server: Server
+) -> None:
+    intercepted: List[Request] = []
+
+    def _handle(route: Route) -> None:
+        asyncio.create_task(route.continue_())
+        intercepted.append(route.request)
+
     await page.route(
         "**/*",
-        lambda route: (
-            asyncio.create_task(route.continue_()),
-            intercepted.append(route.request),
-        ),
+        _handle,
     )
 
     server.set_redirect("/one-style.css", "/two-style.css")
@@ -345,6 +383,7 @@ async def test_page_route_should_work_with_redirects_for_subresources(page, serv
     )
 
     response = await page.goto(server.PREFIX + "/one-style.html")
+    assert response
     assert response.status == 200
     assert "one-style.html" in response.url
 
@@ -360,26 +399,29 @@ async def test_page_route_should_work_with_redirects_for_subresources(page, serv
         "/three-style.css",
         "/four-style.css",
     ]:
+        assert r
         assert r.resource_type == "stylesheet"
         assert url in r.url
         r = r.redirected_to
     assert r is None
 
 
-async def test_page_route_should_work_with_equal_requests(page, server):
+async def test_page_route_should_work_with_equal_requests(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     hits = [True]
 
-    def handle_request(request, hits):
+    def handle_request(request: HttpRequestWithPostBody, hits: List[bool]) -> None:
         request.write(str(len(hits) * 11).encode())
         request.finish()
         hits.append(True)
 
     server.set_route("/zzz", lambda r: handle_request(r, hits))
 
-    spinner = []
+    spinner: List[bool] = []
 
-    async def handle_route(route):
+    async def handle_route(route: Route) -> None:
         if len(spinner) == 1:
             await route.abort()
             spinner.pop(0)
@@ -401,15 +443,17 @@ async def handle_route(route):
 
 
 async def test_page_route_should_navigate_to_dataURL_and_not_fire_dataURL_requests(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     requests = []
+
+    def _handle(route: Route) -> None:
+        requests.append(route.request)
+        asyncio.create_task(route.continue_())
+
     await page.route(
         "**/*",
-        lambda route: (
-            requests.append(route.request),
-            asyncio.create_task(route.continue_()),
-        ),
+        _handle,
     )
 
     data_URL = "data:text/html,<div>yo</div>"
@@ -419,17 +463,16 @@ async def test_page_route_should_navigate_to_dataURL_and_not_fire_dataURL_reques
 
 
 async def test_page_route_should_be_able_to_fetch_dataURL_and_not_fire_dataURL_requests(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     requests = []
-    await page.route(
-        "**/*",
-        lambda route: (
-            requests.append(route.request),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
+
+    def _handle(route: Route) -> None:
+        requests.append(route.request)
+        asyncio.create_task(route.continue_())
+
+    await page.route("**/*", _handle)
 
     data_URL = "data:text/html,<div>yo</div>"
     text = await page.evaluate("url => fetch(url).then(r => r.text())", data_URL)
@@ -438,43 +481,50 @@ async def test_page_route_should_be_able_to_fetch_dataURL_and_not_fire_dataURL_r
 
 
 async def test_page_route_should_navigate_to_URL_with_hash_and_and_fire_requests_without_hash(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     requests = []
+
+    def _handle(route: Route) -> None:
+        requests.append(route.request)
+        asyncio.create_task(route.continue_())
+
     await page.route(
         "**/*",
-        lambda route: (
-            requests.append(route.request),
-            asyncio.create_task(route.continue_()),
-        ),
+        _handle,
     )
 
     response = await page.goto(server.EMPTY_PAGE + "#hash")
+    assert response
     assert response.status == 200
     assert response.url == server.EMPTY_PAGE
     assert len(requests) == 1
     assert requests[0].url == server.EMPTY_PAGE
 
 
-async def test_page_route_should_work_with_encoded_server(page, server):
+async def test_page_route_should_work_with_encoded_server(
+    page: Page, server: Server
+) -> None:
     # The requestWillBeSent will report encoded URL, whereas interception will
     # report URL as-is. @see crbug.com/759388
     await page.route("**/*", lambda route: route.continue_())
     response = await page.goto(server.PREFIX + "/some nonexisting page")
+    assert response
     assert response.status == 404
 
 
-async def test_page_route_should_work_with_encoded_server___2(page, server):
+async def test_page_route_should_work_with_encoded_server___2(
+    page: Page, server: Server
+) -> None:
     # The requestWillBeSent will report URL as-is, whereas interception will
     # report encoded URL for stylesheet. @see crbug.com/759388
-    requests = []
-    await page.route(
-        "**/*",
-        lambda route: (
-            asyncio.create_task(route.continue_()),
-            requests.append(route.request),
-        ),
-    )
+    requests: List[Request] = []
+
+    def _handle(route: Route) -> None:
+        asyncio.create_task(route.continue_())
+        requests.append(route.request)
+
+    await page.route("**/*", _handle)
 
     response = await page.goto(
         f"""data:text/html,<link rel="stylesheet" href="{server.PREFIX}/fonts?helvetica|arial"/>"""
@@ -482,14 +532,14 @@ async def test_page_route_should_work_with_encoded_server___2(page, server):
     assert response is None
     # TODO: https://github.com/microsoft/playwright/issues/12789
     assert len(requests) >= 1
-    assert (await requests[0].response()).status == 404
+    assert (must(await requests[0].response())).status == 404
 
 
 async def test_page_route_should_not_throw_Invalid_Interception_Id_if_the_request_was_cancelled(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.set_content("<iframe></iframe>")
-    route_future = asyncio.Future()
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
     await page.route("**/*", lambda r, _: route_future.set_result(r))
 
     async with page.expect_request("**/*"):
@@ -503,28 +553,31 @@ async def test_page_route_should_not_throw_Invalid_Interception_Id_if_the_reques
 
 
 async def test_page_route_should_intercept_main_resource_during_cross_process_navigation(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     intercepted = []
+
+    def _handle(route: Route) -> None:
+        intercepted.append(True)
+        asyncio.create_task(route.continue_())
+
     await page.route(
         server.CROSS_PROCESS_PREFIX + "/empty.html",
-        lambda route: (
-            intercepted.append(True),
-            asyncio.create_task(route.continue_()),
-        ),
+        _handle,
     )
 
     response = await page.goto(server.CROSS_PROCESS_PREFIX + "/empty.html")
+    assert response
     assert response.ok
     assert len(intercepted) == 1
 
 
 @pytest.mark.skip_browser("webkit")
-async def test_page_route_should_create_a_redirect(page, server):
+async def test_page_route_should_create_a_redirect(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/empty.html")
 
-    async def handle_route(route, request):
+    async def handle_route(route: Route, request: Request) -> None:
         if request.url != (server.PREFIX + "/redirect_this"):
             return await route.continue_()
         await route.fulfill(status=301, headers={"location": "/empty.html"})
@@ -544,10 +597,12 @@ async def handle_route(route, request):
     assert text == ""
 
 
-async def test_page_route_should_support_cors_with_GET(page, server, browser_name):
+async def test_page_route_should_support_cors_with_GET(
+    page: Page, server: Server, browser_name: str
+) -> None:
     await page.goto(server.EMPTY_PAGE)
 
-    async def handle_route(route, request):
+    async def handle_route(route: Route, request: Request) -> None:
         headers = {
             "access-control-allow-origin": "*"
             if request.url.endswith("allow")
@@ -590,7 +645,9 @@ async def handle_route(route, request):
         assert "NetworkError" in exc.value.message
 
 
-async def test_page_route_should_support_cors_with_POST(page, server):
+async def test_page_route_should_support_cors_with_POST(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.route(
         "**/cars",
@@ -617,7 +674,9 @@ async def test_page_route_should_support_cors_with_POST(page, server):
     assert resp == ["electric", "gas"]
 
 
-async def test_page_route_should_support_cors_for_different_methods(page, server):
+async def test_page_route_should_support_cors_for_different_methods(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.route(
         "**/cars",
@@ -659,7 +718,7 @@ async def test_page_route_should_support_cors_for_different_methods(page, server
     assert resp == ["DELETE", "electric", "gas"]
 
 
-async def test_request_fulfill_should_work_a(page, server):
+async def test_request_fulfill_should_work_a(page: Page, server: Server) -> None:
     await page.route(
         "**/*",
         lambda route: route.fulfill(
@@ -671,26 +730,33 @@ async def test_request_fulfill_should_work_a(page, server):
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 201
     assert response.headers["foo"] == "bar"
     assert await page.evaluate("() => document.body.textContent") == "Yo, page!"
 
 
-async def test_request_fulfill_should_work_with_status_code_422(page, server):
+async def test_request_fulfill_should_work_with_status_code_422(
+    page: Page, server: Server
+) -> None:
     await page.route(
         "**/*",
         lambda route: route.fulfill(status=422, body="Yo, page!"),
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 422
     assert response.status_text == "Unprocessable Entity"
     assert await page.evaluate("() => document.body.textContent") == "Yo, page!"
 
 
 async def test_request_fulfill_should_allow_mocking_binary_responses(
-    page: Page, server, assert_to_be_golden, assetdir
-):
+    page: Page,
+    server: Server,
+    assert_to_be_golden: Callable[[bytes, str], None],
+    assetdir: Path,
+) -> None:
     await page.route(
         "**/*",
         lambda route: route.fulfill(
@@ -714,8 +780,8 @@ async def test_request_fulfill_should_allow_mocking_binary_responses(
 
 
 async def test_request_fulfill_should_allow_mocking_svg_with_charset(
-    page, server, assert_to_be_golden
-):
+    page: Page, server: Server, assert_to_be_golden: Callable[[bytes, str], None]
+) -> None:
     await page.route(
         "**/*",
         lambda route: route.fulfill(
@@ -734,12 +800,16 @@ async def test_request_fulfill_should_allow_mocking_svg_with_charset(
         server.PREFIX,
     )
     img = await page.query_selector("img")
+    assert img
     assert_to_be_golden(await img.screenshot(), "mock-svg.png")
 
 
 async def test_request_fulfill_should_work_with_file_path(
-    page: Page, server, assert_to_be_golden, assetdir
-):
+    page: Page,
+    server: Server,
+    assert_to_be_golden: Callable[[bytes, str], None],
+    assetdir: Path,
+) -> None:
     await page.route(
         "**/*",
         lambda route: route.fulfill(
@@ -761,16 +831,17 @@ async def test_request_fulfill_should_work_with_file_path(
 
 
 async def test_request_fulfill_should_stringify_intercepted_request_response_headers(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.route(
         "**/*",
         lambda route: route.fulfill(
-            status=200, headers={"foo": True}, body="Yo, page!"
+            status=200, headers={"foo": True}, body="Yo, page!"  # type: ignore
         ),
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 200
     headers = response.headers
     assert headers["foo"] == "True"
@@ -778,23 +849,21 @@ async def test_request_fulfill_should_stringify_intercepted_request_response_hea
 
 
 async def test_request_fulfill_should_not_modify_the_headers_sent_to_the_server(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/empty.html")
     interceptedRequests = []
 
     # this is just to enable request interception, which disables caching in chromium
     await page.route(server.PREFIX + "/unused", lambda route, req: None)
 
-    server.set_route(
-        "/something",
-        lambda response: (
-            interceptedRequests.append(response),
-            response.setHeader("Access-Control-Allow-Origin", "*"),
-            response.write(b"done"),
-            response.finish(),
-        ),
-    )
+    def _handler1(response: HttpRequestWithPostBody) -> None:
+        interceptedRequests.append(response)
+        response.setHeader("Access-Control-Allow-Origin", "*")
+        response.write(b"done")
+        response.finish()
+
+    server.set_route("/something", _handler1)
 
     text = await page.evaluate(
         """async url => {
@@ -805,13 +874,15 @@ async def test_request_fulfill_should_not_modify_the_headers_sent_to_the_server(
     )
     assert text == "done"
 
-    playwrightRequest = asyncio.Future()
+    playwrightRequest: "asyncio.Future[Request]" = asyncio.Future()
+
+    def _handler2(route: Route, request: Request) -> None:
+        playwrightRequest.set_result(request)
+        asyncio.create_task(route.continue_(headers={**request.headers}))
+
     await page.route(
         server.CROSS_PROCESS_PREFIX + "/something",
-        lambda route, request: (
-            playwrightRequest.set_result(request),
-            asyncio.create_task(route.continue_(headers={**request.headers})),
-        ),
+        _handler2,
     )
 
     textAfterRoute = await page.evaluate(
@@ -829,22 +900,23 @@ async def test_request_fulfill_should_not_modify_the_headers_sent_to_the_server(
     )
 
 
-async def test_request_fulfill_should_include_the_origin_header(page, server):
+async def test_request_fulfill_should_include_the_origin_header(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/empty.html")
     interceptedRequest = []
-    await page.route(
-        server.CROSS_PROCESS_PREFIX + "/something",
-        lambda route, request: (
-            interceptedRequest.append(request),
-            asyncio.create_task(
-                route.fulfill(
-                    headers={"Access-Control-Allow-Origin": "*"},
-                    content_type="text/plain",
-                    body="done",
-                )
-            ),
-        ),
-    )
+
+    def _handle(route: Route, request: Request) -> None:
+        interceptedRequest.append(request)
+        asyncio.create_task(
+            route.fulfill(
+                headers={"Access-Control-Allow-Origin": "*"},
+                content_type="text/plain",
+                body="done",
+            )
+        )
+
+    await page.route(server.CROSS_PROCESS_PREFIX + "/something", _handle)
 
     text = await page.evaluate(
         """async url => {
@@ -858,10 +930,12 @@ async def test_request_fulfill_should_include_the_origin_header(page, server):
     assert interceptedRequest[0].headers["origin"] == server.PREFIX
 
 
-async def test_request_fulfill_should_work_with_request_interception(page, server):
+async def test_request_fulfill_should_work_with_request_interception(
+    page: Page, server: Server
+) -> None:
     requests = {}
 
-    async def _handle_route(route: Route):
+    async def _handle_route(route: Route) -> None:
         requests[route.request.url.split("/").pop()] = route.request
         await route.continue_()
 
@@ -876,8 +950,8 @@ async def _handle_route(route: Route):
 
 
 async def test_Interception_should_work_with_request_interception(
-    browser: Browser, https_server
-):
+    browser: Browser, https_server: Server
+) -> None:
     context = await browser.new_context(ignore_https_errors=True)
     page = await context.new_page()
 
@@ -889,8 +963,8 @@ async def test_Interception_should_work_with_request_interception(
 
 
 async def test_ignore_http_errors_service_worker_should_intercept_after_a_service_worker(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/serviceworkers/fetchdummy/sw.html")
     await page.evaluate("() => window.activationPromise")
 
@@ -898,7 +972,7 @@ async def test_ignore_http_errors_service_worker_should_intercept_after_a_servic
     sw_response = await page.evaluate('() => fetchDummy("foo")')
     assert sw_response == "responseFromServiceWorker:foo"
 
-    def _handle_route(route):
+    def _handle_route(route: Route) -> None:
         asyncio.ensure_future(
             route.fulfill(
                 status=200,
@@ -918,10 +992,12 @@ def _handle_route(route):
     assert non_intercepted_response == "FAILURE: Not Found"
 
 
-async def test_page_route_should_support_times_parameter(page: Page, server: Server):
+async def test_page_route_should_support_times_parameter(
+    page: Page, server: Server
+) -> None:
     intercepted = []
 
-    async def handle_request(route):
+    async def handle_request(route: Route) -> None:
         await route.continue_()
         intercepted.append(True)
 
@@ -935,10 +1011,10 @@ async def handle_request(route):
 
 async def test_context_route_should_support_times_parameter(
     context: BrowserContext, page: Page, server: Server
-):
+) -> None:
     intercepted = []
 
-    async def handle_request(route):
+    async def handle_request(route: Route) -> None:
         await route.continue_()
         intercepted.append(True)
 
diff --git a/tests/async/test_issues.py b/tests/async/test_issues.py
index 2ee4078b6..b6d17e2e3 100644
--- a/tests/async/test_issues.py
+++ b/tests/async/test_issues.py
@@ -13,14 +13,15 @@
 # limitations under the License.
 
 from asyncio import FIRST_COMPLETED, CancelledError, create_task, wait
+from typing import Dict
 
 import pytest
 
-from playwright.async_api import Page
+from playwright.async_api import Browser, BrowserType, Page, Playwright
 
 
 @pytest.mark.only_browser("chromium")
-async def test_issue_189(browser_type, launch_arguments):
+async def test_issue_189(browser_type: BrowserType, launch_arguments: Dict) -> None:
     browser = await browser_type.launch(
         **launch_arguments, ignore_default_args=["--mute-audio"]
     )
@@ -30,13 +31,13 @@ async def test_issue_189(browser_type, launch_arguments):
 
 
 @pytest.mark.only_browser("chromium")
-async def test_issue_195(playwright, browser):
+async def test_issue_195(playwright: Playwright, browser: Browser) -> None:
     iphone_11 = playwright.devices["iPhone 11"]
     context = await browser.new_context(**iphone_11)
     await context.close()
 
 
-async def test_connection_task_cancel(page: Page):
+async def test_connection_task_cancel(page: Page) -> None:
     await page.set_content("<input />")
     done, pending = await wait(
         {
diff --git a/tests/async/test_jshandle.py b/tests/async/test_jshandle.py
index 9f4c56c4e..f4136e92c 100644
--- a/tests/async/test_jshandle.py
+++ b/tests/async/test_jshandle.py
@@ -15,11 +15,12 @@
 import json
 import math
 from datetime import datetime
+from typing import Any, Dict
 
 from playwright.async_api import Page
 
 
-async def test_jshandle_evaluate_work(page: Page):
+async def test_jshandle_evaluate_work(page: Page) -> None:
     window_handle = await page.evaluate_handle("window")
     assert window_handle
     assert (
@@ -27,31 +28,31 @@ async def test_jshandle_evaluate_work(page: Page):
     )
 
 
-async def test_jshandle_evaluate_accept_object_handle_as_argument(page):
+async def test_jshandle_evaluate_accept_object_handle_as_argument(page: Page) -> None:
     navigator_handle = await page.evaluate_handle("navigator")
     text = await page.evaluate("e => e.userAgent", navigator_handle)
     assert "Mozilla" in text
 
 
-async def test_jshandle_evaluate_accept_handle_to_primitive_types(page):
+async def test_jshandle_evaluate_accept_handle_to_primitive_types(page: Page) -> None:
     handle = await page.evaluate_handle("5")
     is_five = await page.evaluate("e => Object.is(e, 5)", handle)
     assert is_five
 
 
-async def test_jshandle_evaluate_accept_nested_handle(page):
+async def test_jshandle_evaluate_accept_nested_handle(page: Page) -> None:
     foo = await page.evaluate_handle('({ x: 1, y: "foo" })')
     result = await page.evaluate("({ foo }) => foo", {"foo": foo})
     assert result == {"x": 1, "y": "foo"}
 
 
-async def test_jshandle_evaluate_accept_nested_window_handle(page):
+async def test_jshandle_evaluate_accept_nested_window_handle(page: Page) -> None:
     foo = await page.evaluate_handle("window")
     result = await page.evaluate("({ foo }) => foo === window", {"foo": foo})
     assert result
 
 
-async def test_jshandle_evaluate_accept_multiple_nested_handles(page):
+async def test_jshandle_evaluate_accept_multiple_nested_handles(page: Page) -> None:
     foo = await page.evaluate_handle('({ x: 1, y: "foo" })')
     bar = await page.evaluate_handle("5")
     baz = await page.evaluate_handle('["baz"]')
@@ -65,8 +66,8 @@ async def test_jshandle_evaluate_accept_multiple_nested_handles(page):
     }
 
 
-async def test_jshandle_evaluate_should_work_for_circular_objects(page):
-    a = {"x": 1}
+async def test_jshandle_evaluate_should_work_for_circular_objects(page: Page) -> None:
+    a: Dict[str, Any] = {"x": 1}
     a["y"] = a
     result = await page.evaluate("a => { a.y.x += 1; return a; }", a)
     assert result["x"] == 2
@@ -74,19 +75,23 @@ async def test_jshandle_evaluate_should_work_for_circular_objects(page):
     assert result == result["y"]
 
 
-async def test_jshandle_evaluate_accept_same_nested_object_multiple_times(page):
+async def test_jshandle_evaluate_accept_same_nested_object_multiple_times(
+    page: Page,
+) -> None:
     foo = {"x": 1}
     assert await page.evaluate(
         "x => x", {"foo": foo, "bar": [foo], "baz": {"foo": foo}}
     ) == {"foo": {"x": 1}, "bar": [{"x": 1}], "baz": {"foo": {"x": 1}}}
 
 
-async def test_jshandle_evaluate_accept_object_handle_to_unserializable_value(page):
+async def test_jshandle_evaluate_accept_object_handle_to_unserializable_value(
+    page: Page,
+) -> None:
     handle = await page.evaluate_handle("() => Infinity")
     assert await page.evaluate("e => Object.is(e, Infinity)", handle)
 
 
-async def test_jshandle_evaluate_pass_configurable_args(page):
+async def test_jshandle_evaluate_pass_configurable_args(page: Page) -> None:
     result = await page.evaluate(
         """arg => {
             if (arg.foo !== 42)
@@ -104,7 +109,7 @@ async def test_jshandle_evaluate_pass_configurable_args(page):
     assert result == {}
 
 
-async def test_jshandle_properties_get_property(page):
+async def test_jshandle_properties_get_property(page: Page) -> None:
     handle1 = await page.evaluate_handle(
         """() => ({
             one: 1,
@@ -116,7 +121,9 @@ async def test_jshandle_properties_get_property(page):
     assert await handle2.json_value() == 2
 
 
-async def test_jshandle_properties_work_with_undefined_null_and_empty(page):
+async def test_jshandle_properties_work_with_undefined_null_and_empty(
+    page: Page,
+) -> None:
     handle = await page.evaluate_handle(
         """() => ({
             undefined: undefined,
@@ -131,7 +138,7 @@ async def test_jshandle_properties_work_with_undefined_null_and_empty(page):
     assert await empty_handle.json_value() is None
 
 
-async def test_jshandle_properties_work_with_unserializable_values(page):
+async def test_jshandle_properties_work_with_unserializable_values(page: Page) -> None:
     handle = await page.evaluate_handle(
         """() => ({
             infinity: Infinity,
@@ -150,7 +157,7 @@ async def test_jshandle_properties_work_with_unserializable_values(page):
     assert await neg_zero_handle.json_value() == float("-0")
 
 
-async def test_jshandle_properties_get_properties(page):
+async def test_jshandle_properties_get_properties(page: Page) -> None:
     handle = await page.evaluate_handle('() => ({ foo: "bar" })')
     properties = await handle.get_properties()
     assert "foo" in properties
@@ -158,27 +165,27 @@ async def test_jshandle_properties_get_properties(page):
     assert await foo.json_value() == "bar"
 
 
-async def test_jshandle_properties_return_empty_map_for_non_objects(page):
+async def test_jshandle_properties_return_empty_map_for_non_objects(page: Page) -> None:
     handle = await page.evaluate_handle("123")
     properties = await handle.get_properties()
     assert properties == {}
 
 
-async def test_jshandle_json_value_work(page):
+async def test_jshandle_json_value_work(page: Page) -> None:
     handle = await page.evaluate_handle('() => ({foo: "bar"})')
     json = await handle.json_value()
     assert json == {"foo": "bar"}
 
 
-async def test_jshandle_json_value_work_with_dates(page):
+async def test_jshandle_json_value_work_with_dates(page: Page) -> None:
     handle = await page.evaluate_handle('() => new Date("2020-05-27T01:31:38.506Z")')
     json = await handle.json_value()
     assert json == datetime.fromisoformat("2020-05-27T01:31:38.506")
 
 
-async def test_jshandle_json_value_should_work_for_circular_object(page):
+async def test_jshandle_json_value_should_work_for_circular_object(page: Page) -> None:
     handle = await page.evaluate_handle("const a = {}; a.b = a; a")
-    a = {}
+    a: Dict[str, Any] = {}
     a["b"] = a
     result = await handle.json_value()
     # Node test looks like the below, but assert isn't smart enough to handle this:
@@ -186,26 +193,28 @@ async def test_jshandle_json_value_should_work_for_circular_object(page):
     assert result["b"] == result
 
 
-async def test_jshandle_as_element_work(page):
+async def test_jshandle_as_element_work(page: Page) -> None:
     handle = await page.evaluate_handle("document.body")
     element = handle.as_element()
     assert element is not None
 
 
-async def test_jshandle_as_element_return_none_for_non_elements(page):
+async def test_jshandle_as_element_return_none_for_non_elements(page: Page) -> None:
     handle = await page.evaluate_handle("2")
     element = handle.as_element()
     assert element is None
 
 
-async def test_jshandle_to_string_work_for_primitives(page):
+async def test_jshandle_to_string_work_for_primitives(page: Page) -> None:
     number_handle = await page.evaluate_handle("2")
     assert str(number_handle) == "2"
     string_handle = await page.evaluate_handle('"a"')
     assert str(string_handle) == "a"
 
 
-async def test_jshandle_to_string_work_for_complicated_objects(page, browser_name):
+async def test_jshandle_to_string_work_for_complicated_objects(
+    page: Page, browser_name: str
+) -> None:
     handle = await page.evaluate_handle("window")
     if browser_name != "firefox":
         assert str(handle) == "Window"
@@ -213,7 +222,7 @@ async def test_jshandle_to_string_work_for_complicated_objects(page, browser_nam
         assert str(handle) == "JSHandle@object"
 
 
-async def test_jshandle_to_string_work_for_promises(page):
+async def test_jshandle_to_string_work_for_promises(page: Page) -> None:
     handle = await page.evaluate_handle("({b: Promise.resolve(123)})")
     b_handle = await handle.get_property("b")
     assert str(b_handle) == "Promise"
diff --git a/tests/async/test_keyboard.py b/tests/async/test_keyboard.py
index 761fe977c..8e8a162c9 100644
--- a/tests/async/test_keyboard.py
+++ b/tests/async/test_keyboard.py
@@ -13,10 +13,13 @@
 # limitations under the License.
 import pytest
 
-from playwright.async_api import Error, Page
+from playwright.async_api import Error, JSHandle, Page
+from tests.server import Server
 
+from .utils import Utils
 
-async def captureLastKeydown(page):
+
+async def captureLastKeydown(page: Page) -> JSHandle:
     lastEvent = await page.evaluate_handle(
         """() => {
         const lastEvent = {
@@ -42,7 +45,7 @@ async def captureLastKeydown(page):
     return lastEvent
 
 
-async def test_keyboard_type_into_a_textarea(page):
+async def test_keyboard_type_into_a_textarea(page: Page) -> None:
     await page.evaluate(
         """
             const textarea = document.createElement('textarea');
@@ -55,7 +58,7 @@ async def test_keyboard_type_into_a_textarea(page):
     assert await page.evaluate('document.querySelector("textarea").value') == text
 
 
-async def test_keyboard_move_with_the_arrow_keys(page, server):
+async def test_keyboard_move_with_the_arrow_keys(page: Page, server: Server) -> None:
     await page.goto(f"{server.PREFIX}/input/textarea.html")
     await page.type("textarea", "Hello World!")
     assert (
@@ -80,9 +83,12 @@ async def test_keyboard_move_with_the_arrow_keys(page, server):
     )
 
 
-async def test_keyboard_send_a_character_with_elementhandle_press(page, server):
+async def test_keyboard_send_a_character_with_elementhandle_press(
+    page: Page, server: Server
+) -> None:
     await page.goto(f"{server.PREFIX}/input/textarea.html")
     textarea = await page.query_selector("textarea")
+    assert textarea
     await textarea.press("a")
     assert await page.evaluate("document.querySelector('textarea').value") == "a"
     await page.evaluate(
@@ -92,7 +98,9 @@ async def test_keyboard_send_a_character_with_elementhandle_press(page, server):
     assert await page.evaluate("document.querySelector('textarea').value") == "a"
 
 
-async def test_should_send_a_character_with_send_character(page, server):
+async def test_should_send_a_character_with_send_character(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.focus("textarea")
     await page.keyboard.insert_text("嗨")
@@ -104,10 +112,9 @@ async def test_should_send_a_character_with_send_character(page, server):
     assert await page.evaluate('() => document.querySelector("textarea").value') == "嗨a"
 
 
-async def test_should_only_emit_input_event(page, server):
+async def test_should_only_emit_input_event(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.focus("textarea")
-    page.on("console", "m => console.log(m.text())")
     events = await page.evaluate_handle(
         """() => {
     const events = [];
@@ -123,7 +130,9 @@ async def test_should_only_emit_input_event(page, server):
     assert await events.json_value() == ["input"]
 
 
-async def test_should_report_shiftkey(page: Page, server, is_mac, is_firefox):
+async def test_should_report_shiftkey(
+    page: Page, server: Server, is_mac: bool, is_firefox: bool
+) -> None:
     if is_firefox and is_mac:
         pytest.skip()
     await page.goto(server.PREFIX + "/input/keyboard.html")
@@ -178,7 +187,7 @@ async def test_should_report_shiftkey(page: Page, server, is_mac, is_firefox):
         )
 
 
-async def test_should_report_multiple_modifiers(page: Page, server):
+async def test_should_report_multiple_modifiers(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/keyboard.html")
     keyboard = page.keyboard
     await keyboard.down("Control")
@@ -210,7 +219,9 @@ async def test_should_report_multiple_modifiers(page: Page, server):
     assert await page.evaluate("() => getResult()") == "Keyup: Alt AltLeft 18 []"
 
 
-async def test_should_send_proper_codes_while_typing(page: Page, server):
+async def test_should_send_proper_codes_while_typing(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/keyboard.html")
     await page.keyboard.type("!")
     assert await page.evaluate("() => getResult()") == "\n".join(
@@ -230,7 +241,9 @@ async def test_should_send_proper_codes_while_typing(page: Page, server):
     )
 
 
-async def test_should_send_proper_codes_while_typing_with_shift(page: Page, server):
+async def test_should_send_proper_codes_while_typing_with_shift(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/keyboard.html")
     keyboard = page.keyboard
     await keyboard.down("Shift")
@@ -246,7 +259,7 @@ async def test_should_send_proper_codes_while_typing_with_shift(page: Page, serv
     await keyboard.up("Shift")
 
 
-async def test_should_not_type_canceled_events(page: Page, server):
+async def test_should_not_type_canceled_events(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.focus("textarea")
     await page.evaluate(
@@ -269,7 +282,7 @@ async def test_should_not_type_canceled_events(page: Page, server):
     )
 
 
-async def test_should_press_plus(page: Page, server):
+async def test_should_press_plus(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/keyboard.html")
     await page.keyboard.press("+")
     assert await page.evaluate("() => getResult()") == "\n".join(
@@ -281,7 +294,7 @@ async def test_should_press_plus(page: Page, server):
     )
 
 
-async def test_should_press_shift_plus(page: Page, server):
+async def test_should_press_shift_plus(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/keyboard.html")
     await page.keyboard.press("Shift++")
     assert await page.evaluate("() => getResult()") == "\n".join(
@@ -295,7 +308,9 @@ async def test_should_press_shift_plus(page: Page, server):
     )
 
 
-async def test_should_support_plus_separated_modifiers(page: Page, server):
+async def test_should_support_plus_separated_modifiers(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/keyboard.html")
     await page.keyboard.press("Shift+~")
     assert await page.evaluate("() => getResult()") == "\n".join(
@@ -309,7 +324,9 @@ async def test_should_support_plus_separated_modifiers(page: Page, server):
     )
 
 
-async def test_should_suport_multiple_plus_separated_modifiers(page: Page, server):
+async def test_should_suport_multiple_plus_separated_modifiers(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/keyboard.html")
     await page.keyboard.press("Control+Shift+~")
     assert await page.evaluate("() => getResult()") == "\n".join(
@@ -324,7 +341,7 @@ async def test_should_suport_multiple_plus_separated_modifiers(page: Page, serve
     )
 
 
-async def test_should_shift_raw_codes(page: Page, server):
+async def test_should_shift_raw_codes(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/keyboard.html")
     await page.keyboard.press("Shift+Digit3")
     assert await page.evaluate("() => getResult()") == "\n".join(
@@ -338,7 +355,7 @@ async def test_should_shift_raw_codes(page: Page, server):
     )
 
 
-async def test_should_specify_repeat_property(page: Page, server):
+async def test_should_specify_repeat_property(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.focus("textarea")
     lastEvent = await captureLastKeydown(page)
@@ -357,7 +374,7 @@ async def test_should_specify_repeat_property(page: Page, server):
     assert await lastEvent.evaluate("e => e.repeat") is False
 
 
-async def test_should_type_all_kinds_of_characters(page: Page, server):
+async def test_should_type_all_kinds_of_characters(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.focus("textarea")
     text = "This text goes onto two lines.\nThis character is 嗨."
@@ -365,7 +382,7 @@ async def test_should_type_all_kinds_of_characters(page: Page, server):
     assert await page.eval_on_selector("textarea", "t => t.value") == text
 
 
-async def test_should_specify_location(page: Page, server):
+async def test_should_specify_location(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     lastEvent = await captureLastKeydown(page)
     textarea = await page.query_selector("textarea")
@@ -384,12 +401,12 @@ async def test_should_specify_location(page: Page, server):
     assert await lastEvent.evaluate("e => e.location") == 3
 
 
-async def test_should_press_enter(page: Page, server):
+async def test_should_press_enter(page: Page) -> None:
     await page.set_content("<textarea></textarea>")
     await page.focus("textarea")
     lastEventHandle = await captureLastKeydown(page)
 
-    async def testEnterKey(key, expectedKey, expectedCode):
+    async def testEnterKey(key: str, expectedKey: str, expectedCode: str) -> None:
         await page.keyboard.press(key)
         lastEvent = await lastEventHandle.json_value()
         assert lastEvent["key"] == expectedKey
@@ -404,7 +421,7 @@ async def testEnterKey(key, expectedKey, expectedCode):
     await testEnterKey("\r", "Enter", "Enter")
 
 
-async def test_should_throw_unknown_keys(page: Page, server):
+async def test_should_throw_unknown_keys(page: Page, server: Server) -> None:
     with pytest.raises(Error) as exc:
         await page.keyboard.press("NotARealKey")
     assert exc.value.message == 'Unknown key: "NotARealKey"'
@@ -418,7 +435,7 @@ async def test_should_throw_unknown_keys(page: Page, server):
     assert exc.value.message == 'Unknown key: "😊"'
 
 
-async def test_should_type_emoji(page: Page, server):
+async def test_should_type_emoji(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.type("textarea", "👹 Tokyo street Japan 🇯🇵")
     assert (
@@ -427,7 +444,9 @@ async def test_should_type_emoji(page: Page, server):
     )
 
 
-async def test_should_type_emoji_into_an_iframe(page: Page, server, utils):
+async def test_should_type_emoji_into_an_iframe(
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await utils.attach_frame(page, "emoji-test", server.PREFIX + "/input/textarea.html")
     frame = page.frames[1]
@@ -440,7 +459,9 @@ async def test_should_type_emoji_into_an_iframe(page: Page, server, utils):
     )
 
 
-async def test_should_handle_select_all(page: Page, server, is_mac):
+async def test_should_handle_select_all(
+    page: Page, server: Server, is_mac: bool
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
     assert textarea
@@ -453,9 +474,12 @@ async def test_should_handle_select_all(page: Page, server, is_mac):
     assert await page.eval_on_selector("textarea", "textarea => textarea.value") == ""
 
 
-async def test_should_be_able_to_prevent_select_all(page, server, is_mac):
+async def test_should_be_able_to_prevent_select_all(
+    page: Page, server: Server, is_mac: bool
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
+    assert textarea
     await textarea.type("some text")
     await page.eval_on_selector(
         "textarea",
@@ -480,9 +504,12 @@ async def test_should_be_able_to_prevent_select_all(page, server, is_mac):
 
 @pytest.mark.only_platform("darwin")
 @pytest.mark.skip_browser("firefox")  # Upstream issue
-async def test_should_support_macos_shortcuts(page, server, is_firefox, is_mac):
+async def test_should_support_macos_shortcuts(
+    page: Page, server: Server, is_firefox: bool, is_mac: bool
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
+    assert textarea
     await textarea.type("some text")
     # select one word backwards
     await page.keyboard.press("Shift+Control+Alt+KeyB")
@@ -492,7 +519,9 @@ async def test_should_support_macos_shortcuts(page, server, is_firefox, is_mac):
     )
 
 
-async def test_should_press_the_meta_key(page, server, is_firefox, is_mac):
+async def test_should_press_the_meta_key(
+    page: Page, server: Server, is_firefox: bool, is_mac: bool
+) -> None:
     lastEvent = await captureLastKeydown(page)
     await page.keyboard.press("Meta")
     v = await lastEvent.json_value()
@@ -513,7 +542,9 @@ async def test_should_press_the_meta_key(page, server, is_firefox, is_mac):
         assert metaKey
 
 
-async def test_should_work_after_a_cross_origin_navigation(page, server):
+async def test_should_work_after_a_cross_origin_navigation(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/empty.html")
     await page.goto(server.CROSS_PROCESS_PREFIX + "/empty.html")
     lastEvent = await captureLastKeydown(page)
@@ -523,7 +554,9 @@ async def test_should_work_after_a_cross_origin_navigation(page, server):
 
 # event.keyIdentifier has been removed from all browsers except WebKit
 @pytest.mark.only_browser("webkit")
-async def test_should_expose_keyIdentifier_in_webkit(page, server):
+async def test_should_expose_keyIdentifier_in_webkit(
+    page: Page, server: Server
+) -> None:
     lastEvent = await captureLastKeydown(page)
     keyMap = {
         "ArrowUp": "Up",
@@ -542,7 +575,7 @@ async def test_should_expose_keyIdentifier_in_webkit(page, server):
         assert await lastEvent.evaluate("e => e.keyIdentifier") == keyIdentifier
 
 
-async def test_should_scroll_with_pagedown(page: Page, server):
+async def test_should_scroll_with_pagedown(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/scrollable.html")
     # A click is required for WebKit to send the event into the body.
     await page.click("body")
diff --git a/tests/async/test_launcher.py b/tests/async/test_launcher.py
index a1f3f1480..95734cb35 100644
--- a/tests/async/test_launcher.py
+++ b/tests/async/test_launcher.py
@@ -14,6 +14,8 @@
 
 import asyncio
 import os
+from pathlib import Path
+from typing import Dict, Optional
 
 import pytest
 
@@ -22,8 +24,8 @@
 
 
 async def test_browser_type_launch_should_reject_all_promises_when_browser_is_closed(
-    browser_type: BrowserType, launch_arguments
-):
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
     browser = await browser_type.launch(**launch_arguments)
     page = await (await browser.new_context()).new_page()
     never_resolves = asyncio.create_task(page.evaluate("() => new Promise(r => {})"))
@@ -35,16 +37,16 @@ async def test_browser_type_launch_should_reject_all_promises_when_browser_is_cl
 
 @pytest.mark.skip_browser("firefox")
 async def test_browser_type_launch_should_throw_if_page_argument_is_passed(
-    browser_type, launch_arguments
-):
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
     with pytest.raises(Error) as exc:
         await browser_type.launch(**launch_arguments, args=["http://example.com"])
     assert "can not specify page" in exc.value.message
 
 
 async def test_browser_type_launch_should_reject_if_launched_browser_fails_immediately(
-    browser_type, launch_arguments, assetdir
-):
+    browser_type: BrowserType, launch_arguments: Dict, assetdir: Path
+) -> None:
     with pytest.raises(Error):
         await browser_type.launch(
             **launch_arguments,
@@ -53,8 +55,8 @@ async def test_browser_type_launch_should_reject_if_launched_browser_fails_immed
 
 
 async def test_browser_type_launch_should_reject_if_executable_path_is_invalid(
-    browser_type, launch_arguments
-):
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
     with pytest.raises(Error) as exc:
         await browser_type.launch(
             **launch_arguments, executable_path="random-invalid-path"
@@ -62,7 +64,9 @@ async def test_browser_type_launch_should_reject_if_executable_path_is_invalid(
     assert "executable doesn't exist" in exc.value.message
 
 
-async def test_browser_type_executable_path_should_work(browser_type, browser_channel):
+async def test_browser_type_executable_path_should_work(
+    browser_type: BrowserType, browser_channel: str
+) -> None:
     if browser_channel:
         return
     executable_path = browser_type.executable_path
@@ -71,8 +75,8 @@ async def test_browser_type_executable_path_should_work(browser_type, browser_ch
 
 
 async def test_browser_type_name_should_work(
-    browser_type, is_webkit, is_firefox, is_chromium
-):
+    browser_type: BrowserType, is_webkit: bool, is_firefox: bool, is_chromium: bool
+) -> None:
     if is_webkit:
         assert browser_type.name == "webkit"
     elif is_firefox:
@@ -84,17 +88,19 @@ async def test_browser_type_name_should_work(
 
 
 async def test_browser_close_should_fire_close_event_for_all_contexts(
-    browser_type, launch_arguments
-):
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
     browser = await browser_type.launch(**launch_arguments)
     context = await browser.new_context()
     closed = []
-    context.on("close", lambda: closed.append(True))
+    context.on("close", lambda _: closed.append(True))
     await browser.close()
     assert closed == [True]
 
 
-async def test_browser_close_should_be_callable_twice(browser_type, launch_arguments):
+async def test_browser_close_should_be_callable_twice(
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
     browser = await browser_type.launch(**launch_arguments)
     await asyncio.gather(
         browser.close(),
@@ -106,11 +112,11 @@ async def test_browser_close_should_be_callable_twice(browser_type, launch_argum
 @pytest.mark.only_browser("chromium")
 async def test_browser_launch_should_return_background_pages(
     browser_type: BrowserType,
-    tmpdir,
-    browser_channel,
-    assetdir,
-    launch_arguments,
-):
+    tmpdir: Path,
+    browser_channel: Optional[str],
+    assetdir: Path,
+    launch_arguments: Dict,
+) -> None:
     if browser_channel:
         pytest.skip()
 
diff --git a/tests/async/test_listeners.py b/tests/async/test_listeners.py
index 9903beb8e..5185fd487 100644
--- a/tests/async/test_listeners.py
+++ b/tests/async/test_listeners.py
@@ -12,11 +12,14 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from playwright.async_api import Page, Response
+from tests.server import Server
 
-async def test_listeners(page, server):
+
+async def test_listeners(page: Page, server: Server) -> None:
     log = []
 
-    def print_response(response):
+    def print_response(response: Response) -> None:
         log.append(response)
 
     page.on("response", print_response)
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 50dc91cfb..1a423fd2a 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -14,6 +14,7 @@
 
 import os
 import re
+from typing import Callable
 from urllib.parse import urlparse
 
 import pytest
@@ -26,14 +27,16 @@
 FILE_TO_UPLOAD = _dirname / ".." / "assets/file-to-upload.txt"
 
 
-async def test_locators_click_should_work(page: Page, server: Server):
+async def test_locators_click_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = page.locator("button")
     await button.click()
     assert await page.evaluate("window['result']") == "Clicked"
 
 
-async def test_locators_click_should_work_with_node_removed(page: Page, server: Server):
+async def test_locators_click_should_work_with_node_removed(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.evaluate("delete window['Node']")
     button = page.locator("button")
@@ -41,7 +44,9 @@ async def test_locators_click_should_work_with_node_removed(page: Page, server:
     assert await page.evaluate("window['result']") == "Clicked"
 
 
-async def test_locators_click_should_work_for_text_nodes(page: Page, server: Server):
+async def test_locators_click_should_work_for_text_nodes(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.evaluate(
         """() => {
@@ -58,7 +63,7 @@ async def test_locators_click_should_work_for_text_nodes(page: Page, server: Ser
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_locators_should_have_repr(page: Page, server: Server):
+async def test_locators_should_have_repr(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = page.locator("button")
     await button.click()
@@ -68,39 +73,39 @@ async def test_locators_should_have_repr(page: Page, server: Server):
     )
 
 
-async def test_locators_get_attribute_should_work(page: Page, server: Server):
+async def test_locators_get_attribute_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/dom.html")
     button = page.locator("#outer")
     assert await button.get_attribute("name") == "value"
     assert await button.get_attribute("foo") is None
 
 
-async def test_locators_input_value_should_work(page: Page, server: Server):
+async def test_locators_input_value_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/dom.html")
     await page.fill("#textarea", "input value")
     text_area = page.locator("#textarea")
     assert await text_area.input_value() == "input value"
 
 
-async def test_locators_inner_html_should_work(page: Page, server: Server):
+async def test_locators_inner_html_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/dom.html")
     locator = page.locator("#outer")
     assert await locator.inner_html() == '<div id="inner">Text,\nmore text</div>'
 
 
-async def test_locators_inner_text_should_work(page: Page, server: Server):
+async def test_locators_inner_text_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/dom.html")
     locator = page.locator("#inner")
     assert await locator.inner_text() == "Text, more text"
 
 
-async def test_locators_text_content_should_work(page: Page, server: Server):
+async def test_locators_text_content_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/dom.html")
     locator = page.locator("#inner")
     assert await locator.text_content() == "Text,\nmore text"
 
 
-async def test_locators_is_hidden_and_is_visible_should_work(page: Page):
+async def test_locators_is_hidden_and_is_visible_should_work(page: Page) -> None:
     await page.set_content("<div>Hi</div><span></span>")
 
     div = page.locator("div")
@@ -112,7 +117,7 @@ async def test_locators_is_hidden_and_is_visible_should_work(page: Page):
     assert await span.is_hidden() is True
 
 
-async def test_locators_is_enabled_and_is_disabled_should_work(page: Page):
+async def test_locators_is_enabled_and_is_disabled_should_work(page: Page) -> None:
     await page.set_content(
         """
         <button disabled>button1</button>
@@ -134,7 +139,7 @@ async def test_locators_is_enabled_and_is_disabled_should_work(page: Page):
     assert await button1.is_disabled() is False
 
 
-async def test_locators_is_editable_should_work(page: Page):
+async def test_locators_is_editable_should_work(page: Page) -> None:
     await page.set_content(
         """
         <input id=input1 disabled><textarea></textarea><input id=input2>
@@ -148,7 +153,7 @@ async def test_locators_is_editable_should_work(page: Page):
     assert await input2.is_editable() is True
 
 
-async def test_locators_is_checked_should_work(page: Page):
+async def test_locators_is_checked_should_work(page: Page) -> None:
     await page.set_content(
         """
         <input type='checkbox' checked><div>Not a checkbox</div>
@@ -161,7 +166,7 @@ async def test_locators_is_checked_should_work(page: Page):
     assert await element.is_checked() is False
 
 
-async def test_locators_all_text_contents_should_work(page: Page):
+async def test_locators_all_text_contents_should_work(page: Page) -> None:
     await page.set_content(
         """
         <div>A</div><div>B</div><div>C</div>
@@ -172,7 +177,7 @@ async def test_locators_all_text_contents_should_work(page: Page):
     assert await element.all_text_contents() == ["A", "B", "C"]
 
 
-async def test_locators_all_inner_texts(page: Page):
+async def test_locators_all_inner_texts(page: Page) -> None:
     await page.set_content(
         """
         <div>A</div><div>B</div><div>C</div>
@@ -183,7 +188,9 @@ async def test_locators_all_inner_texts(page: Page):
     assert await element.all_inner_texts() == ["A", "B", "C"]
 
 
-async def test_locators_should_query_existing_element(page: Page, server: Server):
+async def test_locators_should_query_existing_element(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/playground.html")
     await page.set_content(
         """<html><body><div class="second"><div class="inner">A</div></div></body></html>"""
@@ -196,7 +203,7 @@ async def test_locators_should_query_existing_element(page: Page, server: Server
     )
 
 
-async def test_locators_evaluate_handle_should_work(page: Page, server: Server):
+async def test_locators_evaluate_handle_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/dom.html")
     outer = page.locator("#outer")
     inner = outer.locator("#inner")
@@ -218,7 +225,7 @@ async def test_locators_evaluate_handle_should_work(page: Page, server: Server):
     )
 
 
-async def test_locators_should_query_existing_elements(page: Page):
+async def test_locators_should_query_existing_elements(page: Page) -> None:
     await page.set_content(
         """<html><body><div>A</div><br/><div>B</div></body></html>"""
     )
@@ -231,7 +238,9 @@ async def test_locators_should_query_existing_elements(page: Page):
     assert result == ["A", "B"]
 
 
-async def test_locators_return_empty_array_for_non_existing_elements(page: Page):
+async def test_locators_return_empty_array_for_non_existing_elements(
+    page: Page,
+) -> None:
     await page.set_content(
         """<html><body><div>A</div><br/><div>B</div></body></html>"""
     )
@@ -241,7 +250,7 @@ async def test_locators_return_empty_array_for_non_existing_elements(page: Page)
     assert elements == []
 
 
-async def test_locators_evaluate_all_should_work(page: Page):
+async def test_locators_evaluate_all_should_work(page: Page) -> None:
     await page.set_content(
         """<html><body><div class="tweet"><div class="like">100</div><div class="like">10</div></div></body></html>"""
     )
@@ -250,7 +259,9 @@ async def test_locators_evaluate_all_should_work(page: Page):
     assert content == ["100", "10"]
 
 
-async def test_locators_evaluate_all_should_work_with_missing_selector(page: Page):
+async def test_locators_evaluate_all_should_work_with_missing_selector(
+    page: Page,
+) -> None:
     await page.set_content(
         """<div class="a">not-a-child-div</div><div id="myId"></div"""
     )
@@ -259,7 +270,7 @@ async def test_locators_evaluate_all_should_work_with_missing_selector(page: Pag
     assert nodes_length == 0
 
 
-async def test_locators_hover_should_work(page: Page, server: Server):
+async def test_locators_hover_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/scrollable.html")
     button = page.locator("#button-6")
     await button.hover()
@@ -268,7 +279,7 @@ async def test_locators_hover_should_work(page: Page, server: Server):
     )
 
 
-async def test_locators_fill_should_work(page: Page, server: Server):
+async def test_locators_fill_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     button = page.locator("input")
     await button.fill("some value")
@@ -284,21 +295,21 @@ async def test_locators_clear_should_work(page: Page, server: Server) -> None:
     assert await page.evaluate("result") == ""
 
 
-async def test_locators_check_should_work(page: Page):
+async def test_locators_check_should_work(page: Page) -> None:
     await page.set_content("<input id='checkbox' type='checkbox'></input>")
     button = page.locator("input")
     await button.check()
     assert await page.evaluate("checkbox.checked") is True
 
 
-async def test_locators_uncheck_should_work(page: Page):
+async def test_locators_uncheck_should_work(page: Page) -> None:
     await page.set_content("<input id='checkbox' type='checkbox' checked></input>")
     button = page.locator("input")
     await button.uncheck()
     assert await page.evaluate("checkbox.checked") is False
 
 
-async def test_locators_select_option_should_work(page: Page, server: Server):
+async def test_locators_select_option_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     select = page.locator("select")
     await select.select_option("blue")
@@ -306,7 +317,7 @@ async def test_locators_select_option_should_work(page: Page, server: Server):
     assert await page.evaluate("result.onChange") == ["blue"]
 
 
-async def test_locators_focus_should_work(page: Page, server: Server):
+async def test_locators_focus_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = page.locator("button")
     assert await button.evaluate("button => document.activeElement === button") is False
@@ -314,14 +325,14 @@ async def test_locators_focus_should_work(page: Page, server: Server):
     assert await button.evaluate("button => document.activeElement === button") is True
 
 
-async def test_locators_dispatch_event_should_work(page: Page, server: Server):
+async def test_locators_dispatch_event_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     button = page.locator("button")
     await button.dispatch_event("click")
     assert await page.evaluate("result") == "Clicked"
 
 
-async def test_locators_should_upload_a_file(page: Page, server: Server):
+async def test_locators_should_upload_a_file(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/fileupload.html")
     input = page.locator("input[type=file]")
 
@@ -333,13 +344,13 @@ async def test_locators_should_upload_a_file(page: Page, server: Server):
     )
 
 
-async def test_locators_should_press(page: Page):
+async def test_locators_should_press(page: Page) -> None:
     await page.set_content("<input type='text' />")
     await page.locator("input").press("h")
     assert await page.eval_on_selector("input", "input => input.value") == "h"
 
 
-async def test_locators_should_scroll_into_view(page: Page, server: Server):
+async def test_locators_should_scroll_into_view(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/offscreenbuttons.html")
     for i in range(11):
         button = page.locator(f"#btn{i}")
@@ -357,7 +368,7 @@ async def test_locators_should_scroll_into_view(page: Page, server: Server):
 
 async def test_locators_should_select_textarea(
     page: Page, server: Server, browser_name: str
-):
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = page.locator("textarea")
     await textarea.evaluate("textarea => textarea.value = 'some value'")
@@ -369,21 +380,21 @@ async def test_locators_should_select_textarea(
         assert await page.evaluate("window.getSelection().toString()") == "some value"
 
 
-async def test_locators_should_type(page: Page):
+async def test_locators_should_type(page: Page) -> None:
     await page.set_content("<input type='text' />")
     await page.locator("input").type("hello")
     assert await page.eval_on_selector("input", "input => input.value") == "hello"
 
 
-async def test_locators_should_press_sequentially(page: Page):
+async def test_locators_should_press_sequentially(page: Page) -> None:
     await page.set_content("<input type='text' />")
     await page.locator("input").press_sequentially("hello")
     assert await page.eval_on_selector("input", "input => input.value") == "hello"
 
 
 async def test_locators_should_screenshot(
-    page: Page, server: Server, assert_to_be_golden
-):
+    page: Page, server: Server, assert_to_be_golden: Callable[[bytes, str], None]
+) -> None:
     await page.set_viewport_size(
         {
             "width": 500,
@@ -398,7 +409,7 @@ async def test_locators_should_screenshot(
     )
 
 
-async def test_locators_should_return_bounding_box(page: Page, server: Server):
+async def test_locators_should_return_bounding_box(page: Page, server: Server) -> None:
     await page.set_viewport_size(
         {
             "width": 500,
@@ -416,7 +427,7 @@ async def test_locators_should_return_bounding_box(page: Page, server: Server):
     }
 
 
-async def test_locators_should_respect_first_and_last(page: Page):
+async def test_locators_should_respect_first_and_last(page: Page) -> None:
     await page.set_content(
         """
         <section>
@@ -431,7 +442,7 @@ async def test_locators_should_respect_first_and_last(page: Page):
     assert await page.locator("div").last.locator("p").count() == 3
 
 
-async def test_locators_should_respect_nth(page: Page):
+async def test_locators_should_respect_nth(page: Page) -> None:
     await page.set_content(
         """
     <section>
@@ -445,7 +456,7 @@ async def test_locators_should_respect_nth(page: Page):
     assert await page.locator("div").nth(2).locator("p").count() == 3
 
 
-async def test_locators_should_throw_on_capture_without_nth(page: Page):
+async def test_locators_should_throw_on_capture_without_nth(page: Page) -> None:
     await page.set_content(
         """
         <section><div><p>A</p></div></section>
@@ -455,7 +466,7 @@ async def test_locators_should_throw_on_capture_without_nth(page: Page):
         await page.locator("*css=div >> p").nth(1).click()
 
 
-async def test_locators_should_throw_due_to_strictness(page: Page):
+async def test_locators_should_throw_due_to_strictness(page: Page) -> None:
     await page.set_content(
         """
         <div>A</div><div>B</div>
@@ -465,7 +476,7 @@ async def test_locators_should_throw_due_to_strictness(page: Page):
         await page.locator("div").is_visible()
 
 
-async def test_locators_should_throw_due_to_strictness_2(page: Page):
+async def test_locators_should_throw_due_to_strictness_2(page: Page) -> None:
     await page.set_content(
         """
         <select><option>One</option><option>Two</option></select>
@@ -475,7 +486,7 @@ async def test_locators_should_throw_due_to_strictness_2(page: Page):
         await page.locator("option").evaluate("e => {}")
 
 
-async def test_locators_set_checked(page: Page):
+async def test_locators_set_checked(page: Page) -> None:
     await page.set_content("`<input id='checkbox' type='checkbox'></input>`")
     locator = page.locator("input")
     await locator.set_checked(True)
@@ -493,7 +504,7 @@ async def test_locators_wait_for(page: Page) -> None:
     assert await locator.text_content() == "target"
 
 
-async def test_should_wait_for_hidden(page):
+async def test_should_wait_for_hidden(page: Page) -> None:
     await page.set_content("<div><span>target</span></div>")
     locator = page.locator("span")
     task = locator.wait_for(state="hidden")
@@ -501,7 +512,7 @@ async def test_should_wait_for_hidden(page):
     await task
 
 
-async def test_should_combine_visible_with_other_selectors(page):
+async def test_should_combine_visible_with_other_selectors(page: Page) -> None:
     await page.set_content(
         """<div>
         <div class="item" style="display: none">Hidden data0</div>
@@ -520,13 +531,17 @@ async def test_should_combine_visible_with_other_selectors(page):
     )
 
 
-async def test_locator_count_should_work_with_deleted_map_in_main_world(page):
+async def test_locator_count_should_work_with_deleted_map_in_main_world(
+    page: Page,
+) -> None:
     await page.evaluate("Map = 1")
     await page.locator("#searchResultTableDiv .x-grid3-row").count()
     await expect(page.locator("#searchResultTableDiv .x-grid3-row")).to_have_count(0)
 
 
-async def test_locator_locator_and_framelocator_locator_should_accept_locator(page):
+async def test_locator_locator_and_framelocator_locator_should_accept_locator(
+    page: Page,
+) -> None:
     await page.set_content(
         """
         <div><input value=outer></div>
@@ -681,7 +696,7 @@ async def test_drag_to(page: Page, server: Server) -> None:
     )
 
 
-async def test_drag_to_with_position(page: Page, server: Server):
+async def test_drag_to_with_position(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
         """
@@ -917,14 +932,16 @@ async def test_should_support_locator_that(page: Page) -> None:
     ).to_have_count(1)
 
 
-async def test_should_filter_by_case_insensitive_regex_in_a_child(page):
+async def test_should_filter_by_case_insensitive_regex_in_a_child(page: Page) -> None:
     await page.set_content('<div class="test"><h5>Title Text</h5></div>')
     await expect(
         page.locator("div", has_text=re.compile(r"^title text$", re.I))
     ).to_have_text("Title Text")
 
 
-async def test_should_filter_by_case_insensitive_regex_in_multiple_children(page):
+async def test_should_filter_by_case_insensitive_regex_in_multiple_children(
+    page: Page,
+) -> None:
     await page.set_content(
         '<div class="test"><h5>Title</h5> <h2><i>Text</i></h2></div>'
     )
@@ -933,7 +950,7 @@ async def test_should_filter_by_case_insensitive_regex_in_multiple_children(page
     ).to_have_class("test")
 
 
-async def test_should_filter_by_regex_with_special_symbols(page):
+async def test_should_filter_by_regex_with_special_symbols(page: Page) -> None:
     await page.set_content(
         '<div class="test"><h5>First/"and"</h5><h2><i>Second\\</i></h2></div>'
     )
@@ -984,7 +1001,7 @@ async def test_should_support_locator_filter(page: Page) -> None:
     await expect(page.locator("div").filter(has_not_text="foo")).to_have_count(2)
 
 
-async def test_locators_should_support_locator_and(page: Page, server: Server):
+async def test_locators_should_support_locator_and(page: Page, server: Server) -> None:
     await page.set_content(
         """
         <div data-testid=foo>hello</div><div data-testid=bar>world</div>
@@ -1009,7 +1026,7 @@ async def test_locators_should_support_locator_and(page: Page, server: Server):
     ).to_have_count(2)
 
 
-async def test_locators_has_does_not_encode_unicode(page: Page, server: Server):
+async def test_locators_has_does_not_encode_unicode(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     locators = [
         page.locator("button", has_text="Драматург"),
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index 89fec6700..62cc5036f 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -15,32 +15,41 @@
 import asyncio
 import re
 import sys
-from typing import Any
+from pathlib import Path
+from typing import Any, List, Optional
 
 import pytest
 
-from playwright.async_api import Error, Page, Request, TimeoutError
-from tests.server import Server
+from playwright.async_api import (
+    BrowserContext,
+    Error,
+    Page,
+    Request,
+    Response,
+    Route,
+    TimeoutError,
+)
+from tests.server import HttpRequestWithPostBody, Server
 
 
-async def test_goto_should_work(page, server):
+async def test_goto_should_work(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     assert page.url == server.EMPTY_PAGE
 
 
-async def test_goto_should_work_with_file_URL(page, server, assetdir):
+async def test_goto_should_work_with_file_URL(page: Page, assetdir: Path) -> None:
     fileurl = (assetdir / "frames" / "two-frames.html").as_uri()
     await page.goto(fileurl)
     assert page.url.lower() == fileurl.lower()
     assert len(page.frames) == 3
 
 
-async def test_goto_should_use_http_for_no_protocol(page, server):
+async def test_goto_should_use_http_for_no_protocol(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE[7:])
     assert page.url == server.EMPTY_PAGE
 
 
-async def test_goto_should_work_cross_process(page, server):
+async def test_goto_should_work_cross_process(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     assert page.url == server.EMPTY_PAGE
 
@@ -54,13 +63,16 @@ def on_request(r: Request) -> None:
     page.on("request", on_request)
 
     response = await page.goto(url)
+    assert response
     assert page.url == url
     assert response.frame == page.main_frame
     assert request_frames[0] == page.main_frame
     assert response.url == url
 
 
-async def test_goto_should_capture_iframe_navigation_request(page, server):
+async def test_goto_should_capture_iframe_navigation_request(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     assert page.url == server.EMPTY_PAGE
 
@@ -73,6 +85,7 @@ def on_request(r: Request) -> None:
     page.on("request", on_request)
 
     response = await page.goto(server.PREFIX + "/frames/one-frame.html")
+    assert response
     assert page.url == server.PREFIX + "/frames/one-frame.html"
     assert response.frame == page.main_frame
     assert response.url == server.PREFIX + "/frames/one-frame.html"
@@ -82,8 +95,8 @@ def on_request(r: Request) -> None:
 
 
 async def test_goto_should_capture_cross_process_iframe_navigation_request(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     assert page.url == server.EMPTY_PAGE
 
@@ -96,6 +109,7 @@ def on_request(r: Request) -> None:
     page.on("request", on_request)
 
     response = await page.goto(server.CROSS_PROCESS_PREFIX + "/frames/one-frame.html")
+    assert response
     assert page.url == server.CROSS_PROCESS_PREFIX + "/frames/one-frame.html"
     assert response.frame == page.main_frame
     assert response.url == server.CROSS_PROCESS_PREFIX + "/frames/one-frame.html"
@@ -104,7 +118,9 @@ def on_request(r: Request) -> None:
     assert request_frames[0] == page.frames[1]
 
 
-async def test_goto_should_work_with_anchor_navigation(page, server):
+async def test_goto_should_work_with_anchor_navigation(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     assert page.url == server.EMPTY_PAGE
     await page.goto(server.EMPTY_PAGE + "#foo")
@@ -113,29 +129,33 @@ async def test_goto_should_work_with_anchor_navigation(page, server):
     assert page.url == server.EMPTY_PAGE + "#bar"
 
 
-async def test_goto_should_work_with_redirects(page, server):
+async def test_goto_should_work_with_redirects(page: Page, server: Server) -> None:
     server.set_redirect("/redirect/1.html", "/redirect/2.html")
     server.set_redirect("/redirect/2.html", "/empty.html")
     response = await page.goto(server.PREFIX + "/redirect/1.html")
+    assert response
     assert response.status == 200
     assert page.url == server.EMPTY_PAGE
 
 
-async def test_goto_should_navigate_to_about_blank(page, server):
+async def test_goto_should_navigate_to_about_blank(page: Page, server: Server) -> None:
     response = await page.goto("about:blank")
     assert response is None
 
 
 async def test_goto_should_return_response_when_page_changes_its_url_after_load(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     response = await page.goto(server.PREFIX + "/historyapi.html")
+    assert response
     assert response.status == 200
 
 
 @pytest.mark.skip_browser("firefox")
-async def test_goto_should_work_with_subframes_return_204(page, server):
-    def handle(request):
+async def test_goto_should_work_with_subframes_return_204(
+    page: Page, server: Server
+) -> None:
+    def handle(request: HttpRequestWithPostBody) -> None:
         request.setResponseCode(204)
         request.finish()
 
@@ -145,10 +165,10 @@ def handle(request):
 
 
 async def test_goto_should_fail_when_server_returns_204(
-    page, server, is_chromium, is_webkit
-):
+    page: Page, server: Server, is_chromium: bool, is_webkit: bool
+) -> None:
     # WebKit just loads an empty page.
-    def handle(request):
+    def handle(request: HttpRequestWithPostBody) -> None:
         request.setResponseCode(204)
         request.finish()
 
@@ -165,14 +185,17 @@ def handle(request):
         assert "NS_BINDING_ABORTED" in exc_info.value.message
 
 
-async def test_goto_should_navigate_to_empty_page_with_domcontentloaded(page, server):
+async def test_goto_should_navigate_to_empty_page_with_domcontentloaded(
+    page: Page, server: Server
+) -> None:
     response = await page.goto(server.EMPTY_PAGE, wait_until="domcontentloaded")
+    assert response
     assert response.status == 200
 
 
 async def test_goto_should_work_when_page_calls_history_api_in_beforeunload(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.evaluate(
         """() => {
@@ -181,12 +204,13 @@ async def test_goto_should_work_when_page_calls_history_api_in_beforeunload(
     )
 
     response = await page.goto(server.PREFIX + "/grid.html")
+    assert response
     assert response.status == 200
 
 
 async def test_goto_should_fail_when_navigating_to_bad_url(
-    page, server, is_chromium, is_webkit
-):
+    page: Page, is_chromium: bool, is_webkit: bool
+) -> None:
     with pytest.raises(Error) as exc_info:
         await page.goto("asdfasdf")
     if is_chromium or is_webkit:
@@ -196,16 +220,16 @@ async def test_goto_should_fail_when_navigating_to_bad_url(
 
 
 async def test_goto_should_fail_when_navigating_to_bad_ssl(
-    page, https_server, browser_name
-):
+    page: Page, https_server: Server, browser_name: str
+) -> None:
     with pytest.raises(Error) as exc_info:
         await page.goto(https_server.EMPTY_PAGE)
     expect_ssl_error(exc_info.value.message, browser_name)
 
 
 async def test_goto_should_fail_when_navigating_to_bad_ssl_after_redirects(
-    page, server, https_server, browser_name
-):
+    page: Page, server: Server, https_server: Server, browser_name: str
+) -> None:
     server.set_redirect("/redirect/1.html", "/redirect/2.html")
     server.set_redirect("/redirect/2.html", "/empty.html")
     with pytest.raises(Error) as exc_info:
@@ -214,16 +238,18 @@ async def test_goto_should_fail_when_navigating_to_bad_ssl_after_redirects(
 
 
 async def test_goto_should_not_crash_when_navigating_to_bad_ssl_after_a_cross_origin_navigation(
-    page, server, https_server, browser_name
-):
+    page: Page, server: Server, https_server: Server
+) -> None:
     await page.goto(server.CROSS_PROCESS_PREFIX + "/empty.html")
     with pytest.raises(Error):
         await page.goto(https_server.EMPTY_PAGE)
 
 
-async def test_goto_should_throw_if_networkidle2_is_passed_as_an_option(page, server):
+async def test_goto_should_throw_if_networkidle2_is_passed_as_an_option(
+    page: Page, server: Server
+) -> None:
     with pytest.raises(Error) as exc_info:
-        await page.goto(server.EMPTY_PAGE, wait_until="networkidle2")
+        await page.goto(server.EMPTY_PAGE, wait_until="networkidle2")  # type: ignore
     assert (
         "wait_until: expected one of (load|domcontentloaded|networkidle|commit)"
         in exc_info.value.message
@@ -231,8 +257,8 @@ async def test_goto_should_throw_if_networkidle2_is_passed_as_an_option(page, se
 
 
 async def test_goto_should_fail_when_main_resources_failed_to_load(
-    page, server, is_chromium, is_webkit, is_win
-):
+    page: Page, is_chromium: bool, is_webkit: bool, is_win: bool
+) -> None:
     with pytest.raises(Error) as exc_info:
         await page.goto("http://localhost:44123/non-existing-url")
     if is_chromium:
@@ -245,7 +271,9 @@ async def test_goto_should_fail_when_main_resources_failed_to_load(
         assert "NS_ERROR_CONNECTION_REFUSED" in exc_info.value.message
 
 
-async def test_goto_should_fail_when_exceeding_maximum_navigation_timeout(page, server):
+async def test_goto_should_fail_when_exceeding_maximum_navigation_timeout(
+    page: Page, server: Server
+) -> None:
     # Hang for request to the empty.html
     server.set_route("/empty.html", lambda request: None)
     with pytest.raises(Error) as exc_info:
@@ -256,8 +284,8 @@ async def test_goto_should_fail_when_exceeding_maximum_navigation_timeout(page,
 
 
 async def test_goto_should_fail_when_exceeding_default_maximum_navigation_timeout(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     # Hang for request to the empty.html
     server.set_route("/empty.html", lambda request: None)
     page.context.set_default_navigation_timeout(2)
@@ -270,8 +298,8 @@ async def test_goto_should_fail_when_exceeding_default_maximum_navigation_timeou
 
 
 async def test_goto_should_fail_when_exceeding_browser_context_navigation_timeout(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     # Hang for request to the empty.html
     server.set_route("/empty.html", lambda request: None)
     page.context.set_default_navigation_timeout(2)
@@ -282,7 +310,9 @@ async def test_goto_should_fail_when_exceeding_browser_context_navigation_timeou
     assert isinstance(exc_info.value, TimeoutError)
 
 
-async def test_goto_should_fail_when_exceeding_default_maximum_timeout(page, server):
+async def test_goto_should_fail_when_exceeding_default_maximum_timeout(
+    page: Page, server: Server
+) -> None:
     # Hang for request to the empty.html
     server.set_route("/empty.html", lambda request: None)
     page.context.set_default_timeout(2)
@@ -294,7 +324,9 @@ async def test_goto_should_fail_when_exceeding_default_maximum_timeout(page, ser
     assert isinstance(exc_info.value, TimeoutError)
 
 
-async def test_goto_should_fail_when_exceeding_browser_context_timeout(page, server):
+async def test_goto_should_fail_when_exceeding_browser_context_timeout(
+    page: Page, server: Server
+) -> None:
     # Hang for request to the empty.html
     server.set_route("/empty.html", lambda request: None)
     page.context.set_default_timeout(2)
@@ -306,8 +338,8 @@ async def test_goto_should_fail_when_exceeding_browser_context_timeout(page, ser
 
 
 async def test_goto_should_prioritize_default_navigation_timeout_over_default_timeout(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     # Hang for request to the empty.html
     server.set_route("/empty.html", lambda request: None)
     page.set_default_timeout(0)
@@ -319,41 +351,54 @@ async def test_goto_should_prioritize_default_navigation_timeout_over_default_ti
     assert isinstance(exc_info.value, TimeoutError)
 
 
-async def test_goto_should_disable_timeout_when_its_set_to_0(page, server):
-    loaded = []
-    page.once("load", lambda: loaded.append(True))
+async def test_goto_should_disable_timeout_when_its_set_to_0(
+    page: Page, server: Server
+) -> None:
+    loaded: List[bool] = []
+    page.once("load", lambda _: loaded.append(True))
     await page.goto(server.PREFIX + "/grid.html", timeout=0, wait_until="load")
     assert loaded == [True]
 
 
-async def test_goto_should_work_when_navigating_to_valid_url(page, server):
+async def test_goto_should_work_when_navigating_to_valid_url(
+    page: Page, server: Server
+) -> None:
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.ok
 
 
-async def test_goto_should_work_when_navigating_to_data_url(page, server):
+async def test_goto_should_work_when_navigating_to_data_url(
+    page: Page, server: Server
+) -> None:
     response = await page.goto("data:text/html,hello")
     assert response is None
 
 
-async def test_goto_should_work_when_navigating_to_404(page, server):
+async def test_goto_should_work_when_navigating_to_404(
+    page: Page, server: Server
+) -> None:
     response = await page.goto(server.PREFIX + "/not-found")
+    assert response
     assert response.ok is False
     assert response.status == 404
 
 
-async def test_goto_should_return_last_response_in_redirect_chain(page, server):
+async def test_goto_should_return_last_response_in_redirect_chain(
+    page: Page, server: Server
+) -> None:
     server.set_redirect("/redirect/1.html", "/redirect/2.html")
     server.set_redirect("/redirect/2.html", "/redirect/3.html")
     server.set_redirect("/redirect/3.html", server.EMPTY_PAGE)
     response = await page.goto(server.PREFIX + "/redirect/1.html")
+    assert response
     assert response.ok
     assert response.url == server.EMPTY_PAGE
 
 
 async def test_goto_should_navigate_to_data_url_and_not_fire_dataURL_requests(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     requests = []
     page.on("request", lambda request: requests.append(request))
     dataURL = "data:text/html,<div>yo</div>"
@@ -363,26 +408,30 @@ async def test_goto_should_navigate_to_data_url_and_not_fire_dataURL_requests(
 
 
 async def test_goto_should_navigate_to_url_with_hash_and_fire_requests_without_hash(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     requests = []
     page.on("request", lambda request: requests.append(request))
     response = await page.goto(server.EMPTY_PAGE + "#hash")
+    assert response
     assert response.status == 200
     assert response.url == server.EMPTY_PAGE
     assert len(requests) == 1
     assert requests[0].url == server.EMPTY_PAGE
 
 
-async def test_goto_should_work_with_self_requesting_page(page, server):
+async def test_goto_should_work_with_self_requesting_page(
+    page: Page, server: Server
+) -> None:
     response = await page.goto(server.PREFIX + "/self-request.html")
+    assert response
     assert response.status == 200
     assert "self-request.html" in response.url
 
 
 async def test_goto_should_fail_when_navigating_and_show_the_url_at_the_error_message(
-    page, server, https_server
-):
+    page: Page, https_server: Server
+) -> None:
     url = https_server.PREFIX + "/redirect/1.html"
     with pytest.raises(Error) as exc_info:
         await page.goto(url)
@@ -390,14 +439,14 @@ async def test_goto_should_fail_when_navigating_and_show_the_url_at_the_error_me
 
 
 async def test_goto_should_be_able_to_navigate_to_a_page_controlled_by_service_worker(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/serviceworkers/fetch/sw.html")
     await page.evaluate("window.activationPromise")
     await page.goto(server.PREFIX + "/serviceworkers/fetch/sw.html")
 
 
-async def test_goto_should_send_referer(page, server):
+async def test_goto_should_send_referer(page: Page, server: Server) -> None:
     [request1, request2, _] = await asyncio.gather(
         server.wait_for_request("/grid.html"),
         server.wait_for_request("/digits/1.png"),
@@ -410,8 +459,8 @@ async def test_goto_should_send_referer(page, server):
 
 
 async def test_goto_should_reject_referer_option_when_set_extra_http_headers_provides_referer(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.set_extra_http_headers({"referer": "http://microsoft.com/"})
     with pytest.raises(Error) as exc_info:
         await page.goto(server.PREFIX + "/grid.html", referer="http://google.com/")
@@ -421,19 +470,20 @@ async def test_goto_should_reject_referer_option_when_set_extra_http_headers_pro
     assert server.PREFIX + "/grid.html" in exc_info.value.message
 
 
-async def test_goto_should_work_with_commit(page: Page, server):
+async def test_goto_should_work_with_commit(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE, wait_until="commit")
     assert page.url == server.EMPTY_PAGE
 
 
 async def test_network_idle_should_navigate_to_empty_page_with_networkidle(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     response = await page.goto(server.EMPTY_PAGE, wait_until="networkidle")
+    assert response
     assert response.status == 200
 
 
-async def test_wait_for_nav_should_work(page, server):
+async def test_wait_for_nav_should_work(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_navigation() as response_info:
         await page.evaluate(
@@ -444,7 +494,7 @@ async def test_wait_for_nav_should_work(page, server):
     assert "grid.html" in response.url
 
 
-async def test_wait_for_nav_should_respect_timeout(page, server):
+async def test_wait_for_nav_should_respect_timeout(page: Page, server: Server) -> None:
     with pytest.raises(Error) as exc_info:
         async with page.expect_navigation(url="**/frame.html", timeout=2500):
             await page.goto(server.EMPTY_PAGE)
@@ -452,15 +502,17 @@ async def test_wait_for_nav_should_respect_timeout(page, server):
 
 
 async def test_wait_for_nav_should_work_with_both_domcontentloaded_and_load(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     async with page.expect_navigation(
         wait_until="domcontentloaded"
     ), page.expect_navigation(wait_until="load"):
         await page.goto(server.PREFIX + "/one-style.html")
 
 
-async def test_wait_for_nav_should_work_with_clicking_on_anchor_links(page, server):
+async def test_wait_for_nav_should_work_with_clicking_on_anchor_links(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content('<a href="#foobar">foobar</a>')
     async with page.expect_navigation() as response_info:
@@ -471,8 +523,8 @@ async def test_wait_for_nav_should_work_with_clicking_on_anchor_links(page, serv
 
 
 async def test_wait_for_nav_should_work_with_clicking_on_links_which_do_not_commit_navigation(
-    page, server, https_server, browser_name
-):
+    page: Page, server: Server, https_server: Server, browser_name: str
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(f"<a href='{https_server.EMPTY_PAGE}'>foobar</a>")
     with pytest.raises(Error) as exc_info:
@@ -481,7 +533,9 @@ async def test_wait_for_nav_should_work_with_clicking_on_links_which_do_not_comm
     expect_ssl_error(exc_info.value.message, browser_name)
 
 
-async def test_wait_for_nav_should_work_with_history_push_state(page, server):
+async def test_wait_for_nav_should_work_with_history_push_state(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
         """
@@ -498,7 +552,9 @@ async def test_wait_for_nav_should_work_with_history_push_state(page, server):
     assert page.url == server.PREFIX + "/wow.html"
 
 
-async def test_wait_for_nav_should_work_with_history_replace_state(page, server):
+async def test_wait_for_nav_should_work_with_history_replace_state(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
         """
@@ -515,7 +571,9 @@ async def test_wait_for_nav_should_work_with_history_replace_state(page, server)
     assert page.url == server.PREFIX + "/replaced.html"
 
 
-async def test_wait_for_nav_should_work_with_dom_history_back_forward(page, server):
+async def test_wait_for_nav_should_work_with_dom_history_back_forward(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
         """
@@ -546,12 +604,12 @@ async def test_wait_for_nav_should_work_with_dom_history_back_forward(page, serv
     "webkit"
 )  # WebKit issues load event in some cases, but not always
 async def test_wait_for_nav_should_work_when_subframe_issues_window_stop(
-    page, server, is_webkit
-):
+    page: Page, server: Server, is_webkit: bool
+) -> None:
     server.set_route("/frames/style.css", lambda _: None)
     done = False
 
-    async def nav_and_mark_done():
+    async def nav_and_mark_done() -> None:
         nonlocal done
         await page.goto(server.PREFIX + "/frames/one-frame.html")
         done = True
@@ -573,8 +631,10 @@ async def nav_and_mark_done():
         task.cancel()
 
 
-async def test_wait_for_nav_should_work_with_url_match(page, server):
-    responses = [None, None, None]
+async def test_wait_for_nav_should_work_with_url_match(
+    page: Page, server: Server
+) -> None:
+    responses: List[Optional[Response]] = [None, None, None]
 
     async def wait_for_nav(url: Any, index: int) -> None:
         async with page.expect_navigation(url=url) as response_info:
@@ -615,8 +675,8 @@ async def wait_for_nav(url: Any, index: int) -> None:
 
 
 async def test_wait_for_nav_should_work_with_url_match_for_same_document_navigations(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_navigation(url=re.compile(r"third\.html")) as response_info:
         assert not response_info.is_done()
@@ -628,7 +688,9 @@ async def test_wait_for_nav_should_work_with_url_match_for_same_document_navigat
     assert response_info.is_done()
 
 
-async def test_wait_for_nav_should_work_for_cross_process_navigations(page, server):
+async def test_wait_for_nav_should_work_for_cross_process_navigations(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     url = server.CROSS_PROCESS_PREFIX + "/empty.html"
     async with page.expect_navigation(wait_until="domcontentloaded") as response_info:
@@ -640,8 +702,8 @@ async def test_wait_for_nav_should_work_for_cross_process_navigations(page, serv
 
 
 async def test_expect_navigation_should_work_for_cross_process_navigations(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     url = server.CROSS_PROCESS_PREFIX + "/empty.html"
     async with page.expect_navigation(wait_until="domcontentloaded") as response_info:
@@ -653,7 +715,7 @@ async def test_expect_navigation_should_work_for_cross_process_navigations(
     await goto_task
 
 
-async def test_wait_for_nav_should_work_with_commit(page: Page, server):
+async def test_wait_for_nav_should_work_with_commit(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_navigation(wait_until="commit") as response_info:
         await page.evaluate(
@@ -664,10 +726,12 @@ async def test_wait_for_nav_should_work_with_commit(page: Page, server):
     assert "grid.html" in response.url
 
 
-async def test_wait_for_load_state_should_respect_timeout(page, server):
+async def test_wait_for_load_state_should_respect_timeout(
+    page: Page, server: Server
+) -> None:
     requests = []
 
-    def handler(request: Any):
+    def handler(request: Any) -> None:
         requests.append(request)
 
     server.set_route("/one-style.css", handler)
@@ -678,15 +742,19 @@ def handler(request: Any):
     assert "Timeout 1ms exceeded." in exc_info.value.message
 
 
-async def test_wait_for_load_state_should_resolve_immediately_if_loaded(page, server):
+async def test_wait_for_load_state_should_resolve_immediately_if_loaded(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/one-style.html")
     await page.wait_for_load_state()
 
 
-async def test_wait_for_load_state_should_throw_for_bad_state(page, server):
+async def test_wait_for_load_state_should_throw_for_bad_state(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/one-style.html")
     with pytest.raises(Error) as exc_info:
-        await page.wait_for_load_state("bad")
+        await page.wait_for_load_state("bad")  # type: ignore
     assert (
         "state: expected one of (load|domcontentloaded|networkidle|commit)"
         in exc_info.value.message
@@ -694,13 +762,13 @@ async def test_wait_for_load_state_should_throw_for_bad_state(page, server):
 
 
 async def test_wait_for_load_state_should_resolve_immediately_if_load_state_matches(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
 
     requests = []
 
-    def handler(request: Any):
+    def handler(request: Any) -> None:
         requests.append(request)
 
     server.set_route("/one-style.css", handler)
@@ -709,7 +777,7 @@ def handler(request: Any):
     await page.wait_for_load_state("domcontentloaded")
 
 
-async def test_wait_for_load_state_networkidle(page: Page, server: Server):
+async def test_wait_for_load_state_networkidle(page: Page, server: Server) -> None:
     wait_for_network_idle_future = asyncio.create_task(
         page.wait_for_load_state("networkidle")
     )
@@ -718,8 +786,8 @@ async def test_wait_for_load_state_networkidle(page: Page, server: Server):
 
 
 async def test_wait_for_load_state_should_work_with_pages_that_have_loaded_before_being_connected_to(
-    page, context, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_popup() as popup_info:
         await page.evaluate("window._popup = window.open(document.location.href)")
@@ -732,8 +800,8 @@ 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(
-    browser, page, is_firefox
-):
+    page: Page, is_firefox: bool
+) -> None:
     ready_state = []
     async with page.expect_popup() as popup_info:
         ready_state.append(
@@ -752,8 +820,8 @@ async def test_wait_for_load_state_should_wait_for_load_state_of_empty_url_popup
 
 
 async def test_wait_for_load_state_should_wait_for_load_state_of_about_blank_popup_(
-    browser, page
-):
+    page: Page,
+) -> None:
     async with page.expect_popup() as popup_info:
         await page.evaluate("window.open('about:blank') && 1")
     popup = await popup_info.value
@@ -762,8 +830,8 @@ async def test_wait_for_load_state_should_wait_for_load_state_of_about_blank_pop
 
 
 async def test_wait_for_load_state_should_wait_for_load_state_of_about_blank_popup_with_noopener(
-    browser, page
-):
+    page: Page,
+) -> None:
     async with page.expect_popup() as popup_info:
         await page.evaluate("window.open('about:blank', null, 'noopener') && 1")
 
@@ -773,8 +841,8 @@ async def test_wait_for_load_state_should_wait_for_load_state_of_about_blank_pop
 
 
 async def test_wait_for_load_state_should_wait_for_load_state_of_popup_with_network_url_(
-    browser, page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_popup() as popup_info:
         await page.evaluate("url => window.open(url) && 1", server.EMPTY_PAGE)
@@ -785,8 +853,8 @@ async def test_wait_for_load_state_should_wait_for_load_state_of_popup_with_netw
 
 
 async def test_wait_for_load_state_should_wait_for_load_state_of_popup_with_network_url_and_noopener_(
-    browser, page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_popup() as popup_info:
         await page.evaluate(
@@ -799,8 +867,8 @@ async def test_wait_for_load_state_should_wait_for_load_state_of_popup_with_netw
 
 
 async def test_wait_for_load_state_should_work_with_clicking_target__blank(
-    browser, page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
         '<a target=_blank rel="opener" href="/one-style.html">yo</a>'
@@ -813,8 +881,8 @@ async def test_wait_for_load_state_should_work_with_clicking_target__blank(
 
 
 async def test_wait_for_load_state_should_wait_for_load_state_of_new_page(
-    context, page, server
-):
+    context: BrowserContext,
+) -> None:
     async with context.expect_page() as page_info:
         await context.new_page()
     new_page = await page_info.value
@@ -822,12 +890,14 @@ async def test_wait_for_load_state_should_wait_for_load_state_of_new_page(
     assert await new_page.evaluate("document.readyState") == "complete"
 
 
-async def test_wait_for_load_state_in_popup(context, server):
+async def test_wait_for_load_state_in_popup(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     css_requests = []
 
-    def handle_request(request):
+    def handle_request(request: HttpRequestWithPostBody) -> None:
         css_requests.append(request)
         request.write(b"body {}")
         request.finish()
@@ -844,17 +914,19 @@ def handle_request(request):
     assert len(css_requests)
 
 
-async def test_go_back_should_work(page, server):
+async def test_go_back_should_work(page: Page, server: Server) -> None:
     assert await page.go_back() is None
 
     await page.goto(server.EMPTY_PAGE)
     await page.goto(server.PREFIX + "/grid.html")
 
     response = await page.go_back()
+    assert response
     assert response.ok
     assert server.EMPTY_PAGE in response.url
 
     response = await page.go_forward()
+    assert response
     assert response.ok
     assert "/grid.html" in response.url
 
@@ -862,7 +934,7 @@ async def test_go_back_should_work(page, server):
     assert response is None
 
 
-async def test_go_back_should_work_with_history_api(page, server):
+async def test_go_back_should_work_with_history_api(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.evaluate(
         """() => {
@@ -880,17 +952,20 @@ async def test_go_back_should_work_with_history_api(page, server):
     assert page.url == server.PREFIX + "/first.html"
 
 
-async def test_frame_goto_should_navigate_subframes(page, server):
+async def test_frame_goto_should_navigate_subframes(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/frames/one-frame.html")
     assert "/frames/one-frame.html" in page.frames[0].url
     assert "/frames/frame.html" in page.frames[1].url
 
     response = await page.frames[1].goto(server.EMPTY_PAGE)
+    assert response
     assert response.ok
     assert response.frame == page.frames[1]
 
 
-async def test_frame_goto_should_reject_when_frame_detaches(page, server, browser_name):
+async def test_frame_goto_should_reject_when_frame_detaches(
+    page: Page, server: Server, browser_name: str
+) -> None:
     await page.goto(server.PREFIX + "/frames/one-frame.html")
 
     server.set_route("/one-style.css", lambda _: None)
@@ -913,7 +988,9 @@ async def test_frame_goto_should_reject_when_frame_detaches(page, server, browse
         assert "frame was detached" in exc_info.value.message.lower()
 
 
-async def test_frame_goto_should_continue_after_client_redirect(page, server):
+async def test_frame_goto_should_continue_after_client_redirect(
+    page: Page, server: Server
+) -> None:
     server.set_route("/frames/script.js", lambda _: None)
     url = server.PREFIX + "/frames/child-redirect.html"
 
@@ -926,7 +1003,7 @@ async def test_frame_goto_should_continue_after_client_redirect(page, server):
     )
 
 
-async def test_frame_wait_for_nav_should_work(page, server):
+async def test_frame_wait_for_nav_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/frames/one-frame.html")
     frame = page.frames[1]
     async with frame.expect_navigation() as response_info:
@@ -940,7 +1017,9 @@ async def test_frame_wait_for_nav_should_work(page, server):
     assert "/frames/one-frame.html" in page.url
 
 
-async def test_frame_wait_for_nav_should_fail_when_frame_detaches(page, server: Server):
+async def test_frame_wait_for_nav_should_fail_when_frame_detaches(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/frames/one-frame.html")
     frame = page.frames[1]
     server.set_route("/empty.html", lambda _: None)
@@ -948,7 +1027,7 @@ async def test_frame_wait_for_nav_should_fail_when_frame_detaches(page, server:
     with pytest.raises(Error) as exc_info:
         async with frame.expect_navigation():
 
-            async def after_it():
+            async def after_it() -> None:
                 await server.wait_for_request("/one-style.html")
                 await page.eval_on_selector(
                     "iframe", "frame => setTimeout(() => frame.remove(), 0)"
@@ -964,11 +1043,13 @@ async def after_it():
     assert "frame was detached" in exc_info.value.message
 
 
-async def test_frame_wait_for_load_state_should_work(page, server):
+async def test_frame_wait_for_load_state_should_work(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/frames/one-frame.html")
     frame = page.frames[1]
 
-    request_future = asyncio.Future()
+    request_future: "asyncio.Future[Route]" = asyncio.Future()
     await page.route(
         server.PREFIX + "/one-style.css",
         lambda route, request: request_future.set_result(route),
@@ -984,22 +1065,22 @@ async def test_frame_wait_for_load_state_should_work(page, server):
     await load_task
 
 
-async def test_reload_should_work(page, server):
+async def test_reload_should_work(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.evaluate("window._foo = 10")
     await page.reload()
     assert await page.evaluate("window._foo") is None
 
 
-async def test_reload_should_work_with_data_url(page, server):
+async def test_reload_should_work_with_data_url(page: Page, server: Server) -> None:
     await page.goto("data:text/html,hello")
     assert "hello" in await page.content()
     assert await page.reload() is None
     assert "hello" in await page.content()
 
 
-async def test_should_work_with__blank_target(page, server):
-    def handler(request):
+async def test_should_work_with__blank_target(page: Page, server: Server) -> None:
+    def handler(request: HttpRequestWithPostBody) -> None:
         request.write(
             f'<a href="{server.EMPTY_PAGE}" target="_blank">Click me</a>'.encode()
         )
@@ -1011,8 +1092,10 @@ def handler(request):
     await page.click('"Click me"')
 
 
-async def test_should_work_with_cross_process__blank_target(page, server):
-    def handler(request):
+async def test_should_work_with_cross_process__blank_target(
+    page: Page, server: Server
+) -> None:
+    def handler(request: HttpRequestWithPostBody) -> None:
         request.write(
             f'<a href="{server.CROSS_PROCESS_PREFIX}/empty.html" target="_blank">Click me</a>'.encode()
         )
diff --git a/tests/async/test_network.py b/tests/async/test_network.py
index f4072fff4..015372fc0 100644
--- a/tests/async/test_network.py
+++ b/tests/async/test_network.py
@@ -15,18 +15,21 @@
 import asyncio
 import json
 from asyncio import Future
-from typing import Dict, List
+from pathlib import Path
+from typing import Dict, List, Optional, Union
 
 import pytest
 from flaky import flaky
 from twisted.web import http
 
-from playwright.async_api import Browser, Error, Page, Request, Route
-from tests.server import Server
+from playwright.async_api import Browser, Error, Page, Request, Response, Route
+from tests.server import HttpRequestWithPostBody, Server
 
+from .utils import Utils
 
-async def test_request_fulfill(page, server):
-    async def handle_request(route: Route, request: Request):
+
+async def test_request_fulfill(page: Page, server: Server) -> None:
+    async def handle_request(route: Route, request: Request) -> None:
         headers = await route.request.all_headers()
         assert headers["accept"]
         assert route.request == request
@@ -50,6 +53,7 @@ async def handle_request(route: Route, request: Request):
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
 
     assert response.ok
     assert (
@@ -58,12 +62,14 @@ async def handle_request(route: Route, request: Request):
     assert await response.text() == "Text"
 
 
-async def test_request_continue(page, server):
-    async def handle_request(route, request, intercepted):
+async def test_request_continue(page: Page, server: Server) -> None:
+    async def handle_request(
+        route: Route, request: Request, intercepted: List[bool]
+    ) -> None:
         intercepted.append(True)
         await route.continue_()
 
-    intercepted = []
+    intercepted: List[bool] = []
     await page.route(
         "**/*",
         lambda route, request: asyncio.create_task(
@@ -72,26 +78,29 @@ async def handle_request(route, request, intercepted):
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.ok
     assert intercepted == [True]
     assert await page.title() == ""
 
 
 async def test_page_events_request_should_fire_for_navigation_requests(
-    page: Page, server
-):
+    page: Page, server: Server
+) -> None:
     requests = []
     page.on("request", lambda r: requests.append(r))
     await page.goto(server.EMPTY_PAGE)
     assert len(requests) == 1
 
 
-async def test_page_events_request_should_accept_method(page: Page, server):
+async def test_page_events_request_should_accept_method(
+    page: Page, server: Server
+) -> None:
     class Log:
-        def __init__(self):
-            self.requests = []
+        def __init__(self) -> None:
+            self.requests: List[Request] = []
 
-        def handle(self, request):
+        def handle(self, request: Request) -> None:
             self.requests.append(request)
 
     log = Log()
@@ -100,7 +109,9 @@ def handle(self, request):
     assert len(log.requests) == 1
 
 
-async def test_page_events_request_should_fire_for_iframes(page, server, utils):
+async def test_page_events_request_should_fire_for_iframes(
+    page: Page, server: Server, utils: Utils
+) -> None:
     requests = []
     page.on("request", lambda r: requests.append(r))
     await page.goto(server.EMPTY_PAGE)
@@ -108,7 +119,9 @@ async def test_page_events_request_should_fire_for_iframes(page, server, utils):
     assert len(requests) == 2
 
 
-async def test_page_events_request_should_fire_for_fetches(page, server):
+async def test_page_events_request_should_fire_for_fetches(
+    page: Page, server: Server
+) -> None:
     requests = []
     page.on("request", lambda r: requests.append(r))
     await page.goto(server.EMPTY_PAGE)
@@ -117,8 +130,8 @@ async def test_page_events_request_should_fire_for_fetches(page, server):
 
 
 async def test_page_events_request_should_report_requests_and_responses_handled_by_service_worker(
-    page: Page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/serviceworkers/fetchdummy/sw.html")
     await page.evaluate("() => window.activationPromise")
     sw_response = None
@@ -134,8 +147,8 @@ async def test_page_events_request_should_report_requests_and_responses_handled_
 
 
 async def test_request_frame_should_work_for_main_frame_navigation_request(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     requests = []
     page.on("request", lambda r: requests.append(r))
     await page.goto(server.EMPTY_PAGE)
@@ -144,8 +157,8 @@ async def test_request_frame_should_work_for_main_frame_navigation_request(
 
 
 async def test_request_frame_should_work_for_subframe_navigation_request(
-    page, server, utils
-):
+    page: Page, server: Server, utils: Utils
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     requests = []
     page.on("request", lambda r: requests.append(r))
@@ -154,7 +167,9 @@ async def test_request_frame_should_work_for_subframe_navigation_request(
     assert requests[0].frame == page.frames[1]
 
 
-async def test_request_frame_should_work_for_fetch_requests(page, server):
+async def test_request_frame_should_work_for_fetch_requests(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     requests: List[Request] = []
     page.on("request", lambda r: requests.append(r))
@@ -165,9 +180,10 @@ async def test_request_frame_should_work_for_fetch_requests(page, server):
 
 
 async def test_request_headers_should_work(
-    page, server, is_chromium, is_firefox, is_webkit
-):
+    page: Page, server: Server, is_chromium: bool, is_firefox: bool, is_webkit: bool
+) -> None:
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     if is_chromium:
         assert "Chrome" in response.request.headers["user-agent"]
     elif is_firefox:
@@ -177,13 +193,13 @@ async def test_request_headers_should_work(
 
 
 async def test_request_headers_should_get_the_same_headers_as_the_server(
-    page: Page, server, is_webkit, is_win
-):
+    page: Page, server: Server, is_webkit: bool, is_win: bool
+) -> None:
     if is_webkit and is_win:
         pytest.xfail("Curl does not show accept-encoding and accept-language")
     server_request_headers_future: Future[Dict[str, str]] = asyncio.Future()
 
-    def handle(request):
+    def handle(request: http.Request) -> None:
         normalized_headers = {
             key.decode().lower(): value[0].decode()
             for key, value in request.requestHeaders.getAllRawHeaders()
@@ -200,14 +216,14 @@ def handle(request):
 
 
 async def test_request_headers_should_get_the_same_headers_as_the_server_cors(
-    page: Page, server, is_webkit, is_win
-):
+    page: Page, server: Server, is_webkit: bool, is_win: bool
+) -> None:
     if is_webkit and is_win:
         pytest.xfail("Curl does not show accept-encoding and accept-language")
     await page.goto(server.PREFIX + "/empty.html")
     server_request_headers_future: Future[Dict[str, str]] = asyncio.Future()
 
-    def handle_something(request):
+    def handle_something(request: http.Request) -> None:
         normalized_headers = {
             key.decode().lower(): value[0].decode()
             for key, value in request.requestHeaders.getAllRawHeaders()
@@ -241,7 +257,7 @@ async def test_should_report_request_headers_array(
         pytest.skip("libcurl does not support non-set-cookie multivalue headers")
     expected_headers = []
 
-    def handle(request: http.Request):
+    def handle(request: http.Request) -> None:
         for name, values in request.requestHeaders.getAllRawHeaders():
             for value in values:
                 expected_headers.append(
@@ -285,7 +301,7 @@ def handle(request: http.Request):
 
 
 async def test_should_report_response_headers_array(
-    page: Page, server: Server, is_win, browser_name
+    page: Page, server: Server, is_win: bool, browser_name: str
 ) -> None:
     if is_win and browser_name == "webkit":
         pytest.skip("libcurl does not support non-set-cookie multivalue headers")
@@ -295,7 +311,7 @@ async def test_should_report_response_headers_array(
         "set-cookie": ["a=b", "c=d"],
     }
 
-    def handle(request: http.Request):
+    def handle(request: http.Request) -> None:
         for key in expected_headers:
             for value in expected_headers[key]:
                 request.responseHeaders.addRawHeader(key, value)
@@ -309,7 +325,7 @@ def handle(request: http.Request):
         """
         )
     response = await response_info.value
-    actual_headers = {}
+    actual_headers: Dict[str, List[str]] = {}
     for header in await response.headers_array():
         name = header["name"].lower()
         value = header["value"]
@@ -329,15 +345,16 @@ def handle(request: http.Request):
     assert await response.header_values("set-cookie") == ["a=b", "c=d"]
 
 
-async def test_response_headers_should_work(page: Page, server):
+async def test_response_headers_should_work(page: Page, server: Server) -> None:
     server.set_route("/empty.html", lambda r: (r.setHeader("foo", "bar"), r.finish()))
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.headers["foo"] == "bar"
     assert (await response.all_headers())["foo"] == "bar"
 
 
-async def test_request_post_data_should_work(page, server):
+async def test_request_post_data_should_work(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     server.set_route("/post", lambda r: r.finish())
     requests = []
@@ -350,13 +367,14 @@ async def test_request_post_data_should_work(page, server):
 
 
 async def test_request_post_data__should_be_undefined_when_there_is_no_post_data(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.request.post_data is None
 
 
-async def test_should_parse_the_json_post_data(page, server):
+async def test_should_parse_the_json_post_data(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     server.set_route("/post", lambda req: req.finish())
     requests = []
@@ -368,7 +386,9 @@ async def test_should_parse_the_json_post_data(page, server):
     assert requests[0].post_data_json == {"foo": "bar"}
 
 
-async def test_should_parse_the_data_if_content_type_is_form_urlencoded(page, server):
+async def test_should_parse_the_data_if_content_type_is_form_urlencoded(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     server.set_route("/post", lambda req: req.finish())
     requests = []
@@ -381,12 +401,17 @@ async def test_should_parse_the_data_if_content_type_is_form_urlencoded(page, se
     assert requests[0].post_data_json == {"foo": "bar", "baz": "123"}
 
 
-async def test_should_be_undefined_when_there_is_no_post_data(page, server):
+async def test_should_be_undefined_when_there_is_no_post_data(
+    page: Page, server: Server
+) -> None:
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.request.post_data_json is None
 
 
-async def test_should_return_post_data_without_content_type(page, server):
+async def test_should_return_post_data_without_content_type(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_request("**/*") as request_info:
         await page.evaluate(
@@ -404,7 +429,9 @@ async def test_should_return_post_data_without_content_type(page, server):
     assert request.post_data_json == {"value": 42}
 
 
-async def test_should_throw_on_invalid_json_in_post_data(page, server):
+async def test_should_throw_on_invalid_json_in_post_data(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_request("**/*") as request_info:
         await page.evaluate(
@@ -424,7 +451,7 @@ async def test_should_throw_on_invalid_json_in_post_data(page, server):
     assert "POST data is not a valid JSON object: <not a json>" in str(exc_info.value)
 
 
-async def test_should_work_with_binary_post_data(page, server):
+async def test_should_work_with_binary_post_data(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     server.set_route("/post", lambda req: req.finish())
     requests = []
@@ -441,7 +468,9 @@ async def test_should_work_with_binary_post_data(page, server):
         assert buffer[i] == i
 
 
-async def test_should_work_with_binary_post_data_and_interception(page, server):
+async def test_should_work_with_binary_post_data_and_interception(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     server.set_route("/post", lambda req: req.finish())
     requests = []
@@ -459,42 +488,53 @@ async def test_should_work_with_binary_post_data_and_interception(page, server):
         assert buffer[i] == i
 
 
-async def test_response_text_should_work(page, server):
+async def test_response_text_should_work(page: Page, server: Server) -> None:
     response = await page.goto(server.PREFIX + "/simple.json")
+    assert response
     assert await response.text() == '{"foo": "bar"}\n'
 
 
-async def test_response_text_should_return_uncompressed_text(page, server):
+async def test_response_text_should_return_uncompressed_text(
+    page: Page, server: Server
+) -> None:
     server.enable_gzip("/simple.json")
     response = await page.goto(server.PREFIX + "/simple.json")
+    assert response
     assert response.headers["content-encoding"] == "gzip"
     assert await response.text() == '{"foo": "bar"}\n'
 
 
 async def test_response_text_should_throw_when_requesting_body_of_redirected_response(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     server.set_redirect("/foo.html", "/empty.html")
     response = await page.goto(server.PREFIX + "/foo.html")
+    assert response
     redirected_from = response.request.redirected_from
     assert redirected_from
     redirected = await redirected_from.response()
+    assert redirected
     assert redirected.status == 302
-    error = None
+    error: Optional[Error] = None
     try:
         await redirected.text()
     except Error as exc:
         error = exc
+    assert error
     assert "Response body is unavailable for redirect responses" in error.message
 
 
-async def test_response_json_should_work(page, server):
+async def test_response_json_should_work(page: Page, server: Server) -> None:
     response = await page.goto(server.PREFIX + "/simple.json")
+    assert response
     assert await response.json() == {"foo": "bar"}
 
 
-async def test_response_body_should_work(page, server, assetdir):
+async def test_response_body_should_work(
+    page: Page, server: Server, assetdir: Path
+) -> None:
     response = await page.goto(server.PREFIX + "/pptr.png")
+    assert response
     with open(
         assetdir / "pptr.png",
         "rb",
@@ -502,9 +542,12 @@ async def test_response_body_should_work(page, server, assetdir):
         assert fd.read() == await response.body()
 
 
-async def test_response_body_should_work_with_compression(page, server, assetdir):
+async def test_response_body_should_work_with_compression(
+    page: Page, server: Server, assetdir: Path
+) -> None:
     server.enable_gzip("/pptr.png")
     response = await page.goto(server.PREFIX + "/pptr.png")
+    assert response
     with open(
         assetdir / "pptr.png",
         "rb",
@@ -512,14 +555,17 @@ async def test_response_body_should_work_with_compression(page, server, assetdir
         assert fd.read() == await response.body()
 
 
-async def test_response_status_text_should_work(page, server):
+async def test_response_status_text_should_work(page: Page, server: Server) -> None:
     server.set_route("/cool", lambda r: (r.setResponseCode(200, b"cool!"), r.finish()))
 
     response = await page.goto(server.PREFIX + "/cool")
+    assert response
     assert response.status_text == "cool!"
 
 
-async def test_request_resource_type_should_return_event_source(page, server):
+async def test_request_resource_type_should_return_event_source(
+    page: Page, server: Server
+) -> None:
     SSE_MESSAGE = {"foo": "bar"}
     # 1. Setup server-sent events on server that immediately sends a message to the client.
     server.set_route(
@@ -553,7 +599,7 @@ async def test_request_resource_type_should_return_event_source(page, server):
     assert requests[0].resource_type == "eventsource"
 
 
-async def test_network_events_request(page, server):
+async def test_network_events_request(page: Page, server: Server) -> None:
     requests = []
     page.on("request", lambda r: requests.append(r))
     await page.goto(server.EMPTY_PAGE)
@@ -566,7 +612,7 @@ async def test_network_events_request(page, server):
     assert requests[0].frame.url == server.EMPTY_PAGE
 
 
-async def test_network_events_response(page, server):
+async def test_network_events_response(page: Page, server: Server) -> None:
     responses = []
     page.on("response", lambda r: responses.append(r))
     await page.goto(server.EMPTY_PAGE)
@@ -578,9 +624,14 @@ async def test_network_events_response(page, server):
 
 
 async def test_network_events_request_failed(
-    page, server, is_chromium, is_webkit, is_mac, is_win
-):
-    def handle_request(request):
+    page: Page,
+    server: Server,
+    is_chromium: bool,
+    is_webkit: bool,
+    is_mac: bool,
+    is_win: bool,
+) -> None:
+    def handle_request(request: HttpRequestWithPostBody) -> None:
         request.setHeader("Content-Type", "text/css")
         request.transport.loseConnection()
 
@@ -614,7 +665,7 @@ def handle_request(request):
     assert failed_requests[0].frame
 
 
-async def test_network_events_request_finished(page, server):
+async def test_network_events_request_finished(page: Page, server: Server) -> None:
     async with page.expect_event("requestfinished") as event_info:
         await page.goto(server.EMPTY_PAGE)
     request = await event_info.value
@@ -624,64 +675,89 @@ async def test_network_events_request_finished(page, server):
     assert request.frame.url == server.EMPTY_PAGE
 
 
-async def test_network_events_should_fire_events_in_proper_order(page, server):
+async def test_network_events_should_fire_events_in_proper_order(
+    page: Page, server: Server
+) -> None:
     events = []
     page.on("request", lambda request: events.append("request"))
     page.on("response", lambda response: events.append("response"))
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     await response.finished()
     events.append("requestfinished")
     assert events == ["request", "response", "requestfinished"]
 
 
-async def test_network_events_should_support_redirects(page, server):
+async def test_network_events_should_support_redirects(
+    page: Page, server: Server
+) -> None:
     FOO_URL = server.PREFIX + "/foo.html"
-    events = {}
+    events: Dict[str, List[Union[str, int]]] = {}
     events[FOO_URL] = []
     events[server.EMPTY_PAGE] = []
-    page.on("request", lambda request: events[request.url].append(request.method))
-    page.on("response", lambda response: events[response.url].append(response.status))
-    page.on("requestfinished", lambda request: events[request.url].append("DONE"))
-    page.on("requestfailed", lambda request: events[request.url].append("FAIL"))
+
+    def _handle_on_request(request: Request) -> None:
+        events[request.url].append(request.method)
+
+    page.on("request", _handle_on_request)
+
+    def _handle_on_response(response: Response) -> None:
+        events[response.url].append(response.status)
+
+    page.on("response", _handle_on_response)
+
+    def _handle_on_requestfinished(request: Request) -> None:
+        events[request.url].append("DONE")
+
+    page.on("requestfinished", _handle_on_requestfinished)
+
+    def _handle_on_requestfailed(request: Request) -> None:
+        events[request.url].append("FAIL")
+
+    page.on("requestfailed", _handle_on_requestfailed)
     server.set_redirect("/foo.html", "/empty.html")
     response = await page.goto(FOO_URL)
+    assert response
     await response.finished()
     expected = {}
     expected[FOO_URL] = ["GET", 302, "DONE"]
     expected[server.EMPTY_PAGE] = ["GET", 200, "DONE"]
     assert events == expected
     redirected_from = response.request.redirected_from
+    assert redirected_from
     assert "/foo.html" in redirected_from.url
     assert redirected_from.redirected_from is None
     assert redirected_from.redirected_to == response.request
 
 
-async def test_request_is_navigation_request_should_work(page, server):
-    requests = {}
+async def test_request_is_navigation_request_should_work(
+    page: Page, server: Server
+) -> None:
+    requests: Dict[str, Request] = {}
 
-    def handle_request(request):
+    def handle_request(request: Request) -> None:
         requests[request.url.split("/").pop()] = request
 
     page.on("request", handle_request)
     server.set_redirect("/rrredirect", "/frames/one-frame.html")
     await page.goto(server.PREFIX + "/rrredirect")
-    assert requests.get("rrredirect").is_navigation_request()
-    assert requests.get("one-frame.html").is_navigation_request()
-    assert requests.get("frame.html").is_navigation_request()
-    assert requests.get("script.js").is_navigation_request() is False
-    assert requests.get("style.css").is_navigation_request() is False
+    assert requests["rrredirect"].is_navigation_request()
+    assert requests["one-frame.html"].is_navigation_request()
+    assert requests["frame.html"].is_navigation_request()
+    assert requests["script.js"].is_navigation_request() is False
+    assert requests["style.css"].is_navigation_request() is False
 
 
 async def test_request_is_navigation_request_should_work_when_navigating_to_image(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     requests = []
     page.on("request", lambda r: requests.append(r))
     await page.goto(server.PREFIX + "/pptr.png")
     assert requests[0].is_navigation_request()
 
 
-async def test_set_extra_http_headers_should_work(page, server):
+async def test_set_extra_http_headers_should_work(page: Page, server: Server) -> None:
     await page.set_extra_http_headers({"foo": "bar"})
 
     request = (
@@ -693,7 +769,9 @@ async def test_set_extra_http_headers_should_work(page, server):
     assert request.getHeader("foo") == "bar"
 
 
-async def test_set_extra_http_headers_should_work_with_redirects(page, server):
+async def test_set_extra_http_headers_should_work_with_redirects(
+    page: Page, server: Server
+) -> None:
     server.set_redirect("/foo.html", "/empty.html")
     await page.set_extra_http_headers({"foo": "bar"})
 
@@ -707,8 +785,8 @@ async def test_set_extra_http_headers_should_work_with_redirects(page, server):
 
 
 async def test_set_extra_http_headers_should_work_with_extra_headers_from_browser_context(
-    browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context()
     await context.set_extra_http_headers({"foo": "bar"})
 
@@ -725,8 +803,8 @@ async def test_set_extra_http_headers_should_work_with_extra_headers_from_browse
 
 @flaky  # Flaky upstream https://devops.aslushnikov.com/flakiness2.html#filter_spec=should+override+extra+headers+from+browser+context&test_parameter_filters=%5B%5B%22browserName%22%2C%5B%5B%22webkit%22%2C%22include%22%5D%5D%5D%2C%5B%22video%22%2C%5B%5Btrue%2C%22exclude%22%5D%5D%5D%2C%5B%22platform%22%2C%5B%5B%22Windows%22%2C%22include%22%5D%5D%5D%5D
 async def test_set_extra_http_headers_should_override_extra_headers_from_browser_context(
-    browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(extra_http_headers={"fOo": "bAr", "baR": "foO"})
 
     page = await context.new_page()
@@ -744,18 +822,20 @@ async def test_set_extra_http_headers_should_override_extra_headers_from_browser
 
 
 async def test_set_extra_http_headers_should_throw_for_non_string_header_values(
-    page, server
-):
-    error = None
+    page: Page,
+) -> None:
+    error: Optional[Error] = None
     try:
-        await page.set_extra_http_headers({"foo": 1})
+        await page.set_extra_http_headers({"foo": 1})  # type: ignore
     except Error as exc:
         error = exc
+    assert error
     assert error.message == "headers[0].value: expected string, got number"
 
 
-async def test_response_server_addr(page: Page, server: Server):
+async def test_response_server_addr(page: Page, server: Server) -> None:
     response = await page.goto(f"http://127.0.0.1:{server.PORT}")
+    assert response
     server_addr = await response.server_addr()
     assert server_addr
     assert server_addr["port"] == server.PORT
@@ -763,12 +843,17 @@ async def test_response_server_addr(page: Page, server: Server):
 
 
 async def test_response_security_details(
-    browser: Browser, https_server: Server, browser_name, is_win, is_linux
-):
+    browser: Browser,
+    https_server: Server,
+    browser_name: str,
+    is_win: bool,
+    is_linux: bool,
+) -> None:
     if (browser_name == "webkit" and is_linux) or (browser_name == "webkit" and is_win):
         pytest.skip("https://github.com/microsoft/playwright/issues/6759")
     page = await browser.new_page(ignore_https_errors=True)
     response = await page.goto(https_server.EMPTY_PAGE)
+    assert response
     await response.finished()
     security_details = await response.security_details()
     assert security_details
@@ -796,8 +881,11 @@ async def test_response_security_details(
     await page.close()
 
 
-async def test_response_security_details_none_without_https(page: Page, server: Server):
+async def test_response_security_details_none_without_https(
+    page: Page, server: Server
+) -> None:
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     security_details = await response.security_details()
     assert security_details is None
 
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 117c8009a..349914b6f 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -15,15 +15,24 @@
 import asyncio
 import os
 import re
+from pathlib import Path
+from typing import Dict, List, Optional
 
 import pytest
 
-from playwright.async_api import BrowserContext, Error, Page, Route, TimeoutError
-from tests.server import Server
-from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
+from playwright.async_api import (
+    BrowserContext,
+    Error,
+    JSHandle,
+    Page,
+    Route,
+    TimeoutError,
+)
+from tests.server import HttpRequestWithPostBody, Server
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE, must
 
 
-async def test_close_should_reject_all_promises(context):
+async def test_close_should_reject_all_promises(context: BrowserContext) -> None:
     new_page = await context.new_page()
     with pytest.raises(Error) as exc_info:
         await asyncio.gather(
@@ -32,7 +41,9 @@ async def test_close_should_reject_all_promises(context):
     assert " closed" in exc_info.value.message
 
 
-async def test_closed_should_not_visible_in_context_pages(context):
+async def test_closed_should_not_visible_in_context_pages(
+    context: BrowserContext,
+) -> None:
     page = await context.new_page()
     assert page in context.pages
     await page.close()
@@ -40,8 +51,8 @@ async def test_closed_should_not_visible_in_context_pages(context):
 
 
 async def test_close_should_run_beforeunload_if_asked_for(
-    context, server, is_chromium, is_webkit
-):
+    context: BrowserContext, server: Server, is_chromium: bool, is_webkit: bool
+) -> None:
     page = await context.new_page()
     await page.goto(server.PREFIX + "/beforeunload.html")
     # We have to interact with a page so that 'beforeunload' handlers
@@ -67,7 +78,9 @@ async def test_close_should_run_beforeunload_if_asked_for(
         await dialog.accept()
 
 
-async def test_close_should_not_run_beforeunload_by_default(context, server):
+async def test_close_should_not_run_beforeunload_by_default(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.PREFIX + "/beforeunload.html")
     # We have to interact with a page so that 'beforeunload' handlers
@@ -78,7 +91,7 @@ async def test_close_should_not_run_beforeunload_by_default(context, server):
 
 async def test_should_be_able_to_navigate_away_from_page_with_before_unload(
     server: Server, page: Page
-):
+) -> None:
     await page.goto(server.PREFIX + "/beforeunload.html")
     # We have to interact with a page so that 'beforeunload' handlers
     # fire.
@@ -86,23 +99,25 @@ async def test_should_be_able_to_navigate_away_from_page_with_before_unload(
     await page.goto(server.EMPTY_PAGE)
 
 
-async def test_close_should_set_the_page_close_state(context):
+async def test_close_should_set_the_page_close_state(context: BrowserContext) -> None:
     page = await context.new_page()
     assert page.is_closed() is False
     await page.close()
     assert page.is_closed()
 
 
-async def test_close_should_terminate_network_waiters(context, server):
+async def test_close_should_terminate_network_waiters(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
 
-    async def wait_for_request():
+    async def wait_for_request() -> Error:
         with pytest.raises(Error) as exc_info:
             async with page.expect_request(server.EMPTY_PAGE):
                 pass
         return exc_info.value
 
-    async def wait_for_response():
+    async def wait_for_response() -> Error:
         with pytest.raises(Error) as exc_info:
             async with page.expect_response(server.EMPTY_PAGE):
                 pass
@@ -113,11 +128,12 @@ async def wait_for_response():
     )
     for i in range(2):
         error = results[i]
+        assert error
         assert TARGET_CLOSED_ERROR_MESSAGE in error.message
         assert "Timeout" not in error.message
 
 
-async def test_close_should_be_callable_twice(context):
+async def test_close_should_be_callable_twice(context: BrowserContext) -> None:
     page = await context.new_page()
     await asyncio.gather(
         page.close(),
@@ -126,33 +142,34 @@ async def test_close_should_be_callable_twice(context):
     await page.close()
 
 
-async def test_load_should_fire_when_expected(page):
+async def test_load_should_fire_when_expected(page: Page) -> None:
     async with page.expect_event("load"):
         await page.goto("about:blank")
 
 
+@pytest.mark.skip("FIXME")
 async def test_should_work_with_wait_for_loadstate(page: Page, server: Server) -> None:
     messages = []
+
+    def _handler(request: HttpRequestWithPostBody) -> None:
+        messages.append("route")
+        request.setHeader("Content-Type", "text/html")
+        request.write(b"<link rel='stylesheet' href='./one-style.css'>")
+        request.finish()
+
     server.set_route(
         "/empty.html",
-        lambda route, response: (
-            messages.append("route"),
-            response.set_header("Content-Type", "text/html"),
-            response.set_content(
-                "<link rel='stylesheet' href='./one-style.css'>", response.finish()
-            ),
-        ),
+        _handler,
     )
 
-    return messages
     await page.set_content(f'<a id="anchor" href="{server.EMPTY_PAGE}">empty.html</a>')
 
-    async def wait_for_clickload():
+    async def wait_for_clickload() -> None:
         await page.click("a")
         await page.wait_for_load_state("load")
         messages.append("clickload")
 
-    async def wait_for_page_load():
+    async def wait_for_page_load() -> None:
         await page.wait_for_event("load")
         messages.append("load")
 
@@ -164,16 +181,17 @@ async def wait_for_page_load():
     assert messages == ["route", "load", "clickload"]
 
 
-async def test_async_stacks_should_work(page, server):
+async def test_async_stacks_should_work(page: Page, server: Server) -> None:
     await page.route(
         "**/empty.html", lambda route, response: asyncio.create_task(route.abort())
     )
     with pytest.raises(Error) as exc_info:
         await page.goto(server.EMPTY_PAGE)
+    assert exc_info.value.stack
     assert __file__ in exc_info.value.stack
 
 
-async def test_opener_should_provide_access_to_the_opener_page(page):
+async def test_opener_should_provide_access_to_the_opener_page(page: Page) -> None:
     async with page.expect_popup() as popup_info:
         await page.evaluate("window.open('about:blank')")
     popup = await popup_info.value
@@ -181,7 +199,9 @@ async def test_opener_should_provide_access_to_the_opener_page(page):
     assert opener == page
 
 
-async def test_opener_should_return_null_if_parent_page_has_been_closed(page):
+async def test_opener_should_return_null_if_parent_page_has_been_closed(
+    page: Page,
+) -> None:
     async with page.expect_popup() as popup_info:
         await page.evaluate("window.open('about:blank')")
     popup = await popup_info.value
@@ -190,14 +210,16 @@ async def test_opener_should_return_null_if_parent_page_has_been_closed(page):
     assert opener is None
 
 
-async def test_domcontentloaded_should_fire_when_expected(page, server):
+async def test_domcontentloaded_should_fire_when_expected(
+    page: Page, server: Server
+) -> None:
     future = asyncio.create_task(page.goto("about:blank"))
     async with page.expect_event("domcontentloaded"):
         pass
     await future
 
 
-async def test_wait_for_request(page, server):
+async def test_wait_for_request(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_request(server.PREFIX + "/digits/2.png") as request_info:
         await page.evaluate(
@@ -211,7 +233,9 @@ async def test_wait_for_request(page, server):
     assert request.url == server.PREFIX + "/digits/2.png"
 
 
-async def test_wait_for_request_should_work_with_predicate(page, server):
+async def test_wait_for_request_should_work_with_predicate(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_request(
         lambda request: request.url == server.PREFIX + "/digits/2.png"
@@ -227,14 +251,16 @@ async def test_wait_for_request_should_work_with_predicate(page, server):
     assert request.url == server.PREFIX + "/digits/2.png"
 
 
-async def test_wait_for_request_should_timeout(page, server):
+async def test_wait_for_request_should_timeout(page: Page, server: Server) -> None:
     with pytest.raises(Error) as exc_info:
         async with page.expect_event("request", timeout=1):
             pass
     assert exc_info.type is TimeoutError
 
 
-async def test_wait_for_request_should_respect_default_timeout(page, server):
+async def test_wait_for_request_should_respect_default_timeout(
+    page: Page, server: Server
+) -> None:
     page.set_default_timeout(1)
     with pytest.raises(Error) as exc_info:
         async with page.expect_event("request", lambda _: False):
@@ -242,7 +268,9 @@ async def test_wait_for_request_should_respect_default_timeout(page, server):
     assert exc_info.type is TimeoutError
 
 
-async def test_wait_for_request_should_work_with_no_timeout(page, server):
+async def test_wait_for_request_should_work_with_no_timeout(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_request(
         server.PREFIX + "/digits/2.png", timeout=0
@@ -258,7 +286,9 @@ async def test_wait_for_request_should_work_with_no_timeout(page, server):
     assert request.url == server.PREFIX + "/digits/2.png"
 
 
-async def test_wait_for_request_should_work_with_url_match(page, server):
+async def test_wait_for_request_should_work_with_url_match(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_request(re.compile(r"digits\/\d\.png")) as request_info:
         await page.evaluate("fetch('/digits/1.png')")
@@ -266,14 +296,16 @@ async def test_wait_for_request_should_work_with_url_match(page, server):
     assert request.url == server.PREFIX + "/digits/1.png"
 
 
-async def test_wait_for_event_should_fail_with_error_upon_disconnect(page):
+async def test_wait_for_event_should_fail_with_error_upon_disconnect(
+    page: Page,
+) -> None:
     with pytest.raises(Error) as exc_info:
         async with page.expect_download():
             await page.close()
     assert TARGET_CLOSED_ERROR_MESSAGE in exc_info.value.message
 
 
-async def test_wait_for_response_should_work(page, server):
+async def test_wait_for_response_should_work(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_response(server.PREFIX + "/digits/2.png") as response_info:
         await page.evaluate(
@@ -287,14 +319,14 @@ async def test_wait_for_response_should_work(page, server):
     assert response.url == server.PREFIX + "/digits/2.png"
 
 
-async def test_wait_for_response_should_respect_timeout(page):
+async def test_wait_for_response_should_respect_timeout(page: Page) -> None:
     with pytest.raises(Error) as exc_info:
         async with page.expect_response("**/*", timeout=1):
             pass
     assert exc_info.type is TimeoutError
 
 
-async def test_wait_for_response_should_respect_default_timeout(page):
+async def test_wait_for_response_should_respect_default_timeout(page: Page) -> None:
     page.set_default_timeout(1)
     with pytest.raises(Error) as exc_info:
         async with page.expect_response(lambda _: False):
@@ -302,7 +334,9 @@ async def test_wait_for_response_should_respect_default_timeout(page):
     assert exc_info.type is TimeoutError
 
 
-async def test_wait_for_response_should_work_with_predicate(page, server):
+async def test_wait_for_response_should_work_with_predicate(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_response(
         lambda response: response.url == server.PREFIX + "/digits/2.png"
@@ -318,7 +352,9 @@ async def test_wait_for_response_should_work_with_predicate(page, server):
     assert response.url == server.PREFIX + "/digits/2.png"
 
 
-async def test_wait_for_response_should_work_with_no_timeout(page, server):
+async def test_wait_for_response_should_work_with_no_timeout(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_response(server.PREFIX + "/digits/2.png") as response_info:
         await page.evaluate(
@@ -353,10 +389,10 @@ async def test_expect_response_should_not_hang_when_predicate_throws(
             raise Exception("Oops!")
 
 
-async def test_expose_binding(page):
+async def test_expose_binding(page: Page) -> None:
     binding_source = []
 
-    def binding(source, a, b):
+    def binding(source: Dict, a: int, b: int) -> int:
         binding_source.append(source)
         return a + b
 
@@ -370,14 +406,16 @@ def binding(source, a, b):
     assert result == 11
 
 
-async def test_expose_function(page, server):
+async def test_expose_function(page: Page, server: Server) -> None:
     await page.expose_function("compute", lambda a, b: a * b)
     result = await page.evaluate("compute(9, 4)")
     assert result == 36
 
 
-async def test_expose_function_should_throw_exception_in_page_context(page, server):
-    def throw():
+async def test_expose_function_should_throw_exception_in_page_context(
+    page: Page, server: Server
+) -> None:
+    def throw() -> None:
         raise Exception("WOOF WOOF")
 
     await page.expose_function("woof", lambda: throw())
@@ -394,7 +432,9 @@ def throw():
     assert __file__ in result["stack"]
 
 
-async def test_expose_function_should_be_callable_from_inside_add_init_script(page):
+async def test_expose_function_should_be_callable_from_inside_add_init_script(
+    page: Page,
+) -> None:
     called = []
     await page.expose_function("woof", lambda: called.append(True))
     await page.add_init_script("woof()")
@@ -402,52 +442,62 @@ async def test_expose_function_should_be_callable_from_inside_add_init_script(pa
     assert called == [True]
 
 
-async def test_expose_function_should_survive_navigation(page, server):
+async def test_expose_function_should_survive_navigation(
+    page: Page, server: Server
+) -> None:
     await page.expose_function("compute", lambda a, b: a * b)
     await page.goto(server.EMPTY_PAGE)
     result = await page.evaluate("compute(9, 4)")
     assert result == 36
 
 
-async def test_expose_function_should_await_returned_promise(page):
-    async def mul(a, b):
+async def test_expose_function_should_await_returned_promise(page: Page) -> None:
+    async def mul(a: int, b: int) -> int:
         return a * b
 
     await page.expose_function("compute", mul)
     assert await page.evaluate("compute(3, 5)") == 15
 
 
-async def test_expose_function_should_work_on_frames(page, server):
+async def test_expose_function_should_work_on_frames(
+    page: Page, server: Server
+) -> None:
     await page.expose_function("compute", lambda a, b: a * b)
     await page.goto(server.PREFIX + "/frames/nested-frames.html")
     frame = page.frames[1]
     assert await frame.evaluate("compute(3, 5)") == 15
 
 
-async def test_expose_function_should_work_on_frames_before_navigation(page, server):
+async def test_expose_function_should_work_on_frames_before_navigation(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/frames/nested-frames.html")
     await page.expose_function("compute", lambda a, b: a * b)
     frame = page.frames[1]
     assert await frame.evaluate("compute(3, 5)") == 15
 
 
-async def test_expose_function_should_work_after_cross_origin_navigation(page, server):
+async def test_expose_function_should_work_after_cross_origin_navigation(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.expose_function("compute", lambda a, b: a * b)
     await page.goto(server.CROSS_PROCESS_PREFIX + "/empty.html")
     assert await page.evaluate("compute(9, 4)") == 36
 
 
-async def test_expose_function_should_work_with_complex_objects(page, server):
+async def test_expose_function_should_work_with_complex_objects(
+    page: Page, server: Server
+) -> None:
     await page.expose_function("complexObject", lambda a, b: dict(x=a["x"] + b["x"]))
     result = await page.evaluate("complexObject({x: 5}, {x: 2})")
     assert result["x"] == 7
 
 
-async def test_expose_bindinghandle_should_work(page, server):
-    targets = []
+async def test_expose_bindinghandle_should_work(page: Page, server: Server) -> None:
+    targets: List[JSHandle] = []
 
-    def logme(t):
+    def logme(t: JSHandle) -> int:
         targets.append(t)
         return 17
 
@@ -457,7 +507,9 @@ def logme(t):
     assert result == 17
 
 
-async def test_page_error_should_fire(page, server, browser_name):
+async def test_page_error_should_fire(
+    page: Page, server: Server, browser_name: str
+) -> None:
     url = server.PREFIX + "/error.html"
     async with page.expect_event("pageerror") as error_info:
         await page.goto(url)
@@ -494,7 +546,7 @@ async def test_page_error_should_fire(page, server, browser_name):
         )
 
 
-async def test_page_error_should_handle_odd_values(page):
+async def test_page_error_should_handle_odd_values(page: Page) -> None:
     cases = [["null", "null"], ["undefined", "undefined"], ["0", "0"], ['""', ""]]
     for [value, message] in cases:
         async with page.expect_event("pageerror") as error_info:
@@ -503,21 +555,21 @@ async def test_page_error_should_handle_odd_values(page):
         assert error.message == message
 
 
-async def test_page_error_should_handle_object(page, is_chromium):
+async def test_page_error_should_handle_object(page: Page, is_chromium: bool) -> None:
     async with page.expect_event("pageerror") as error_info:
         await page.evaluate("() => setTimeout(() => { throw {}; }, 0)")
     error = await error_info.value
     assert error.message == "Object" if is_chromium else "[object Object]"
 
 
-async def test_page_error_should_handle_window(page, is_chromium):
+async def test_page_error_should_handle_window(page: Page, is_chromium: bool) -> None:
     async with page.expect_event("pageerror") as error_info:
         await page.evaluate("() => setTimeout(() => { throw window; }, 0)")
     error = await error_info.value
     assert error.message == "Window" if is_chromium else "[object Window]"
 
 
-async def test_page_error_should_pass_error_name_property(page):
+async def test_page_error_should_pass_error_name_property(page: Page) -> None:
     async with page.expect_event("pageerror") as error_info:
         await page.evaluate(
             """() => setTimeout(() => {
@@ -535,33 +587,37 @@ async def test_page_error_should_pass_error_name_property(page):
 expected_output = "<html><head></head><body><div>hello</div></body></html>"
 
 
-async def test_set_content_should_work(page, server):
+async def test_set_content_should_work(page: Page, server: Server) -> None:
     await page.set_content("<div>hello</div>")
     result = await page.content()
     assert result == expected_output
 
 
-async def test_set_content_should_work_with_domcontentloaded(page, server):
+async def test_set_content_should_work_with_domcontentloaded(
+    page: Page, server: Server
+) -> None:
     await page.set_content("<div>hello</div>", wait_until="domcontentloaded")
     result = await page.content()
     assert result == expected_output
 
 
-async def test_set_content_should_work_with_doctype(page, server):
+async def test_set_content_should_work_with_doctype(page: Page, server: Server) -> None:
     doctype = "<!DOCTYPE html>"
     await page.set_content(f"{doctype}<div>hello</div>")
     result = await page.content()
     assert result == f"{doctype}{expected_output}"
 
 
-async def test_set_content_should_work_with_HTML_4_doctype(page, server):
+async def test_set_content_should_work_with_HTML_4_doctype(
+    page: Page, server: Server
+) -> None:
     doctype = '<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">'
     await page.set_content(f"{doctype}<div>hello</div>")
     result = await page.content()
     assert result == f"{doctype}{expected_output}"
 
 
-async def test_set_content_should_respect_timeout(page, server):
+async def test_set_content_should_respect_timeout(page: Page, server: Server) -> None:
     img_path = "/img.png"
     # stall for image
     server.set_route(img_path, lambda request: None)
@@ -572,7 +628,9 @@ async def test_set_content_should_respect_timeout(page, server):
     assert exc_info.type is TimeoutError
 
 
-async def test_set_content_should_respect_default_navigation_timeout(page, server):
+async def test_set_content_should_respect_default_navigation_timeout(
+    page: Page, server: Server
+) -> None:
     page.set_default_navigation_timeout(1)
     img_path = "/img.png"
     # stall for image
@@ -584,12 +642,14 @@ async def test_set_content_should_respect_default_navigation_timeout(page, serve
     assert exc_info.type is TimeoutError
 
 
-async def test_set_content_should_await_resources_to_load(page, server):
-    img_route = asyncio.Future()
+async def test_set_content_should_await_resources_to_load(
+    page: Page, server: Server
+) -> None:
+    img_route: "asyncio.Future[Route]" = asyncio.Future()
     await page.route("**/img.png", lambda route, request: img_route.set_result(route))
     loaded = []
 
-    async def load():
+    async def load() -> None:
         await page.set_content(f'<img src="{server.PREFIX}/img.png"></img>')
         loaded.append(True)
 
@@ -601,49 +661,55 @@ async def load():
     await content_promise
 
 
-async def test_set_content_should_work_with_tricky_content(page):
+async def test_set_content_should_work_with_tricky_content(page: Page) -> None:
     await page.set_content("<div>hello world</div>" + "\x7F")
     assert await page.eval_on_selector("div", "div => div.textContent") == "hello world"
 
 
-async def test_set_content_should_work_with_accents(page):
+async def test_set_content_should_work_with_accents(page: Page) -> None:
     await page.set_content("<div>aberración</div>")
     assert await page.eval_on_selector("div", "div => div.textContent") == "aberración"
 
 
-async def test_set_content_should_work_with_emojis(page):
+async def test_set_content_should_work_with_emojis(page: Page) -> None:
     await page.set_content("<div>🐥</div>")
     assert await page.eval_on_selector("div", "div => div.textContent") == "🐥"
 
 
-async def test_set_content_should_work_with_newline(page):
+async def test_set_content_should_work_with_newline(page: Page) -> None:
     await page.set_content("<div>\n</div>")
     assert await page.eval_on_selector("div", "div => div.textContent") == "\n"
 
 
-async def test_add_script_tag_should_work_with_a_url(page, server):
+async def test_add_script_tag_should_work_with_a_url(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     script_handle = await page.add_script_tag(url="/injectedfile.js")
     assert script_handle.as_element()
     assert await page.evaluate("__injected") == 42
 
 
-async def test_add_script_tag_should_work_with_a_url_and_type_module(page, server):
+async def test_add_script_tag_should_work_with_a_url_and_type_module(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.add_script_tag(url="/es6/es6import.js", type="module")
     assert await page.evaluate("__es6injected") == 42
 
 
 async def test_add_script_tag_should_work_with_a_path_and_type_module(
-    page, server, assetdir
-):
+    page: Page, server: Server, assetdir: Path
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.add_script_tag(path=assetdir / "es6" / "es6pathimport.js", type="module")
     await page.wait_for_function("window.__es6injected")
     assert await page.evaluate("__es6injected") == 42
 
 
-async def test_add_script_tag_should_work_with_a_content_and_type_module(page, server):
+async def test_add_script_tag_should_work_with_a_content_and_type_module(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.add_script_tag(
         content="import num from '/es6/es6module.js';window.__es6injected = num;",
@@ -654,15 +720,17 @@ async def test_add_script_tag_should_work_with_a_content_and_type_module(page, s
 
 
 async def test_add_script_tag_should_throw_an_error_if_loading_from_url_fail(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     with pytest.raises(Error) as exc_info:
         await page.add_script_tag(url="/nonexistfile.js")
     assert exc_info.value
 
 
-async def test_add_script_tag_should_work_with_a_path(page, server, assetdir):
+async def test_add_script_tag_should_work_with_a_path(
+    page: Page, server: Server, assetdir: Path
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     script_handle = await page.add_script_tag(path=assetdir / "injectedfile.js")
     assert script_handle.as_element()
@@ -671,8 +739,8 @@ async def test_add_script_tag_should_work_with_a_path(page, server, assetdir):
 
 @pytest.mark.skip_browser("webkit")
 async def test_add_script_tag_should_include_source_url_when_path_is_provided(
-    page, server, assetdir
-):
+    page: Page, server: Server, assetdir: Path
+) -> None:
     # Lacking sourceURL support in WebKit
     await page.goto(server.EMPTY_PAGE)
     await page.add_script_tag(path=assetdir / "injectedfile.js")
@@ -680,7 +748,9 @@ async def test_add_script_tag_should_include_source_url_when_path_is_provided(
     assert os.path.join("assets", "injectedfile.js") in result
 
 
-async def test_add_script_tag_should_work_with_content(page, server):
+async def test_add_script_tag_should_work_with_content(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     script_handle = await page.add_script_tag(content="window.__injected = 35;")
     assert script_handle.as_element()
@@ -689,8 +759,8 @@ async def test_add_script_tag_should_work_with_content(page, server):
 
 @pytest.mark.skip_browser("firefox")
 async def test_add_script_tag_should_throw_when_added_with_content_to_the_csp_page(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     # Firefox fires onload for blocked script before it issues the CSP console error.
     await page.goto(server.PREFIX + "/csp.html")
     with pytest.raises(Error) as exc_info:
@@ -699,8 +769,8 @@ async def test_add_script_tag_should_throw_when_added_with_content_to_the_csp_pa
 
 
 async def test_add_script_tag_should_throw_when_added_with_URL_to_the_csp_page(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/csp.html")
     with pytest.raises(Error) as exc_info:
         await page.add_script_tag(url=server.CROSS_PROCESS_PREFIX + "/injectedfile.js")
@@ -708,8 +778,8 @@ async def test_add_script_tag_should_throw_when_added_with_URL_to_the_csp_page(
 
 
 async def test_add_script_tag_should_throw_a_nice_error_when_the_request_fails(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     url = server.PREFIX + "/this_does_not_exist.js"
     with pytest.raises(Error) as exc_info:
@@ -717,7 +787,7 @@ async def test_add_script_tag_should_throw_a_nice_error_when_the_request_fails(
     assert url in exc_info.value.message
 
 
-async def test_add_style_tag_should_work_with_a_url(page, server):
+async def test_add_style_tag_should_work_with_a_url(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     style_handle = await page.add_style_tag(url="/injectedstyle.css")
     assert style_handle.as_element()
@@ -730,15 +800,17 @@ async def test_add_style_tag_should_work_with_a_url(page, server):
 
 
 async def test_add_style_tag_should_throw_an_error_if_loading_from_url_fail(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     with pytest.raises(Error) as exc_info:
         await page.add_style_tag(url="/nonexistfile.js")
     assert exc_info.value
 
 
-async def test_add_style_tag_should_work_with_a_path(page, server, assetdir):
+async def test_add_style_tag_should_work_with_a_path(
+    page: Page, server: Server, assetdir: Path
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     style_handle = await page.add_style_tag(path=assetdir / "injectedstyle.css")
     assert style_handle.as_element()
@@ -751,8 +823,8 @@ async def test_add_style_tag_should_work_with_a_path(page, server, assetdir):
 
 
 async def test_add_style_tag_should_include_source_url_when_path_is_provided(
-    page, server, assetdir
-):
+    page: Page, server: Server, assetdir: Path
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.add_style_tag(path=assetdir / "injectedstyle.css")
     style_handle = await page.query_selector("style")
@@ -760,7 +832,9 @@ async def test_add_style_tag_should_include_source_url_when_path_is_provided(
     assert os.path.join("assets", "injectedstyle.css") in style_content
 
 
-async def test_add_style_tag_should_work_with_content(page, server):
+async def test_add_style_tag_should_work_with_content(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     style_handle = await page.add_style_tag(content="body { background-color: green; }")
     assert style_handle.as_element()
@@ -773,8 +847,8 @@ async def test_add_style_tag_should_work_with_content(page, server):
 
 
 async def test_add_style_tag_should_throw_when_added_with_content_to_the_CSP_page(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/csp.html")
     with pytest.raises(Error) as exc_info:
         await page.add_style_tag(content="body { background-color: green; }")
@@ -782,52 +856,54 @@ async def test_add_style_tag_should_throw_when_added_with_content_to_the_CSP_pag
 
 
 async def test_add_style_tag_should_throw_when_added_with_URL_to_the_CSP_page(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/csp.html")
     with pytest.raises(Error) as exc_info:
         await page.add_style_tag(url=server.CROSS_PROCESS_PREFIX + "/injectedstyle.css")
     assert exc_info.value
 
 
-async def test_url_should_work(page, server):
+async def test_url_should_work(page: Page, server: Server) -> None:
     assert page.url == "about:blank"
     await page.goto(server.EMPTY_PAGE)
     assert page.url == server.EMPTY_PAGE
 
 
-async def test_url_should_include_hashes(page, server):
+async def test_url_should_include_hashes(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE + "#hash")
     assert page.url == server.EMPTY_PAGE + "#hash"
     await page.evaluate("window.location.hash = 'dynamic'")
     assert page.url == server.EMPTY_PAGE + "#dynamic"
 
 
-async def test_title_should_return_the_page_title(page, server):
+async def test_title_should_return_the_page_title(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/title.html")
     assert await page.title() == "Woof-Woof"
 
 
-async def give_it_a_chance_to_fill(page):
+async def give_it_a_chance_to_fill(page: Page) -> None:
     for i in range(5):
         await page.evaluate(
             "() => new Promise(f => requestAnimationFrame(() => requestAnimationFrame(f)))"
         )
 
 
-async def test_fill_should_fill_textarea(page, server):
+async def test_fill_should_fill_textarea(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.fill("textarea", "some value")
     assert await page.evaluate("result") == "some value"
 
 
-async def test_fill_should_fill_input(page, server):
+async def test_fill_should_fill_input(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.fill("input", "some value")
     assert await page.evaluate("result") == "some value"
 
 
-async def test_fill_should_throw_on_unsupported_inputs(page, server):
+async def test_fill_should_throw_on_unsupported_inputs(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     for type in [
         "button",
@@ -846,7 +922,9 @@ async def test_fill_should_throw_on_unsupported_inputs(page, server):
         assert f'Input of type "{type}" cannot be filled' in exc_info.value.message
 
 
-async def test_fill_should_fill_different_input_types(page, server):
+async def test_fill_should_fill_different_input_types(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     for type in ["password", "search", "tel", "text", "url"]:
         await page.eval_on_selector(
@@ -856,7 +934,9 @@ async def test_fill_should_fill_different_input_types(page, server):
         assert await page.evaluate("result") == "text " + type
 
 
-async def test_fill_should_fill_date_input_after_clicking(page, server):
+async def test_fill_should_fill_date_input_after_clicking(
+    page: Page, server: Server
+) -> None:
     await page.set_content("<input type=date>")
     await page.click("input")
     await page.fill("input", "2020-03-02")
@@ -864,7 +944,7 @@ async def test_fill_should_fill_date_input_after_clicking(page, server):
 
 
 @pytest.mark.skip_browser("webkit")
-async def test_fill_should_throw_on_incorrect_date(page, server):
+async def test_fill_should_throw_on_incorrect_date(page: Page, server: Server) -> None:
     # Disabled as in upstream, we should validate time in the Playwright lib
     await page.set_content("<input type=date>")
     with pytest.raises(Error) as exc_info:
@@ -872,14 +952,14 @@ async def test_fill_should_throw_on_incorrect_date(page, server):
     assert "Malformed value" in exc_info.value.message
 
 
-async def test_fill_should_fill_time_input(page, server):
+async def test_fill_should_fill_time_input(page: Page, server: Server) -> None:
     await page.set_content("<input type=time>")
     await page.fill("input", "13:15")
     assert await page.eval_on_selector("input", "input => input.value") == "13:15"
 
 
 @pytest.mark.skip_browser("webkit")
-async def test_fill_should_throw_on_incorrect_time(page, server):
+async def test_fill_should_throw_on_incorrect_time(page: Page, server: Server) -> None:
     # Disabled as in upstream, we should validate time in the Playwright lib
     await page.set_content("<input type=time>")
     with pytest.raises(Error) as exc_info:
@@ -887,7 +967,9 @@ async def test_fill_should_throw_on_incorrect_time(page, server):
     assert "Malformed value" in exc_info.value.message
 
 
-async def test_fill_should_fill_datetime_local_input(page, server):
+async def test_fill_should_fill_datetime_local_input(
+    page: Page, server: Server
+) -> None:
     await page.set_content("<input type=datetime-local>")
     await page.fill("input", "2020-03-02T05:15")
     assert (
@@ -897,14 +979,14 @@ async def test_fill_should_fill_datetime_local_input(page, server):
 
 
 @pytest.mark.only_browser("chromium")
-async def test_fill_should_throw_on_incorrect_datetime_local(page):
+async def test_fill_should_throw_on_incorrect_datetime_local(page: Page) -> None:
     await page.set_content("<input type=datetime-local>")
     with pytest.raises(Error) as exc_info:
         await page.fill("input", "abc")
     assert "Malformed value" in exc_info.value.message
 
 
-async def test_fill_should_fill_contenteditable(page, server):
+async def test_fill_should_fill_contenteditable(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.fill("div[contenteditable]", "some value")
     assert (
@@ -914,8 +996,8 @@ async def test_fill_should_fill_contenteditable(page, server):
 
 
 async def test_fill_should_fill_elements_with_existing_value_and_selection(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
 
     await page.eval_on_selector("input", "input => input.value = 'value one'")
@@ -953,27 +1035,31 @@ async def test_fill_should_fill_elements_with_existing_value_and_selection(
 
 
 async def test_fill_should_throw_when_element_is_not_an_input_textarea_or_contenteditable(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     with pytest.raises(Error) as exc_info:
         await page.fill("body", "")
     assert "Element is not an <input>" in exc_info.value.message
 
 
-async def test_fill_should_throw_if_passed_a_non_string_value(page, server):
+async def test_fill_should_throw_if_passed_a_non_string_value(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     with pytest.raises(Error) as exc_info:
-        await page.fill("textarea", 123)
+        await page.fill("textarea", 123)  # type: ignore
     assert "expected string, got number" in exc_info.value.message
 
 
-async def test_fill_should_retry_on_disabled_element(page, server):
+async def test_fill_should_retry_on_disabled_element(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.eval_on_selector("input", "i => i.disabled = true")
     done = []
 
-    async def fill():
+    async def fill() -> None:
         await page.fill("input", "some value")
         done.append(True)
 
@@ -987,12 +1073,14 @@ async def fill():
     assert await page.evaluate("result") == "some value"
 
 
-async def test_fill_should_retry_on_readonly_element(page, server):
+async def test_fill_should_retry_on_readonly_element(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.eval_on_selector("textarea", "i => i.readOnly = true")
     done = []
 
-    async def fill():
+    async def fill() -> None:
         await page.fill("textarea", "some value")
         done.append(True)
 
@@ -1006,12 +1094,14 @@ async def fill():
     assert await page.evaluate("result") == "some value"
 
 
-async def test_fill_should_retry_on_invisible_element(page, server):
+async def test_fill_should_retry_on_invisible_element(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.eval_on_selector("input", "i => i.style.display = 'none'")
     done = []
 
-    async def fill():
+    async def fill() -> None:
         await page.fill("input", "some value")
         done.append(True)
 
@@ -1025,19 +1115,21 @@ async def fill():
     assert await page.evaluate("result") == "some value"
 
 
-async def test_fill_should_be_able_to_fill_the_body(page):
+async def test_fill_should_be_able_to_fill_the_body(page: Page) -> None:
     await page.set_content('<body contentEditable="true"></body>')
     await page.fill("body", "some value")
     assert await page.evaluate("document.body.textContent") == "some value"
 
 
-async def test_fill_should_fill_fixed_position_input(page):
+async def test_fill_should_fill_fixed_position_input(page: Page) -> None:
     await page.set_content('<input style="position: fixed;" />')
     await page.fill("input", "some value")
     assert await page.evaluate("document.querySelector('input').value") == "some value"
 
 
-async def test_fill_should_be_able_to_fill_when_focus_is_in_the_wrong_frame(page):
+async def test_fill_should_be_able_to_fill_when_focus_is_in_the_wrong_frame(
+    page: Page,
+) -> None:
     await page.set_content(
         """
       <div contentEditable="true"></div>
@@ -1049,32 +1141,40 @@ async def test_fill_should_be_able_to_fill_when_focus_is_in_the_wrong_frame(page
     assert await page.eval_on_selector("div", "d => d.textContent") == "some value"
 
 
-async def test_fill_should_be_able_to_fill_the_input_type_number_(page):
+async def test_fill_should_be_able_to_fill_the_input_type_number_(page: Page) -> None:
     await page.set_content('<input id="input" type="number"></input>')
     await page.fill("input", "42")
     assert await page.evaluate("input.value") == "42"
 
 
-async def test_fill_should_be_able_to_fill_exponent_into_the_input_type_number_(page):
+async def test_fill_should_be_able_to_fill_exponent_into_the_input_type_number_(
+    page: Page,
+) -> None:
     await page.set_content('<input id="input" type="number"></input>')
     await page.fill("input", "-10e5")
     assert await page.evaluate("input.value") == "-10e5"
 
 
-async def test_fill_should_be_able_to_fill_input_type_number__with_empty_string(page):
+async def test_fill_should_be_able_to_fill_input_type_number__with_empty_string(
+    page: Page,
+) -> None:
     await page.set_content('<input id="input" type="number" value="123"></input>')
     await page.fill("input", "")
     assert await page.evaluate("input.value") == ""
 
 
-async def test_fill_should_not_be_able_to_fill_text_into_the_input_type_number_(page):
+async def test_fill_should_not_be_able_to_fill_text_into_the_input_type_number_(
+    page: Page,
+) -> None:
     await page.set_content('<input id="input" type="number"></input>')
     with pytest.raises(Error) as exc_info:
         await page.fill("input", "abc")
     assert "Cannot type text into input[type=number]" in exc_info.value.message
 
 
-async def test_fill_should_be_able_to_clear_using_fill(page, server):
+async def test_fill_should_be_able_to_clear_using_fill(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.fill("input", "some value")
     assert await page.evaluate("result") == "some value"
@@ -1082,7 +1182,9 @@ async def test_fill_should_be_able_to_clear_using_fill(page, server):
     assert await page.evaluate("result") == ""
 
 
-async def test_close_event_should_work_with_window_close(page, server):
+async def test_close_event_should_work_with_window_close(
+    page: Page, server: Server
+) -> None:
     async with page.expect_popup() as popup_info:
         await page.evaluate("window['newPage'] = window.open('about:blank')")
     popup = await popup_info.value
@@ -1091,17 +1193,21 @@ async def test_close_event_should_work_with_window_close(page, server):
         await page.evaluate("window['newPage'].close()")
 
 
-async def test_close_event_should_work_with_page_close(context, server):
+async def test_close_event_should_work_with_page_close(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     async with page.expect_event("close"):
         await page.close()
 
 
-async def test_page_context_should_return_the_correct_browser_instance(page, context):
+async def test_page_context_should_return_the_correct_browser_instance(
+    page: Page, context: BrowserContext
+) -> None:
     assert page.context == context
 
 
-async def test_frame_should_respect_name(page, server):
+async def test_frame_should_respect_name(page: Page, server: Server) -> None:
     await page.set_content("<iframe name=target></iframe>")
     assert page.frame(name="bogus") is None
     frame = page.frame(name="target")
@@ -1109,28 +1215,29 @@ async def test_frame_should_respect_name(page, server):
     assert frame == page.main_frame.child_frames[0]
 
 
-async def test_frame_should_respect_url(page, server):
+async def test_frame_should_respect_url(page: Page, server: Server) -> None:
     await page.set_content(f'<iframe src="{server.EMPTY_PAGE}"></iframe>')
     assert page.frame(url=re.compile(r"bogus")) is None
-    assert page.frame(url=re.compile(r"empty")).url == server.EMPTY_PAGE
+    assert must(page.frame(url=re.compile(r"empty"))).url == server.EMPTY_PAGE
 
 
-async def test_press_should_work(page, server):
+async def test_press_should_work(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     await page.press("textarea", "a")
     assert await page.evaluate("document.querySelector('textarea').value") == "a"
 
 
-async def test_frame_press_should_work(page, server):
+async def test_frame_press_should_work(page: Page, server: Server) -> None:
     await page.set_content(
         f'<iframe name=inner src="{server.PREFIX}/input/textarea.html"></iframe>'
     )
     frame = page.frame("inner")
+    assert frame
     await frame.press("textarea", "a")
     assert await frame.evaluate("document.querySelector('textarea').value") == "a"
 
 
-async def test_should_emulate_reduced_motion(page, server):
+async def test_should_emulate_reduced_motion(page: Page, server: Server) -> None:
     assert await page.evaluate(
         "matchMedia('(prefers-reduced-motion: no-preference)').matches"
     )
@@ -1148,7 +1255,7 @@ async def test_should_emulate_reduced_motion(page, server):
     )
 
 
-async def test_input_value(page: Page, server: Server):
+async def test_input_value(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
 
     await page.fill("input", "my-text-content")
@@ -1158,7 +1265,7 @@ async def test_input_value(page: Page, server: Server):
     assert await page.input_value("input") == ""
 
 
-async def test_drag_and_drop_helper_method(page: Page, server: Server):
+async def test_drag_and_drop_helper_method(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/drag-n-drop.html")
     await page.drag_and_drop("#source", "#target")
     assert (
@@ -1169,7 +1276,7 @@ async def test_drag_and_drop_helper_method(page: Page, server: Server):
     )
 
 
-async def test_drag_and_drop_with_position(page: Page, server: Server):
+async def test_drag_and_drop_with_position(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
         """
@@ -1213,7 +1320,7 @@ async def test_drag_and_drop_with_position(page: Page, server: Server):
     ]
 
 
-async def test_should_check_box_using_set_checked(page: Page):
+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)
     assert await page.evaluate("checkbox.checked") is True
@@ -1221,7 +1328,7 @@ async def test_should_check_box_using_set_checked(page: Page):
     assert await page.evaluate("checkbox.checked") is False
 
 
-async def test_should_set_bodysize_and_headersize(page: Page, server: Server):
+async def test_should_set_bodysize_and_headersize(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_request("*/**") as request_info:
         await page.evaluate(
@@ -1233,7 +1340,7 @@ async def test_should_set_bodysize_and_headersize(page: Page, server: Server):
     assert sizes["requestHeadersSize"] >= 300
 
 
-async def test_should_set_bodysize_to_0(page: Page, server: Server):
+async def test_should_set_bodysize_to_0(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_request("*/**") as request_info:
         await page.evaluate("() => fetch('./get').then(r => r.text())")
@@ -1244,7 +1351,7 @@ async def test_should_set_bodysize_to_0(page: Page, server: Server):
 
 
 @pytest.mark.skip_browser("webkit")  # https://bugs.webkit.org/show_bug.cgi?id=225281
-async def test_should_emulate_forced_colors(page):
+async def test_should_emulate_forced_colors(page: Page) -> None:
     assert await page.evaluate("matchMedia('(forced-colors: none)').matches")
     await page.emulate_media(forced_colors="none")
     assert await page.evaluate("matchMedia('(forced-colors: none)').matches")
@@ -1256,8 +1363,8 @@ async def test_should_emulate_forced_colors(page):
 
 async def test_should_not_throw_when_continuing_while_page_is_closing(
     page: Page, server: Server
-):
-    done = None
+) -> None:
+    done: Optional[asyncio.Future] = None
 
     def handle_route(route: Route) -> None:
         nonlocal done
@@ -1266,13 +1373,13 @@ def handle_route(route: Route) -> None:
     await page.route("**/*", handle_route)
     with pytest.raises(Error):
         await page.goto(server.EMPTY_PAGE)
-    await done
+    await must(done)
 
 
 async def test_should_not_throw_when_continuing_after_page_is_closed(
     page: Page, server: Server
-):
-    done = asyncio.Future()
+) -> None:
+    done: "asyncio.Future[bool]" = asyncio.Future()
 
     async def handle_route(route: Route) -> None:
         await page.close()
@@ -1286,10 +1393,10 @@ async def handle_route(route: Route) -> None:
     await done
 
 
-async def test_expose_binding_should_serialize_cycles(page: Page):
+async def test_expose_binding_should_serialize_cycles(page: Page) -> None:
     binding_values = []
 
-    def binding(source, o):
+    def binding(source: Dict, o: Dict) -> None:
         binding_values.append(o)
 
     await page.expose_binding("log", lambda source, o: binding(source, o))
@@ -1304,7 +1411,7 @@ async def test_page_pause_should_reset_default_timeouts(
         pytest.skip()
 
     await page.goto(server.EMPTY_PAGE)
-    page.pause()
+    await page.pause()
     with pytest.raises(Error, match="Timeout 30000ms exceeded."):
         await page.get_by_text("foo").click()
 
@@ -1318,7 +1425,7 @@ async def test_page_pause_should_reset_custom_timeouts(
     page.set_default_timeout(123)
     page.set_default_navigation_timeout(456)
     await page.goto(server.EMPTY_PAGE)
-    page.pause()
+    await page.pause()
     with pytest.raises(Error, match="Timeout 123ms exceeded."):
         await page.get_by_text("foo").click()
 
diff --git a/tests/async/test_page_base_url.py b/tests/async/test_page_base_url.py
index 11d0349b2..ab917b248 100644
--- a/tests/async/test_page_base_url.py
+++ b/tests/async/test_page_base_url.py
@@ -12,69 +12,77 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from pathlib import Path
+from typing import Dict
+
 from playwright.async_api import Browser, BrowserType
 from tests.server import Server
+from tests.utils import must
 
 
 async def test_should_construct_a_new_url_when_a_base_url_in_browser_new_context_is_passed(
     browser: Browser, server: Server
-):
+) -> None:
     context = await browser.new_context(base_url=server.PREFIX)
     page = await context.new_page()
-    assert (await page.goto("/empty.html")).url == server.EMPTY_PAGE
+    assert (must(await page.goto("/empty.html"))).url == server.EMPTY_PAGE
     await context.close()
 
 
 async def test_should_construct_a_new_url_when_a_base_url_in_browser_new_page_is_passed(
     browser: Browser, server: Server
-):
+) -> None:
     page = await browser.new_page(base_url=server.PREFIX)
-    assert (await page.goto("/empty.html")).url == server.EMPTY_PAGE
+    assert (must(await page.goto("/empty.html"))).url == server.EMPTY_PAGE
     await page.close()
 
 
 async def test_should_construct_a_new_url_when_a_base_url_in_browser_new_persistent_context_is_passed(
-    browser_type: BrowserType, tmpdir, server: Server, launch_arguments
-):
+    browser_type: BrowserType, tmpdir: Path, server: Server, launch_arguments: Dict
+) -> None:
     context = await browser_type.launch_persistent_context(
         tmpdir, **launch_arguments, base_url=server.PREFIX
     )
     page = await context.new_page()
-    assert (await page.goto("/empty.html")).url == server.EMPTY_PAGE
+    assert (must(await page.goto("/empty.html"))).url == server.EMPTY_PAGE
     await context.close()
 
 
 async def test_should_construct_correctly_when_a_baseurl_without_a_trailing_slash_is_passed(
     browser: Browser, server: Server
-):
+) -> None:
     page = await browser.new_page(base_url=server.PREFIX + "/url-construction")
-    assert (await page.goto("mypage.html")).url == server.PREFIX + "/mypage.html"
-    assert (await page.goto("./mypage.html")).url == server.PREFIX + "/mypage.html"
-    assert (await page.goto("/mypage.html")).url == server.PREFIX + "/mypage.html"
+    assert (must(await page.goto("mypage.html"))).url == server.PREFIX + "/mypage.html"
+    assert (
+        must(await page.goto("./mypage.html"))
+    ).url == server.PREFIX + "/mypage.html"
+    assert (must(await page.goto("/mypage.html"))).url == server.PREFIX + "/mypage.html"
     await page.close()
 
 
 async def test_should_construct_correctly_when_a_baseurl_with_a_trailing_slash_is_passed(
     browser: Browser, server: Server
-):
+) -> None:
     page = await browser.new_page(base_url=server.PREFIX + "/url-construction/")
     assert (
-        await page.goto("mypage.html")
+        must(await page.goto("mypage.html"))
     ).url == server.PREFIX + "/url-construction/mypage.html"
     assert (
-        await page.goto("./mypage.html")
+        must(await page.goto("./mypage.html"))
     ).url == server.PREFIX + "/url-construction/mypage.html"
-    assert (await page.goto("/mypage.html")).url == server.PREFIX + "/mypage.html"
-    assert (await page.goto(".")).url == server.PREFIX + "/url-construction/"
-    assert (await page.goto("/")).url == server.PREFIX + "/"
+    assert (must(await page.goto("/mypage.html"))).url == server.PREFIX + "/mypage.html"
+    assert (must(await page.goto("."))).url == server.PREFIX + "/url-construction/"
+    assert (must(await page.goto("/"))).url == server.PREFIX + "/"
     await page.close()
 
 
 async def test_should_not_construct_a_new_url_when_valid_urls_are_passed(
     browser: Browser, server: Server
-):
+) -> None:
     page = await browser.new_page(base_url="http://microsoft.com")
-    assert (await page.goto(server.EMPTY_PAGE)).url == server.EMPTY_PAGE
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response
+    assert response.url == server.EMPTY_PAGE
 
     await page.goto("data:text/html,Hello world")
     assert page.url == "data:text/html,Hello world"
@@ -87,7 +95,7 @@ async def test_should_not_construct_a_new_url_when_valid_urls_are_passed(
 
 async def test_should_be_able_to_match_a_url_relative_to_its_given_url_with_urlmatcher(
     browser: Browser, server: Server
-):
+) -> None:
     page = await browser.new_page(base_url=server.PREFIX + "/foobar/")
 
     await page.goto("/kek/index.html")
diff --git a/tests/async/test_page_network_request.py b/tests/async/test_page_network_request.py
index f2a1383ba..375342ae8 100644
--- a/tests/async/test_page_network_request.py
+++ b/tests/async/test_page_network_request.py
@@ -22,7 +22,7 @@
 
 async def test_should_not_allow_to_access_frame_on_popup_main_request(
     page: Page, server: Server
-):
+) -> None:
     await page.set_content(f'<a target=_blank href="{server.EMPTY_PAGE}">click me</a>')
     request_promise = asyncio.ensure_future(page.context.wait_for_event("request"))
     popup_promise = asyncio.ensure_future(page.context.wait_for_event("page"))
@@ -38,6 +38,7 @@ async def test_should_not_allow_to_access_frame_on_popup_main_request(
     )
 
     response = await request.response()
+    assert response
     await response.finished()
     await popup_promise
     await clicked
diff --git a/tests/async/test_page_network_response.py b/tests/async/test_page_network_response.py
index 52dd6e64a..98f4aaa42 100644
--- a/tests/async/test_page_network_response.py
+++ b/tests/async/test_page_network_response.py
@@ -16,7 +16,7 @@
 
 import pytest
 
-from playwright.async_api import Page
+from playwright.async_api import Error, Page
 from tests.server import HttpRequestWithPostBody, Server
 
 
@@ -25,7 +25,7 @@ async def test_should_reject_response_finished_if_page_closes(
 ) -> None:
     await page.goto(server.EMPTY_PAGE)
 
-    def handle_get(request: HttpRequestWithPostBody):
+    def handle_get(request: HttpRequestWithPostBody) -> None:
         # In Firefox, |fetch| will be hanging until it receives |Content-Type| header
         # from server.
         request.setHeader("Content-Type", "text/plain; charset=utf-8")
@@ -40,7 +40,7 @@ def handle_get(request: HttpRequestWithPostBody):
 
     finish_coroutine = page_response.finished()
     await page.close()
-    with pytest.raises(Exception) as exc_info:
+    with pytest.raises(Error) as exc_info:
         await finish_coroutine
     error = exc_info.value
     assert "closed" in error.message
@@ -51,7 +51,7 @@ async def test_should_reject_response_finished_if_context_closes(
 ) -> None:
     await page.goto(server.EMPTY_PAGE)
 
-    def handle_get(request: HttpRequestWithPostBody):
+    def handle_get(request: HttpRequestWithPostBody) -> None:
         # In Firefox, |fetch| will be hanging until it receives |Content-Type| header
         # from server.
         request.setHeader("Content-Type", "text/plain; charset=utf-8")
@@ -66,7 +66,7 @@ def handle_get(request: HttpRequestWithPostBody):
 
     finish_coroutine = page_response.finished()
     await page.context.close()
-    with pytest.raises(Exception) as exc_info:
+    with pytest.raises(Error) as exc_info:
         await finish_coroutine
     error = exc_info.value
     assert "closed" in error.message
diff --git a/tests/async/test_page_request_fallback.py b/tests/async/test_page_request_fallback.py
index 0102655de..199e072e6 100644
--- a/tests/async/test_page_request_fallback.py
+++ b/tests/async/test_page_request_fallback.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import asyncio
+from typing import Any, Callable, Coroutine, cast
 
 import pytest
 
@@ -27,27 +28,24 @@ async def test_should_work(page: Page, server: Server) -> None:
 
 async def test_should_fall_back(page: Page, server: Server) -> None:
     intercepted = []
-    await page.route(
-        "**/empty.html",
-        lambda route: (
-            intercepted.append(1),
-            asyncio.create_task(route.fallback()),
-        ),
-    )
-    await page.route(
-        "**/empty.html",
-        lambda route: (
-            intercepted.append(2),
-            asyncio.create_task(route.fallback()),
-        ),
-    )
-    await page.route(
-        "**/empty.html",
-        lambda route: (
-            intercepted.append(3),
-            asyncio.create_task(route.fallback()),
-        ),
-    )
+
+    def _handler1(route: Route) -> None:
+        intercepted.append(1)
+        asyncio.create_task(route.fallback())
+
+    await page.route("**/empty.html", _handler1)
+
+    def _handler2(route: Route) -> None:
+        intercepted.append(2)
+        asyncio.create_task(route.fallback())
+
+    await page.route("**/empty.html", _handler2)
+
+    def _handler3(route: Route) -> None:
+        intercepted.append(3)
+        asyncio.create_task(route.fallback())
+
+    await page.route("**/empty.html", _handler3)
 
     await page.goto(server.EMPTY_PAGE)
     assert intercepted == [3, 2, 1]
@@ -56,8 +54,8 @@ async def test_should_fall_back(page: Page, server: Server) -> None:
 async def test_should_fall_back_async_delayed(page: Page, server: Server) -> None:
     intercepted = []
 
-    def create_handler(i: int):
-        async def handler(route):
+    def create_handler(i: int) -> Callable[[Route], Coroutine]:
+        async def handler(route: Route) -> None:
             intercepted.append(i)
             await asyncio.sleep(0.1)
             await route.fallback()
@@ -84,6 +82,7 @@ async def test_should_chain_once(page: Page, server: Server) -> None:
     )
 
     resp = await page.goto(server.PREFIX + "/madeup.txt")
+    assert resp
     body = await resp.body()
     assert body == b"fulfilled one"
 
@@ -91,7 +90,7 @@ async def test_should_chain_once(page: Page, server: Server) -> None:
 async def test_should_not_chain_fulfill(page: Page, server: Server) -> None:
     failed = [False]
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         failed[0] = True
 
     await page.route("**/empty.html", handler)
@@ -104,6 +103,7 @@ def handler(route: Route):
     )
 
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     body = await response.body()
     assert body == b"fulfilled"
     assert not failed[0]
@@ -114,7 +114,7 @@ async def test_should_not_chain_abort(
 ) -> None:
     failed = [False]
 
-    def handler(route: Route):
+    def handler(route: Route) -> None:
         failed[0] = True
 
     await page.route("**/empty.html", handler)
@@ -137,9 +137,9 @@ def handler(route: Route):
 async def test_should_fall_back_after_exception(page: Page, server: Server) -> None:
     await page.route("**/empty.html", lambda route: route.continue_())
 
-    async def handler(route: Route):
+    async def handler(route: Route) -> None:
         try:
-            await route.fulfill(response=47)
+            await route.fulfill(response=cast(Any, {}))
         except Exception:
             await route.fallback()
 
@@ -151,14 +151,14 @@ async def handler(route: Route):
 async def test_should_amend_http_headers(page: Page, server: Server) -> None:
     values = []
 
-    async def handler(route: Route):
+    async def handler(route: Route) -> None:
         values.append(route.request.headers.get("foo"))
         values.append(await route.request.header_value("FOO"))
         await route.continue_()
 
     await page.route("**/sleep.zzz", handler)
 
-    async def handler_with_header_mods(route: Route):
+    async def handler_with_header_mods(route: Route) -> None:
         await route.fallback(headers={**route.request.headers, "FOO": "bar"})
 
     await page.route("**/*", handler_with_header_mods)
@@ -186,13 +186,13 @@ async def test_should_delete_header_with_undefined_value(
 
     intercepted_request = []
 
-    async def capture_and_continue(route: Route, request: Request):
+    async def capture_and_continue(route: Route, request: Request) -> None:
         intercepted_request.append(request)
         await route.continue_()
 
     await page.route("**/*", capture_and_continue)
 
-    async def delete_foo_header(route: Route, request: Request):
+    async def delete_foo_header(route: Route, request: Request) -> None:
         headers = await request.all_headers()
         await route.fallback(headers={**headers, "foo": None})
 
@@ -227,13 +227,12 @@ async def test_should_amend_method(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
 
     method = []
-    await page.route(
-        "**/*",
-        lambda route: (
-            method.append(route.request.method),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
+
+    def _handler(route: Route) -> None:
+        method.append(route.request.method)
+        asyncio.create_task(route.continue_())
+
+    await page.route("**/*", _handler)
     await page.route(
         "**/*", lambda route: asyncio.create_task(route.fallback(method="POST"))
     )
@@ -249,19 +248,17 @@ async def test_should_amend_method(page: Page, server: Server) -> None:
 
 async def test_should_override_request_url(page: Page, server: Server) -> None:
     url = []
-    await page.route(
-        "**/global-var.html",
-        lambda route: (
-            url.append(route.request.url),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
-    await page.route(
-        "**/foo",
-        lambda route: asyncio.create_task(
-            route.fallback(url=server.PREFIX + "/global-var.html")
-        ),
-    )
+
+    def _handler1(route: Route) -> None:
+        url.append(route.request.url)
+        asyncio.create_task(route.continue_())
+
+    await page.route("**/global-var.html", _handler1)
+
+    def _handler2(route: Route) -> None:
+        asyncio.create_task(route.fallback(url=server.PREFIX + "/global-var.html"))
+
+    await page.route("**/foo", _handler2)
 
     [server_request, response, _] = await asyncio.gather(
         server.wait_for_request("/global-var.html"),
@@ -280,13 +277,12 @@ async def test_should_override_request_url(page: Page, server: Server) -> None:
 async def test_should_amend_post_data(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     post_data = []
-    await page.route(
-        "**/*",
-        lambda route: (
-            post_data.append(route.request.post_data),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
+
+    def _handler(route: Route) -> None:
+        post_data.append(route.request.post_data)
+        asyncio.create_task(route.continue_())
+
+    await page.route("**/*", _handler)
     await page.route(
         "**/*", lambda route: asyncio.create_task(route.fallback(post_data="doggo"))
     )
@@ -298,22 +294,20 @@ async def test_should_amend_post_data(page: Page, server: Server) -> None:
     assert server_request.post_body == b"doggo"
 
 
-async def test_should_amend_binary_post_data(page, server):
+async def test_should_amend_binary_post_data(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     post_data_buffer = []
-    await page.route(
-        "**/*",
-        lambda route: (
-            post_data_buffer.append(route.request.post_data),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
-    await page.route(
-        "**/*",
-        lambda route: asyncio.create_task(
-            route.fallback(post_data=b"\x00\x01\x02\x03\x04")
-        ),
-    )
+
+    def _handler1(route: Route) -> None:
+        post_data_buffer.append(route.request.post_data)
+        asyncio.create_task(route.continue_())
+
+    await page.route("**/*", _handler1)
+
+    async def _handler2(route: Route) -> None:
+        await route.fallback(post_data=b"\x00\x01\x02\x03\x04")
+
+    await page.route("**/*", _handler2)
 
     [server_request, result] = await asyncio.gather(
         server.wait_for_request("/sleep.zzz"),
@@ -329,42 +323,38 @@ async def test_should_chain_fallback_with_dynamic_url(
     server: Server, page: Page
 ) -> None:
     intercepted = []
-    await page.route(
-        "**/bar",
-        lambda route: (
-            intercepted.append(1),
-            asyncio.create_task(route.fallback(url=server.EMPTY_PAGE)),
-        ),
-    )
-    await page.route(
-        "**/foo",
-        lambda route: (
-            intercepted.append(2),
-            asyncio.create_task(route.fallback(url="http://localhost/bar")),
-        ),
-    )
-    await page.route(
-        "**/empty.html",
-        lambda route: (
-            intercepted.append(3),
-            asyncio.create_task(route.fallback(url="http://localhost/foo")),
-        ),
-    )
+
+    def _handler1(route: Route) -> None:
+        intercepted.append(1)
+        asyncio.create_task(route.fallback(url=server.EMPTY_PAGE))
+
+    await page.route("**/bar", _handler1)
+
+    def _handler2(route: Route, request: Request) -> None:
+        intercepted.append(2)
+        asyncio.create_task(route.fallback(url="http://localhost/bar"))
+
+    await page.route("**/foo", _handler2)
+
+    def _handler3(route: Route, request: Request) -> None:
+        intercepted.append(3)
+        asyncio.create_task(route.fallback(url="http://localhost/foo"))
+
+    await page.route("**/empty.html", _handler3)
 
     await page.goto(server.EMPTY_PAGE)
     assert intercepted == [3, 2, 1]
 
 
-async def test_should_amend_json_post_data(server, page):
+async def test_should_amend_json_post_data(server: Server, page: Page) -> None:
     await page.goto(server.EMPTY_PAGE)
     post_data = []
-    await page.route(
-        "**/*",
-        lambda route: (
-            post_data.append(route.request.post_data),
-            asyncio.create_task(route.continue_()),
-        ),
-    )
+
+    def _handle1(route: Route, request: Request) -> None:
+        post_data.append(route.request.post_data)
+        asyncio.create_task(route.continue_())
+
+    await page.route("**/*", _handle1)
     await page.route(
         "**/*",
         lambda route: asyncio.create_task(route.fallback(post_data={"foo": "bar"})),
diff --git a/tests/async/test_page_request_intercept.py b/tests/async/test_page_request_intercept.py
index 39b07d4bc..2206135be 100644
--- a/tests/async/test_page_request_intercept.py
+++ b/tests/async/test_page_request_intercept.py
@@ -13,40 +13,41 @@
 # limitations under the License.
 
 import asyncio
+from typing import cast
 
 import pytest
 
-from playwright.async_api import Page, Route, expect
-from tests.server import Server
+from playwright.async_api import Error, Page, Route, expect
+from tests.server import HttpRequestWithPostBody, Server
 
 
-async def test_should_support_timeout_option_in_route_fetch(server: Server, page: Page):
-    server.set_route(
-        "/slow",
-        lambda request: (
-            request.responseHeaders.addRawHeader("Content-Length", "4096"),
-            request.responseHeaders.addRawHeader("Content-Type", "text/html"),
-            request.write(b""),
-        ),
-    )
+async def test_should_support_timeout_option_in_route_fetch(
+    server: Server, page: Page
+) -> None:
+    def _handler(request: HttpRequestWithPostBody) -> None:
+        request.responseHeaders.addRawHeader("Content-Length", "4096")
+        request.responseHeaders.addRawHeader("Content-Type", "text/html")
+        request.write(b"")
 
-    async def handle(route: Route):
-        with pytest.raises(Exception) as error:
+    server.set_route("/slow", _handler)
+
+    async def handle(route: Route) -> None:
+        with pytest.raises(Error) as error:
             await route.fetch(timeout=1000)
         assert "Request timed out after 1000ms" in error.value.message
 
     await page.route("**/*", lambda route: handle(route))
-    with pytest.raises(Exception) as error:
+    with pytest.raises(Error) as error:
         await page.goto(server.PREFIX + "/slow", timeout=2000)
     assert "Timeout 2000ms exceeded" in error.value.message
 
 
 async def test_should_not_follow_redirects_when_max_redirects_is_set_to_0_in_route_fetch(
     server: Server, page: Page
-):
+) -> None:
     server.set_redirect("/foo", "/empty.html")
 
-    async def handle(route: Route):
+    async def handle(route: Route) -> None:
         response = await route.fetch(max_redirects=0)
         assert response.headers["location"] == "/empty.html"
         assert response.status == 302
@@ -57,34 +58,38 @@ async def handle(route: Route):
     assert "hello" in await page.content()
 
 
-async def test_should_intercept_with_url_override(server: Server, page: Page):
-    async def handle(route: Route):
+async def test_should_intercept_with_url_override(server: Server, page: Page) -> None:
+    async def handle(route: Route) -> None:
         response = await route.fetch(url=server.PREFIX + "/one-style.html")
         await route.fulfill(response=response)
 
     await page.route("**/*.html", lambda route: handle(route))
     response = await page.goto(server.PREFIX + "/empty.html")
+    assert response
     assert response.status == 200
     assert "one-style.css" in (await response.body()).decode("utf-8")
 
 
-async def test_should_intercept_with_post_data_override(server: Server, page: Page):
+async def test_should_intercept_with_post_data_override(
+    server: Server, page: Page
+) -> None:
     request_promise = asyncio.create_task(server.wait_for_request("/empty.html"))
 
-    async def handle(route: Route):
+    async def handle(route: Route) -> None:
         response = await route.fetch(post_data={"foo": "bar"})
         await route.fulfill(response=response)
 
     await page.route("**/*.html", lambda route: handle(route))
     await page.goto(server.PREFIX + "/empty.html")
     request = await request_promise
+    assert request.post_body
     assert request.post_body.decode("utf-8") == '{"foo": "bar"}'
 
 
 async def test_should_fulfill_popup_main_request_using_alias(
     page: Page, server: Server
-):
-    async def route_handler(route: Route):
+) -> None:
+    async def route_handler(route: Route) -> None:
         response = await route.fetch()
         await route.fulfill(response=response, body="hello")
 
@@ -93,4 +98,4 @@ async def route_handler(route: Route):
     [popup, _] = await asyncio.gather(
         page.wait_for_event("popup"), page.get_by_text("click me").click()
     )
-    await expect(popup.locator("body")).to_have_text("hello")
+    await expect(cast(Page, popup).locator("body")).to_have_text("hello")
diff --git a/tests/async/test_page_select_option.py b/tests/async/test_page_select_option.py
index 33e9a098a..e59c6a481 100644
--- a/tests/async/test_page_select_option.py
+++ b/tests/async/test_page_select_option.py
@@ -18,7 +18,9 @@
 from tests.server import Server
 
 
-async def test_select_option_should_select_single_option(page: Page, server: Server):
+async def test_select_option_should_select_single_option(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.select_option("select", "blue")
     assert await page.evaluate("result.onInput") == ["blue"]
@@ -27,7 +29,7 @@ async def test_select_option_should_select_single_option(page: Page, server: Ser
 
 async def test_select_option_should_select_single_option_by_value(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.select_option("select", "blue")
     assert await page.evaluate("result.onInput") == ["blue"]
@@ -36,7 +38,7 @@ async def test_select_option_should_select_single_option_by_value(
 
 async def test_select_option_should_select_single_option_by_label(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.select_option("select", label="Indigo")
     assert await page.evaluate("result.onInput") == ["indigo"]
@@ -45,7 +47,7 @@ async def test_select_option_should_select_single_option_by_label(
 
 async def test_select_option_should_select_single_option_by_handle(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.select_option(
         "select", element=await page.query_selector("[id=whiteOption]")
@@ -56,7 +58,7 @@ async def test_select_option_should_select_single_option_by_handle(
 
 async def test_select_option_should_select_single_option_by_index(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.select_option("select", index=2)
     assert await page.evaluate("result.onInput") == ["brown"]
@@ -65,7 +67,7 @@ async def test_select_option_should_select_single_option_by_index(
 
 async def test_select_option_should_select_only_first_option(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.select_option("select", ["blue", "green", "red"])
     assert await page.evaluate("result.onInput") == ["blue"]
@@ -73,8 +75,8 @@ async def test_select_option_should_select_only_first_option(
 
 
 async def test_select_option_should_not_throw_when_select_causes_navigation(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.eval_on_selector(
         "select",
@@ -85,7 +87,9 @@ async def test_select_option_should_not_throw_when_select_causes_navigation(
     assert "empty.html" in page.url
 
 
-async def test_select_option_should_select_multiple_options(page: Page, server: Server):
+async def test_select_option_should_select_multiple_options(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.evaluate("makeMultiple()")
     await page.select_option("select", ["blue", "green", "red"])
@@ -94,8 +98,8 @@ async def test_select_option_should_select_multiple_options(page: Page, server:
 
 
 async def test_select_option_should_select_multiple_options_with_attributes(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.evaluate("makeMultiple()")
     await page.select_option(
@@ -108,7 +112,9 @@ async def test_select_option_should_select_multiple_options_with_attributes(
     assert await page.evaluate("result.onChange") == ["blue", "gray", "green"]
 
 
-async def test_select_option_should_respect_event_bubbling(page: Page, server: Server):
+async def test_select_option_should_respect_event_bubbling(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.select_option("select", "blue")
     assert await page.evaluate("result.onBubblingInput") == ["blue"]
@@ -117,7 +123,7 @@ async def test_select_option_should_respect_event_bubbling(page: Page, server: S
 
 async def test_select_option_should_throw_when_element_is_not_a__select_(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     with pytest.raises(Error) as exc_info:
         await page.select_option("body", "")
@@ -126,7 +132,7 @@ async def test_select_option_should_throw_when_element_is_not_a__select_(
 
 async def test_select_option_should_return_on_no_matched_values(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     with pytest.raises(TimeoutError) as exc_info:
         await page.select_option("select", ["42", "abc"], timeout=1000)
@@ -135,7 +141,7 @@ async def test_select_option_should_return_on_no_matched_values(
 
 async def test_select_option_should_return_an_array_of_matched_values(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.evaluate("makeMultiple()")
     result = await page.select_option("select", ["blue", "black", "magenta"])
@@ -143,28 +149,34 @@ async def test_select_option_should_return_an_array_of_matched_values(
 
 
 async def test_select_option_should_return_an_array_of_one_element_when_multiple_is_not_set(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     result = await page.select_option("select", ["42", "blue", "black", "magenta"])
     assert len(result) == 1
 
 
-async def test_select_option_should_return_on_no_values(page: Page, server: Server):
+async def test_select_option_should_return_on_no_values(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     result = await page.select_option("select", [])
     assert result == []
 
 
-async def test_select_option_should_not_allow_null_items(page: Page, server: Server):
+async def test_select_option_should_not_allow_null_items(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.evaluate("makeMultiple()")
     with pytest.raises(Error) as exc_info:
-        await page.select_option("select", ["blue", None, "black", "magenta"])
+        await page.select_option("select", ["blue", None, "black", "magenta"])  # type: ignore
     assert "expected string, got object" in exc_info.value.message
 
 
-async def test_select_option_should_unselect_with_null(page: Page, server: Server):
+async def test_select_option_should_unselect_with_null(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.evaluate("makeMultiple()")
     result = await page.select_option("select", ["blue", "black", "magenta"])
@@ -177,8 +189,8 @@ async def test_select_option_should_unselect_with_null(page: Page, server: Serve
 
 
 async def test_select_option_should_deselect_all_options_when_passed_no_values_for_a_multiple_select(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.evaluate("makeMultiple()")
     await page.select_option("select", ["blue", "black", "magenta"])
@@ -190,8 +202,8 @@ async def test_select_option_should_deselect_all_options_when_passed_no_values_f
 
 
 async def test_select_option_should_deselect_all_options_when_passed_no_values_for_a_select_without_multiple(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.select_option("select", ["blue", "black", "magenta"])
     await page.select_option("select", [])
@@ -202,8 +214,8 @@ async def test_select_option_should_deselect_all_options_when_passed_no_values_f
 
 
 async def test_select_option_should_work_when_re_defining_top_level_event_class(
-    page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.evaluate("window.Event = null")
     await page.select_option("select", "blue")
@@ -213,7 +225,7 @@ async def test_select_option_should_work_when_re_defining_top_level_event_class(
 
 async def test_select_options_should_fall_back_to_selecting_by_label(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.PREFIX + "/input/select.html")
     await page.select_option("select", "Blue")
     assert await page.evaluate("result.onInput") == ["blue"]
diff --git a/tests/async/test_pdf.py b/tests/async/test_pdf.py
index a94efb92f..a57a33d05 100644
--- a/tests/async/test_pdf.py
+++ b/tests/async/test_pdf.py
@@ -21,13 +21,13 @@
 
 
 @pytest.mark.only_browser("chromium")
-async def test_should_be_able_to_save_pdf_file(page: Page, server, tmpdir: Path):
+async def test_should_be_able_to_save_pdf_file(page: Page, tmpdir: Path) -> None:
     output_file = tmpdir / "foo.png"
     await page.pdf(path=str(output_file))
     assert os.path.getsize(output_file) > 0
 
 
 @pytest.mark.only_browser("chromium")
-async def test_should_be_able_capture_pdf_without_path(page: Page):
+async def test_should_be_able_capture_pdf_without_path(page: Page) -> None:
     buffer = await page.pdf()
     assert buffer
diff --git a/tests/async/test_popup.py b/tests/async/test_popup.py
index 42e4c29e5..ff3b346ff 100644
--- a/tests/async/test_popup.py
+++ b/tests/async/test_popup.py
@@ -13,14 +13,16 @@
 # limitations under the License.
 
 import asyncio
-from typing import List
+from typing import List, Optional
 
-from playwright.async_api import Browser, Route
+from playwright.async_api import Browser, BrowserContext, Request, Route
+from tests.server import Server
+from tests.utils import must
 
 
 async def test_link_navigation_inherit_user_agent_from_browser_context(
-    browser: Browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(user_agent="hey")
 
     page = await context.new_page()
@@ -41,7 +43,9 @@ async def test_link_navigation_inherit_user_agent_from_browser_context(
     await context.close()
 
 
-async def test_link_navigation_respect_routes_from_browser_context(context, server):
+async def test_link_navigation_respect_routes_from_browser_context(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     await page.set_content('<a target=_blank rel=noopener href="empty.html">link</a>')
@@ -59,8 +63,8 @@ async def handle_request(route: Route) -> None:
 
 
 async def test_window_open_inherit_user_agent_from_browser_context(
-    browser: Browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(user_agent="hey")
 
     page = await context.new_page()
@@ -81,8 +85,8 @@ async def test_window_open_inherit_user_agent_from_browser_context(
 
 
 async def test_should_inherit_extra_headers_from_browser_context(
-    browser: Browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(extra_http_headers={"foo": "bar"})
 
     page = await context.new_page()
@@ -97,7 +101,9 @@ async def test_should_inherit_extra_headers_from_browser_context(
     await context.close()
 
 
-async def test_should_inherit_offline_from_browser_context(context, server):
+async def test_should_inherit_offline_from_browser_context(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     await context.set_offline(True)
@@ -112,8 +118,8 @@ async def test_should_inherit_offline_from_browser_context(context, server):
 
 
 async def test_should_inherit_http_credentials_from_browser_context(
-    browser: Browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     server.set_auth("/title.html", "user", "pass")
     context = await browser.new_context(
         http_credentials={"username": "user", "password": "pass"}
@@ -131,8 +137,8 @@ async def test_should_inherit_http_credentials_from_browser_context(
 
 
 async def test_should_inherit_touch_support_from_browser_context(
-    browser: Browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(
         viewport={"width": 400, "height": 500}, has_touch=True
     )
@@ -151,8 +157,8 @@ async def test_should_inherit_touch_support_from_browser_context(
 
 
 async def test_should_inherit_viewport_size_from_browser_context(
-    browser: Browser, server
-):
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(viewport={"width": 400, "height": 500})
 
     page = await context.new_page()
@@ -168,7 +174,9 @@ async def test_should_inherit_viewport_size_from_browser_context(
     await context.close()
 
 
-async def test_should_use_viewport_size_from_window_features(browser: Browser, server):
+async def test_should_use_viewport_size_from_window_features(
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(viewport={"width": 700, "height": 700})
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
@@ -199,15 +207,17 @@ async def test_should_use_viewport_size_from_window_features(browser: Browser, s
     assert resized == {"width": 500, "height": 400}
 
 
-async def test_should_respect_routes_from_browser_context(context, server):
+async def test_should_respect_routes_from_browser_context(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
 
-    def handle_request(route, request, intercepted):
+    def handle_request(route: Route, request: Request, intercepted: List[bool]) -> None:
         asyncio.create_task(route.continue_())
         intercepted.append(True)
 
-    intercepted = []
+    intercepted: List[bool] = []
     await context.route(
         "**/empty.html",
         lambda route, request: handle_request(route, request, intercepted),
@@ -221,8 +231,8 @@ def handle_request(route, request, intercepted):
 
 
 async def test_browser_context_add_init_script_should_apply_to_an_in_process_popup(
-    context, server
-):
+    context: BrowserContext, server: Server
+) -> None:
     await context.add_init_script("window.injected = 123")
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
@@ -237,8 +247,8 @@ async def test_browser_context_add_init_script_should_apply_to_an_in_process_pop
 
 
 async def test_browser_context_add_init_script_should_apply_to_a_cross_process_popup(
-    context, server
-):
+    context: BrowserContext, server: Server
+) -> None:
     await context.add_init_script("window.injected = 123")
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
@@ -252,7 +262,9 @@ async def test_browser_context_add_init_script_should_apply_to_a_cross_process_p
     assert await popup.evaluate("injected") == 123
 
 
-async def test_should_expose_function_from_browser_context(context, server):
+async def test_should_expose_function_from_browser_context(
+    context: BrowserContext, server: Server
+) -> None:
     await context.expose_function("add", lambda a, b: a + b)
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
@@ -266,7 +278,7 @@ async def test_should_expose_function_from_browser_context(context, server):
     assert added == 13
 
 
-async def test_should_work(context):
+async def test_should_work(context: BrowserContext) -> None:
     page = await context.new_page()
     async with page.expect_popup() as popup_info:
         await page.evaluate('window.__popup = window.open("about:blank")')
@@ -275,7 +287,9 @@ async def test_should_work(context):
     assert await popup.evaluate("!!window.opener")
 
 
-async def test_should_work_with_window_features(context, server):
+async def test_should_work_with_window_features(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_popup() as popup_info:
@@ -287,7 +301,9 @@ async def test_should_work_with_window_features(context, server):
     assert await popup.evaluate("!!window.opener")
 
 
-async def test_window_open_emit_for_immediately_closed_popups(context):
+async def test_window_open_emit_for_immediately_closed_popups(
+    context: BrowserContext,
+) -> None:
     page = await context.new_page()
     async with page.expect_popup() as popup_info:
         await page.evaluate(
@@ -300,7 +316,9 @@ async def test_window_open_emit_for_immediately_closed_popups(context):
     assert popup
 
 
-async def test_should_emit_for_immediately_closed_popups(context, server):
+async def test_should_emit_for_immediately_closed_popups(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_popup() as popup_info:
@@ -314,9 +332,9 @@ async def test_should_emit_for_immediately_closed_popups(context, server):
     assert popup
 
 
-async def test_should_be_able_to_capture_alert(context):
+async def test_should_be_able_to_capture_alert(context: BrowserContext) -> None:
     page = await context.new_page()
-    evaluate_task = None
+    evaluate_task: Optional[asyncio.Future] = None
 
     async def evaluate() -> None:
         nonlocal evaluate_task
@@ -336,10 +354,10 @@ async def evaluate() -> None:
     assert dialog.message == "hello"
     assert dialog.page == popup
     await dialog.dismiss()
-    await evaluate_task
+    await must(evaluate_task)
 
 
-async def test_should_work_with_empty_url(context):
+async def test_should_work_with_empty_url(context: BrowserContext) -> None:
     page = await context.new_page()
     async with page.expect_popup() as popup_info:
         await page.evaluate("() => window.__popup = window.open('')")
@@ -348,7 +366,7 @@ async def test_should_work_with_empty_url(context):
     assert await popup.evaluate("!!window.opener")
 
 
-async def test_should_work_with_noopener_and_no_url(context):
+async def test_should_work_with_noopener_and_no_url(context: BrowserContext) -> None:
     page = await context.new_page()
     async with page.expect_popup() as popup_info:
         await page.evaluate(
@@ -361,7 +379,9 @@ async def test_should_work_with_noopener_and_no_url(context):
     assert await popup.evaluate("!!window.opener") is False
 
 
-async def test_should_work_with_noopener_and_about_blank(context):
+async def test_should_work_with_noopener_and_about_blank(
+    context: BrowserContext,
+) -> None:
     page = await context.new_page()
     async with page.expect_popup() as popup_info:
         await page.evaluate(
@@ -372,7 +392,9 @@ async def test_should_work_with_noopener_and_about_blank(context):
     assert await popup.evaluate("!!window.opener") is False
 
 
-async def test_should_work_with_noopener_and_url(context, server):
+async def test_should_work_with_noopener_and_url(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_popup() as popup_info:
@@ -385,7 +407,9 @@ async def test_should_work_with_noopener_and_url(context, server):
     assert await popup.evaluate("!!window.opener") is False
 
 
-async def test_should_work_with_clicking_target__blank(context, server):
+async def test_should_work_with_clicking_target__blank(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
@@ -400,8 +424,8 @@ async def test_should_work_with_clicking_target__blank(context, server):
 
 
 async def test_should_work_with_fake_clicking_target__blank_and_rel_noopener(
-    context, server
-):
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
@@ -415,8 +439,8 @@ async def test_should_work_with_fake_clicking_target__blank_and_rel_noopener(
 
 
 async def test_should_work_with_clicking_target__blank_and_rel_noopener(
-    context, server
-):
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
@@ -429,7 +453,9 @@ async def test_should_work_with_clicking_target__blank_and_rel_noopener(
     assert await popup.evaluate("!!window.opener") is False
 
 
-async def test_should_not_treat_navigations_as_new_popups(context, server):
+async def test_should_not_treat_navigations_as_new_popups(
+    context: BrowserContext, server: Server
+) -> None:
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
diff --git a/tests/async/test_proxy.py b/tests/async/test_proxy.py
index f4a862b5c..e1c072e9d 100644
--- a/tests/async/test_proxy.py
+++ b/tests/async/test_proxy.py
@@ -12,20 +12,27 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import asyncio
 import base64
+from typing import Callable
 
 import pytest
 
-from playwright.async_api import Error
+from playwright.async_api import Browser, Error
+from tests.server import HttpRequestWithPostBody, Server
 
 
-async def test_should_throw_for_bad_server_value(browser_factory):
+async def test_should_throw_for_bad_server_value(
+    browser_factory: "Callable[..., asyncio.Future[Browser]]",
+) -> None:
     with pytest.raises(Error) as exc_info:
         await browser_factory(proxy={"server": 123})
     assert "proxy.server: expected string, got number" in exc_info.value.message
 
 
-async def test_should_use_proxy(browser_factory, server):
+async def test_should_use_proxy(
+    browser_factory: "Callable[..., asyncio.Future[Browser]]", server: Server
+) -> None:
     server.set_route(
         "/target.html",
         lambda r: (
@@ -39,7 +46,9 @@ async def test_should_use_proxy(browser_factory, server):
     assert await page.title() == "Served by the proxy"
 
 
-async def test_should_use_proxy_for_second_page(browser_factory, server):
+async def test_should_use_proxy_for_second_page(
+    browser_factory: "Callable[..., asyncio.Future[Browser]]", server: Server
+) -> None:
     server.set_route(
         "/target.html",
         lambda r: (
@@ -58,7 +67,9 @@ async def test_should_use_proxy_for_second_page(browser_factory, server):
     assert await page2.title() == "Served by the proxy"
 
 
-async def test_should_work_with_ip_port_notion(browser_factory, server):
+async def test_should_work_with_ip_port_notion(
+    browser_factory: "Callable[..., asyncio.Future[Browser]]", server: Server
+) -> None:
     server.set_route(
         "/target.html",
         lambda r: (
@@ -72,8 +83,10 @@ async def test_should_work_with_ip_port_notion(browser_factory, server):
     assert await page.title() == "Served by the proxy"
 
 
-async def test_should_authenticate(browser_factory, server):
-    def handler(req):
+async def test_should_authenticate(
+    browser_factory: "Callable[..., asyncio.Future[Browser]]", server: Server
+) -> None:
+    def handler(req: HttpRequestWithPostBody) -> None:
         auth = req.getHeader("proxy-authorization")
         if not auth:
             req.setHeader(
@@ -100,8 +113,10 @@ def handler(req):
     )
 
 
-async def test_should_authenticate_with_empty_password(browser_factory, server):
-    def handler(req):
+async def test_should_authenticate_with_empty_password(
+    browser_factory: "Callable[..., asyncio.Future[Browser]]", server: Server
+) -> None:
+    def handler(req: HttpRequestWithPostBody) -> None:
         auth = req.getHeader("proxy-authorization")
         if not auth:
             req.setHeader(
diff --git a/tests/async/test_queryselector.py b/tests/async/test_queryselector.py
index 814f7a3a9..0a09a40c9 100644
--- a/tests/async/test_queryselector.py
+++ b/tests/async/test_queryselector.py
@@ -11,12 +11,18 @@
 # 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 pathlib import Path
+
 import pytest
 
-from playwright.async_api import Error, Page
+from playwright.async_api import Browser, Error, Page, Selectors
+
+from .utils import Utils
 
 
-async def test_selectors_register_should_work(selectors, browser, browser_name):
+async def test_selectors_register_should_work(
+    selectors: Selectors, browser: Browser, browser_name: str
+) -> None:
     tag_selector = """
         {
             create(root, target) {
@@ -74,8 +80,8 @@ async def test_selectors_register_should_work(selectors, browser, browser_name):
 
 
 async def test_selectors_register_should_work_with_path(
-    selectors, page: Page, utils, assetdir
-):
+    selectors: Selectors, page: Page, utils: Utils, assetdir: Path
+) -> None:
     await utils.register_selector_engine(
         selectors, "foo", path=assetdir / "sectionselectorengine.js"
     )
@@ -84,8 +90,8 @@ async def test_selectors_register_should_work_with_path(
 
 
 async def test_selectors_register_should_work_in_main_and_isolated_world(
-    selectors, page: Page, utils
-):
+    selectors: Selectors, page: Page, utils: Utils
+) -> None:
     dummy_selector_script = """{
       create(root, target) { },
       query(root, selector) {
@@ -150,7 +156,9 @@ async def test_selectors_register_should_work_in_main_and_isolated_world(
     )
 
 
-async def test_selectors_register_should_handle_errors(selectors, page: Page, utils):
+async def test_selectors_register_should_handle_errors(
+    selectors: Selectors, page: Page, utils: Utils
+) -> None:
     with pytest.raises(Error) as exc:
         await page.query_selector("neverregister=ignored")
     assert (
diff --git a/tests/async/test_request_continue.py b/tests/async/test_request_continue.py
index f56adb7bd..eb7dfbfda 100644
--- a/tests/async/test_request_continue.py
+++ b/tests/async/test_request_continue.py
@@ -13,14 +13,20 @@
 # limitations under the License.
 
 import asyncio
+from typing import Optional
 
+from playwright.async_api import Page, Route
+from tests.server import Server
 
-async def test_request_continue_should_work(page, server):
+
+async def test_request_continue_should_work(page: Page, server: Server) -> None:
     await page.route("**/*", lambda route: asyncio.create_task(route.continue_()))
     await page.goto(server.EMPTY_PAGE)
 
 
-async def test_request_continue_should_amend_http_headers(page, server):
+async def test_request_continue_should_amend_http_headers(
+    page: Page, server: Server
+) -> None:
     await page.route(
         "**/*",
         lambda route: asyncio.create_task(
@@ -36,7 +42,7 @@ async def test_request_continue_should_amend_http_headers(page, server):
     assert request.getHeader("foo") == "bar"
 
 
-async def test_request_continue_should_amend_method(page, server):
+async def test_request_continue_should_amend_method(page: Page, server: Server) -> None:
     server_request = asyncio.create_task(server.wait_for_request("/sleep.zzz"))
     await page.goto(server.EMPTY_PAGE)
     await page.route(
@@ -50,7 +56,9 @@ async def test_request_continue_should_amend_method(page, server):
     assert (await server_request).method.decode() == "POST"
 
 
-async def test_request_continue_should_amend_method_on_main_request(page, server):
+async def test_request_continue_should_amend_method_on_main_request(
+    page: Page, server: Server
+) -> None:
     request = asyncio.create_task(server.wait_for_request("/empty.html"))
     await page.route(
         "**/*", lambda route: asyncio.create_task(route.continue_(method="POST"))
@@ -59,7 +67,9 @@ async def test_request_continue_should_amend_method_on_main_request(page, server
     assert (await request).method.decode() == "POST"
 
 
-async def test_request_continue_should_amend_post_data(page, server):
+async def test_request_continue_should_amend_post_data(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.route(
         "**/*",
@@ -74,10 +84,11 @@ async def test_request_continue_should_amend_post_data(page, server):
             """
         ),
     )
+    assert server_request.post_body
     assert server_request.post_body.decode() == "doggo"
 
 
-async def test_should_override_request_url(page, server):
+async def test_should_override_request_url(page: Page, server: Server) -> None:
     request = asyncio.create_task(server.wait_for_request("/empty.html"))
     await page.route(
         "**/foo",
@@ -88,10 +99,10 @@ async def test_should_override_request_url(page, server):
     assert (await request).method == b"GET"
 
 
-async def test_should_raise_except(page, server):
-    exc_fut = asyncio.Future()
+async def test_should_raise_except(page: Page, server: Server) -> None:
+    exc_fut: "asyncio.Future[Optional[Exception]]" = asyncio.Future()
 
-    async def capture_exception(route):
+    async def capture_exception(route: Route) -> None:
         try:
             await route.continue_(url="file:///tmp/does-not-exist")
             exc_fut.set_result(None)
@@ -103,7 +114,7 @@ async def capture_exception(route):
     assert "New URL must have same protocol as overridden URL" in str(await exc_fut)
 
 
-async def test_should_amend_utf8_post_data(page, server):
+async def test_should_amend_utf8_post_data(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.route(
         "**/*",
@@ -115,10 +126,11 @@ async def test_should_amend_utf8_post_data(page, server):
         page.evaluate("fetch('/sleep.zzz', { method: 'POST', body: 'birdy' })"),
     )
     assert server_request.method == b"POST"
+    assert server_request.post_body
     assert server_request.post_body.decode("utf8") == "пушкин"
 
 
-async def test_should_amend_binary_post_data(page, server):
+async def test_should_amend_binary_post_data(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.route(
         "**/*",
diff --git a/tests/async/test_request_fulfill.py b/tests/async/test_request_fulfill.py
index 3b5fa99e5..854db7b57 100644
--- a/tests/async/test_request_fulfill.py
+++ b/tests/async/test_request_fulfill.py
@@ -16,13 +16,16 @@
 from tests.server import Server
 
 
-async def test_should_fetch_original_request_and_fulfill(page: Page, server: Server):
-    async def handle(route: Route):
+async def test_should_fetch_original_request_and_fulfill(
+    page: Page, server: Server
+) -> None:
+    async def handle(route: Route) -> None:
         response = await page.request.fetch(route.request)
         await route.fulfill(response=response)
 
     await page.route("**/*", handle)
     response = await page.goto(server.PREFIX + "/title.html")
+    assert response
     assert response.status == 200
     assert await page.title() == "Woof-Woof"
 
diff --git a/tests/async/test_request_intercept.py b/tests/async/test_request_intercept.py
index 39ccf3d3f..316e0b102 100644
--- a/tests/async/test_request_intercept.py
+++ b/tests/async/test_request_intercept.py
@@ -21,8 +21,8 @@
 from tests.server import Server
 
 
-async def test_should_fulfill_intercepted_response(page: Page, server: Server):
-    async def handle(route: Route):
+async def test_should_fulfill_intercepted_response(page: Page, server: Server) -> None:
+    async def handle(route: Route) -> None:
         response = await page.request.fetch(route.request)
         await route.fulfill(
             response=response,
@@ -34,14 +34,17 @@ async def handle(route: Route):
 
     await page.route("**/*", handle)
     response = await page.goto(server.PREFIX + "/empty.html")
+    assert response
     assert response.status == 201
     assert response.headers["foo"] == "bar"
     assert response.headers["content-type"] == "text/plain"
     assert await page.evaluate("() => document.body.textContent") == "Yo, page!"
 
 
-async def test_should_fulfill_response_with_empty_body(page: Page, server: Server):
-    async def handle(route: Route):
+async def test_should_fulfill_response_with_empty_body(
+    page: Page, server: Server
+) -> None:
+    async def handle(route: Route) -> None:
         response = await page.request.fetch(route.request)
         await route.fulfill(
             response=response, status=201, body="", headers={"content-length": "0"}
@@ -49,26 +52,28 @@ async def handle(route: Route):
 
     await page.route("**/*", handle)
     response = await page.goto(server.PREFIX + "/title.html")
+    assert response
     assert response.status == 201
     assert await response.text() == ""
 
 
 async def test_should_override_with_defaults_when_intercepted_response_not_provided(
     page: Page, server: Server, browser_name: str
-):
-    def server_handler(request: http.Request):
+) -> None:
+    def server_handler(request: http.Request) -> None:
         request.setHeader("foo", "bar")
         request.write("my content".encode())
         request.finish()
 
     server.set_route("/empty.html", server_handler)
 
-    async def handle(route: Route):
+    async def handle(route: Route) -> None:
         await page.request.fetch(route.request)
         await route.fulfill(status=201)
 
     await page.route("**/*", handle)
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 201
     assert await response.text() == ""
     if browser_name == "webkit":
@@ -77,8 +82,8 @@ async def handle(route: Route):
         assert response.headers == {}
 
 
-async def test_should_fulfill_with_any_response(page: Page, server: Server):
-    def server_handler(request: http.Request):
+async def test_should_fulfill_with_any_response(page: Page, server: Server) -> None:
+    def server_handler(request: http.Request) -> None:
         request.setHeader("foo", "bar")
         request.write("Woo-hoo".encode())
         request.finish()
@@ -92,6 +97,7 @@ def server_handler(request: http.Request):
         ),
     )
     response = await page.goto(server.EMPTY_PAGE)
+    assert response
     assert response.status == 201
     assert await response.text() == "Woo-hoo"
     assert response.headers["foo"] == "bar"
@@ -99,15 +105,16 @@ def server_handler(request: http.Request):
 
 async def test_should_support_fulfill_after_intercept(
     page: Page, server: Server, assetdir: Path
-):
+) -> None:
     request_future = asyncio.create_task(server.wait_for_request("/title.html"))
 
-    async def handle_route(route: Route):
+    async def handle_route(route: Route) -> None:
         response = await page.request.fetch(route.request)
         await route.fulfill(response=response)
 
     await page.route("**", handle_route)
     response = await page.goto(server.PREFIX + "/title.html")
+    assert response
     request = await request_future
     assert request.uri.decode() == "/title.html"
     original = (assetdir / "title.html").read_text()
@@ -116,10 +123,10 @@ async def handle_route(route: Route):
 
 async def test_should_give_access_to_the_intercepted_response(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.EMPTY_PAGE)
 
-    route_task = asyncio.Future()
+    route_task: "asyncio.Future[Route]" = asyncio.Future()
     await page.route("**/title.html", lambda route: route_task.set_result(route))
 
     eval_task = asyncio.create_task(
@@ -149,10 +156,10 @@ async def test_should_give_access_to_the_intercepted_response(
 
 async def test_should_give_access_to_the_intercepted_response_body(
     page: Page, server: Server
-):
+) -> None:
     await page.goto(server.EMPTY_PAGE)
 
-    route_task = asyncio.Future()
+    route_task: "asyncio.Future[Route]" = asyncio.Future()
     await page.route("**/simple.json", lambda route: route_task.set_result(route))
 
     eval_task = asyncio.create_task(
diff --git a/tests/async/test_resource_timing.py b/tests/async/test_resource_timing.py
index 17ea0e10b..2a14414df 100644
--- a/tests/async/test_resource_timing.py
+++ b/tests/async/test_resource_timing.py
@@ -17,8 +17,11 @@
 import pytest
 from flaky import flaky
 
+from playwright.async_api import Browser, Page
+from tests.server import Server
 
-async def test_should_work(page, server):
+
+async def test_should_work(page: Page, server: Server) -> None:
     async with page.expect_event("requestfinished") as request_info:
         await page.goto(server.EMPTY_PAGE)
     request = await request_info.value
@@ -31,7 +34,9 @@ async def test_should_work(page, server):
 
 
 @flaky
-async def test_should_work_for_subresource(page, server, is_win, is_mac, is_webkit):
+async def test_should_work_for_subresource(
+    page: Page, server: Server, is_win: bool, is_mac: bool, is_webkit: bool
+) -> None:
     if is_webkit and (is_mac or is_win):
         pytest.skip()
     requests = []
@@ -47,7 +52,7 @@ async def test_should_work_for_subresource(page, server, is_win, is_mac, is_webk
 
 
 @flaky  # Upstream flaky
-async def test_should_work_for_ssl(browser, https_server):
+async def test_should_work_for_ssl(browser: Browser, https_server: Server) -> None:
     page = await browser.new_page(ignore_https_errors=True)
     async with page.expect_event("requestfinished") as request_info:
         await page.goto(https_server.EMPTY_PAGE)
@@ -62,7 +67,7 @@ async def test_should_work_for_ssl(browser, https_server):
 
 
 @pytest.mark.skip_browser("webkit")  # In WebKit, redirects don"t carry the timing info
-async def test_should_work_for_redirect(page, server):
+async def test_should_work_for_redirect(page: Page, server: Server) -> None:
     server.set_redirect("/foo.html", "/empty.html")
     responses = []
     page.on("response", lambda response: responses.append(response))
diff --git a/tests/async/test_screenshot.py b/tests/async/test_screenshot.py
index 37bcf490d..3cd536f96 100644
--- a/tests/async/test_screenshot.py
+++ b/tests/async/test_screenshot.py
@@ -12,13 +12,16 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from typing import Callable
+
 from playwright.async_api import Page
 from tests.server import Server
+from tests.utils import must
 
 
 async def test_should_screenshot_with_mask(
-    page: Page, server: Server, assert_to_be_golden
-):
+    page: Page, server: Server, assert_to_be_golden: Callable[[bytes, str], None]
+) -> None:
     await page.set_viewport_size(
         {
             "width": 500,
@@ -35,7 +38,7 @@ async def test_should_screenshot_with_mask(
         "mask-should-work-with-locator.png",
     )
     assert_to_be_golden(
-        await (await page.query_selector("body")).screenshot(
+        await must(await page.query_selector("body")).screenshot(
             mask=[page.locator("div").nth(5)]
         ),
         "mask-should-work-with-element-handle.png",
diff --git a/tests/async/test_selectors_misc.py b/tests/async/test_selectors_misc.py
index 480adb7f7..5527d6ec8 100644
--- a/tests/async/test_selectors_misc.py
+++ b/tests/async/test_selectors_misc.py
@@ -15,7 +15,7 @@
 from playwright.async_api import Page
 
 
-async def test_should_work_with_internal_and(page: Page, server):
+async def test_should_work_with_internal_and(page: Page) -> None:
     await page.set_content(
         """
         <div class=foo>hello</div><div class=bar>world</div>
diff --git a/tests/async/test_selectors_text.py b/tests/async/test_selectors_text.py
index 0b231ccab..2135dcade 100644
--- a/tests/async/test_selectors_text.py
+++ b/tests/async/test_selectors_text.py
@@ -50,7 +50,7 @@ async def test_has_text_and_internal_text_should_match_full_node_text_in_strict_
     await expect(page.locator("div", has_text=re.compile("^hello$"))).to_have_id("div2")
 
 
-async def test_should_work(page: Page, server) -> None:
+async def test_should_work(page: Page) -> None:
     await page.set_content(
         """
         <div>yo</div><div>ya</div><div>\nye  </div>
diff --git a/tests/async/test_tap.py b/tests/async/test_tap.py
index 026e3cdcd..abb3c61e5 100644
--- a/tests/async/test_tap.py
+++ b/tests/async/test_tap.py
@@ -13,20 +13,21 @@
 # limitations under the License.
 
 import asyncio
+from typing import AsyncGenerator, Optional, cast
 
 import pytest
 
-from playwright.async_api import ElementHandle, JSHandle, Page
+from playwright.async_api import Browser, BrowserContext, ElementHandle, JSHandle, Page
 
 
 @pytest.fixture
-async def context(browser):
+async def context(browser: Browser) -> AsyncGenerator[BrowserContext, None]:
     context = await browser.new_context(has_touch=True)
     yield context
     await context.close()
 
 
-async def test_should_send_all_of_the_correct_events(page):
+async def test_should_send_all_of_the_correct_events(page: Page) -> None:
     await page.set_content(
         """
             <div id="a" style="background: lightblue; width: 50px; height: 50px">a</div>
@@ -54,7 +55,7 @@ async def test_should_send_all_of_the_correct_events(page):
     ]
 
 
-async def test_should_not_send_mouse_events_touchstart_is_canceled(page):
+async def test_should_not_send_mouse_events_touchstart_is_canceled(page: Page) -> None:
     await page.set_content("hello world")
     await page.evaluate(
         """() => {
@@ -76,7 +77,7 @@ async def test_should_not_send_mouse_events_touchstart_is_canceled(page):
     ]
 
 
-async def test_should_not_send_mouse_events_touchend_is_canceled(page):
+async def test_should_not_send_mouse_events_touchend_is_canceled(page: Page) -> None:
     await page.set_content("hello world")
     await page.evaluate(
         """() => {
@@ -98,7 +99,7 @@ async def test_should_not_send_mouse_events_touchend_is_canceled(page):
     ]
 
 
-async def test_should_work_with_modifiers(page):
+async def test_should_work_with_modifiers(page: Page) -> None:
     await page.set_content("hello world")
     alt_key_promise = asyncio.create_task(
         page.evaluate(
@@ -115,7 +116,7 @@ async def test_should_work_with_modifiers(page):
     assert await alt_key_promise is True
 
 
-async def test_should_send_well_formed_touch_points(page):
+async def test_should_send_well_formed_touch_points(page: Page) -> None:
     promises = asyncio.gather(
         page.evaluate(
             """() => new Promise(resolve => {
@@ -172,15 +173,18 @@ async def test_should_send_well_formed_touch_points(page):
     assert touchend == []
 
 
-async def test_should_wait_until_an_element_is_visible_to_tap_it(page):
-    div = await page.evaluate_handle(
-        """() => {
+async def test_should_wait_until_an_element_is_visible_to_tap_it(page: Page) -> None:
+    div = cast(
+        ElementHandle,
+        await page.evaluate_handle(
+            """() => {
             const button = document.createElement('button');
             button.textContent = 'not clicked';
             document.body.appendChild(button);
             button.style.display = 'none';
             return button;
         }"""
+        ),
     )
     tap_promise = asyncio.create_task(div.tap())
     await asyncio.sleep(0)  # issue tap
@@ -190,7 +194,7 @@ async def test_should_wait_until_an_element_is_visible_to_tap_it(page):
     assert await div.text_content() == "clicked"
 
 
-async def test_locators_tap(page: Page):
+async def test_locators_tap(page: Page) -> None:
     await page.set_content(
         """
         <div id="a" style="background: lightblue; width: 50px; height: 50px">a</div>
@@ -218,7 +222,8 @@ async def test_locators_tap(page: Page):
     ]
 
 
-async def track_events(target: ElementHandle) -> JSHandle:
+async def track_events(target: Optional[ElementHandle]) -> JSHandle:
+    assert target
     return await target.evaluate_handle(
         """target => {
             const events = [];
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index 702f1fd45..a9cfdfbcb 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -23,7 +23,7 @@
 
 async def test_browser_context_output_trace(
     browser: Browser, server: Server, tmp_path: Path
-):
+) -> None:
     context = await browser.new_context()
     await context.tracing.start(screenshots=True, snapshots=True)
     page = await context.new_page()
@@ -32,7 +32,7 @@ async def test_browser_context_output_trace(
     assert Path(tmp_path / "trace.zip").exists()
 
 
-async def test_start_stop(browser: Browser):
+async def test_start_stop(browser: Browser) -> None:
     context = await browser.new_context()
     await context.tracing.start()
     await context.tracing.stop()
@@ -41,13 +41,13 @@ async def test_start_stop(browser: Browser):
 
 async def test_browser_context_should_not_throw_when_stopping_without_start_but_not_exporting(
     context: BrowserContext, server: Server, tmp_path: Path
-):
+) -> None:
     await context.tracing.stop()
 
 
 async def test_browser_context_output_trace_chunk(
     browser: Browser, server: Server, tmp_path: Path
-):
+) -> None:
     context = await browser.new_context()
     await context.tracing.start(screenshots=True, snapshots=True)
     page = await context.new_page()
@@ -67,7 +67,7 @@ async def test_browser_context_output_trace_chunk(
 
 async def test_should_collect_sources(
     context: BrowserContext, page: Page, server: Server, tmp_path: Path
-):
+) -> None:
     await context.tracing.start(sources=True)
     await page.goto(server.EMPTY_PAGE)
     await page.set_content("<button>Click</button>")
@@ -234,7 +234,7 @@ async def test_should_respect_traces_dir_and_name(
     browser_type: BrowserType,
     server: Server,
     tmpdir: Path,
-    launch_arguments: Dict[str, str],
+    launch_arguments: Dict,
 ) -> None:
     traces_dir = tmpdir / "traces"
     browser = await browser_type.launch(traces_dir=traces_dir, **launch_arguments)
diff --git a/tests/async/test_video.py b/tests/async/test_video.py
index 366707bca..8575aabad 100644
--- a/tests/async/test_video.py
+++ b/tests/async/test_video.py
@@ -13,19 +13,30 @@
 # limitations under the License.
 
 import os
+from pathlib import Path
+from typing import Dict
 
+from playwright.async_api import Browser, BrowserType
+from tests.server import Server
 
-async def test_should_expose_video_path(browser, tmpdir, server):
+
+async def test_should_expose_video_path(
+    browser: Browser, tmpdir: Path, server: Server
+) -> None:
     page = await browser.new_page(record_video_dir=tmpdir)
     await page.goto(server.PREFIX + "/grid.html")
+    assert page.video
     path = await page.video.path()
     assert str(tmpdir) in str(path)
     await page.context.close()
 
 
-async def test_short_video_should_throw(browser, tmpdir, server):
+async def test_short_video_should_throw(
+    browser: Browser, tmpdir: Path, server: Server
+) -> None:
     page = await browser.new_page(record_video_dir=tmpdir)
     await page.goto(server.PREFIX + "/grid.html")
+    assert page.video
     path = await page.video.path()
     assert str(tmpdir) in str(path)
     await page.wait_for_timeout(1000)
@@ -34,8 +45,8 @@ async def test_short_video_should_throw(browser, tmpdir, server):
 
 
 async def test_short_video_should_throw_persistent_context(
-    browser_type, tmpdir, launch_arguments, server
-):
+    browser_type: BrowserType, tmpdir: Path, launch_arguments: Dict, server: Server
+) -> None:
     context = await browser_type.launch_persistent_context(
         str(tmpdir),
         **launch_arguments,
@@ -47,17 +58,19 @@ async def test_short_video_should_throw_persistent_context(
     await page.wait_for_timeout(1000)
     await context.close()
 
+    assert page.video
     path = await page.video.path()
     assert str(tmpdir) in str(path)
 
 
 async def test_should_not_error_if_page_not_closed_before_save_as(
-    browser, tmpdir, server
-):
+    browser: Browser, tmpdir: Path, server: Server
+) -> None:
     page = await browser.new_page(record_video_dir=tmpdir)
     await page.goto(server.PREFIX + "/grid.html")
     await page.wait_for_timeout(1000)  # make sure video has some data
     out_path = tmpdir / "some-video.webm"
+    assert page.video
     saved = page.video.save_as(out_path)
     await page.close()
     await saved
diff --git a/tests/async/test_wait_for_function.py b/tests/async/test_wait_for_function.py
index da480f323..9d1171922 100644
--- a/tests/async/test_wait_for_function.py
+++ b/tests/async/test_wait_for_function.py
@@ -16,17 +16,17 @@
 
 import pytest
 
-from playwright.async_api import Error, Page
+from playwright.async_api import ConsoleMessage, Error, Page
 
 
-async def test_should_timeout(page: Page):
+async def test_should_timeout(page: Page) -> None:
     start_time = datetime.now()
     timeout = 42
     await page.wait_for_timeout(timeout)
     assert ((datetime.now() - start_time).microseconds * 1000) >= timeout / 2
 
 
-async def test_should_accept_a_string(page: Page):
+async def test_should_accept_a_string(page: Page) -> None:
     watchdog = page.wait_for_function("window.__FOO === 1")
     await page.evaluate("window['__FOO'] = 1")
     await watchdog
@@ -34,7 +34,7 @@ async def test_should_accept_a_string(page: Page):
 
 async def test_should_work_when_resolved_right_before_execution_context_disposal(
     page: Page,
-):
+) -> None:
     await page.add_init_script("window['__RELOADED'] = true")
     await page.wait_for_function(
         """() => {
@@ -45,7 +45,7 @@ async def test_should_work_when_resolved_right_before_execution_context_disposal
     )
 
 
-async def test_should_poll_on_interval(page: Page):
+async def test_should_poll_on_interval(page: Page) -> None:
     polling = 100
     time_delta = await page.wait_for_function(
         """() => {
@@ -60,10 +60,10 @@ async def test_should_poll_on_interval(page: Page):
     assert await time_delta.json_value() >= polling
 
 
-async def test_should_avoid_side_effects_after_timeout(page: Page):
+async def test_should_avoid_side_effects_after_timeout(page: Page) -> None:
     counter = 0
 
-    async def on_console(message):
+    async def on_console(message: ConsoleMessage) -> None:
         nonlocal counter
         counter += 1
 
@@ -85,7 +85,7 @@ async def on_console(message):
     assert counter == saved_counter
 
 
-async def test_should_throw_on_polling_mutation(page: Page):
+async def test_should_throw_on_polling_mutation(page: Page) -> None:
     with pytest.raises(Error) as exc_info:
-        await page.wait_for_function("() => true", polling="mutation")
+        await page.wait_for_function("() => true", polling="mutation")  # type: ignore
     assert "Unknown polling option: mutation" in exc_info.value.message
diff --git a/tests/async/test_wait_for_url.py b/tests/async/test_wait_for_url.py
index 974d795d3..49e19b2d7 100644
--- a/tests/async/test_wait_for_url.py
+++ b/tests/async/test_wait_for_url.py
@@ -17,9 +17,10 @@
 import pytest
 
 from playwright.async_api import Error, Page
+from tests.server import Server
 
 
-async def test_wait_for_url_should_work(page: Page, server):
+async def test_wait_for_url_should_work(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.evaluate(
         "url => window.location.href = url", server.PREFIX + "/grid.html"
@@ -28,7 +29,7 @@ async def test_wait_for_url_should_work(page: Page, server):
     assert "grid.html" in page.url
 
 
-async def test_wait_for_url_should_respect_timeout(page: Page, server):
+async def test_wait_for_url_should_respect_timeout(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     with pytest.raises(Error) as exc_info:
         await page.wait_for_url("**/frame.html", timeout=2500)
@@ -36,16 +37,16 @@ async def test_wait_for_url_should_respect_timeout(page: Page, server):
 
 
 async def test_wait_for_url_should_work_with_both_domcontentloaded_and_load(
-    page: Page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.wait_for_url("**/*", wait_until="domcontentloaded")
     await page.wait_for_url("**/*", wait_until="load")
 
 
 async def test_wait_for_url_should_work_with_clicking_on_anchor_links(
-    page: Page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content('<a href="#foobar">foobar</a>')
     await page.click("a")
@@ -53,7 +54,9 @@ async def test_wait_for_url_should_work_with_clicking_on_anchor_links(
     assert page.url == server.EMPTY_PAGE + "#foobar"
 
 
-async def test_wait_for_url_should_work_with_history_push_state(page: Page, server):
+async def test_wait_for_url_should_work_with_history_push_state(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
         """
@@ -68,7 +71,9 @@ async def test_wait_for_url_should_work_with_history_push_state(page: Page, serv
     assert page.url == server.PREFIX + "/wow.html"
 
 
-async def test_wait_for_url_should_work_with_history_replace_state(page: Page, server):
+async def test_wait_for_url_should_work_with_history_replace_state(
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
         """
@@ -84,8 +89,8 @@ async def test_wait_for_url_should_work_with_history_replace_state(page: Page, s
 
 
 async def test_wait_for_url_should_work_with_dom_history_back_forward(
-    page: Page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
         """
@@ -112,8 +117,8 @@ async def test_wait_for_url_should_work_with_dom_history_back_forward(
 
 
 async def test_wait_for_url_should_work_with_url_match_for_same_document_navigations(
-    page: Page, server
-):
+    page: Page, server: Server
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.evaluate("history.pushState({}, '', '/first.html')")
     await page.evaluate("history.pushState({}, '', '/second.html')")
@@ -122,7 +127,7 @@ async def test_wait_for_url_should_work_with_url_match_for_same_document_navigat
     assert "/third.html" in page.url
 
 
-async def test_wait_for_url_should_work_with_commit(page: Page, server):
+async def test_wait_for_url_should_work_with_commit(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.evaluate(
         "url => window.location.href = url", server.PREFIX + "/grid.html"
diff --git a/tests/async/test_websocket.py b/tests/async/test_websocket.py
index cf16ad90a..eb90f95d3 100644
--- a/tests/async/test_websocket.py
+++ b/tests/async/test_websocket.py
@@ -13,14 +13,17 @@
 # limitations under the License.
 
 import asyncio
+from typing import Union
 
 import pytest
 from flaky import flaky
 
-from playwright.async_api import Error
+from playwright.async_api import Error, Page, WebSocket
+from tests.conftest import WebSocketServerServer
+from tests.server import Server
 
 
-async def test_should_work(page, ws_server):
+async def test_should_work(page: Page, ws_server: WebSocketServerServer) -> None:
     value = await page.evaluate(
         """port => {
         let cb;
@@ -35,7 +38,9 @@ async def test_should_work(page, ws_server):
     pass
 
 
-async def test_should_emit_close_events(page, ws_server):
+async def test_should_emit_close_events(
+    page: Page, ws_server: WebSocketServerServer
+) -> None:
     async with page.expect_websocket() as ws_info:
         await page.evaluate(
             """port => {
@@ -55,17 +60,32 @@ async def test_should_emit_close_events(page, ws_server):
     assert ws.is_closed()
 
 
-async def test_should_emit_frame_events(page, ws_server):
+async def test_should_emit_frame_events(
+    page: Page, ws_server: WebSocketServerServer
+) -> None:
     log = []
-    socke_close_future = asyncio.Future()
+    socke_close_future: "asyncio.Future[None]" = asyncio.Future()
 
-    def on_web_socket(ws):
+    def on_web_socket(ws: WebSocket) -> None:
         log.append("open")
-        ws.on("framesent", lambda payload: log.append(f"sent<{payload}>"))
-        ws.on("framereceived", lambda payload: log.append(f"received<{payload}>"))
-        ws.on(
-            "close", lambda: (log.append("close"), socke_close_future.set_result(None))
-        )
+
+        def _on_framesent(payload: Union[bytes, str]) -> None:
+            assert isinstance(payload, str)
+            log.append(f"sent<{payload}>")
+
+        ws.on("framesent", _on_framesent)
+
+        def _on_framereceived(payload: Union[bytes, str]) -> None:
+            assert isinstance(payload, str)
+            log.append(f"received<{payload}>")
+
+        ws.on("framereceived", _on_framereceived)
+
+        def _handle_close(ws: WebSocket) -> None:
+            log.append("close")
+            socke_close_future.set_result(None)
+
+        ws.on("close", _handle_close)
 
     page.on("websocket", on_web_socket)
     async with page.expect_event("websocket"):
@@ -84,15 +104,17 @@ def on_web_socket(ws):
     assert log == ["close", "open", "received<incoming>", "sent<outgoing>"]
 
 
-async def test_should_emit_binary_frame_events(page, ws_server):
-    done_task = asyncio.Future()
+async def test_should_emit_binary_frame_events(
+    page: Page, ws_server: WebSocketServerServer
+) -> None:
+    done_task: "asyncio.Future[None]" = asyncio.Future()
     sent = []
     received = []
 
-    def on_web_socket(ws):
+    def on_web_socket(ws: WebSocket) -> None:
         ws.on("framesent", lambda payload: sent.append(payload))
         ws.on("framereceived", lambda payload: received.append(payload))
-        ws.on("close", lambda: done_task.set_result(None))
+        ws.on("close", lambda _: done_task.set_result(None))
 
     page.on("websocket", on_web_socket)
     async with page.expect_event("websocket"):
@@ -115,7 +137,9 @@ def on_web_socket(ws):
 
 
 @flaky
-async def test_should_reject_wait_for_event_on_close_and_error(page, ws_server):
+async def test_should_reject_wait_for_event_on_close_and_error(
+    page: Page, ws_server: WebSocketServerServer
+) -> None:
     async with page.expect_event("websocket") as ws_info:
         await page.evaluate(
             """port => {
@@ -131,13 +155,20 @@ async def test_should_reject_wait_for_event_on_close_and_error(page, ws_server):
     assert exc_info.value.message == "Socket closed"
 
 
-async def test_should_emit_error_event(page, server, browser_name):
-    future = asyncio.Future()
+async def test_should_emit_error_event(
+    page: Page, server: Server, browser_name: str
+) -> None:
+    future: "asyncio.Future[str]" = asyncio.Future()
+
+    def _on_ws_socket_error(err: str) -> None:
+        future.set_result(err)
+
+    def _on_websocket(websocket: WebSocket) -> None:
+        websocket.on("socketerror", _on_ws_socket_error)
+
     page.on(
         "websocket",
-        lambda websocket: websocket.on(
-            "socketerror", lambda err: future.set_result(err)
-        ),
+        _on_websocket,
     )
     await page.evaluate(
         """port => new WebSocket(`ws://localhost:${port}/bogus-ws`)""",
diff --git a/tests/async/test_worker.py b/tests/async/test_worker.py
index 8b2e56f3f..996404b6e 100644
--- a/tests/async/test_worker.py
+++ b/tests/async/test_worker.py
@@ -18,11 +18,12 @@
 import pytest
 from flaky import flaky
 
-from playwright.async_api import Error, Page, Worker
+from playwright.async_api import Browser, ConsoleMessage, Error, Page, Worker
+from tests.server import Server
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
-async def test_workers_page_workers(page: Page, server):
+async def test_workers_page_workers(page: Page, server: Server) -> None:
     async with page.expect_worker() as worker_info:
         await page.goto(server.PREFIX + "/worker/worker.html")
     worker = await worker_info.value
@@ -38,7 +39,7 @@ async def test_workers_page_workers(page: Page, server):
     assert len(page.workers) == 0
 
 
-async def test_workers_should_emit_created_and_destroyed_events(page: Page):
+async def test_workers_should_emit_created_and_destroyed_events(page: Page) -> None:
     worker_obj = None
     async with page.expect_event("worker") as event_info:
         worker_obj = await page.evaluate_handle(
@@ -55,7 +56,7 @@ async def test_workers_should_emit_created_and_destroyed_events(page: Page):
     assert TARGET_CLOSED_ERROR_MESSAGE in exc.value.message
 
 
-async def test_workers_should_report_console_logs(page):
+async def test_workers_should_report_console_logs(page: Page) -> None:
     async with page.expect_console_message() as message_info:
         await page.evaluate(
             '() => new Worker(URL.createObjectURL(new Blob(["console.log(1)"], {type: "application/javascript"})))'
@@ -64,8 +65,10 @@ async def test_workers_should_report_console_logs(page):
     assert message.text == "1"
 
 
-async def test_workers_should_have_JSHandles_for_console_logs(page, browser_name):
-    log_promise = asyncio.Future()
+async def test_workers_should_have_JSHandles_for_console_logs(
+    page: Page, browser_name: str
+) -> None:
+    log_promise: "asyncio.Future[ConsoleMessage]" = asyncio.Future()
     page.on("console", lambda m: log_promise.set_result(m))
     await page.evaluate(
         "() => new Worker(URL.createObjectURL(new Blob(['console.log(1,2,3,this)'], {type: 'application/javascript'})))"
@@ -79,7 +82,7 @@ async def test_workers_should_have_JSHandles_for_console_logs(page, browser_name
     assert await (await log.args[3].get_property("origin")).json_value() == "null"
 
 
-async def test_workers_should_evaluate(page):
+async def test_workers_should_evaluate(page: Page) -> None:
     async with page.expect_event("worker") as event_info:
         await page.evaluate(
             "() => new Worker(URL.createObjectURL(new Blob(['console.log(1)'], {type: 'application/javascript'})))"
@@ -88,8 +91,8 @@ async def test_workers_should_evaluate(page):
     assert await worker.evaluate("1+1") == 2
 
 
-async def test_workers_should_report_errors(page):
-    error_promise = asyncio.Future()
+async def test_workers_should_report_errors(page: Page) -> None:
+    error_promise: "asyncio.Future[Error]" = asyncio.Future()
     page.on("pageerror", lambda e: error_promise.set_result(e))
     await page.evaluate(
         """() => new Worker(URL.createObjectURL(new Blob([`
@@ -105,7 +108,7 @@ async def test_workers_should_report_errors(page):
 
 
 @flaky  # Upstream flaky
-async def test_workers_should_clear_upon_navigation(server, page):
+async def test_workers_should_clear_upon_navigation(server: Server, page: Page) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_event("worker") as event_info:
         await page.evaluate(
@@ -121,7 +124,9 @@ async def test_workers_should_clear_upon_navigation(server, page):
 
 
 @flaky  # Upstream flaky
-async def test_workers_should_clear_upon_cross_process_navigation(server, page):
+async def test_workers_should_clear_upon_cross_process_navigation(
+    server: Server, page: Page
+) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_event("worker") as event_info:
         await page.evaluate(
@@ -139,7 +144,9 @@ async def test_workers_should_clear_upon_cross_process_navigation(server, page):
 @pytest.mark.skip_browser(
     "firefox"
 )  # https://github.com/microsoft/playwright/issues/21760
-async def test_workers_should_report_network_activity(page, server):
+async def test_workers_should_report_network_activity(
+    page: Page, server: Server
+) -> None:
     async with page.expect_worker() as worker_info:
         await page.goto(server.PREFIX + "/worker/worker.html")
     worker = await worker_info.value
@@ -160,7 +167,9 @@ async def test_workers_should_report_network_activity(page, server):
 @pytest.mark.skip_browser(
     "firefox"
 )  # https://github.com/microsoft/playwright/issues/21760
-async def test_workers_should_report_network_activity_on_worker_creation(page, server):
+async def test_workers_should_report_network_activity_on_worker_creation(
+    page: Page, server: Server
+) -> None:
     # Chromium needs waitForDebugger enabled for this one.
     await page.goto(server.EMPTY_PAGE)
     url = server.PREFIX + "/one-style.css"
@@ -180,7 +189,9 @@ async def test_workers_should_report_network_activity_on_worker_creation(page, s
     assert response.ok
 
 
-async def test_workers_should_format_number_using_context_locale(browser, server):
+async def test_workers_should_format_number_using_context_locale(
+    browser: Browser, server: Server
+) -> None:
     context = await browser.new_context(locale="ru-RU")
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
diff --git a/tests/async/utils.py b/tests/async/utils.py
index 1261ce1a1..c253eb1ca 100644
--- a/tests/async/utils.py
+++ b/tests/async/utils.py
@@ -13,7 +13,7 @@
 # limitations under the License.
 
 import re
-from typing import List, cast
+from typing import Any, List, cast
 
 from playwright.async_api import (
     ElementHandle,
@@ -26,7 +26,7 @@
 
 
 class Utils:
-    async def attach_frame(self, page: Page, frame_id: str, url: str):
+    async def attach_frame(self, page: Page, frame_id: str, url: str) -> Frame:
         handle = await page.evaluate_handle(
             """async ({ frame_id, url }) => {
                 const frame = document.createElement('iframe');
@@ -38,9 +38,11 @@ async def attach_frame(self, page: Page, frame_id: str, url: str):
             }""",
             {"frame_id": frame_id, "url": url},
         )
-        return await cast(ElementHandle, handle.as_element()).content_frame()
+        frame = await cast(ElementHandle, handle.as_element()).content_frame()
+        assert frame
+        return frame
 
-    async def detach_frame(self, page: Page, frame_id: str):
+    async def detach_frame(self, page: Page, frame_id: str) -> None:
         await page.evaluate(
             "frame_id => document.getElementById(frame_id).remove()", frame_id
         )
@@ -58,14 +60,14 @@ def dump_frames(self, frame: Frame, indentation: str = "") -> List[str]:
             result = result + utils.dump_frames(child, "    " + indentation)
         return result
 
-    async def verify_viewport(self, page: Page, width: int, height: int):
+    async def verify_viewport(self, page: Page, width: int, height: int) -> None:
         assert cast(ViewportSize, page.viewport_size)["width"] == width
         assert cast(ViewportSize, page.viewport_size)["height"] == height
         assert await page.evaluate("window.innerWidth") == width
         assert await page.evaluate("window.innerHeight") == height
 
     async def register_selector_engine(
-        self, selectors: Selectors, *args, **kwargs
+        self, selectors: Selectors, *args: Any, **kwargs: Any
     ) -> None:
         try:
             await selectors.register(*args, **kwargs)
diff --git a/tests/conftest.py b/tests/conftest.py
index 80ec8e0fb..6dbd34478 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -20,7 +20,7 @@
 import subprocess
 import sys
 from pathlib import Path
-from typing import Any, AsyncGenerator, Callable, Dict, Generator, List
+from typing import Any, AsyncGenerator, Callable, Dict, Generator, List, Optional, cast
 
 import pytest
 from PIL import Image
@@ -95,13 +95,13 @@ def after_each_hook() -> Generator[None, None, None]:
 
 
 @pytest.fixture(scope="session")
-def browser_name(pytestconfig: pytest.Config) -> None:
-    return pytestconfig.getoption("browser")
+def browser_name(pytestconfig: pytest.Config) -> str:
+    return cast(str, pytestconfig.getoption("browser"))
 
 
 @pytest.fixture(scope="session")
-def browser_channel(pytestconfig: pytest.Config) -> None:
-    return pytestconfig.getoption("--browser-channel")
+def browser_channel(pytestconfig: pytest.Config) -> Optional[str]:
+    return cast(Optional[str], pytestconfig.getoption("--browser-channel"))
 
 
 @pytest.fixture(scope="session")
diff --git a/tests/server.py b/tests/server.py
index 2bd3e672a..37d2c2b0d 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -21,7 +21,17 @@
 import threading
 from contextlib import closing
 from http import HTTPStatus
-from typing import Any, Callable, Dict, Generator, Generic, Set, Tuple, TypeVar
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generator,
+    Generic,
+    Optional,
+    Set,
+    Tuple,
+    TypeVar,
+)
 from urllib.parse import urlparse
 
 from autobahn.twisted.websocket import WebSocketServerFactory, WebSocketServerProtocol
@@ -43,7 +53,7 @@ def find_free_port() -> int:
 
 
 class HttpRequestWithPostBody(http.Request):
-    post_body = None
+    post_body: Optional[bytes] = None
 
 
 T = TypeVar("T")
@@ -86,7 +96,7 @@ def start(self) -> None:
         request_subscribers: Dict[str, asyncio.Future] = {}
         auth: Dict[str, Tuple[str, str]] = {}
         csp: Dict[str, str] = {}
-        routes: Dict[str, Callable[[http.Request], Any]] = {}
+        routes: Dict[str, Callable[[HttpRequestWithPostBody], Any]] = {}
         gzip_routes: Set[str] = set()
         self.request_subscribers = request_subscribers
         self.auth = auth
diff --git a/tests/sync/test_page_request_intercept.py b/tests/sync/test_page_request_intercept.py
index f44a30deb..d62cc5f79 100644
--- a/tests/sync/test_page_request_intercept.py
+++ b/tests/sync/test_page_request_intercept.py
@@ -15,19 +15,20 @@
 import pytest
 
 from playwright.sync_api import Error, Page, Route
-from tests.server import Server
+from tests.server import HttpRequestWithPostBody, Server
 
 
 def test_should_support_timeout_option_in_route_fetch(
     server: Server, page: Page
 ) -> None:
+    def _handle(request: HttpRequestWithPostBody) -> None:
+        request.responseHeaders.addRawHeader("Content-Length", "4096")
+        request.responseHeaders.addRawHeader("Content-Type", "text/html")
+        request.write(b"")
+
     server.set_route(
         "/slow",
-        lambda request: (
-            request.responseHeaders.addRawHeader("Content-Length", "4096"),
-            request.responseHeaders.addRawHeader("Content-Type", "text/html"),
-            request.write(b""),
-        ),
+        _handle,
     )
 
     def handle(route: Route) -> None:
diff --git a/tests/utils.py b/tests/utils.py
index 96886a305..4a9faf9a1 100644
--- a/tests/utils.py
+++ b/tests/utils.py
@@ -15,7 +15,7 @@
 import json
 import zipfile
 from pathlib import Path
-from typing import Any, Dict, List, Tuple
+from typing import Any, Dict, List, Optional, Tuple, TypeVar
 
 
 def parse_trace(path: Path) -> Tuple[Dict[str, bytes], List[Any]]:
@@ -58,3 +58,10 @@ def get_trace_actions(events: List[Any]) -> List[str]:
 
 
 TARGET_CLOSED_ERROR_MESSAGE = "Target page, context or browser has been closed"
+
+MustType = TypeVar("MustType")
+
+
+def must(value: Optional[MustType]) -> MustType:
+    assert value
+    return value

From fa71145cc6e8417ff4d887dd3d3dae4802f56192 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 29 Nov 2023 17:34:41 -0800
Subject: [PATCH 122/438] chore: use Sequence for input List like types (#2178)

---
 playwright/_impl/_api_structures.py           |   4 +-
 playwright/_impl/_assertions.py               |  65 ++--
 playwright/_impl/_browser.py                  |   8 +-
 playwright/_impl/_browser_context.py          |   9 +-
 playwright/_impl/_browser_type.py             |  12 +-
 playwright/_impl/_connection.py               |   5 +-
 playwright/_impl/_element_handle.py           |  50 +--
 playwright/_impl/_file_chooser.py             |   6 +-
 playwright/_impl/_frame.py                    |  33 +-
 playwright/_impl/_impl_to_api_mapping.py      |   4 +-
 playwright/_impl/_js_handle.py                |   3 +-
 playwright/_impl/_locator.py                  |  23 +-
 playwright/_impl/_page.py                     |  23 +-
 playwright/_impl/_set_input_files_helpers.py  |  13 +-
 playwright/async_api/_generated.py            | 284 +++++++++---------
 playwright/sync_api/_generated.py             | 284 +++++++++---------
 pyproject.toml                                |   2 +-
 scripts/documentation_provider.py             |  41 ++-
 scripts/generate_api.py                       |   7 +-
 .../test_browsercontext_request_fallback.py   |   3 +-
 tests/async/test_interception.py              |   6 +-
 tests/async/test_page_request_fallback.py     |   3 +-
 22 files changed, 481 insertions(+), 407 deletions(-)

diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index a3240ee5c..f45f713a1 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -13,7 +13,7 @@
 # limitations under the License.
 
 import sys
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Dict, List, Optional, Sequence, Union
 
 if sys.version_info >= (3, 8):  # pragma: no cover
     from typing import Literal, TypedDict
@@ -185,7 +185,7 @@ class ExpectedTextValue(TypedDict, total=False):
 
 class FrameExpectOptions(TypedDict, total=False):
     expressionArg: Any
-    expectedText: Optional[List[ExpectedTextValue]]
+    expectedText: Optional[Sequence[ExpectedTextValue]]
     expectedNumber: Optional[float]
     expectedValue: Optional[Any]
     useInnerText: Optional[bool]
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index d3e3f9e03..73dc76000 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -12,7 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from typing import Any, List, Optional, Pattern, Union
+import collections.abc
+from typing import Any, List, Optional, Pattern, Sequence, Union
 from urllib.parse import urljoin
 
 from playwright._impl._api_structures import ExpectedTextValue, FrameExpectOptions
@@ -149,9 +150,9 @@ def _not(self) -> "LocatorAssertions":
     async def to_contain_text(
         self,
         expected: Union[
-            List[str],
-            List[Pattern[str]],
-            List[Union[Pattern[str], str]],
+            Sequence[str],
+            Sequence[Pattern[str]],
+            Sequence[Union[Pattern[str], str]],
             Pattern[str],
             str,
         ],
@@ -160,7 +161,9 @@ async def to_contain_text(
         ignore_case: bool = None,
     ) -> None:
         __tracebackhide__ = True
-        if isinstance(expected, list):
+        if isinstance(expected, collections.abc.Sequence) and not isinstance(
+            expected, str
+        ):
             expected_text = to_expected_text_values(
                 expected,
                 match_substring=True,
@@ -198,9 +201,9 @@ async def to_contain_text(
     async def not_to_contain_text(
         self,
         expected: Union[
-            List[str],
-            List[Pattern[str]],
-            List[Union[Pattern[str], str]],
+            Sequence[str],
+            Sequence[Pattern[str]],
+            Sequence[Union[Pattern[str], str]],
             Pattern[str],
             str,
         ],
@@ -244,16 +247,18 @@ async def not_to_have_attribute(
     async def to_have_class(
         self,
         expected: Union[
-            List[str],
-            List[Pattern[str]],
-            List[Union[Pattern[str], str]],
+            Sequence[str],
+            Sequence[Pattern[str]],
+            Sequence[Union[Pattern[str], str]],
             Pattern[str],
             str,
         ],
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
-        if isinstance(expected, list):
+        if isinstance(expected, collections.abc.Sequence) and not isinstance(
+            expected, str
+        ):
             expected_text = to_expected_text_values(expected)
             await self._expect_impl(
                 "to.have.class.array",
@@ -273,9 +278,9 @@ async def to_have_class(
     async def not_to_have_class(
         self,
         expected: Union[
-            List[str],
-            List[Pattern[str]],
-            List[Union[Pattern[str], str]],
+            Sequence[str],
+            Sequence[Pattern[str]],
+            Sequence[Union[Pattern[str], str]],
             Pattern[str],
             str,
         ],
@@ -402,7 +407,9 @@ async def not_to_have_value(
 
     async def to_have_values(
         self,
-        values: Union[List[str], List[Pattern[str]], List[Union[Pattern[str], str]]],
+        values: Union[
+            Sequence[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]]
+        ],
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
@@ -416,7 +423,9 @@ async def to_have_values(
 
     async def not_to_have_values(
         self,
-        values: Union[List[str], List[Pattern[str]], List[Union[Pattern[str], str]]],
+        values: Union[
+            Sequence[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]]
+        ],
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
@@ -425,9 +434,9 @@ async def not_to_have_values(
     async def to_have_text(
         self,
         expected: Union[
-            List[str],
-            List[Pattern[str]],
-            List[Union[Pattern[str], str]],
+            Sequence[str],
+            Sequence[Pattern[str]],
+            Sequence[Union[Pattern[str], str]],
             Pattern[str],
             str,
         ],
@@ -436,7 +445,9 @@ async def to_have_text(
         ignore_case: bool = None,
     ) -> None:
         __tracebackhide__ = True
-        if isinstance(expected, list):
+        if isinstance(expected, collections.abc.Sequence) and not isinstance(
+            expected, str
+        ):
             expected_text = to_expected_text_values(
                 expected,
                 normalize_white_space=True,
@@ -470,9 +481,9 @@ async def to_have_text(
     async def not_to_have_text(
         self,
         expected: Union[
-            List[str],
-            List[Pattern[str]],
-            List[Union[Pattern[str], str]],
+            Sequence[str],
+            Sequence[Pattern[str]],
+            Sequence[Union[Pattern[str], str]],
             Pattern[str],
             str,
         ],
@@ -758,11 +769,13 @@ def expected_regex(
 
 
 def to_expected_text_values(
-    items: Union[List[Pattern[str]], List[str], List[Union[str, Pattern[str]]]],
+    items: Union[
+        Sequence[Pattern[str]], Sequence[str], Sequence[Union[str, Pattern[str]]]
+    ],
     match_substring: bool = False,
     normalize_white_space: bool = False,
     ignore_case: Optional[bool] = None,
-) -> List[ExpectedTextValue]:
+) -> Sequence[ExpectedTextValue]:
     out: List[ExpectedTextValue] = []
     assert isinstance(items, list)
     for item in items:
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index 2fd9a8c50..8a248f703 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -15,7 +15,7 @@
 import json
 from pathlib import Path
 from types import SimpleNamespace
-from typing import TYPE_CHECKING, Dict, List, Optional, Pattern, Union, cast
+from typing import TYPE_CHECKING, Dict, List, Optional, Pattern, Sequence, Union, cast
 
 from playwright._impl._api_structures import (
     Geolocation,
@@ -96,7 +96,7 @@ async def new_context(
         locale: str = None,
         timezoneId: str = None,
         geolocation: Geolocation = None,
-        permissions: List[str] = None,
+        permissions: Sequence[str] = None,
         extraHTTPHeaders: Dict[str, str] = None,
         offline: bool = None,
         httpCredentials: HttpCredentials = None,
@@ -141,7 +141,7 @@ async def new_page(
         locale: str = None,
         timezoneId: str = None,
         geolocation: Geolocation = None,
-        permissions: List[str] = None,
+        permissions: Sequence[str] = None,
         extraHTTPHeaders: Dict[str, str] = None,
         offline: bool = None,
         httpCredentials: HttpCredentials = None,
@@ -200,7 +200,7 @@ async def start_tracing(
         page: Page = None,
         path: Union[str, Path] = None,
         screenshots: bool = None,
-        categories: List[str] = None,
+        categories: Sequence[str] = None,
     ) -> None:
         params = locals_to_params(locals())
         if page:
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index d978b1201..74ceac9a1 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -25,6 +25,7 @@
     List,
     Optional,
     Pattern,
+    Sequence,
     Set,
     Union,
     cast,
@@ -284,21 +285,21 @@ async def new_page(self) -> Page:
             raise Error("Please use browser.new_context()")
         return from_channel(await self._channel.send("newPage"))
 
-    async def cookies(self, urls: Union[str, List[str]] = None) -> List[Cookie]:
+    async def cookies(self, urls: Union[str, Sequence[str]] = None) -> List[Cookie]:
         if urls is None:
             urls = []
-        if not isinstance(urls, list):
+        if isinstance(urls, str):
             urls = [urls]
         return await self._channel.send("cookies", dict(urls=urls))
 
-    async def add_cookies(self, cookies: List[SetCookieParam]) -> None:
+    async def add_cookies(self, cookies: Sequence[SetCookieParam]) -> None:
         await self._channel.send("addCookies", dict(cookies=cookies))
 
     async def clear_cookies(self) -> None:
         await self._channel.send("clearCookies")
 
     async def grant_permissions(
-        self, permissions: List[str], origin: str = None
+        self, permissions: Sequence[str], origin: str = None
     ) -> None:
         await self._channel.send("grantPermissions", locals_to_params(locals()))
 
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 49013df29..28a0e7cb4 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -15,7 +15,7 @@
 import asyncio
 import pathlib
 from pathlib import Path
-from typing import TYPE_CHECKING, Dict, List, Optional, Pattern, Union, cast
+from typing import TYPE_CHECKING, Dict, Optional, Pattern, Sequence, Union, cast
 
 from playwright._impl._api_structures import (
     Geolocation,
@@ -72,8 +72,8 @@ async def launch(
         self,
         executablePath: Union[str, Path] = None,
         channel: str = None,
-        args: List[str] = None,
-        ignoreDefaultArgs: Union[bool, List[str]] = None,
+        args: Sequence[str] = None,
+        ignoreDefaultArgs: Union[bool, Sequence[str]] = None,
         handleSIGINT: bool = None,
         handleSIGTERM: bool = None,
         handleSIGHUP: bool = None,
@@ -101,8 +101,8 @@ async def launch_persistent_context(
         userDataDir: Union[str, Path],
         channel: str = None,
         executablePath: Union[str, Path] = None,
-        args: List[str] = None,
-        ignoreDefaultArgs: Union[bool, List[str]] = None,
+        args: Sequence[str] = None,
+        ignoreDefaultArgs: Union[bool, Sequence[str]] = None,
         handleSIGINT: bool = None,
         handleSIGTERM: bool = None,
         handleSIGHUP: bool = None,
@@ -123,7 +123,7 @@ async def launch_persistent_context(
         locale: str = None,
         timezoneId: str = None,
         geolocation: Geolocation = None,
-        permissions: List[str] = None,
+        permissions: Sequence[str] = None,
         extraHTTPHeaders: Dict[str, str] = None,
         offline: bool = None,
         httpCredentials: HttpCredentials = None,
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 4c6bac00a..f1e0dd34f 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import asyncio
+import collections.abc
 import contextvars
 import datetime
 import inspect
@@ -455,7 +456,9 @@ def _replace_channels_with_guids(
             return payload
         if isinstance(payload, Path):
             return str(payload)
-        if isinstance(payload, list):
+        if isinstance(payload, collections.abc.Sequence) and not isinstance(
+            payload, str
+        ):
             return list(map(self._replace_channels_with_guids, payload))
         if isinstance(payload, Channel):
             return dict(guid=payload._guid)
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 3636f3529..03e49eb04 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -15,7 +15,17 @@
 import base64
 import sys
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Union, cast
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    List,
+    Optional,
+    Sequence,
+    Union,
+    cast,
+)
 
 from playwright._impl._api_structures import FilePayload, FloatRect, Position
 from playwright._impl._connection import ChannelOwner, from_nullable_channel
@@ -103,7 +113,7 @@ async def scroll_into_view_if_needed(self, timeout: float = None) -> None:
 
     async def hover(
         self,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
         noWaitAfter: bool = None,
@@ -114,7 +124,7 @@ async def hover(
 
     async def click(
         self,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         delay: float = None,
         button: MouseButton = None,
@@ -128,7 +138,7 @@ async def click(
 
     async def dblclick(
         self,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         delay: float = None,
         button: MouseButton = None,
@@ -141,10 +151,10 @@ async def dblclick(
 
     async def select_option(
         self,
-        value: Union[str, List[str]] = None,
-        index: Union[int, List[int]] = None,
-        label: Union[str, List[str]] = None,
-        element: Union["ElementHandle", List["ElementHandle"]] = None,
+        value: Union[str, Sequence[str]] = None,
+        index: Union[int, Sequence[int]] = None,
+        label: Union[str, Sequence[str]] = None,
+        element: Union["ElementHandle", Sequence["ElementHandle"]] = None,
         timeout: float = None,
         force: bool = None,
         noWaitAfter: bool = None,
@@ -161,7 +171,7 @@ async def select_option(
 
     async def tap(
         self,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
         force: bool = None,
@@ -187,7 +197,9 @@ async def input_value(self, timeout: float = None) -> str:
 
     async def set_input_files(
         self,
-        files: Union[str, Path, FilePayload, List[Union[str, Path]], List[FilePayload]],
+        files: Union[
+            str, Path, FilePayload, Sequence[Union[str, Path]], Sequence[FilePayload]
+        ],
         timeout: float = None,
         noWaitAfter: bool = None,
     ) -> None:
@@ -284,7 +296,7 @@ async def screenshot(
         animations: Literal["allow", "disabled"] = None,
         caret: Literal["hide", "initial"] = None,
         scale: Literal["css", "device"] = None,
-        mask: List["Locator"] = None,
+        mask: Sequence["Locator"] = None,
         mask_color: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
@@ -378,10 +390,10 @@ async def wait_for_selector(
 
 
 def convert_select_option_values(
-    value: Union[str, List[str]] = None,
-    index: Union[int, List[int]] = None,
-    label: Union[str, List[str]] = None,
-    element: Union["ElementHandle", List["ElementHandle"]] = None,
+    value: Union[str, Sequence[str]] = None,
+    index: Union[int, Sequence[int]] = None,
+    label: Union[str, Sequence[str]] = None,
+    element: Union["ElementHandle", Sequence["ElementHandle"]] = None,
 ) -> Any:
     if value is None and index is None and label is None and element is None:
         return {}
@@ -389,19 +401,19 @@ def convert_select_option_values(
     options: Any = None
     elements: Any = None
     if value:
-        if not isinstance(value, list):
+        if isinstance(value, str):
             value = [value]
         options = (options or []) + list(map(lambda e: dict(valueOrLabel=e), value))
     if index:
-        if not isinstance(index, list):
+        if isinstance(index, int):
             index = [index]
         options = (options or []) + list(map(lambda e: dict(index=e), index))
     if label:
-        if not isinstance(label, list):
+        if isinstance(label, str):
             label = [label]
         options = (options or []) + list(map(lambda e: dict(label=e), label))
     if element:
-        if not isinstance(element, list):
+        if isinstance(element, ElementHandle):
             element = [element]
         elements = list(map(lambda e: e._channel, element))
 
diff --git a/playwright/_impl/_file_chooser.py b/playwright/_impl/_file_chooser.py
index a15050fc0..951919d22 100644
--- a/playwright/_impl/_file_chooser.py
+++ b/playwright/_impl/_file_chooser.py
@@ -13,7 +13,7 @@
 # limitations under the License.
 
 from pathlib import Path
-from typing import TYPE_CHECKING, List, Union
+from typing import TYPE_CHECKING, Sequence, Union
 
 from playwright._impl._api_structures import FilePayload
 
@@ -48,7 +48,9 @@ def is_multiple(self) -> bool:
 
     async def set_files(
         self,
-        files: Union[str, Path, FilePayload, List[Union[str, Path]], List[FilePayload]],
+        files: Union[
+            str, Path, FilePayload, Sequence[Union[str, Path]], Sequence[FilePayload]
+        ],
         timeout: float = None,
         noWaitAfter: bool = None,
     ) -> None:
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 7fde8c4ef..2cfbb7240 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -15,7 +15,18 @@
 import asyncio
 import sys
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Dict, List, Optional, Pattern, Set, Union, cast
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    List,
+    Optional,
+    Pattern,
+    Sequence,
+    Set,
+    Union,
+    cast,
+)
 
 from pyee import EventEmitter
 
@@ -469,7 +480,7 @@ async def add_style_tag(
     async def click(
         self,
         selector: str,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         delay: float = None,
         button: MouseButton = None,
@@ -485,7 +496,7 @@ async def click(
     async def dblclick(
         self,
         selector: str,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         delay: float = None,
         button: MouseButton = None,
@@ -500,7 +511,7 @@ async def dblclick(
     async def tap(
         self,
         selector: str,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
         force: bool = None,
@@ -625,7 +636,7 @@ async def get_attribute(
     async def hover(
         self,
         selector: str,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
         noWaitAfter: bool = None,
@@ -652,10 +663,10 @@ async def drag_and_drop(
     async def select_option(
         self,
         selector: str,
-        value: Union[str, List[str]] = None,
-        index: Union[int, List[int]] = None,
-        label: Union[str, List[str]] = None,
-        element: Union["ElementHandle", List["ElementHandle"]] = None,
+        value: Union[str, Sequence[str]] = None,
+        index: Union[int, Sequence[int]] = None,
+        label: Union[str, Sequence[str]] = None,
+        element: Union["ElementHandle", Sequence["ElementHandle"]] = None,
         timeout: float = None,
         noWaitAfter: bool = None,
         strict: bool = None,
@@ -684,7 +695,9 @@ async def input_value(
     async def set_input_files(
         self,
         selector: str,
-        files: Union[str, Path, FilePayload, List[Union[str, Path]], List[FilePayload]],
+        files: Union[
+            str, Path, FilePayload, Sequence[Union[str, Path]], Sequence[FilePayload]
+        ],
         strict: bool = None,
         timeout: float = None,
         noWaitAfter: bool = None,
diff --git a/playwright/_impl/_impl_to_api_mapping.py b/playwright/_impl/_impl_to_api_mapping.py
index 60a748fdc..4315e1868 100644
--- a/playwright/_impl/_impl_to_api_mapping.py
+++ b/playwright/_impl/_impl_to_api_mapping.py
@@ -13,7 +13,7 @@
 # limitations under the License.
 
 import inspect
-from typing import Any, Callable, Dict, List, Optional, Union
+from typing import Any, Callable, Dict, List, Optional, Sequence, Union
 
 from playwright._impl._errors import Error
 from playwright._impl._map import Map
@@ -81,7 +81,7 @@ def from_impl(self, obj: Any) -> Any:
     def from_impl_nullable(self, obj: Any = None) -> Optional[Any]:
         return self.from_impl(obj) if obj else None
 
-    def from_impl_list(self, items: List[Any]) -> List[Any]:
+    def from_impl_list(self, items: Sequence[Any]) -> List[Any]:
         return list(map(lambda a: self.from_impl(a), items))
 
     def from_impl_dict(self, map: Dict[str, Any]) -> Dict[str, Any]:
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index b23b61ced..4bd8146b1 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import collections.abc
 import math
 from datetime import datetime
 from typing import TYPE_CHECKING, Any, Dict, List, Optional
@@ -140,7 +141,7 @@ def serialize_value(
     if value in visitor_info.visited:
         return dict(ref=visitor_info.visited[value])
 
-    if isinstance(value, list):
+    if isinstance(value, collections.abc.Sequence) and not isinstance(value, str):
         id = visitor_info.visit(value)
         a = []
         for e in value:
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 7591ff116..3f9fa5ce3 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -25,6 +25,7 @@
     List,
     Optional,
     Pattern,
+    Sequence,
     Tuple,
     TypeVar,
     Union,
@@ -144,7 +145,7 @@ async def check(
 
     async def click(
         self,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         delay: float = None,
         button: MouseButton = None,
@@ -159,7 +160,7 @@ async def click(
 
     async def dblclick(
         self,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         delay: float = None,
         button: MouseButton = None,
@@ -415,7 +416,7 @@ async def get_attribute(self, name: str, timeout: float = None) -> Optional[str]
 
     async def hover(
         self,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
         noWaitAfter: bool = None,
@@ -521,7 +522,7 @@ async def screenshot(
         animations: Literal["allow", "disabled"] = None,
         caret: Literal["hide", "initial"] = None,
         scale: Literal["css", "device"] = None,
-        mask: List["Locator"] = None,
+        mask: Sequence["Locator"] = None,
         mask_color: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
@@ -542,10 +543,10 @@ async def scroll_into_view_if_needed(
 
     async def select_option(
         self,
-        value: Union[str, List[str]] = None,
-        index: Union[int, List[int]] = None,
-        label: Union[str, List[str]] = None,
-        element: Union["ElementHandle", List["ElementHandle"]] = None,
+        value: Union[str, Sequence[str]] = None,
+        index: Union[int, Sequence[int]] = None,
+        label: Union[str, Sequence[str]] = None,
+        element: Union["ElementHandle", Sequence["ElementHandle"]] = None,
         timeout: float = None,
         noWaitAfter: bool = None,
         force: bool = None,
@@ -572,8 +573,8 @@ async def set_input_files(
             str,
             pathlib.Path,
             FilePayload,
-            List[Union[str, pathlib.Path]],
-            List[FilePayload],
+            Sequence[Union[str, pathlib.Path]],
+            Sequence[FilePayload],
         ],
         timeout: float = None,
         noWaitAfter: bool = None,
@@ -587,7 +588,7 @@ async def set_input_files(
 
     async def tap(
         self,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
         force: bool = None,
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 8c9f4557a..2bfae2090 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -27,6 +27,7 @@
     List,
     Optional,
     Pattern,
+    Sequence,
     Union,
     cast,
 )
@@ -636,7 +637,7 @@ async def screenshot(
         animations: Literal["allow", "disabled"] = None,
         caret: Literal["hide", "initial"] = None,
         scale: Literal["css", "device"] = None,
-        mask: List["Locator"] = None,
+        mask: Sequence["Locator"] = None,
         mask_color: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
@@ -680,7 +681,7 @@ def is_closed(self) -> bool:
     async def click(
         self,
         selector: str,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         delay: float = None,
         button: MouseButton = None,
@@ -696,7 +697,7 @@ async def click(
     async def dblclick(
         self,
         selector: str,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         delay: float = None,
         button: MouseButton = None,
@@ -711,7 +712,7 @@ async def dblclick(
     async def tap(
         self,
         selector: str,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
         force: bool = None,
@@ -833,7 +834,7 @@ async def get_attribute(
     async def hover(
         self,
         selector: str,
-        modifiers: List[KeyboardModifier] = None,
+        modifiers: Sequence[KeyboardModifier] = None,
         position: Position = None,
         timeout: float = None,
         noWaitAfter: bool = None,
@@ -860,10 +861,10 @@ async def drag_and_drop(
     async def select_option(
         self,
         selector: str,
-        value: Union[str, List[str]] = None,
-        index: Union[int, List[int]] = None,
-        label: Union[str, List[str]] = None,
-        element: Union["ElementHandle", List["ElementHandle"]] = None,
+        value: Union[str, Sequence[str]] = None,
+        index: Union[int, Sequence[int]] = None,
+        label: Union[str, Sequence[str]] = None,
+        element: Union["ElementHandle", Sequence["ElementHandle"]] = None,
         timeout: float = None,
         noWaitAfter: bool = None,
         force: bool = None,
@@ -881,7 +882,9 @@ async def input_value(
     async def set_input_files(
         self,
         selector: str,
-        files: Union[str, Path, FilePayload, List[Union[str, Path]], List[FilePayload]],
+        files: Union[
+            str, Path, FilePayload, Sequence[Union[str, Path]], Sequence[FilePayload]
+        ],
         timeout: float = None,
         strict: bool = None,
         noWaitAfter: bool = None,
diff --git a/playwright/_impl/_set_input_files_helpers.py b/playwright/_impl/_set_input_files_helpers.py
index b1e929252..a5db6c1da 100644
--- a/playwright/_impl/_set_input_files_helpers.py
+++ b/playwright/_impl/_set_input_files_helpers.py
@@ -12,10 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 import base64
+import collections.abc
 import os
 import sys
 from pathlib import Path
-from typing import TYPE_CHECKING, Dict, List, Optional, Union, cast
+from typing import TYPE_CHECKING, Dict, List, Optional, Sequence, Union, cast
 
 if sys.version_info >= (3, 8):  # pragma: no cover
     from typing import TypedDict
@@ -41,10 +42,16 @@ class InputFilesList(TypedDict, total=False):
 
 
 async def convert_input_files(
-    files: Union[str, Path, FilePayload, List[Union[str, Path]], List[FilePayload]],
+    files: Union[
+        str, Path, FilePayload, Sequence[Union[str, Path]], Sequence[FilePayload]
+    ],
     context: "BrowserContext",
 ) -> InputFilesList:
-    items = files if isinstance(files, list) else [files]
+    items = (
+        files
+        if isinstance(files, collections.abc.Sequence) and not isinstance(files, str)
+        else [files]
+    )
 
     if any([isinstance(item, (str, Path)) for item in items]):
         if not all([isinstance(item, (str, Path)) for item in items]):
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 4f0fae513..3ab7a143f 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -1986,7 +1986,7 @@ async def hover(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -2009,7 +2009,7 @@ async def hover(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -2044,7 +2044,7 @@ async def click(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -2070,7 +2070,7 @@ async def click(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -2114,7 +2114,7 @@ async def dblclick(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -2142,7 +2142,7 @@ async def dblclick(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -2181,12 +2181,12 @@ async def dblclick(
 
     async def select_option(
         self,
-        value: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        value: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         *,
-        index: typing.Optional[typing.Union[int, typing.List[int]]] = None,
-        label: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        index: typing.Optional[typing.Union[int, typing.Sequence[int]]] = None,
+        label: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         element: typing.Optional[
-            typing.Union["ElementHandle", typing.List["ElementHandle"]]
+            typing.Union["ElementHandle", typing.Sequence["ElementHandle"]]
         ] = None,
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
@@ -2228,15 +2228,15 @@ async def select_option(
 
         Parameters
         ----------
-        value : Union[List[str], str, None]
+        value : Union[Sequence[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        index : Union[List[int], int, None]
+        index : Union[Sequence[int], int, None]
             Options to select by index. Optional.
-        label : Union[List[str], str, None]
+        label : Union[Sequence[str], str, None]
             Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        element : Union[ElementHandle, List[ElementHandle], None]
+        element : Union[ElementHandle, Sequence[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
             Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
@@ -2269,7 +2269,7 @@ async def tap(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -2294,7 +2294,7 @@ async def tap(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -2424,8 +2424,8 @@ async def set_input_files(
             str,
             pathlib.Path,
             FilePayload,
-            typing.List[typing.Union[str, pathlib.Path]],
-            typing.List[FilePayload],
+            typing.Sequence[typing.Union[str, pathlib.Path]],
+            typing.Sequence[FilePayload],
         ],
         *,
         timeout: typing.Optional[float] = None,
@@ -2443,7 +2443,7 @@ async def set_input_files(
 
         Parameters
         ----------
-        files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
+        files : Union[Sequence[Union[pathlib.Path, str]], Sequence[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         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.
@@ -2768,7 +2768,7 @@ async def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None
     ) -> bytes:
         """ElementHandle.screenshot
@@ -2814,7 +2814,7 @@ async def screenshot(
             screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
-        mask : Union[List[Locator], None]
+        mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
             box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
         mask_color : Union[str, None]
@@ -3222,8 +3222,8 @@ async def set_files(
             str,
             pathlib.Path,
             FilePayload,
-            typing.List[typing.Union[str, pathlib.Path]],
-            typing.List[FilePayload],
+            typing.Sequence[typing.Union[str, pathlib.Path]],
+            typing.Sequence[FilePayload],
         ],
         *,
         timeout: typing.Optional[float] = None,
@@ -3236,7 +3236,7 @@ async def set_files(
 
         Parameters
         ----------
-        files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
+        files : Union[Sequence[Union[pathlib.Path, str]], Sequence[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         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.
@@ -4399,7 +4399,7 @@ async def click(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -4429,7 +4429,7 @@ async def click(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -4479,7 +4479,7 @@ async def dblclick(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -4511,7 +4511,7 @@ async def dblclick(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -4558,7 +4558,7 @@ async def tap(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -4587,7 +4587,7 @@ async def tap(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -5448,7 +5448,7 @@ async def hover(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -5475,7 +5475,7 @@ async def hover(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -5574,12 +5574,12 @@ async def drag_and_drop(
     async def select_option(
         self,
         selector: str,
-        value: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        value: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         *,
-        index: typing.Optional[typing.Union[int, typing.List[int]]] = None,
-        label: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        index: typing.Optional[typing.Union[int, typing.Sequence[int]]] = None,
+        label: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         element: typing.Optional[
-            typing.Union["ElementHandle", typing.List["ElementHandle"]]
+            typing.Union["ElementHandle", typing.Sequence["ElementHandle"]]
         ] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
@@ -5624,15 +5624,15 @@ async def select_option(
         ----------
         selector : str
             A selector to query for.
-        value : Union[List[str], str, None]
+        value : Union[Sequence[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        index : Union[List[int], int, None]
+        index : Union[Sequence[int], int, None]
             Options to select by index. Optional.
-        label : Union[List[str], str, None]
+        label : Union[Sequence[str], str, None]
             Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        element : Union[ElementHandle, List[ElementHandle], None]
+        element : Union[ElementHandle, Sequence[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
             Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
@@ -5711,8 +5711,8 @@ async def set_input_files(
             str,
             pathlib.Path,
             FilePayload,
-            typing.List[typing.Union[str, pathlib.Path]],
-            typing.List[FilePayload],
+            typing.Sequence[typing.Union[str, pathlib.Path]],
+            typing.Sequence[FilePayload],
         ],
         *,
         strict: typing.Optional[bool] = None,
@@ -5734,7 +5734,7 @@ async def set_input_files(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
+        files : Union[Sequence[Union[pathlib.Path, str]], Sequence[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9923,7 +9923,7 @@ async def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None
     ) -> bytes:
         """Page.screenshot
@@ -9967,7 +9967,7 @@ async def screenshot(
             screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
-        mask : Union[List[Locator], None]
+        mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
             box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
         mask_color : Union[str, None]
@@ -10054,7 +10054,7 @@ async def click(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -10084,7 +10084,7 @@ async def click(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -10134,7 +10134,7 @@ async def dblclick(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -10166,7 +10166,7 @@ async def dblclick(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -10213,7 +10213,7 @@ async def tap(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -10242,7 +10242,7 @@ async def tap(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -11101,7 +11101,7 @@ async def hover(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -11128,7 +11128,7 @@ async def hover(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -11254,12 +11254,12 @@ async def drag_and_drop(
     async def select_option(
         self,
         selector: str,
-        value: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        value: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         *,
-        index: typing.Optional[typing.Union[int, typing.List[int]]] = None,
-        label: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        index: typing.Optional[typing.Union[int, typing.Sequence[int]]] = None,
+        label: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         element: typing.Optional[
-            typing.Union["ElementHandle", typing.List["ElementHandle"]]
+            typing.Union["ElementHandle", typing.Sequence["ElementHandle"]]
         ] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
@@ -11305,15 +11305,15 @@ async def select_option(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        value : Union[List[str], str, None]
+        value : Union[Sequence[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        index : Union[List[int], int, None]
+        index : Union[Sequence[int], int, None]
             Options to select by index. Optional.
-        label : Union[List[str], str, None]
+        label : Union[Sequence[str], str, None]
             Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        element : Union[ElementHandle, List[ElementHandle], None]
+        element : Union[ElementHandle, Sequence[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
             Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
@@ -11392,8 +11392,8 @@ async def set_input_files(
             str,
             pathlib.Path,
             FilePayload,
-            typing.List[typing.Union[str, pathlib.Path]],
-            typing.List[FilePayload],
+            typing.Sequence[typing.Union[str, pathlib.Path]],
+            typing.Sequence[FilePayload],
         ],
         *,
         timeout: typing.Optional[float] = None,
@@ -11415,7 +11415,7 @@ async def set_input_files(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
+        files : Union[Sequence[Union[pathlib.Path, str]], Sequence[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         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.
@@ -13063,7 +13063,7 @@ async def new_page(self) -> "Page":
         return mapping.from_impl(await self._impl_obj.new_page())
 
     async def cookies(
-        self, urls: typing.Optional[typing.Union[str, typing.List[str]]] = None
+        self, urls: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None
     ) -> typing.List[Cookie]:
         """BrowserContext.cookies
 
@@ -13072,7 +13072,7 @@ async def cookies(
 
         Parameters
         ----------
-        urls : Union[List[str], str, None]
+        urls : Union[Sequence[str], str, None]
             Optional list of URLs.
 
         Returns
@@ -13084,7 +13084,7 @@ async def cookies(
             await self._impl_obj.cookies(urls=mapping.to_impl(urls))
         )
 
-    async def add_cookies(self, cookies: typing.List[SetCookieParam]) -> None:
+    async def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
         """BrowserContext.add_cookies
 
         Adds cookies into this browser context. All pages within this context will have these cookies installed. Cookies
@@ -13102,7 +13102,7 @@ async def add_cookies(self, cookies: typing.List[SetCookieParam]) -> None:
 
         Parameters
         ----------
-        cookies : List[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
+        cookies : Sequence[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
             Adds cookies to the browser context.
 
             For the cookie to apply to all subdomains as well, prefix domain with a dot, like this: ".example.com".
@@ -13121,7 +13121,7 @@ async def clear_cookies(self) -> None:
         return mapping.from_maybe_impl(await self._impl_obj.clear_cookies())
 
     async def grant_permissions(
-        self, permissions: typing.List[str], *, origin: typing.Optional[str] = None
+        self, permissions: typing.Sequence[str], *, origin: typing.Optional[str] = None
     ) -> None:
         """BrowserContext.grant_permissions
 
@@ -13130,7 +13130,7 @@ async def grant_permissions(
 
         Parameters
         ----------
-        permissions : List[str]
+        permissions : Sequence[str]
             A permission or an array of permissions to grant. Permissions can be one of the following values:
             - `'geolocation'`
             - `'midi'`
@@ -14039,7 +14039,7 @@ async def new_context(
         locale: typing.Optional[str] = None,
         timezone_id: typing.Optional[str] = None,
         geolocation: typing.Optional[Geolocation] = None,
-        permissions: typing.Optional[typing.List[str]] = None,
+        permissions: typing.Optional[typing.Sequence[str]] = None,
         extra_http_headers: typing.Optional[typing.Dict[str, str]] = None,
         offline: typing.Optional[bool] = None,
         http_credentials: typing.Optional[HttpCredentials] = None,
@@ -14137,7 +14137,7 @@ async def new_context(
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
-        permissions : Union[List[str], None]
+        permissions : Union[Sequence[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
             more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
@@ -14191,7 +14191,7 @@ async def new_context(
             Dimensions of the recorded videos. If not specified the size will be equal to `viewport` scaled down to fit into
             800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
             will be scaled down if necessary to fit the specified size.
-        storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
+        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}]}]}, None]
             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
@@ -14282,7 +14282,7 @@ async def new_page(
         locale: typing.Optional[str] = None,
         timezone_id: typing.Optional[str] = None,
         geolocation: typing.Optional[Geolocation] = None,
-        permissions: typing.Optional[typing.List[str]] = None,
+        permissions: typing.Optional[typing.Sequence[str]] = None,
         extra_http_headers: typing.Optional[typing.Dict[str, str]] = None,
         offline: typing.Optional[bool] = None,
         http_credentials: typing.Optional[HttpCredentials] = None,
@@ -14351,7 +14351,7 @@ async def new_page(
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
-        permissions : Union[List[str], None]
+        permissions : Union[Sequence[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
             more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
@@ -14405,7 +14405,7 @@ async def new_page(
             Dimensions of the recorded videos. If not specified the size will be equal to `viewport` scaled down to fit into
             800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
             will be scaled down if necessary to fit the specified size.
-        storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
+        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}]}]}, None]
             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
@@ -14526,7 +14526,7 @@ async def start_tracing(
         page: typing.Optional["Page"] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         screenshots: typing.Optional[bool] = None,
-        categories: typing.Optional[typing.List[str]] = None
+        categories: typing.Optional[typing.Sequence[str]] = None
     ) -> None:
         """Browser.start_tracing
 
@@ -14560,7 +14560,7 @@ async def start_tracing(
             A path to write the trace file to.
         screenshots : Union[bool, None]
             captures screenshots in the trace.
-        categories : Union[List[str], None]
+        categories : Union[Sequence[str], None]
             specify custom categories to use instead of default.
         """
 
@@ -14624,9 +14624,9 @@ async def launch(
         *,
         executable_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         channel: typing.Optional[str] = None,
-        args: typing.Optional[typing.List[str]] = None,
+        args: typing.Optional[typing.Sequence[str]] = None,
         ignore_default_args: typing.Optional[
-            typing.Union[bool, typing.List[str]]
+            typing.Union[bool, typing.Sequence[str]]
         ] = None,
         handle_sigint: typing.Optional[bool] = None,
         handle_sigterm: typing.Optional[bool] = None,
@@ -14689,10 +14689,10 @@ async def launch(
             Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
             "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
             [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
-        args : Union[List[str], None]
+        args : Union[Sequence[str], None]
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
             [here](http://peter.sh/experiments/chromium-command-line-switches/).
-        ignore_default_args : Union[List[str], bool, None]
+        ignore_default_args : Union[Sequence[str], bool, None]
             If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`. If an array is
             given, then filters out the given default arguments. Dangerous option; use with care. Defaults to `false`.
         handle_sigint : Union[bool, None]
@@ -14764,9 +14764,9 @@ async def launch_persistent_context(
         *,
         channel: typing.Optional[str] = None,
         executable_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
-        args: typing.Optional[typing.List[str]] = None,
+        args: typing.Optional[typing.Sequence[str]] = None,
         ignore_default_args: typing.Optional[
-            typing.Union[bool, typing.List[str]]
+            typing.Union[bool, typing.Sequence[str]]
         ] = None,
         handle_sigint: typing.Optional[bool] = None,
         handle_sigterm: typing.Optional[bool] = None,
@@ -14788,7 +14788,7 @@ async def launch_persistent_context(
         locale: typing.Optional[str] = None,
         timezone_id: typing.Optional[str] = None,
         geolocation: typing.Optional[Geolocation] = None,
-        permissions: typing.Optional[typing.List[str]] = None,
+        permissions: typing.Optional[typing.Sequence[str]] = None,
         extra_http_headers: typing.Optional[typing.Dict[str, str]] = None,
         offline: typing.Optional[bool] = None,
         http_credentials: typing.Optional[HttpCredentials] = None,
@@ -14844,10 +14844,10 @@ async def launch_persistent_context(
             Path to a browser executable to run instead of the bundled one. If `executablePath` is a relative path, then it is
             resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
             Firefox or WebKit, use at your own risk.
-        args : Union[List[str], None]
+        args : Union[Sequence[str], None]
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
             [here](http://peter.sh/experiments/chromium-command-line-switches/).
-        ignore_default_args : Union[List[str], bool, None]
+        ignore_default_args : Union[Sequence[str], bool, None]
             If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`. If an array is
             given, then filters out the given default arguments. Dangerous option; use with care. Defaults to `false`.
         handle_sigint : Union[bool, None]
@@ -14904,7 +14904,7 @@ async def launch_persistent_context(
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
-        permissions : Union[List[str], None]
+        permissions : Union[Sequence[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
             more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
@@ -15620,7 +15620,7 @@ async def click(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -15676,7 +15676,7 @@ async def click(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -15720,7 +15720,7 @@ async def dblclick(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -15752,7 +15752,7 @@ async def dblclick(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -17097,7 +17097,7 @@ async def hover(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -17134,7 +17134,7 @@ async def hover(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -17509,7 +17509,7 @@ async def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None
     ) -> bytes:
         """Locator.screenshot
@@ -17579,7 +17579,7 @@ async def screenshot(
             screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
-        mask : Union[List[Locator], None]
+        mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
             box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
         mask_color : Union[str, None]
@@ -17628,12 +17628,12 @@ async def scroll_into_view_if_needed(
 
     async def select_option(
         self,
-        value: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        value: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         *,
-        index: typing.Optional[typing.Union[int, typing.List[int]]] = None,
-        label: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        index: typing.Optional[typing.Union[int, typing.Sequence[int]]] = None,
+        label: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         element: typing.Optional[
-            typing.Union["ElementHandle", typing.List["ElementHandle"]]
+            typing.Union["ElementHandle", typing.Sequence["ElementHandle"]]
         ] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
@@ -17687,15 +17687,15 @@ async def select_option(
 
         Parameters
         ----------
-        value : Union[List[str], str, None]
+        value : Union[Sequence[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        index : Union[List[int], int, None]
+        index : Union[Sequence[int], int, None]
             Options to select by index. Optional.
-        label : Union[List[str], str, None]
+        label : Union[Sequence[str], str, None]
             Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        element : Union[ElementHandle, List[ElementHandle], None]
+        element : Union[ElementHandle, Sequence[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
             Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
@@ -17758,8 +17758,8 @@ async def set_input_files(
             str,
             pathlib.Path,
             FilePayload,
-            typing.List[typing.Union[str, pathlib.Path]],
-            typing.List[FilePayload],
+            typing.Sequence[typing.Union[str, pathlib.Path]],
+            typing.Sequence[FilePayload],
         ],
         *,
         timeout: typing.Optional[float] = None,
@@ -17819,7 +17819,7 @@ async def set_input_files(
 
         Parameters
         ----------
-        files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
+        files : Union[Sequence[Union[pathlib.Path, str]], Sequence[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         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.
@@ -17839,7 +17839,7 @@ async def tap(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -17868,7 +17868,7 @@ async def tap(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -19107,7 +19107,7 @@ async def new_context(
         timeout : Union[float, None]
             Maximum time in milliseconds to wait for the response. Defaults to `30000` (30 seconds). Pass `0` to disable
             timeout.
-        storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
+        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}]}]}, None]
             Populates context with given storage state. This option can be used to initialize context with logged-in
             information obtained via `browser_context.storage_state()` or `a_pi_request_context.storage_state()`.
             Either a path to the file with saved storage, or the value returned by one of
@@ -19280,9 +19280,9 @@ class LocatorAssertions(AsyncBase):
     async def to_contain_text(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -19373,7 +19373,7 @@ async def to_contain_text(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -19397,9 +19397,9 @@ async def to_contain_text(
     async def not_to_contain_text(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -19414,7 +19414,7 @@ async def not_to_contain_text(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -19518,9 +19518,9 @@ async def not_to_have_attribute(
     async def to_have_class(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -19572,7 +19572,7 @@ async def to_have_class(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
@@ -19588,9 +19588,9 @@ async def to_have_class(
     async def not_to_have_class(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -19603,7 +19603,7 @@ async def not_to_have_class(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
@@ -19937,9 +19937,9 @@ async def not_to_have_value(
     async def to_have_values(
         self,
         values: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
         ],
         *,
         timeout: typing.Optional[float] = None
@@ -19981,7 +19981,7 @@ async def to_have_values(
 
         Parameters
         ----------
-        values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
+        values : Union[Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str]]
             Expected options currently selected.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
@@ -19997,9 +19997,9 @@ async def to_have_values(
     async def not_to_have_values(
         self,
         values: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
         ],
         *,
         timeout: typing.Optional[float] = None
@@ -20010,7 +20010,7 @@ async def not_to_have_values(
 
         Parameters
         ----------
-        values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
+        values : Union[Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str]]
             Expected options currently selected.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
@@ -20026,9 +20026,9 @@ async def not_to_have_values(
     async def to_have_text(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -20118,7 +20118,7 @@ async def to_have_text(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected string or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -20142,9 +20142,9 @@ async def to_have_text(
     async def not_to_have_text(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -20159,7 +20159,7 @@ async def not_to_have_text(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected string or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index a0c3ead75..af78b6a72 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -1994,7 +1994,7 @@ def hover(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -2017,7 +2017,7 @@ def hover(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -2054,7 +2054,7 @@ def click(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -2080,7 +2080,7 @@ def click(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -2126,7 +2126,7 @@ def dblclick(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -2154,7 +2154,7 @@ def dblclick(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -2195,12 +2195,12 @@ def dblclick(
 
     def select_option(
         self,
-        value: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        value: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         *,
-        index: typing.Optional[typing.Union[int, typing.List[int]]] = None,
-        label: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        index: typing.Optional[typing.Union[int, typing.Sequence[int]]] = None,
+        label: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         element: typing.Optional[
-            typing.Union["ElementHandle", typing.List["ElementHandle"]]
+            typing.Union["ElementHandle", typing.Sequence["ElementHandle"]]
         ] = None,
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
@@ -2242,15 +2242,15 @@ def select_option(
 
         Parameters
         ----------
-        value : Union[List[str], str, None]
+        value : Union[Sequence[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        index : Union[List[int], int, None]
+        index : Union[Sequence[int], int, None]
             Options to select by index. Optional.
-        label : Union[List[str], str, None]
+        label : Union[Sequence[str], str, None]
             Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        element : Union[ElementHandle, List[ElementHandle], None]
+        element : Union[ElementHandle, Sequence[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
             Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
@@ -2285,7 +2285,7 @@ def tap(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -2310,7 +2310,7 @@ def tap(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -2444,8 +2444,8 @@ def set_input_files(
             str,
             pathlib.Path,
             FilePayload,
-            typing.List[typing.Union[str, pathlib.Path]],
-            typing.List[FilePayload],
+            typing.Sequence[typing.Union[str, pathlib.Path]],
+            typing.Sequence[FilePayload],
         ],
         *,
         timeout: typing.Optional[float] = None,
@@ -2463,7 +2463,7 @@ def set_input_files(
 
         Parameters
         ----------
-        files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
+        files : Union[Sequence[Union[pathlib.Path, str]], Sequence[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         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.
@@ -2802,7 +2802,7 @@ def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None
     ) -> bytes:
         """ElementHandle.screenshot
@@ -2848,7 +2848,7 @@ def screenshot(
             screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
-        mask : Union[List[Locator], None]
+        mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
             box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
         mask_color : Union[str, None]
@@ -3268,8 +3268,8 @@ def set_files(
             str,
             pathlib.Path,
             FilePayload,
-            typing.List[typing.Union[str, pathlib.Path]],
-            typing.List[FilePayload],
+            typing.Sequence[typing.Union[str, pathlib.Path]],
+            typing.Sequence[FilePayload],
         ],
         *,
         timeout: typing.Optional[float] = None,
@@ -3282,7 +3282,7 @@ def set_files(
 
         Parameters
         ----------
-        files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
+        files : Union[Sequence[Union[pathlib.Path, str]], Sequence[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         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.
@@ -4481,7 +4481,7 @@ def click(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -4511,7 +4511,7 @@ def click(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -4563,7 +4563,7 @@ def dblclick(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -4595,7 +4595,7 @@ def dblclick(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -4644,7 +4644,7 @@ def tap(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -4673,7 +4673,7 @@ def tap(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -5546,7 +5546,7 @@ def hover(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -5573,7 +5573,7 @@ def hover(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -5676,12 +5676,12 @@ def drag_and_drop(
     def select_option(
         self,
         selector: str,
-        value: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        value: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         *,
-        index: typing.Optional[typing.Union[int, typing.List[int]]] = None,
-        label: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        index: typing.Optional[typing.Union[int, typing.Sequence[int]]] = None,
+        label: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         element: typing.Optional[
-            typing.Union["ElementHandle", typing.List["ElementHandle"]]
+            typing.Union["ElementHandle", typing.Sequence["ElementHandle"]]
         ] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
@@ -5726,15 +5726,15 @@ def select_option(
         ----------
         selector : str
             A selector to query for.
-        value : Union[List[str], str, None]
+        value : Union[Sequence[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        index : Union[List[int], int, None]
+        index : Union[Sequence[int], int, None]
             Options to select by index. Optional.
-        label : Union[List[str], str, None]
+        label : Union[Sequence[str], str, None]
             Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        element : Union[ElementHandle, List[ElementHandle], None]
+        element : Union[ElementHandle, Sequence[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
             Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
@@ -5817,8 +5817,8 @@ def set_input_files(
             str,
             pathlib.Path,
             FilePayload,
-            typing.List[typing.Union[str, pathlib.Path]],
-            typing.List[FilePayload],
+            typing.Sequence[typing.Union[str, pathlib.Path]],
+            typing.Sequence[FilePayload],
         ],
         *,
         strict: typing.Optional[bool] = None,
@@ -5840,7 +5840,7 @@ def set_input_files(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
+        files : Union[Sequence[Union[pathlib.Path, str]], Sequence[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9991,7 +9991,7 @@ def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None
     ) -> bytes:
         """Page.screenshot
@@ -10035,7 +10035,7 @@ def screenshot(
             screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
-        mask : Union[List[Locator], None]
+        mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
             box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
         mask_color : Union[str, None]
@@ -10126,7 +10126,7 @@ def click(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -10156,7 +10156,7 @@ def click(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -10208,7 +10208,7 @@ def dblclick(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -10240,7 +10240,7 @@ def dblclick(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -10289,7 +10289,7 @@ def tap(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -10318,7 +10318,7 @@ def tap(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -11189,7 +11189,7 @@ def hover(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -11216,7 +11216,7 @@ def hover(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -11346,12 +11346,12 @@ def drag_and_drop(
     def select_option(
         self,
         selector: str,
-        value: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        value: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         *,
-        index: typing.Optional[typing.Union[int, typing.List[int]]] = None,
-        label: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        index: typing.Optional[typing.Union[int, typing.Sequence[int]]] = None,
+        label: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         element: typing.Optional[
-            typing.Union["ElementHandle", typing.List["ElementHandle"]]
+            typing.Union["ElementHandle", typing.Sequence["ElementHandle"]]
         ] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
@@ -11397,15 +11397,15 @@ def select_option(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        value : Union[List[str], str, None]
+        value : Union[Sequence[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        index : Union[List[int], int, None]
+        index : Union[Sequence[int], int, None]
             Options to select by index. Optional.
-        label : Union[List[str], str, None]
+        label : Union[Sequence[str], str, None]
             Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        element : Union[ElementHandle, List[ElementHandle], None]
+        element : Union[ElementHandle, Sequence[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
             Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
@@ -11488,8 +11488,8 @@ def set_input_files(
             str,
             pathlib.Path,
             FilePayload,
-            typing.List[typing.Union[str, pathlib.Path]],
-            typing.List[FilePayload],
+            typing.Sequence[typing.Union[str, pathlib.Path]],
+            typing.Sequence[FilePayload],
         ],
         *,
         timeout: typing.Optional[float] = None,
@@ -11511,7 +11511,7 @@ def set_input_files(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
+        files : Union[Sequence[Union[pathlib.Path, str]], Sequence[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         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.
@@ -13113,7 +13113,7 @@ def new_page(self) -> "Page":
         return mapping.from_impl(self._sync(self._impl_obj.new_page()))
 
     def cookies(
-        self, urls: typing.Optional[typing.Union[str, typing.List[str]]] = None
+        self, urls: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None
     ) -> typing.List[Cookie]:
         """BrowserContext.cookies
 
@@ -13122,7 +13122,7 @@ def cookies(
 
         Parameters
         ----------
-        urls : Union[List[str], str, None]
+        urls : Union[Sequence[str], str, None]
             Optional list of URLs.
 
         Returns
@@ -13134,7 +13134,7 @@ def cookies(
             self._sync(self._impl_obj.cookies(urls=mapping.to_impl(urls)))
         )
 
-    def add_cookies(self, cookies: typing.List[SetCookieParam]) -> None:
+    def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
         """BrowserContext.add_cookies
 
         Adds cookies into this browser context. All pages within this context will have these cookies installed. Cookies
@@ -13152,7 +13152,7 @@ def add_cookies(self, cookies: typing.List[SetCookieParam]) -> None:
 
         Parameters
         ----------
-        cookies : List[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
+        cookies : Sequence[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
             Adds cookies to the browser context.
 
             For the cookie to apply to all subdomains as well, prefix domain with a dot, like this: ".example.com".
@@ -13171,7 +13171,7 @@ def clear_cookies(self) -> None:
         return mapping.from_maybe_impl(self._sync(self._impl_obj.clear_cookies()))
 
     def grant_permissions(
-        self, permissions: typing.List[str], *, origin: typing.Optional[str] = None
+        self, permissions: typing.Sequence[str], *, origin: typing.Optional[str] = None
     ) -> None:
         """BrowserContext.grant_permissions
 
@@ -13180,7 +13180,7 @@ def grant_permissions(
 
         Parameters
         ----------
-        permissions : List[str]
+        permissions : Sequence[str]
             A permission or an array of permissions to grant. Permissions can be one of the following values:
             - `'geolocation'`
             - `'midi'`
@@ -14099,7 +14099,7 @@ def new_context(
         locale: typing.Optional[str] = None,
         timezone_id: typing.Optional[str] = None,
         geolocation: typing.Optional[Geolocation] = None,
-        permissions: typing.Optional[typing.List[str]] = None,
+        permissions: typing.Optional[typing.Sequence[str]] = None,
         extra_http_headers: typing.Optional[typing.Dict[str, str]] = None,
         offline: typing.Optional[bool] = None,
         http_credentials: typing.Optional[HttpCredentials] = None,
@@ -14197,7 +14197,7 @@ def new_context(
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
-        permissions : Union[List[str], None]
+        permissions : Union[Sequence[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
             more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
@@ -14251,7 +14251,7 @@ def new_context(
             Dimensions of the recorded videos. If not specified the size will be equal to `viewport` scaled down to fit into
             800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
             will be scaled down if necessary to fit the specified size.
-        storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
+        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}]}]}, None]
             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
@@ -14344,7 +14344,7 @@ def new_page(
         locale: typing.Optional[str] = None,
         timezone_id: typing.Optional[str] = None,
         geolocation: typing.Optional[Geolocation] = None,
-        permissions: typing.Optional[typing.List[str]] = None,
+        permissions: typing.Optional[typing.Sequence[str]] = None,
         extra_http_headers: typing.Optional[typing.Dict[str, str]] = None,
         offline: typing.Optional[bool] = None,
         http_credentials: typing.Optional[HttpCredentials] = None,
@@ -14413,7 +14413,7 @@ def new_page(
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
-        permissions : Union[List[str], None]
+        permissions : Union[Sequence[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
             more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
@@ -14467,7 +14467,7 @@ def new_page(
             Dimensions of the recorded videos. If not specified the size will be equal to `viewport` scaled down to fit into
             800x800. If `viewport` is not configured explicitly the video size defaults to 800x450. Actual picture of each page
             will be scaled down if necessary to fit the specified size.
-        storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
+        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}]}]}, None]
             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
@@ -14590,7 +14590,7 @@ def start_tracing(
         page: typing.Optional["Page"] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         screenshots: typing.Optional[bool] = None,
-        categories: typing.Optional[typing.List[str]] = None
+        categories: typing.Optional[typing.Sequence[str]] = None
     ) -> None:
         """Browser.start_tracing
 
@@ -14624,7 +14624,7 @@ def start_tracing(
             A path to write the trace file to.
         screenshots : Union[bool, None]
             captures screenshots in the trace.
-        categories : Union[List[str], None]
+        categories : Union[Sequence[str], None]
             specify custom categories to use instead of default.
         """
 
@@ -14690,9 +14690,9 @@ def launch(
         *,
         executable_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         channel: typing.Optional[str] = None,
-        args: typing.Optional[typing.List[str]] = None,
+        args: typing.Optional[typing.Sequence[str]] = None,
         ignore_default_args: typing.Optional[
-            typing.Union[bool, typing.List[str]]
+            typing.Union[bool, typing.Sequence[str]]
         ] = None,
         handle_sigint: typing.Optional[bool] = None,
         handle_sigterm: typing.Optional[bool] = None,
@@ -14755,10 +14755,10 @@ def launch(
             Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
             "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
             [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
-        args : Union[List[str], None]
+        args : Union[Sequence[str], None]
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
             [here](http://peter.sh/experiments/chromium-command-line-switches/).
-        ignore_default_args : Union[List[str], bool, None]
+        ignore_default_args : Union[Sequence[str], bool, None]
             If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`. If an array is
             given, then filters out the given default arguments. Dangerous option; use with care. Defaults to `false`.
         handle_sigint : Union[bool, None]
@@ -14832,9 +14832,9 @@ def launch_persistent_context(
         *,
         channel: typing.Optional[str] = None,
         executable_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
-        args: typing.Optional[typing.List[str]] = None,
+        args: typing.Optional[typing.Sequence[str]] = None,
         ignore_default_args: typing.Optional[
-            typing.Union[bool, typing.List[str]]
+            typing.Union[bool, typing.Sequence[str]]
         ] = None,
         handle_sigint: typing.Optional[bool] = None,
         handle_sigterm: typing.Optional[bool] = None,
@@ -14856,7 +14856,7 @@ def launch_persistent_context(
         locale: typing.Optional[str] = None,
         timezone_id: typing.Optional[str] = None,
         geolocation: typing.Optional[Geolocation] = None,
-        permissions: typing.Optional[typing.List[str]] = None,
+        permissions: typing.Optional[typing.Sequence[str]] = None,
         extra_http_headers: typing.Optional[typing.Dict[str, str]] = None,
         offline: typing.Optional[bool] = None,
         http_credentials: typing.Optional[HttpCredentials] = None,
@@ -14912,10 +14912,10 @@ def launch_persistent_context(
             Path to a browser executable to run instead of the bundled one. If `executablePath` is a relative path, then it is
             resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
             Firefox or WebKit, use at your own risk.
-        args : Union[List[str], None]
+        args : Union[Sequence[str], None]
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
             [here](http://peter.sh/experiments/chromium-command-line-switches/).
-        ignore_default_args : Union[List[str], bool, None]
+        ignore_default_args : Union[Sequence[str], bool, None]
             If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`. If an array is
             given, then filters out the given default arguments. Dangerous option; use with care. Defaults to `false`.
         handle_sigint : Union[bool, None]
@@ -14972,7 +14972,7 @@ def launch_persistent_context(
             [ICU's metaZones.txt](https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1)
             for a list of supported timezone IDs. Defaults to the system timezone.
         geolocation : Union[{latitude: float, longitude: float, accuracy: Union[float, None]}, None]
-        permissions : Union[List[str], None]
+        permissions : Union[Sequence[str], None]
             A list of permissions to grant to all pages in this context. See `browser_context.grant_permissions()` for
             more details. Defaults to none.
         extra_http_headers : Union[Dict[str, str], None]
@@ -15698,7 +15698,7 @@ def click(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -15754,7 +15754,7 @@ def click(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -15800,7 +15800,7 @@ def dblclick(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -15832,7 +15832,7 @@ def dblclick(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -17197,7 +17197,7 @@ def hover(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -17234,7 +17234,7 @@ def hover(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -17625,7 +17625,7 @@ def screenshot(
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
-        mask: typing.Optional[typing.List["Locator"]] = None,
+        mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None
     ) -> bytes:
         """Locator.screenshot
@@ -17695,7 +17695,7 @@ def screenshot(
             screenshots of high-dpi devices will be twice as large or even larger.
 
             Defaults to `"device"`.
-        mask : Union[List[Locator], None]
+        mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
             box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
         mask_color : Union[str, None]
@@ -17746,12 +17746,12 @@ def scroll_into_view_if_needed(
 
     def select_option(
         self,
-        value: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        value: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         *,
-        index: typing.Optional[typing.Union[int, typing.List[int]]] = None,
-        label: typing.Optional[typing.Union[str, typing.List[str]]] = None,
+        index: typing.Optional[typing.Union[int, typing.Sequence[int]]] = None,
+        label: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         element: typing.Optional[
-            typing.Union["ElementHandle", typing.List["ElementHandle"]]
+            typing.Union["ElementHandle", typing.Sequence["ElementHandle"]]
         ] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
@@ -17805,15 +17805,15 @@ def select_option(
 
         Parameters
         ----------
-        value : Union[List[str], str, None]
+        value : Union[Sequence[str], str, None]
             Options to select by value. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        index : Union[List[int], int, None]
+        index : Union[Sequence[int], int, None]
             Options to select by index. Optional.
-        label : Union[List[str], str, None]
+        label : Union[Sequence[str], str, None]
             Options to select by label. If the `<select>` has the `multiple` attribute, all given options are selected,
             otherwise only the first option matching one of the passed options is selected. Optional.
-        element : Union[ElementHandle, List[ElementHandle], None]
+        element : Union[ElementHandle, Sequence[ElementHandle], None]
             Option elements to select. Optional.
         timeout : Union[float, None]
             Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
@@ -17878,8 +17878,8 @@ def set_input_files(
             str,
             pathlib.Path,
             FilePayload,
-            typing.List[typing.Union[str, pathlib.Path]],
-            typing.List[FilePayload],
+            typing.Sequence[typing.Union[str, pathlib.Path]],
+            typing.Sequence[FilePayload],
         ],
         *,
         timeout: typing.Optional[float] = None,
@@ -17939,7 +17939,7 @@ def set_input_files(
 
         Parameters
         ----------
-        files : Union[List[Union[pathlib.Path, str]], List[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
+        files : Union[Sequence[Union[pathlib.Path, str]], Sequence[{name: str, mimeType: str, buffer: bytes}], pathlib.Path, str, {name: str, mimeType: str, buffer: bytes}]
         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.
@@ -17963,7 +17963,7 @@ def tap(
         self,
         *,
         modifiers: typing.Optional[
-            typing.List[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -17992,7 +17992,7 @@ def tap(
 
         Parameters
         ----------
-        modifiers : Union[List[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
             current modifiers back. If not specified, currently pressed modifiers are used.
         position : Union[{x: float, y: float}, None]
@@ -19255,7 +19255,7 @@ def new_context(
         timeout : Union[float, None]
             Maximum time in milliseconds to wait for the response. Defaults to `30000` (30 seconds). Pass `0` to disable
             timeout.
-        storage_state : Union[pathlib.Path, str, {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}, None]
+        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}]}]}, None]
             Populates context with given storage state. This option can be used to initialize context with logged-in
             information obtained via `browser_context.storage_state()` or `a_pi_request_context.storage_state()`.
             Either a path to the file with saved storage, or the value returned by one of
@@ -19438,9 +19438,9 @@ class LocatorAssertions(SyncBase):
     def to_contain_text(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -19531,7 +19531,7 @@ def to_contain_text(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -19557,9 +19557,9 @@ def to_contain_text(
     def not_to_contain_text(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -19574,7 +19574,7 @@ def not_to_contain_text(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected substring or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -19684,9 +19684,9 @@ def not_to_have_attribute(
     def to_have_class(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -19738,7 +19738,7 @@ def to_have_class(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
@@ -19756,9 +19756,9 @@ def to_have_class(
     def not_to_have_class(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -19771,7 +19771,7 @@ def not_to_have_class(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected class or RegExp or a list of those.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
@@ -20113,9 +20113,9 @@ def not_to_have_value(
     def to_have_values(
         self,
         values: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
         ],
         *,
         timeout: typing.Optional[float] = None
@@ -20157,7 +20157,7 @@ def to_have_values(
 
         Parameters
         ----------
-        values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
+        values : Union[Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str]]
             Expected options currently selected.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
@@ -20175,9 +20175,9 @@ def to_have_values(
     def not_to_have_values(
         self,
         values: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
         ],
         *,
         timeout: typing.Optional[float] = None
@@ -20188,7 +20188,7 @@ def not_to_have_values(
 
         Parameters
         ----------
-        values : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str]]
+        values : Union[Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str]]
             Expected options currently selected.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
@@ -20206,9 +20206,9 @@ def not_to_have_values(
     def to_have_text(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -20298,7 +20298,7 @@ def to_have_text(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected string or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
@@ -20324,9 +20324,9 @@ def to_have_text(
     def not_to_have_text(
         self,
         expected: typing.Union[
-            typing.List[str],
-            typing.List[typing.Pattern[str]],
-            typing.List[typing.Union[typing.Pattern[str], str]],
+            typing.Sequence[str],
+            typing.Sequence[typing.Pattern[str]],
+            typing.Sequence[typing.Union[typing.Pattern[str], str]],
             typing.Pattern[str],
             str,
         ],
@@ -20341,7 +20341,7 @@ def not_to_have_text(
 
         Parameters
         ----------
-        expected : Union[List[Pattern[str]], List[Union[Pattern[str], str]], List[str], Pattern[str], str]
+        expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
             Expected string or RegExp or a list of those.
         use_inner_text : Union[bool, None]
             Whether to use `element.innerText` instead of `element.textContent` when retrieving DOM node text.
diff --git a/pyproject.toml b/pyproject.toml
index 094ca8c81..da6e54e07 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -35,7 +35,7 @@ profile = "black"
 
 [tool.pyright]
 include = ["playwright", "tests/sync"]
-ignore = ["tests/async/", "scripts/", "examples/"]
+ignore = ["tests/async/", "scripts/"]
 pythonVersion = "3.8"
 reportMissingImports = false
 reportTypedDictNotRequiredAccess = false
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 506d522fb..a68697be1 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -172,7 +172,7 @@ def print_entry(
                 if not doc_value:
                     self.errors.add(f"Parameter not documented: {fqname}({name}=)")
                 else:
-                    code_type = self.serialize_python_type(value)
+                    code_type = self.serialize_python_type(value, "in")
 
                     print(f"{indent}{to_snake_case(original_name)} : {code_type}")
                     if doc_value.get("comment"):
@@ -195,7 +195,7 @@ def print_entry(
             print("")
             print("        Returns")
             print("        -------")
-            print(f"        {self.serialize_python_type(value)}")
+            print(f"        {self.serialize_python_type(value, 'out')}")
         print(f'{indent}"""')
 
         for name in args:
@@ -309,7 +309,7 @@ def compare_types(
     ) -> None:
         if "(arg=)" in fqname or "(pageFunction=)" in fqname:
             return
-        code_type = self.serialize_python_type(value)
+        code_type = self.serialize_python_type(value, direction)
         doc_type = self.serialize_doc_type(doc_value["type"], direction)
         if not doc_value["required"]:
             doc_type = self.make_optional(doc_type)
@@ -319,10 +319,10 @@ def compare_types(
                 f"Parameter type mismatch in {fqname}: documented as {doc_type}, code has {code_type}"
             )
 
-    def serialize_python_type(self, value: Any) -> str:
+    def serialize_python_type(self, value: Any, direction: str) -> str:
         str_value = str(value)
         if isinstance(value, list):
-            return f"[{', '.join(list(map(lambda a: self.serialize_python_type(a), value)))}]"
+            return f"[{', '.join(list(map(lambda a: self.serialize_python_type(a, direction), value)))}]"
         if str_value == "<class 'playwright._impl._errors.Error'>":
             return "Error"
         if str_value == "<class 'NoneType'>":
@@ -356,32 +356,45 @@ def serialize_python_type(self, value: Any) -> str:
         if hints:
             signature: List[str] = []
             for [name, value] in hints.items():
-                signature.append(f"{name}: {self.serialize_python_type(value)}")
+                signature.append(
+                    f"{name}: {self.serialize_python_type(value, direction)}"
+                )
             return f"{{{', '.join(signature)}}}"
         if origin == Union:
             args = get_args(value)
             if len(args) == 2 and str(args[1]) == "<class 'NoneType'>":
-                return self.make_optional(self.serialize_python_type(args[0]))
-            ll = list(map(lambda a: self.serialize_python_type(a), args))
+                return self.make_optional(
+                    self.serialize_python_type(args[0], direction)
+                )
+            ll = list(map(lambda a: self.serialize_python_type(a, direction), args))
             ll.sort(key=lambda item: "}" if item == "None" else item)
             return f"Union[{', '.join(ll)}]"
         if str(origin) == "<class 'dict'>":
             args = get_args(value)
-            return f"Dict[{', '.join(list(map(lambda a: self.serialize_python_type(a), args)))}]"
+            return f"Dict[{', '.join(list(map(lambda a: self.serialize_python_type(a, direction), args)))}]"
+        if str(origin) == "<class 'collections.abc.Sequence'>":
+            args = get_args(value)
+            return f"Sequence[{', '.join(list(map(lambda a: self.serialize_python_type(a, direction), args)))}]"
         if str(origin) == "<class 'list'>":
             args = get_args(value)
-            return f"List[{', '.join(list(map(lambda a: self.serialize_python_type(a), args)))}]"
+            list_type = "Sequence" if direction == "in" else "List"
+            return f"{list_type}[{', '.join(list(map(lambda a: self.serialize_python_type(a, direction), args)))}]"
         if str(origin) == "<class 'collections.abc.Callable'>":
             args = get_args(value)
-            return f"Callable[{', '.join(list(map(lambda a: self.serialize_python_type(a), args)))}]"
+            return f"Callable[{', '.join(list(map(lambda a: self.serialize_python_type(a, direction), args)))}]"
         if str(origin) == "<class 're.Pattern'>":
             return "Pattern[str]"
         if str(origin) == "typing.Literal":
             args = get_args(value)
             if len(args) == 1:
-                return '"' + self.serialize_python_type(args[0]) + '"'
+                return '"' + self.serialize_python_type(args[0], direction) + '"'
             body = ", ".join(
-                list(map(lambda a: '"' + self.serialize_python_type(a) + '"', args))
+                list(
+                    map(
+                        lambda a: '"' + self.serialize_python_type(a, direction) + '"',
+                        args,
+                    )
+                )
             )
             return f"Union[{body}]"
         return str_value
@@ -421,7 +434,7 @@ def inner_serialize_doc_type(self, type: Any, direction: str) -> str:
         if "templates" in type:
             base = type_name
             if type_name == "Array":
-                base = "List"
+                base = "Sequence" if direction == "in" else "List"
             if type_name == "Object" or type_name == "Map":
                 base = "Dict"
             return f"{base}[{', '.join(self.serialize_doc_type(t, direction) for t in type['templates'])}]"
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index 3045c1e61..388db89e1 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -148,7 +148,7 @@ def arguments(func: FunctionType, indent: int) -> str:
         elif (
             "typing.Any" in value_str
             or "typing.Dict" in value_str
-            or "typing.List" in value_str
+            or "typing.Sequence" in value_str
             or "Handle" in value_str
         ):
             tokens.append(f"{name}=mapping.to_impl({to_snake_case(name)})")
@@ -191,7 +191,10 @@ def return_value(value: Any) -> List[str]:
         and str(get_args(value)[1]) == "<class 'NoneType'>"
     ):
         return ["mapping.from_impl_nullable(", ")"]
-    if str(get_origin(value)) == "<class 'list'>":
+    if str(get_origin(value)) in [
+        "<class 'list'>",
+        "<class 'collections.abc.Sequence'>",
+    ]:
         return ["mapping.from_impl_list(", ")"]
     if str(get_origin(value)) == "<class 'dict'>":
         return ["mapping.from_impl_dict(", ")"]
diff --git a/tests/async/test_browsercontext_request_fallback.py b/tests/async/test_browsercontext_request_fallback.py
index b003a9db9..f3959490b 100644
--- a/tests/async/test_browsercontext_request_fallback.py
+++ b/tests/async/test_browsercontext_request_fallback.py
@@ -215,7 +215,8 @@ async def capture_and_continue(route: Route, request: Request) -> None:
 
     async def delete_foo_header(route: Route, request: Request) -> None:
         headers = await request.all_headers()
-        await route.fallback(headers={**headers, "foo": None})
+        del headers["foo"]
+        await route.fallback(headers=headers)
 
     await context.route(server.PREFIX + "/something", delete_foo_header)
 
diff --git a/tests/async/test_interception.py b/tests/async/test_interception.py
index 68f749d42..6b0bf0a27 100644
--- a/tests/async/test_interception.py
+++ b/tests/async/test_interception.py
@@ -16,7 +16,7 @@
 import json
 import re
 from pathlib import Path
-from typing import Callable, List
+from typing import Callable, List, Optional
 
 import pytest
 
@@ -344,7 +344,7 @@ def _handle(route: Route, request: Request) -> None:
     assert "/non-existing-page.html" in intercepted[0].url
 
     chain = []
-    r = response.request
+    r: Optional[Request] = response.request
     while r:
         chain.append(r)
         assert r.is_navigation_request()
@@ -392,7 +392,7 @@ def _handle(route: Route) -> None:
     assert intercepted[0].resource_type == "document"
     assert "one-style.html" in intercepted[0].url
 
-    r = intercepted[1]
+    r: Optional[Request] = intercepted[1]
     for url in [
         "/one-style.css",
         "/two-style.css",
diff --git a/tests/async/test_page_request_fallback.py b/tests/async/test_page_request_fallback.py
index 199e072e6..456c911a3 100644
--- a/tests/async/test_page_request_fallback.py
+++ b/tests/async/test_page_request_fallback.py
@@ -194,7 +194,8 @@ async def capture_and_continue(route: Route, request: Request) -> None:
 
     async def delete_foo_header(route: Route, request: Request) -> None:
         headers = await request.all_headers()
-        await route.fallback(headers={**headers, "foo": None})
+        del headers["foo"]
+        await route.fallback(headers=headers)
 
     await page.route(server.PREFIX + "/something", delete_foo_header)
 

From 248f3ec434df48f3347aeecf9c0b0ae64b4e1714 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 29 Nov 2023 19:06:51 -0800
Subject: [PATCH 123/438] chore: refactor TestServer/Request class (#2179)

---
 .pre-commit-config.yaml                       |   2 +-
 local-requirements.txt                        |   1 +
 playwright/_impl/_locator.py                  |   7 +-
 playwright/_impl/_network.py                  |   2 +-
 pyproject.toml                                |  11 +-
 scripts/documentation_provider.py             |  11 +-
 .../async/test_browsercontext_add_cookies.py  |   8 +-
 tests/async/test_browsercontext_events.py     |   4 +-
 tests/async/test_browsercontext_proxy.py      |   6 +-
 tests/async/test_browsertype_connect.py       |   4 +-
 tests/async/test_download.py                  |  12 +-
 tests/async/test_fetch_browser_context.py     |   6 +-
 tests/async/test_har.py                       |   4 +-
 tests/async/test_interception.py              |   6 +-
 tests/async/test_navigation.py                |  12 +-
 tests/async/test_network.py                   |   4 +-
 tests/async/test_page.py                      |   4 +-
 tests/async/test_page_network_response.py     |   6 +-
 tests/async/test_page_request_intercept.py    |   4 +-
 tests/async/test_proxy.py                     |   6 +-
 tests/server.py                               | 173 +++++++++---------
 tests/sync/test_browsercontext_events.py      |   4 +-
 tests/sync/test_page_request_intercept.py     |   4 +-
 23 files changed, 148 insertions(+), 153 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 774b001ec..eabece583 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -22,7 +22,7 @@ repos:
     rev: v1.5.1
     hooks:
       - id: mypy
-        additional_dependencies: [types-pyOpenSSL==23.2.0.2]
+        additional_dependencies: [types-pyOpenSSL==23.2.0.2, types-requests==2.31.0.10]
   - repo: https://github.com/pycqa/flake8
     rev: 6.1.0
     hooks:
diff --git a/local-requirements.txt b/local-requirements.txt
index 68edf4cb1..4a4a27ada 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -20,4 +20,5 @@ service_identity==23.1.0
 setuptools==68.2.2
 twisted==23.10.0
 types-pyOpenSSL==23.2.0.2
+types-requests==2.31.0.10
 wheel==0.41.2
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 3f9fa5ce3..d18d0d5de 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -15,7 +15,6 @@
 import json
 import pathlib
 import sys
-from collections import ChainMap
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -528,7 +527,7 @@ async def screenshot(
         params = locals_to_params(locals())
         return await self._with_element(
             lambda h, timeout: h.screenshot(
-                **ChainMap({"timeout": timeout}, params),
+                **{**params, "timeout": timeout},
             ),
         )
 
@@ -561,9 +560,7 @@ async def select_option(
     async def select_text(self, force: bool = None, timeout: float = None) -> None:
         params = locals_to_params(locals())
         return await self._with_element(
-            lambda h, timeout: h.select_text(
-                **ChainMap({"timeout": timeout}, params),
-            ),
+            lambda h, timeout: h.select_text(**{**params, "timeout": timeout}),
             timeout,
         )
 
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 67bd9d48d..102767cf6 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -167,7 +167,7 @@ def post_data(self) -> Optional[str]:
         data = self._fallback_overrides.post_data_buffer
         if not data:
             return None
-        return data.decode() if isinstance(data, bytes) else data
+        return data.decode()
 
     @property
     def post_data_json(self) -> Optional[Any]:
diff --git a/pyproject.toml b/pyproject.toml
index da6e54e07..e87689aa0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -25,17 +25,16 @@ warn_unused_configs = true
 check_untyped_defs = true
 disallow_untyped_defs = true
 no_implicit_optional = false
-
-[[tool.mypy.overrides]]
-module = "tests/async.*"
-ignore_errors = true
+exclude = [
+    "build/",
+    "env/",
+]
 
 [tool.isort]
 profile = "black"
 
 [tool.pyright]
-include = ["playwright", "tests/sync"]
-ignore = ["tests/async/", "scripts/"]
+include = ["playwright", "tests", "scripts"]
 pythonVersion = "3.8"
 reportMissingImports = false
 reportTypedDictNotRequiredAccess = false
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index a68697be1..2d03ebc04 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -16,16 +16,7 @@
 import re
 import subprocess
 from sys import stderr
-from typing import (  # type: ignore
-    Any,
-    Dict,
-    List,
-    Set,
-    Union,
-    get_args,
-    get_origin,
-    get_type_hints,
-)
+from typing import Any, Dict, List, Set, Union, get_args, get_origin, get_type_hints
 from urllib.parse import urljoin
 
 from playwright._impl._helper import to_snake_case
diff --git a/tests/async/test_browsercontext_add_cookies.py b/tests/async/test_browsercontext_add_cookies.py
index 744e989d1..6f457a11f 100644
--- a/tests/async/test_browsercontext_add_cookies.py
+++ b/tests/async/test_browsercontext_add_cookies.py
@@ -19,7 +19,7 @@
 import pytest
 
 from playwright.async_api import Browser, BrowserContext, Error, Page
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 from tests.utils import must
 
 
@@ -49,7 +49,7 @@ async def test_should_roundtrip_cookie(
     cookies = await context.cookies()
     await context.clear_cookies()
     assert await context.cookies() == []
-    await context.add_cookies(cookies)
+    await context.add_cookies(cookies)  # type: ignore
     assert await context.cookies() == cookies
 
 
@@ -58,7 +58,7 @@ async def test_should_send_cookie_header(
 ) -> None:
     cookie: List[str] = []
 
-    def handler(request: HttpRequestWithPostBody) -> None:
+    def handler(request: TestServerRequest) -> None:
         cookie.extend(must(request.requestHeaders.getRawHeaders("cookie")))
         request.finish()
 
@@ -154,7 +154,7 @@ async def test_should_isolate_send_cookie_header(
 ) -> None:
     cookie: List[str] = []
 
-    def handler(request: HttpRequestWithPostBody) -> None:
+    def handler(request: TestServerRequest) -> None:
         cookie.extend(request.requestHeaders.getRawHeaders("cookie") or [])
         request.finish()
 
diff --git a/tests/async/test_browsercontext_events.py b/tests/async/test_browsercontext_events.py
index 9cae739dc..a0a3b90eb 100644
--- a/tests/async/test_browsercontext_events.py
+++ b/tests/async/test_browsercontext_events.py
@@ -20,7 +20,7 @@
 from playwright.async_api import Page
 from tests.utils import must
 
-from ..server import HttpRequestWithPostBody, Server
+from ..server import Server, TestServerRequest
 
 
 async def test_console_event_should_work(page: Page) -> None:
@@ -162,7 +162,7 @@ async def test_dialog_event_should_work_in_immdiately_closed_popup(page: Page) -
 async def test_dialog_event_should_work_with_inline_script_tag(
     page: Page, server: Server
 ) -> None:
-    def handle_route(request: HttpRequestWithPostBody) -> None:
+    def handle_route(request: TestServerRequest) -> None:
         request.setHeader("content-type", "text/html")
         request.write(b"""<script>window.result = prompt('hey?')</script>""")
         request.finish()
diff --git a/tests/async/test_browsercontext_proxy.py b/tests/async/test_browsercontext_proxy.py
index 07f52a562..6f2f21440 100644
--- a/tests/async/test_browsercontext_proxy.py
+++ b/tests/async/test_browsercontext_proxy.py
@@ -20,7 +20,7 @@
 from flaky import flaky
 
 from playwright.async_api import Browser, BrowserContext
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 
 
 @pytest.fixture(scope="session")
@@ -89,7 +89,7 @@ async def test_should_work_with_ip_port_notion(
 async def test_should_authenticate(
     context_factory: "Callable[..., Awaitable[BrowserContext]]", server: Server
 ) -> None:
-    def handler(req: HttpRequestWithPostBody) -> None:
+    def handler(req: TestServerRequest) -> None:
         auth = req.getHeader("proxy-authorization")
         if not auth:
             req.setHeader(
@@ -120,7 +120,7 @@ def handler(req: HttpRequestWithPostBody) -> None:
 async def test_should_authenticate_with_empty_password(
     context_factory: "Callable[..., Awaitable[BrowserContext]]", server: Server
 ) -> None:
-    def handler(req: HttpRequestWithPostBody) -> None:
+    def handler(req: TestServerRequest) -> None:
         auth = req.getHeader("proxy-authorization")
         if not auth:
             req.setHeader(
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index 556e8eefd..34bf42245 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -23,7 +23,7 @@
 
 from playwright.async_api import BrowserType, Error, Playwright, Route
 from tests.conftest import RemoteServer
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 from tests.utils import parse_trace
 
 
@@ -168,7 +168,7 @@ async def test_browser_type_connect_should_reject_navigation_when_browser_closes
 async def test_should_not_allow_getting_the_path(
     browser_type: BrowserType, launch_server: Callable[[], RemoteServer], server: Server
 ) -> None:
-    def handle_download(request: HttpRequestWithPostBody) -> None:
+    def handle_download(request: TestServerRequest) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.setHeader("Content-Disposition", "attachment")
         request.write(b"Hello world")
diff --git a/tests/async/test_download.py b/tests/async/test_download.py
index 94a329606..96d06820e 100644
--- a/tests/async/test_download.py
+++ b/tests/async/test_download.py
@@ -20,7 +20,7 @@
 import pytest
 
 from playwright.async_api import Browser, Download, Error, Page
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
 
@@ -31,13 +31,13 @@ def assert_file_content(path: Path, content: str) -> None:
 
 @pytest.fixture(autouse=True)
 def after_each_hook(server: Server) -> Generator[None, None, None]:
-    def handle_download(request: HttpRequestWithPostBody) -> None:
+    def handle_download(request: TestServerRequest) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.setHeader("Content-Disposition", "attachment")
         request.write(b"Hello world")
         request.finish()
 
-    def handle_download_with_file_name(request: HttpRequestWithPostBody) -> None:
+    def handle_download_with_file_name(request: TestServerRequest) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.setHeader("Content-Disposition", "attachment; filename=file.txt")
         request.write(b"Hello world")
@@ -206,7 +206,7 @@ async def test_should_report_non_navigation_downloads(
     browser: Browser, server: Server
 ) -> None:
     # Mac WebKit embedder does not download in this case, although Safari does.
-    def handle_download(request: HttpRequestWithPostBody) -> None:
+    def handle_download(request: TestServerRequest) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.write(b"Hello world")
         request.finish()
@@ -275,7 +275,7 @@ async def test_should_report_alt_click_downloads(
 ) -> None:
     # Firefox does not download on alt-click by default.
     # Our WebKit embedder does not download on alt-click, although Safari does.
-    def handle_download(request: HttpRequestWithPostBody) -> None:
+    def handle_download(request: TestServerRequest) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.write(b"Hello world")
         request.finish()
@@ -365,7 +365,7 @@ async def test_should_delete_downloads_on_browser_gone(
 
 
 async def test_download_cancel_should_work(browser: Browser, server: Server) -> None:
-    def handle_download(request: HttpRequestWithPostBody) -> None:
+    def handle_download(request: TestServerRequest) -> None:
         request.setHeader("Content-Type", "application/octet-stream")
         request.setHeader("Content-Disposition", "attachment")
         # Chromium requires a large enough payload to trigger the download event soon enough
diff --git a/tests/async/test_fetch_browser_context.py b/tests/async/test_fetch_browser_context.py
index 999becf47..2c515697b 100644
--- a/tests/async/test_fetch_browser_context.py
+++ b/tests/async/test_fetch_browser_context.py
@@ -14,7 +14,7 @@
 
 import asyncio
 import json
-from typing import Any
+from typing import Any, cast
 from urllib.parse import parse_qs
 
 import pytest
@@ -220,7 +220,9 @@ async def test_should_support_multipart_form_data(
         ),
     )
     assert request.method == b"POST"
-    assert must(request.getHeader("Content-Type")).startswith("multipart/form-data; ")
+    assert cast(str, request.getHeader("Content-Type")).startswith(
+        "multipart/form-data; "
+    )
     assert must(request.getHeader("Content-Length")) == str(
         len(must(request.post_body))
     )
diff --git a/tests/async/test_har.py b/tests/async/test_har.py
index b0978894b..31a34f8fa 100644
--- a/tests/async/test_har.py
+++ b/tests/async/test_har.py
@@ -18,12 +18,12 @@
 import re
 import zipfile
 from pathlib import Path
+from typing import cast
 
 import pytest
 
 from playwright.async_api import Browser, BrowserContext, Error, Page, Route, expect
 from tests.server import Server
-from tests.utils import must
 
 
 async def test_should_work(browser: Browser, server: Server, tmpdir: Path) -> None:
@@ -560,7 +560,7 @@ async def test_should_disambiguate_by_header(
 ) -> None:
     server.set_route(
         "/echo",
-        lambda req: (req.write(must(req.getHeader("baz")).encode()), req.finish()),
+        lambda req: (req.write(cast(str, req.getHeader("baz")).encode()), req.finish()),
     )
     fetch_function = """
         async (bazValue) => {
diff --git a/tests/async/test_interception.py b/tests/async/test_interception.py
index 6b0bf0a27..911d7ddd8 100644
--- a/tests/async/test_interception.py
+++ b/tests/async/test_interception.py
@@ -29,7 +29,7 @@
     Request,
     Route,
 )
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 from tests.utils import must
 
 
@@ -412,7 +412,7 @@ async def test_page_route_should_work_with_equal_requests(
     await page.goto(server.EMPTY_PAGE)
     hits = [True]
 
-    def handle_request(request: HttpRequestWithPostBody, hits: List[bool]) -> None:
+    def handle_request(request: TestServerRequest, hits: List[bool]) -> None:
         request.write(str(len(hits) * 11).encode())
         request.finish()
         hits.append(True)
@@ -857,7 +857,7 @@ async def test_request_fulfill_should_not_modify_the_headers_sent_to_the_server(
     # this is just to enable request interception, which disables caching in chromium
     await page.route(server.PREFIX + "/unused", lambda route, req: None)
 
-    def _handler1(response: HttpRequestWithPostBody) -> None:
+    def _handler1(response: TestServerRequest) -> None:
         interceptedRequests.append(response)
         response.setHeader("Access-Control-Allow-Origin", "*")
         response.write(b"done")
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index 62cc5036f..de4a2f5e9 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -29,7 +29,7 @@
     Route,
     TimeoutError,
 )
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 
 
 async def test_goto_should_work(page: Page, server: Server) -> None:
@@ -155,7 +155,7 @@ async def test_goto_should_return_response_when_page_changes_its_url_after_load(
 async def test_goto_should_work_with_subframes_return_204(
     page: Page, server: Server
 ) -> None:
-    def handle(request: HttpRequestWithPostBody) -> None:
+    def handle(request: TestServerRequest) -> None:
         request.setResponseCode(204)
         request.finish()
 
@@ -168,7 +168,7 @@ async def test_goto_should_fail_when_server_returns_204(
     page: Page, server: Server, is_chromium: bool, is_webkit: bool
 ) -> None:
     # WebKit just loads an empty page.
-    def handle(request: HttpRequestWithPostBody) -> None:
+    def handle(request: TestServerRequest) -> None:
         request.setResponseCode(204)
         request.finish()
 
@@ -897,7 +897,7 @@ async def test_wait_for_load_state_in_popup(
     await page.goto(server.EMPTY_PAGE)
     css_requests = []
 
-    def handle_request(request: HttpRequestWithPostBody) -> None:
+    def handle_request(request: TestServerRequest) -> None:
         css_requests.append(request)
         request.write(b"body {}")
         request.finish()
@@ -1080,7 +1080,7 @@ async def test_reload_should_work_with_data_url(page: Page, server: Server) -> N
 
 
 async def test_should_work_with__blank_target(page: Page, server: Server) -> None:
-    def handler(request: HttpRequestWithPostBody) -> None:
+    def handler(request: TestServerRequest) -> None:
         request.write(
             f'<a href="{server.EMPTY_PAGE}" target="_blank">Click me</a>'.encode()
         )
@@ -1095,7 +1095,7 @@ def handler(request: HttpRequestWithPostBody) -> None:
 async def test_should_work_with_cross_process__blank_target(
     page: Page, server: Server
 ) -> None:
-    def handler(request: HttpRequestWithPostBody) -> None:
+    def handler(request: TestServerRequest) -> None:
         request.write(
             f'<a href="{server.CROSS_PROCESS_PREFIX}/empty.html" target="_blank">Click me</a>'.encode()
         )
diff --git a/tests/async/test_network.py b/tests/async/test_network.py
index 015372fc0..486a98914 100644
--- a/tests/async/test_network.py
+++ b/tests/async/test_network.py
@@ -23,7 +23,7 @@
 from twisted.web import http
 
 from playwright.async_api import Browser, Error, Page, Request, Response, Route
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 
 from .utils import Utils
 
@@ -631,7 +631,7 @@ async def test_network_events_request_failed(
     is_mac: bool,
     is_win: bool,
 ) -> None:
-    def handle_request(request: HttpRequestWithPostBody) -> None:
+    def handle_request(request: TestServerRequest) -> None:
         request.setHeader("Content-Type", "text/css")
         request.transport.loseConnection()
 
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 349914b6f..376df8376 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -28,7 +28,7 @@
     Route,
     TimeoutError,
 )
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE, must
 
 
@@ -151,7 +151,7 @@ async def test_load_should_fire_when_expected(page: Page) -> None:
 async def test_should_work_with_wait_for_loadstate(page: Page, server: Server) -> None:
     messages = []
 
-    def _handler(request: HttpRequestWithPostBody) -> None:
+    def _handler(request: TestServerRequest) -> None:
         messages.append("route")
         request.setHeader("Content-Type", "text/html")
         request.write(b"<link rel='stylesheet' href='./one-style.css'>")
diff --git a/tests/async/test_page_network_response.py b/tests/async/test_page_network_response.py
index 98f4aaa42..58988fabc 100644
--- a/tests/async/test_page_network_response.py
+++ b/tests/async/test_page_network_response.py
@@ -17,7 +17,7 @@
 import pytest
 
 from playwright.async_api import Error, Page
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 
 
 async def test_should_reject_response_finished_if_page_closes(
@@ -25,7 +25,7 @@ async def test_should_reject_response_finished_if_page_closes(
 ) -> None:
     await page.goto(server.EMPTY_PAGE)
 
-    def handle_get(request: HttpRequestWithPostBody) -> None:
+    def handle_get(request: TestServerRequest) -> None:
         # In Firefox, |fetch| will be hanging until it receives |Content-Type| header
         # from server.
         request.setHeader("Content-Type", "text/plain; charset=utf-8")
@@ -51,7 +51,7 @@ async def test_should_reject_response_finished_if_context_closes(
 ) -> None:
     await page.goto(server.EMPTY_PAGE)
 
-    def handle_get(request: HttpRequestWithPostBody) -> None:
+    def handle_get(request: TestServerRequest) -> None:
         # In Firefox, |fetch| will be hanging until it receives |Content-Type| header
         # from server.
         request.setHeader("Content-Type", "text/plain; charset=utf-8")
diff --git a/tests/async/test_page_request_intercept.py b/tests/async/test_page_request_intercept.py
index 2206135be..934aed8a0 100644
--- a/tests/async/test_page_request_intercept.py
+++ b/tests/async/test_page_request_intercept.py
@@ -18,13 +18,13 @@
 import pytest
 
 from playwright.async_api import Error, Page, Route, expect
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 
 
 async def test_should_support_timeout_option_in_route_fetch(
     server: Server, page: Page
 ) -> None:
-    def _handler(request: HttpRequestWithPostBody) -> None:
+    def _handler(request: TestServerRequest) -> None:
         request.responseHeaders.addRawHeader("Content-Length", "4096")
         request.responseHeaders.addRawHeader("Content-Type", "text/html")
         request.write(b"")
diff --git a/tests/async/test_proxy.py b/tests/async/test_proxy.py
index e1c072e9d..d85613964 100644
--- a/tests/async/test_proxy.py
+++ b/tests/async/test_proxy.py
@@ -19,7 +19,7 @@
 import pytest
 
 from playwright.async_api import Browser, Error
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 
 
 async def test_should_throw_for_bad_server_value(
@@ -86,7 +86,7 @@ async def test_should_work_with_ip_port_notion(
 async def test_should_authenticate(
     browser_factory: "Callable[..., asyncio.Future[Browser]]", server: Server
 ) -> None:
-    def handler(req: HttpRequestWithPostBody) -> None:
+    def handler(req: TestServerRequest) -> None:
         auth = req.getHeader("proxy-authorization")
         if not auth:
             req.setHeader(
@@ -116,7 +116,7 @@ def handler(req: HttpRequestWithPostBody) -> None:
 async def test_should_authenticate_with_empty_password(
     browser_factory: "Callable[..., asyncio.Future[Browser]]", server: Server
 ) -> None:
-    def handler(req: HttpRequestWithPostBody) -> None:
+    def handler(req: TestServerRequest) -> None:
         auth = req.getHeader("proxy-authorization")
         if not auth:
             req.setHeader(
diff --git a/tests/server.py b/tests/server.py
index 37d2c2b0d..06e344653 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -31,18 +31,21 @@
     Set,
     Tuple,
     TypeVar,
+    cast,
 )
 from urllib.parse import urlparse
 
 from autobahn.twisted.websocket import WebSocketServerFactory, WebSocketServerProtocol
 from OpenSSL import crypto
-from twisted.internet import reactor, ssl
-from twisted.internet.protocol import ClientFactory
+from twisted.internet import reactor as _twisted_reactor
+from twisted.internet import ssl
+from twisted.internet.selectreactor import SelectReactor
 from twisted.web import http
 
 from playwright._impl._path_utils import get_file_dirname
 
 _dirname = get_file_dirname()
+reactor = cast(SelectReactor, _twisted_reactor)
 
 
 def find_free_port() -> int:
@@ -52,10 +55,6 @@ def find_free_port() -> int:
         return s.getsockname()[1]
 
 
-class HttpRequestWithPostBody(http.Request):
-    post_body: Optional[bytes] = None
-
-
 T = TypeVar("T")
 
 
@@ -70,6 +69,76 @@ def value(self) -> T:
         return self._value
 
 
+class TestServerRequest(http.Request):
+    __test__ = False
+    channel: "TestServerHTTPChannel"
+    post_body: Optional[bytes] = None
+
+    def process(self) -> None:
+        server = self.channel.factory.server_instance
+        if self.content:
+            self.post_body = self.content.read()
+            self.content.seek(0, 0)
+        else:
+            self.post_body = None
+        uri = urlparse(self.uri.decode())
+        path = uri.path
+
+        request_subscriber = server.request_subscribers.get(path)
+        if request_subscriber:
+            request_subscriber._loop.call_soon_threadsafe(
+                request_subscriber.set_result, self
+            )
+            server.request_subscribers.pop(path)
+
+        if server.auth.get(path):
+            authorization_header = self.requestHeaders.getRawHeaders("authorization")
+            creds_correct = False
+            if authorization_header:
+                creds_correct = server.auth.get(path) == (
+                    self.getUser().decode(),
+                    self.getPassword().decode(),
+                )
+            if not creds_correct:
+                self.setHeader(b"www-authenticate", 'Basic realm="Secure Area"')
+                self.setResponseCode(HTTPStatus.UNAUTHORIZED)
+                self.finish()
+                return
+        if server.csp.get(path):
+            self.setHeader(b"Content-Security-Policy", server.csp[path])
+        if server.routes.get(path):
+            server.routes[path](self)
+            return
+        file_content = None
+        try:
+            file_content = (server.static_path / path[1:]).read_bytes()
+            content_type = mimetypes.guess_type(path)[0]
+            if content_type and content_type.startswith("text/"):
+                content_type += "; charset=utf-8"
+            self.setHeader(b"Content-Type", content_type)
+            self.setHeader(b"Cache-Control", "no-cache, no-store")
+            if path in server.gzip_routes:
+                self.setHeader("Content-Encoding", "gzip")
+                self.write(gzip.compress(file_content))
+            else:
+                self.setHeader(b"Content-Length", str(len(file_content)))
+                self.write(file_content)
+            self.setResponseCode(HTTPStatus.OK)
+        except (FileNotFoundError, IsADirectoryError, PermissionError):
+            self.setResponseCode(HTTPStatus.NOT_FOUND)
+        self.finish()
+
+
+class TestServerHTTPChannel(http.HTTPChannel):
+    factory: "TestServerFactory"
+    requestFactory = TestServerRequest
+
+
+class TestServerFactory(http.HTTPFactory):
+    server_instance: "Server"
+    protocol = TestServerHTTPChannel
+
+
 class Server:
     protocol = "http"
 
@@ -89,103 +158,39 @@ def __repr__(self) -> str:
         return self.PREFIX
 
     @abc.abstractmethod
-    def listen(self, factory: ClientFactory) -> None:
+    def listen(self, factory: TestServerFactory) -> None:
         pass
 
     def start(self) -> None:
         request_subscribers: Dict[str, asyncio.Future] = {}
         auth: Dict[str, Tuple[str, str]] = {}
         csp: Dict[str, str] = {}
-        routes: Dict[str, Callable[[HttpRequestWithPostBody], Any]] = {}
+        routes: Dict[str, Callable[[TestServerRequest], Any]] = {}
         gzip_routes: Set[str] = set()
         self.request_subscribers = request_subscribers
         self.auth = auth
         self.csp = csp
         self.routes = routes
         self.gzip_routes = gzip_routes
-        static_path = _dirname / "assets"
-
-        class TestServerHTTPHandler(http.Request):
-            def process(self) -> None:
-                request = self
-                if request.content:
-                    self.post_body = request.content.read()
-                    request.content.seek(0, 0)
-                else:
-                    self.post_body = None
-                uri = urlparse(request.uri.decode())
-                path = uri.path
-
-                request_subscriber = request_subscribers.get(path)
-                if request_subscriber:
-                    request_subscriber._loop.call_soon_threadsafe(
-                        request_subscriber.set_result, request
-                    )
-                    request_subscribers.pop(path)
-
-                if auth.get(path):
-                    authorization_header = request.requestHeaders.getRawHeaders(
-                        "authorization"
-                    )
-                    creds_correct = False
-                    if authorization_header:
-                        creds_correct = auth.get(path) == (
-                            request.getUser().decode(),
-                            request.getPassword().decode(),
-                        )
-                    if not creds_correct:
-                        request.setHeader(
-                            b"www-authenticate", 'Basic realm="Secure Area"'
-                        )
-                        request.setResponseCode(HTTPStatus.UNAUTHORIZED)
-                        request.finish()
-                        return
-                if csp.get(path):
-                    request.setHeader(b"Content-Security-Policy", csp[path])
-                if routes.get(path):
-                    routes[path](request)
-                    return
-                file_content = None
-                try:
-                    file_content = (static_path / path[1:]).read_bytes()
-                    content_type = mimetypes.guess_type(path)[0]
-                    if content_type and content_type.startswith("text/"):
-                        content_type += "; charset=utf-8"
-                    request.setHeader(b"Content-Type", content_type)
-                    request.setHeader(b"Cache-Control", "no-cache, no-store")
-                    if path in gzip_routes:
-                        request.setHeader("Content-Encoding", "gzip")
-                        request.write(gzip.compress(file_content))
-                    else:
-                        request.setHeader(b"Content-Length", str(len(file_content)))
-                        request.write(file_content)
-                    self.setResponseCode(HTTPStatus.OK)
-                except (FileNotFoundError, IsADirectoryError, PermissionError):
-                    request.setResponseCode(HTTPStatus.NOT_FOUND)
-                self.finish()
-
-        class MyHttp(http.HTTPChannel):
-            requestFactory = TestServerHTTPHandler
-
-        class MyHttpFactory(http.HTTPFactory):
-            protocol = MyHttp
-
-        self.listen(MyHttpFactory())
+        self.static_path = _dirname / "assets"
+        factory = TestServerFactory()
+        factory.server_instance = self
+        self.listen(factory)
 
-    async def wait_for_request(self, path: str) -> HttpRequestWithPostBody:
+    async def wait_for_request(self, path: str) -> TestServerRequest:
         if path in self.request_subscribers:
             return await self.request_subscribers[path]
-        future: asyncio.Future["HttpRequestWithPostBody"] = asyncio.Future()
+        future: asyncio.Future["TestServerRequest"] = asyncio.Future()
         self.request_subscribers[path] = future
         return await future
 
     @contextlib.contextmanager
     def expect_request(
         self, path: str
-    ) -> Generator[ExpectResponse[HttpRequestWithPostBody], None, None]:
+    ) -> Generator[ExpectResponse[TestServerRequest], None, None]:
         future = asyncio.create_task(self.wait_for_request(path))
 
-        cb_wrapper: ExpectResponse[HttpRequestWithPostBody] = ExpectResponse()
+        cb_wrapper: ExpectResponse[TestServerRequest] = ExpectResponse()
 
         def done_cb(task: asyncio.Task) -> None:
             cb_wrapper._value = future.result()
@@ -207,7 +212,7 @@ def reset(self) -> None:
         self.routes.clear()
 
     def set_route(
-        self, path: str, callback: Callable[[HttpRequestWithPostBody], Any]
+        self, path: str, callback: Callable[[TestServerRequest], Any]
     ) -> None:
         self.routes[path] = callback
 
@@ -224,7 +229,7 @@ def handle_redirect(request: http.Request) -> None:
 
 
 class HTTPServer(Server):
-    def listen(self, factory: ClientFactory) -> None:
+    def listen(self, factory: http.HTTPFactory) -> None:
         reactor.listenTCP(self.PORT, factory, interface="127.0.0.1")
         try:
             reactor.listenTCP(self.PORT, factory, interface="::1")
@@ -235,7 +240,7 @@ def listen(self, factory: ClientFactory) -> None:
 class HTTPSServer(Server):
     protocol = "https"
 
-    def listen(self, factory: ClientFactory) -> None:
+    def listen(self, factory: http.HTTPFactory) -> None:
         cert = ssl.PrivateCertificate.fromCertificateAndKeyPair(
             ssl.Certificate.loadPEM(
                 (_dirname / "testserver" / "cert.pem").read_bytes()
@@ -295,7 +300,7 @@ def start(self) -> None:
         self.https_server.start()
         self.ws_server.start()
         self.thread = threading.Thread(
-            target=lambda: reactor.run(installSignalHandlers=0)
+            target=lambda: reactor.run(installSignalHandlers=False)
         )
         self.thread.start()
 
diff --git a/tests/sync/test_browsercontext_events.py b/tests/sync/test_browsercontext_events.py
index 6d0840e6a..315fff0dc 100644
--- a/tests/sync/test_browsercontext_events.py
+++ b/tests/sync/test_browsercontext_events.py
@@ -18,7 +18,7 @@
 
 from playwright.sync_api import Dialog, Page
 
-from ..server import HttpRequestWithPostBody, Server
+from ..server import Server, TestServerRequest
 
 
 def test_console_event_should_work(page: Page) -> None:
@@ -170,7 +170,7 @@ def handle_popup(p: Page) -> None:
 def test_dialog_event_should_work_with_inline_script_tag(
     page: Page, server: Server
 ) -> None:
-    def handle_route(request: HttpRequestWithPostBody) -> None:
+    def handle_route(request: TestServerRequest) -> None:
         request.setHeader("content-type", "text/html")
         request.write(b"""<script>window.result = prompt('hey?')</script>""")
         request.finish()
diff --git a/tests/sync/test_page_request_intercept.py b/tests/sync/test_page_request_intercept.py
index d62cc5f79..86cf21b63 100644
--- a/tests/sync/test_page_request_intercept.py
+++ b/tests/sync/test_page_request_intercept.py
@@ -15,13 +15,13 @@
 import pytest
 
 from playwright.sync_api import Error, Page, Route
-from tests.server import HttpRequestWithPostBody, Server
+from tests.server import Server, TestServerRequest
 
 
 def test_should_support_timeout_option_in_route_fetch(
     server: Server, page: Page
 ) -> None:
-    def _handle(request: HttpRequestWithPostBody) -> None:
+    def _handle(request: TestServerRequest) -> None:
         request.responseHeaders.addRawHeader("Content-Length", "4096")
         request.responseHeaders.addRawHeader("Content-Type", "text/html")
         request.write(b"")

From f371be968607ed2fa8affc75e6fed19179ccf2e9 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 30 Nov 2023 10:06:48 -0800
Subject: [PATCH 124/438] chore: unskip tests / unignore linting in tests
 (#2180)

---
 playwright/_impl/_api_structures.py                |  1 +
 scripts/generate_api.py                            | 12 +-----------
 tests/async/test_browsercontext_add_cookies.py     |  1 +
 tests/async/test_launcher.py                       |  2 +-
 tests/sync/test_assertions.py                      |  8 ++------
 tests/sync/test_browsercontext_request_fallback.py |  3 ++-
 tests/sync/test_fetch_browser_context.py           | 11 ++++++-----
 7 files changed, 14 insertions(+), 24 deletions(-)

diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index f45f713a1..c20f8d845 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -39,6 +39,7 @@ class Cookie(TypedDict, total=False):
     sameSite: Literal["Lax", "None", "Strict"]
 
 
+# TODO: We are waiting for PEP705 so SetCookieParam can be readonly and matches Cookie.
 class SetCookieParam(TypedDict, total=False):
     name: str
     value: str
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index 388db89e1..274740bda 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -15,17 +15,7 @@
 import re
 import sys
 from types import FunctionType
-from typing import (  # type: ignore
-    Any,
-    Dict,
-    List,
-    Match,
-    Optional,
-    Union,
-    cast,
-    get_args,
-    get_origin,
-)
+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
diff --git a/tests/async/test_browsercontext_add_cookies.py b/tests/async/test_browsercontext_add_cookies.py
index 6f457a11f..9423ccd63 100644
--- a/tests/async/test_browsercontext_add_cookies.py
+++ b/tests/async/test_browsercontext_add_cookies.py
@@ -49,6 +49,7 @@ async def test_should_roundtrip_cookie(
     cookies = await context.cookies()
     await context.clear_cookies()
     assert await context.cookies() == []
+    # TODO: We are waiting for PEP705 so SetCookieParam can be readonly and matches the Cookie type.
     await context.add_cookies(cookies)  # type: ignore
     assert await context.cookies() == cookies
 
diff --git a/tests/async/test_launcher.py b/tests/async/test_launcher.py
index 95734cb35..d29b20989 100644
--- a/tests/async/test_launcher.py
+++ b/tests/async/test_launcher.py
@@ -130,7 +130,7 @@ async def test_browser_launch_should_return_background_pages(
                 f"--disable-extensions-except={extension_path}",
                 f"--load-extension={extension_path}",
             ],
-        },  # type: ignore
+        },
     )
     background_page = None
     if len(context.background_pages):
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index ef66e2af3..f2df44ab5 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -90,9 +90,7 @@ def test_assertions_locator_to_contain_text(page: Page, server: Server) -> None:
         expect(page.locator("div#foobar")).to_contain_text("bar", timeout=100)
 
     page.set_content("<div>Text \n1</div><div>Text2</div><div>Text3</div>")
-    expect(page.locator("div")).to_contain_text(
-        ["ext     1", re.compile("ext3")]  # type: ignore
-    )
+    expect(page.locator("div")).to_contain_text(["ext     1", re.compile("ext3")])
 
 
 def test_assertions_locator_to_have_attribute(page: Page, server: Server) -> None:
@@ -244,9 +242,7 @@ def test_assertions_locator_to_have_text(page: Page, server: Server) -> None:
 
     page.set_content("<div>Text    \n1</div><div>Text   2a</div>")
     # Should only normalize whitespace in the first item.
-    expect(page.locator("div")).to_have_text(
-        ["Text  1", re.compile(r"Text   \d+a")]  # type: ignore
-    )
+    expect(page.locator("div")).to_have_text(["Text  1", re.compile(r"Text   \d+a")])
 
 
 @pytest.mark.parametrize(
diff --git a/tests/sync/test_browsercontext_request_fallback.py b/tests/sync/test_browsercontext_request_fallback.py
index 24c25f131..e653800d7 100644
--- a/tests/sync/test_browsercontext_request_fallback.py
+++ b/tests/sync/test_browsercontext_request_fallback.py
@@ -204,7 +204,8 @@ def capture_and_continue(route: Route, request: Request) -> None:
 
     def delete_foo_header(route: Route, request: Request) -> None:
         headers = request.all_headers()
-        route.fallback(headers={**headers, "foo": None})  # type: ignore
+        del headers["foo"]
+        route.fallback(headers=headers)
 
     context.route(server.PREFIX + "/something", delete_foo_header)
     with server.expect_request("/something") as server_req_info:
diff --git a/tests/sync/test_fetch_browser_context.py b/tests/sync/test_fetch_browser_context.py
index edb00993b..5a8b38769 100644
--- a/tests/sync/test_fetch_browser_context.py
+++ b/tests/sync/test_fetch_browser_context.py
@@ -20,6 +20,7 @@
 
 from playwright.sync_api import BrowserContext, Error, FilePayload, Page
 from tests.server import Server
+from tests.utils import must
 
 
 def test_get_should_work(context: BrowserContext, server: Server) -> None:
@@ -150,11 +151,11 @@ def support_post_data(fetch_data: Any, request_post_data: Any) -> None:
                 server.PREFIX + "/simple.json", data=fetch_data
             )
         assert request.value.method.decode() == method.upper()
-        assert request.value.post_body == request_post_data  # type: ignore
+        assert request.value.post_body == request_post_data
         assert response.status == 200
         assert response.url == server.PREFIX + "/simple.json"
         assert request.value.getHeader("Content-Length") == str(
-            len(request.value.post_body)  # type: ignore
+            len(must(request.value.post_body))
         )
 
     support_post_data("My request", "My request".encode())
@@ -182,9 +183,9 @@ def test_should_support_application_x_www_form_urlencoded(
         server_req.value.getHeader("Content-Type")
         == "application/x-www-form-urlencoded"
     )
-    body = server_req.value.post_body.decode()  # type: ignore
+    body = must(server_req.value.post_body).decode()
     assert server_req.value.getHeader("Content-Length") == str(len(body))
-    params: Dict[bytes, List[bytes]] = parse_qs(server_req.value.post_body)  # type: ignore
+    params: Dict[bytes, List[bytes]] = parse_qs(server_req.value.post_body)
     assert params[b"firstName"] == [b"John"]
     assert params[b"lastName"] == [b"Doe"]
     assert params[b"file"] == [b"f.js"]
@@ -212,7 +213,7 @@ def test_should_support_multipart_form_data(
     assert content_type
     assert content_type.startswith("multipart/form-data; ")
     assert server_req.value.getHeader("Content-Length") == str(
-        len(server_req.value.post_body)  # type: ignore
+        len(must(server_req.value.post_body))
     )
     assert server_req.value.args[b"firstName"] == [b"John"]
     assert server_req.value.args[b"lastName"] == [b"Doe"]

From cb3a24ec38a003b38004c7fc396d2880688e4355 Mon Sep 17 00:00:00 2001
From: Oleksandr Baltian <obaltian@icloud.com>
Date: Sat, 30 Dec 2023 20:59:13 +0100
Subject: [PATCH 125/438] fix: NameError in _impl/frame.py (#2216)

Fixes ##2215
---
 playwright/_impl/_frame.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 2cfbb7240..2ce4372b6 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -156,7 +156,7 @@ def _setup_navigation_waiter(self, wait_name: str, timeout: float = None) -> Wai
         waiter.reject_on_event(
             self._page,
             "close",
-            lambda: cast(Page, self._page)._close_error_with_reason(),
+            lambda: cast("Page", self._page)._close_error_with_reason(),
         )
         waiter.reject_on_event(
             self._page, "crash", Error("Navigation failed because page crashed!")

From d943ab86589d9b84d8a89d8247d74471af2b05d6 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 3 Jan 2024 18:47:00 +0100
Subject: [PATCH 126/438] fix: mask_color for screenshots (#2205)

---
 playwright/_impl/_browser_type.py   | 2 +-
 playwright/_impl/_element_handle.py | 2 +-
 playwright/_impl/_locator.py        | 2 +-
 playwright/_impl/_page.py           | 2 +-
 playwright/async_api/_generated.py  | 8 ++++----
 playwright/sync_api/_generated.py   | 8 ++++----
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 28a0e7cb4..65e3982c7 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -163,7 +163,7 @@ async def connect_over_cdp(
         self,
         endpointURL: str,
         timeout: float = None,
-        slow_mo: float = None,
+        slowMo: float = None,
         headers: Dict[str, str] = None,
     ) -> Browser:
         params = locals_to_params(locals())
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 03e49eb04..6c585bb0d 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -297,7 +297,7 @@ async def screenshot(
         caret: Literal["hide", "initial"] = None,
         scale: Literal["css", "device"] = None,
         mask: Sequence["Locator"] = None,
-        mask_color: str = None,
+        maskColor: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
         if "path" in params:
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index d18d0d5de..4f4799183 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -522,7 +522,7 @@ async def screenshot(
         caret: Literal["hide", "initial"] = None,
         scale: Literal["css", "device"] = None,
         mask: Sequence["Locator"] = None,
-        mask_color: str = None,
+        maskColor: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
         return await self._with_element(
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 2bfae2090..8d143172f 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -638,7 +638,7 @@ async def screenshot(
         caret: Literal["hide", "initial"] = None,
         scale: Literal["css", "device"] = None,
         mask: Sequence["Locator"] = None,
-        mask_color: str = None,
+        maskColor: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
         if "path" in params:
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 3ab7a143f..4dcd4da23 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -2837,7 +2837,7 @@ async def screenshot(
                 caret=caret,
                 scale=scale,
                 mask=mapping.to_impl(mask),
-                mask_color=mask_color,
+                maskColor=mask_color,
             )
         )
 
@@ -9992,7 +9992,7 @@ async def screenshot(
                 caret=caret,
                 scale=scale,
                 mask=mapping.to_impl(mask),
-                mask_color=mask_color,
+                maskColor=mask_color,
             )
         )
 
@@ -15100,7 +15100,7 @@ async def connect_over_cdp(
             await self._impl_obj.connect_over_cdp(
                 endpointURL=endpoint_url,
                 timeout=timeout,
-                slow_mo=slow_mo,
+                slowMo=slow_mo,
                 headers=mapping.to_impl(headers),
             )
         )
@@ -17602,7 +17602,7 @@ async def screenshot(
                 caret=caret,
                 scale=scale,
                 mask=mapping.to_impl(mask),
-                mask_color=mask_color,
+                maskColor=mask_color,
             )
         )
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index af78b6a72..e4383917b 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -2872,7 +2872,7 @@ def screenshot(
                     caret=caret,
                     scale=scale,
                     mask=mapping.to_impl(mask),
-                    mask_color=mask_color,
+                    maskColor=mask_color,
                 )
             )
         )
@@ -10061,7 +10061,7 @@ def screenshot(
                     caret=caret,
                     scale=scale,
                     mask=mapping.to_impl(mask),
-                    mask_color=mask_color,
+                    maskColor=mask_color,
                 )
             )
         )
@@ -15171,7 +15171,7 @@ def connect_over_cdp(
                 self._impl_obj.connect_over_cdp(
                     endpointURL=endpoint_url,
                     timeout=timeout,
-                    slow_mo=slow_mo,
+                    slowMo=slow_mo,
                     headers=mapping.to_impl(headers),
                 )
             )
@@ -17719,7 +17719,7 @@ def screenshot(
                     caret=caret,
                     scale=scale,
                     mask=mapping.to_impl(mask),
-                    mask_color=mask_color,
+                    maskColor=mask_color,
                 )
             )
         )

From 23a225e914c064f70452280bf1a81053832d857e Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 3 Jan 2024 19:46:30 +0100
Subject: [PATCH 127/438] chore: enforce no underscores in impl class params
 (#2223)

---
 playwright/_impl/_assertions.py      | 80 +++++++++++------------
 playwright/_impl/_browser_context.py | 12 ++--
 playwright/_impl/_browser_type.py    | 16 ++---
 playwright/_impl/_frame.py           | 30 ++++-----
 playwright/_impl/_locator.py         | 74 ++++++++++-----------
 playwright/_impl/_page.py            | 50 +++++++--------
 playwright/_impl/_selectors.py       |  6 +-
 playwright/async_api/_generated.py   | 94 +++++++++++++--------------
 playwright/sync_api/_generated.py    | 96 ++++++++++++++--------------
 scripts/generate_api.py              |  3 +
 10 files changed, 230 insertions(+), 231 deletions(-)

diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 73dc76000..ce8d63816 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -89,45 +89,45 @@ def _not(self) -> "PageAssertions":
         )
 
     async def to_have_title(
-        self, title_or_reg_exp: Union[Pattern[str], str], timeout: float = None
+        self, titleOrRegExp: Union[Pattern[str], str], timeout: float = None
     ) -> None:
         expected_values = to_expected_text_values(
-            [title_or_reg_exp], normalize_white_space=True
+            [titleOrRegExp], normalize_white_space=True
         )
         __tracebackhide__ = True
         await self._expect_impl(
             "to.have.title",
             FrameExpectOptions(expectedText=expected_values, timeout=timeout),
-            title_or_reg_exp,
+            titleOrRegExp,
             "Page title expected to be",
         )
 
     async def not_to_have_title(
-        self, title_or_reg_exp: Union[Pattern[str], str], timeout: float = None
+        self, titleOrRegExp: Union[Pattern[str], str], timeout: float = None
     ) -> None:
         __tracebackhide__ = True
-        await self._not.to_have_title(title_or_reg_exp, timeout)
+        await self._not.to_have_title(titleOrRegExp, timeout)
 
     async def to_have_url(
-        self, url_or_reg_exp: Union[str, Pattern[str]], timeout: float = None
+        self, urlOrRegExp: Union[str, Pattern[str]], timeout: float = None
     ) -> None:
         __tracebackhide__ = True
         base_url = self._actual_page.context._options.get("baseURL")
-        if isinstance(url_or_reg_exp, str) and base_url:
-            url_or_reg_exp = urljoin(base_url, url_or_reg_exp)
-        expected_text = to_expected_text_values([url_or_reg_exp])
+        if isinstance(urlOrRegExp, str) and base_url:
+            urlOrRegExp = urljoin(base_url, urlOrRegExp)
+        expected_text = to_expected_text_values([urlOrRegExp])
         await self._expect_impl(
             "to.have.url",
             FrameExpectOptions(expectedText=expected_text, timeout=timeout),
-            url_or_reg_exp,
+            urlOrRegExp,
             "Page URL expected to be",
         )
 
     async def not_to_have_url(
-        self, url_or_reg_exp: Union[Pattern[str], str], timeout: float = None
+        self, urlOrRegExp: Union[Pattern[str], str], timeout: float = None
     ) -> None:
         __tracebackhide__ = True
-        await self._not.to_have_url(url_or_reg_exp, timeout)
+        await self._not.to_have_url(urlOrRegExp, timeout)
 
 
 class LocatorAssertions(AssertionsBase):
@@ -156,9 +156,9 @@ async def to_contain_text(
             Pattern[str],
             str,
         ],
-        use_inner_text: bool = None,
+        useInnerText: bool = None,
         timeout: float = None,
-        ignore_case: bool = None,
+        ignoreCase: bool = None,
     ) -> None:
         __tracebackhide__ = True
         if isinstance(expected, collections.abc.Sequence) and not isinstance(
@@ -168,13 +168,13 @@ async def to_contain_text(
                 expected,
                 match_substring=True,
                 normalize_white_space=True,
-                ignore_case=ignore_case,
+                ignoreCase=ignoreCase,
             )
             await self._expect_impl(
                 "to.contain.text.array",
                 FrameExpectOptions(
                     expectedText=expected_text,
-                    useInnerText=use_inner_text,
+                    useInnerText=useInnerText,
                     timeout=timeout,
                 ),
                 expected,
@@ -185,13 +185,13 @@ async def to_contain_text(
                 [expected],
                 match_substring=True,
                 normalize_white_space=True,
-                ignore_case=ignore_case,
+                ignoreCase=ignoreCase,
             )
             await self._expect_impl(
                 "to.have.text",
                 FrameExpectOptions(
                     expectedText=expected_text,
-                    useInnerText=use_inner_text,
+                    useInnerText=useInnerText,
                     timeout=timeout,
                 ),
                 expected,
@@ -207,22 +207,22 @@ async def not_to_contain_text(
             Pattern[str],
             str,
         ],
-        use_inner_text: bool = None,
+        useInnerText: bool = None,
         timeout: float = None,
-        ignore_case: bool = None,
+        ignoreCase: bool = None,
     ) -> None:
         __tracebackhide__ = True
-        await self._not.to_contain_text(expected, use_inner_text, timeout, ignore_case)
+        await self._not.to_contain_text(expected, useInnerText, timeout, ignoreCase)
 
     async def to_have_attribute(
         self,
         name: str,
         value: Union[str, Pattern[str]],
-        ignore_case: bool = None,
+        ignoreCase: bool = None,
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
-        expected_text = to_expected_text_values([value], ignore_case=ignore_case)
+        expected_text = to_expected_text_values([value], ignoreCase=ignoreCase)
         await self._expect_impl(
             "to.have.attribute.value",
             FrameExpectOptions(
@@ -236,12 +236,12 @@ async def not_to_have_attribute(
         self,
         name: str,
         value: Union[str, Pattern[str]],
-        ignore_case: bool = None,
+        ignoreCase: bool = None,
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
         await self._not.to_have_attribute(
-            name, value, ignore_case=ignore_case, timeout=timeout
+            name, value, ignoreCase=ignoreCase, timeout=timeout
         )
 
     async def to_have_class(
@@ -440,9 +440,9 @@ async def to_have_text(
             Pattern[str],
             str,
         ],
-        use_inner_text: bool = None,
+        useInnerText: bool = None,
         timeout: float = None,
-        ignore_case: bool = None,
+        ignoreCase: bool = None,
     ) -> None:
         __tracebackhide__ = True
         if isinstance(expected, collections.abc.Sequence) and not isinstance(
@@ -451,13 +451,13 @@ async def to_have_text(
             expected_text = to_expected_text_values(
                 expected,
                 normalize_white_space=True,
-                ignore_case=ignore_case,
+                ignoreCase=ignoreCase,
             )
             await self._expect_impl(
                 "to.have.text.array",
                 FrameExpectOptions(
                     expectedText=expected_text,
-                    useInnerText=use_inner_text,
+                    useInnerText=useInnerText,
                     timeout=timeout,
                 ),
                 expected,
@@ -465,13 +465,13 @@ async def to_have_text(
             )
         else:
             expected_text = to_expected_text_values(
-                [expected], normalize_white_space=True, ignore_case=ignore_case
+                [expected], normalize_white_space=True, ignoreCase=ignoreCase
             )
             await self._expect_impl(
                 "to.have.text",
                 FrameExpectOptions(
                     expectedText=expected_text,
-                    useInnerText=use_inner_text,
+                    useInnerText=useInnerText,
                     timeout=timeout,
                 ),
                 expected,
@@ -487,12 +487,12 @@ async def not_to_have_text(
             Pattern[str],
             str,
         ],
-        use_inner_text: bool = None,
+        useInnerText: bool = None,
         timeout: float = None,
-        ignore_case: bool = None,
+        ignoreCase: bool = None,
     ) -> None:
         __tracebackhide__ = True
-        await self._not.to_have_text(expected, use_inner_text, timeout, ignore_case)
+        await self._not.to_have_text(expected, useInnerText, timeout, ignoreCase)
 
     async def to_be_attached(
         self,
@@ -754,14 +754,14 @@ def expected_regex(
     pattern: Pattern[str],
     match_substring: bool,
     normalize_white_space: bool,
-    ignore_case: Optional[bool] = None,
+    ignoreCase: Optional[bool] = None,
 ) -> ExpectedTextValue:
     expected = ExpectedTextValue(
         regexSource=pattern.pattern,
         regexFlags=escape_regex_flags(pattern),
         matchSubstring=match_substring,
         normalizeWhiteSpace=normalize_white_space,
-        ignoreCase=ignore_case,
+        ignoreCase=ignoreCase,
     )
     if expected["ignoreCase"] is None:
         del expected["ignoreCase"]
@@ -774,7 +774,7 @@ def to_expected_text_values(
     ],
     match_substring: bool = False,
     normalize_white_space: bool = False,
-    ignore_case: Optional[bool] = None,
+    ignoreCase: Optional[bool] = None,
 ) -> Sequence[ExpectedTextValue]:
     out: List[ExpectedTextValue] = []
     assert isinstance(items, list)
@@ -784,15 +784,13 @@ def to_expected_text_values(
                 string=item,
                 matchSubstring=match_substring,
                 normalizeWhiteSpace=normalize_white_space,
-                ignoreCase=ignore_case,
+                ignoreCase=ignoreCase,
             )
             if o["ignoreCase"] is None:
                 del o["ignoreCase"]
             out.append(o)
         elif isinstance(item, Pattern):
             out.append(
-                expected_regex(
-                    item, match_substring, normalize_white_space, ignore_case
-                )
+                expected_regex(item, match_substring, normalize_white_space, ignoreCase)
             )
     return out
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 74ceac9a1..e7e6f19a8 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -399,24 +399,24 @@ async def route_from_har(
         self,
         har: Union[Path, str],
         url: Union[Pattern[str], str] = None,
-        not_found: RouteFromHarNotFoundPolicy = None,
+        notFound: RouteFromHarNotFoundPolicy = None,
         update: bool = None,
-        update_content: Literal["attach", "embed"] = None,
-        update_mode: HarMode = None,
+        updateContent: Literal["attach", "embed"] = None,
+        updateMode: HarMode = None,
     ) -> None:
         if update:
             await self._record_into_har(
                 har=har,
                 page=None,
                 url=url,
-                update_content=update_content,
-                update_mode=update_mode,
+                update_content=updateContent,
+                update_mode=updateMode,
             )
             return
         router = await HarRouter.create(
             local_utils=self._connection.local_utils,
             file=str(har),
-            not_found_action=not_found or "abort",
+            not_found_action=notFound or "abort",
             url_matcher=url,
         )
         await router.add_context_route(self)
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 65e3982c7..8393d69ee 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -183,16 +183,16 @@ async def connect_over_cdp(
 
     async def connect(
         self,
-        ws_endpoint: str,
+        wsEndpoint: str,
         timeout: float = None,
-        slow_mo: float = None,
+        slowMo: float = None,
         headers: Dict[str, str] = None,
-        expose_network: str = None,
+        exposeNetwork: str = None,
     ) -> Browser:
         if timeout is None:
             timeout = 30000
-        if slow_mo is None:
-            slow_mo = 0
+        if slowMo is None:
+            slowMo = 0
 
         headers = {**(headers if headers else {}), "x-playwright-browser": self.name}
         local_utils = self._connection.local_utils
@@ -200,11 +200,11 @@ async def connect(
             await local_utils._channel.send_return_as_dict(
                 "connect",
                 {
-                    "wsEndpoint": ws_endpoint,
+                    "wsEndpoint": wsEndpoint,
                     "headers": headers,
-                    "slowMo": slow_mo,
+                    "slowMo": slowMo,
                     "timeout": timeout,
-                    "exposeNetwork": expose_network,
+                    "exposeNetwork": exposeNetwork,
                 },
             )
         )["pipe"]
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 2ce4372b6..75047ff79 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -175,12 +175,12 @@ def _setup_navigation_waiter(self, wait_name: str, timeout: float = None) -> Wai
     def expect_navigation(
         self,
         url: URLMatch = None,
-        wait_until: DocumentLoadState = None,
+        waitUntil: DocumentLoadState = None,
         timeout: float = None,
     ) -> EventContextManagerImpl[Response]:
         assert self._page
-        if not wait_until:
-            wait_until = "load"
+        if not waitUntil:
+            waitUntil = "load"
 
         if timeout is None:
             timeout = self._page._timeout_settings.navigation_timeout()
@@ -188,7 +188,7 @@ def expect_navigation(
         waiter = self._setup_navigation_waiter("expect_navigation", timeout)
 
         to_url = f' to "{url}"' if url else ""
-        waiter.log(f"waiting for navigation{to_url} until '{wait_until}'")
+        waiter.log(f"waiting for navigation{to_url} until '{waitUntil}'")
         matcher = (
             URLMatcher(self._page._browser_context._options.get("baseURL"), url)
             if url
@@ -212,10 +212,10 @@ async def continuation() -> Optional[Response]:
             event = await waiter.result()
             if "error" in event:
                 raise Error(event["error"])
-            if wait_until not in self._load_states:
+            if waitUntil not in self._load_states:
                 t = deadline - monotonic_time()
                 if t > 0:
-                    await self._wait_for_load_state_impl(state=wait_until, timeout=t)
+                    await self._wait_for_load_state_impl(state=waitUntil, timeout=t)
             if "newDocument" in event and "request" in event["newDocument"]:
                 request = from_channel(event["newDocument"]["request"])
                 return await request.response()
@@ -226,16 +226,16 @@ async def continuation() -> Optional[Response]:
     async def wait_for_url(
         self,
         url: URLMatch,
-        wait_until: DocumentLoadState = None,
+        waitUntil: DocumentLoadState = None,
         timeout: float = None,
     ) -> None:
         assert self._page
         matcher = URLMatcher(self._page._browser_context._options.get("baseURL"), url)
         if matcher.matches(self.url):
-            await self._wait_for_load_state_impl(state=wait_until, timeout=timeout)
+            await self._wait_for_load_state_impl(state=waitUntil, timeout=timeout)
             return
         async with self.expect_navigation(
-            url=url, wait_until=wait_until, timeout=timeout
+            url=url, waitUntil=waitUntil, timeout=timeout
         ):
             pass
 
@@ -535,18 +535,18 @@ async def fill(
     def locator(
         self,
         selector: str,
-        has_text: Union[str, Pattern[str]] = None,
-        has_not_text: Union[str, Pattern[str]] = None,
+        hasText: Union[str, Pattern[str]] = None,
+        hasNotText: Union[str, Pattern[str]] = None,
         has: Locator = None,
-        has_not: Locator = None,
+        hasNot: Locator = None,
     ) -> Locator:
         return Locator(
             self,
             selector,
-            has_text=has_text,
-            has_not_text=has_not_text,
+            has_text=hasText,
+            has_not_text=hasNotText,
             has=has,
-            has_not=has_not,
+            has_not=hasNot,
         )
 
     def get_by_alt_text(
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 4f4799183..55955d089 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -219,30 +219,30 @@ async def clear(
 
     def locator(
         self,
-        selector_or_locator: Union[str, "Locator"],
-        has_text: Union[str, Pattern[str]] = None,
-        has_not_text: Union[str, Pattern[str]] = None,
+        selectorOrLocator: Union[str, "Locator"],
+        hasText: Union[str, Pattern[str]] = None,
+        hasNotText: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
-        has_not: "Locator" = None,
+        hasNot: "Locator" = None,
     ) -> "Locator":
-        if isinstance(selector_or_locator, str):
+        if isinstance(selectorOrLocator, str):
             return Locator(
                 self._frame,
-                f"{self._selector} >> {selector_or_locator}",
-                has_text=has_text,
-                has_not_text=has_not_text,
-                has_not=has_not,
+                f"{self._selector} >> {selectorOrLocator}",
+                has_text=hasText,
+                has_not_text=hasNotText,
+                has_not=hasNot,
                 has=has,
             )
-        selector_or_locator = to_impl(selector_or_locator)
-        if selector_or_locator._frame != self._frame:
+        selectorOrLocator = to_impl(selectorOrLocator)
+        if selectorOrLocator._frame != self._frame:
             raise Error("Locators must belong to the same frame.")
         return Locator(
             self._frame,
-            f"{self._selector} >> internal:chain={json.dumps(selector_or_locator._selector)}",
-            has_text=has_text,
-            has_not_text=has_not_text,
-            has_not=has_not,
+            f"{self._selector} >> internal:chain={json.dumps(selectorOrLocator._selector)}",
+            has_text=hasText,
+            has_not_text=hasNotText,
+            has_not=hasNot,
             has=has,
         )
 
@@ -332,18 +332,18 @@ def nth(self, index: int) -> "Locator":
 
     def filter(
         self,
-        has_text: Union[str, Pattern[str]] = None,
-        has_not_text: Union[str, Pattern[str]] = None,
+        hasText: Union[str, Pattern[str]] = None,
+        hasNotText: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
-        has_not: "Locator" = None,
+        hasNot: "Locator" = None,
     ) -> "Locator":
         return Locator(
             self._frame,
             self._selector,
-            has_text=has_text,
-            has_not_text=has_not_text,
+            has_text=hasText,
+            has_not_text=hasNotText,
             has=has,
-            has_not=has_not,
+            has_not=hasNot,
         )
 
     def or_(self, locator: "Locator") -> "Locator":
@@ -724,31 +724,31 @@ def __init__(self, frame: "Frame", frame_selector: str) -> None:
 
     def locator(
         self,
-        selector_or_locator: Union["Locator", str],
-        has_text: Union[str, Pattern[str]] = None,
-        has_not_text: Union[str, Pattern[str]] = None,
-        has: "Locator" = None,
-        has_not: "Locator" = None,
+        selectorOrLocator: Union["Locator", str],
+        hasText: Union[str, Pattern[str]] = None,
+        hasNotText: Union[str, Pattern[str]] = None,
+        has: Locator = None,
+        hasNot: Locator = None,
     ) -> Locator:
-        if isinstance(selector_or_locator, str):
+        if isinstance(selectorOrLocator, str):
             return Locator(
                 self._frame,
-                f"{self._frame_selector} >> internal:control=enter-frame >> {selector_or_locator}",
-                has_text=has_text,
-                has_not_text=has_not_text,
+                f"{self._frame_selector} >> internal:control=enter-frame >> {selectorOrLocator}",
+                has_text=hasText,
+                has_not_text=hasNotText,
                 has=has,
-                has_not=has_not,
+                has_not=hasNot,
             )
-        selector_or_locator = to_impl(selector_or_locator)
-        if selector_or_locator._frame != self._frame:
+        selectorOrLocator = to_impl(selectorOrLocator)
+        if selectorOrLocator._frame != self._frame:
             raise ValueError("Locators must belong to the same frame.")
         return Locator(
             self._frame,
-            f"{self._frame_selector} >> internal:control=enter-frame >> {selector_or_locator._selector}",
-            has_text=has_text,
-            has_not_text=has_not_text,
+            f"{self._frame_selector} >> internal:control=enter-frame >> {selectorOrLocator._selector}",
+            has_text=hasText,
+            has_not_text=hasNotText,
             has=has,
-            has_not=has_not,
+            has_not=hasNot,
         )
 
     def get_by_alt_text(
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 8d143172f..cfa571f74 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -494,7 +494,7 @@ async def wait_for_load_state(
     async def wait_for_url(
         self,
         url: URLMatch,
-        wait_until: DocumentLoadState = None,
+        waitUntil: DocumentLoadState = None,
         timeout: float = None,
     ) -> None:
         return await self._main_frame.wait_for_url(**locals_to_params(locals()))
@@ -597,24 +597,24 @@ async def route_from_har(
         self,
         har: Union[Path, str],
         url: Union[Pattern[str], str] = None,
-        not_found: RouteFromHarNotFoundPolicy = None,
+        notFound: RouteFromHarNotFoundPolicy = None,
         update: bool = None,
-        update_content: Literal["attach", "embed"] = None,
-        update_mode: HarMode = None,
+        updateContent: Literal["attach", "embed"] = None,
+        updateMode: HarMode = None,
     ) -> None:
         if update:
             await self._browser_context._record_into_har(
                 har=har,
                 page=self,
                 url=url,
-                update_content=update_content,
-                update_mode=update_mode,
+                update_content=updateContent,
+                update_mode=updateMode,
             )
             return
         router = await HarRouter.create(
             local_utils=self._connection.local_utils,
             file=str(har),
-            not_found_action=not_found or "abort",
+            not_found_action=notFound or "abort",
             url_matcher=url,
         )
         await router.add_page_route(self)
@@ -736,17 +736,17 @@ async def fill(
     def locator(
         self,
         selector: str,
-        has_text: Union[str, Pattern[str]] = None,
-        has_not_text: Union[str, Pattern[str]] = None,
+        hasText: Union[str, Pattern[str]] = None,
+        hasNotText: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
-        has_not: "Locator" = None,
+        hasNot: "Locator" = None,
     ) -> "Locator":
         return self._main_frame.locator(
             selector,
-            has_text=has_text,
-            has_not_text=has_not_text,
+            hasText=hasText,
+            hasNotText=hasNotText,
             has=has,
-            has_not=has_not,
+            hasNot=hasNot,
         )
 
     def get_by_alt_text(
@@ -1075,10 +1075,10 @@ def expect_file_chooser(
     def expect_navigation(
         self,
         url: URLMatch = None,
-        wait_until: DocumentLoadState = None,
+        waitUntil: DocumentLoadState = None,
         timeout: float = None,
     ) -> EventContextManagerImpl[Response]:
-        return self.main_frame.expect_navigation(url, wait_until, timeout)
+        return self.main_frame.expect_navigation(url, waitUntil, timeout)
 
     def expect_popup(
         self,
@@ -1089,17 +1089,17 @@ def expect_popup(
 
     def expect_request(
         self,
-        url_or_predicate: URLMatchRequest,
+        urlOrPredicate: URLMatchRequest,
         timeout: float = None,
     ) -> EventContextManagerImpl[Request]:
         matcher = (
             None
-            if callable(url_or_predicate)
+            if callable(urlOrPredicate)
             else URLMatcher(
-                self._browser_context._options.get("baseURL"), url_or_predicate
+                self._browser_context._options.get("baseURL"), urlOrPredicate
             )
         )
-        predicate = url_or_predicate if callable(url_or_predicate) else None
+        predicate = urlOrPredicate if callable(urlOrPredicate) else None
 
         def my_predicate(request: Request) -> bool:
             if matcher:
@@ -1108,7 +1108,7 @@ def my_predicate(request: Request) -> bool:
                 return predicate(request)
             return True
 
-        trimmed_url = trim_url(url_or_predicate)
+        trimmed_url = trim_url(urlOrPredicate)
         log_line = f"waiting for request {trimmed_url}" if trimmed_url else None
         return self._expect_event(
             Page.Events.Request,
@@ -1128,17 +1128,17 @@ def expect_request_finished(
 
     def expect_response(
         self,
-        url_or_predicate: URLMatchResponse,
+        urlOrPredicate: URLMatchResponse,
         timeout: float = None,
     ) -> EventContextManagerImpl[Response]:
         matcher = (
             None
-            if callable(url_or_predicate)
+            if callable(urlOrPredicate)
             else URLMatcher(
-                self._browser_context._options.get("baseURL"), url_or_predicate
+                self._browser_context._options.get("baseURL"), urlOrPredicate
             )
         )
-        predicate = url_or_predicate if callable(url_or_predicate) else None
+        predicate = urlOrPredicate if callable(urlOrPredicate) else None
 
         def my_predicate(response: Response) -> bool:
             if matcher:
@@ -1147,7 +1147,7 @@ def my_predicate(response: Response) -> bool:
                 return predicate(response)
             return True
 
-        trimmed_url = trim_url(url_or_predicate)
+        trimmed_url = trim_url(urlOrPredicate)
         log_line = f"waiting for response {trimmed_url}" if trimmed_url else None
         return self._expect_event(
             Page.Events.Response,
diff --git a/playwright/_impl/_selectors.py b/playwright/_impl/_selectors.py
index 729e17254..cf8af8c06 100644
--- a/playwright/_impl/_selectors.py
+++ b/playwright/_impl/_selectors.py
@@ -47,11 +47,11 @@ async def register(
             await channel._channel.send("register", params)
         self._registrations.append(params)
 
-    def set_test_id_attribute(self, attribute_name: str) -> None:
-        set_test_id_attribute_name(attribute_name)
+    def set_test_id_attribute(self, attributeName: str) -> None:
+        set_test_id_attribute_name(attributeName)
         for channel in self._channels:
             channel._channel.send_no_reply(
-                "setTestIdAttributeName", {"testIdAttributeName": attribute_name}
+                "setTestIdAttributeName", {"testIdAttributeName": attributeName}
             )
 
     def _add_channel(self, channel: "SelectorsOwner") -> None:
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 4dcd4da23..d8276a125 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -3448,7 +3448,7 @@ def expect_navigation(
 
         return AsyncEventContextManager(
             self._impl_obj.expect_navigation(
-                url=self._wrap_handler(url), wait_until=wait_until, timeout=timeout
+                url=self._wrap_handler(url), waitUntil=wait_until, timeout=timeout
             ).future
         )
 
@@ -3500,7 +3500,7 @@ async def wait_for_url(
 
         return mapping.from_maybe_impl(
             await self._impl_obj.wait_for_url(
-                url=self._wrap_handler(url), wait_until=wait_until, timeout=timeout
+                url=self._wrap_handler(url), waitUntil=wait_until, timeout=timeout
             )
         )
 
@@ -4727,10 +4727,10 @@ def locator(
         return mapping.from_impl(
             self._impl_obj.locator(
                 selector=selector,
-                has_text=has_text,
-                has_not_text=has_not_text,
+                hasText=has_text,
+                hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
-                has_not=has_not._impl_obj if has_not else None,
+                hasNot=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -6262,11 +6262,11 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector_or_locator=selector_or_locator,
-                has_text=has_text,
-                has_not_text=has_not_text,
+                selectorOrLocator=selector_or_locator,
+                hasText=has_text,
+                hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
-                has_not=has_not._impl_obj if has_not else None,
+                hasNot=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -7039,7 +7039,7 @@ def set_test_id_attribute(self, attribute_name: str) -> None:
         """
 
         return mapping.from_maybe_impl(
-            self._impl_obj.set_test_id_attribute(attribute_name=attribute_name)
+            self._impl_obj.set_test_id_attribute(attributeName=attribute_name)
         )
 
 
@@ -9415,7 +9415,7 @@ async def wait_for_url(
 
         return mapping.from_maybe_impl(
             await self._impl_obj.wait_for_url(
-                url=self._wrap_handler(url), wait_until=wait_until, timeout=timeout
+                url=self._wrap_handler(url), waitUntil=wait_until, timeout=timeout
             )
         )
 
@@ -9903,10 +9903,10 @@ async def route_from_har(
             await self._impl_obj.route_from_har(
                 har=har,
                 url=url,
-                not_found=not_found,
+                notFound=not_found,
                 update=update,
-                update_content=update_content,
-                update_mode=update_mode,
+                updateContent=update_content,
+                updateMode=update_mode,
             )
         )
 
@@ -10380,10 +10380,10 @@ def locator(
         return mapping.from_impl(
             self._impl_obj.locator(
                 selector=selector,
-                has_text=has_text,
-                has_not_text=has_not_text,
+                hasText=has_text,
+                hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
-                has_not=has_not._impl_obj if has_not else None,
+                hasNot=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -12185,7 +12185,7 @@ def expect_navigation(
 
         return AsyncEventContextManager(
             self._impl_obj.expect_navigation(
-                url=self._wrap_handler(url), wait_until=wait_until, timeout=timeout
+                url=self._wrap_handler(url), waitUntil=wait_until, timeout=timeout
             ).future
         )
 
@@ -12274,7 +12274,7 @@ def expect_request(
 
         return AsyncEventContextManager(
             self._impl_obj.expect_request(
-                url_or_predicate=self._wrap_handler(url_or_predicate), timeout=timeout
+                urlOrPredicate=self._wrap_handler(url_or_predicate), timeout=timeout
             ).future
         )
 
@@ -12367,7 +12367,7 @@ def expect_response(
 
         return AsyncEventContextManager(
             self._impl_obj.expect_response(
-                url_or_predicate=self._wrap_handler(url_or_predicate), timeout=timeout
+                urlOrPredicate=self._wrap_handler(url_or_predicate), timeout=timeout
             ).future
         )
 
@@ -13688,10 +13688,10 @@ async def route_from_har(
             await self._impl_obj.route_from_har(
                 har=har,
                 url=url,
-                not_found=not_found,
+                notFound=not_found,
                 update=update,
-                update_content=update_content,
-                update_mode=update_mode,
+                updateContent=update_content,
+                updateMode=update_mode,
             )
         )
 
@@ -15153,11 +15153,11 @@ async def connect(
 
         return mapping.from_impl(
             await self._impl_obj.connect(
-                ws_endpoint=ws_endpoint,
+                wsEndpoint=ws_endpoint,
                 timeout=timeout,
-                slow_mo=slow_mo,
+                slowMo=slow_mo,
                 headers=mapping.to_impl(headers),
-                expose_network=expose_network,
+                exposeNetwork=expose_network,
             )
         )
 
@@ -16161,11 +16161,11 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector_or_locator=selector_or_locator,
-                has_text=has_text,
-                has_not_text=has_not_text,
+                selectorOrLocator=selector_or_locator,
+                hasText=has_text,
+                hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
-                has_not=has_not._impl_obj if has_not else None,
+                hasNot=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -16823,10 +16823,10 @@ def filter(
 
         return mapping.from_impl(
             self._impl_obj.filter(
-                has_text=has_text,
-                has_not_text=has_not_text,
+                hasText=has_text,
+                hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
-                has_not=has_not._impl_obj if has_not else None,
+                hasNot=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -19175,7 +19175,7 @@ async def to_have_title(
 
         return mapping.from_maybe_impl(
             await self._impl_obj.to_have_title(
-                title_or_reg_exp=title_or_reg_exp, timeout=timeout
+                titleOrRegExp=title_or_reg_exp, timeout=timeout
             )
         )
 
@@ -19200,7 +19200,7 @@ async def not_to_have_title(
 
         return mapping.from_maybe_impl(
             await self._impl_obj.not_to_have_title(
-                title_or_reg_exp=title_or_reg_exp, timeout=timeout
+                titleOrRegExp=title_or_reg_exp, timeout=timeout
             )
         )
 
@@ -19243,7 +19243,7 @@ async def to_have_url(
 
         return mapping.from_maybe_impl(
             await self._impl_obj.to_have_url(
-                url_or_reg_exp=url_or_reg_exp, timeout=timeout
+                urlOrRegExp=url_or_reg_exp, timeout=timeout
             )
         )
 
@@ -19268,7 +19268,7 @@ async def not_to_have_url(
 
         return mapping.from_maybe_impl(
             await self._impl_obj.not_to_have_url(
-                url_or_reg_exp=url_or_reg_exp, timeout=timeout
+                urlOrRegExp=url_or_reg_exp, timeout=timeout
             )
         )
 
@@ -19388,9 +19388,9 @@ async def to_contain_text(
         return mapping.from_maybe_impl(
             await self._impl_obj.to_contain_text(
                 expected=mapping.to_impl(expected),
-                use_inner_text=use_inner_text,
+                useInnerText=use_inner_text,
                 timeout=timeout,
-                ignore_case=ignore_case,
+                ignoreCase=ignore_case,
             )
         )
 
@@ -19429,9 +19429,9 @@ async def not_to_contain_text(
         return mapping.from_maybe_impl(
             await self._impl_obj.not_to_contain_text(
                 expected=mapping.to_impl(expected),
-                use_inner_text=use_inner_text,
+                useInnerText=use_inner_text,
                 timeout=timeout,
-                ignore_case=ignore_case,
+                ignoreCase=ignore_case,
             )
         )
 
@@ -19479,7 +19479,7 @@ async def to_have_attribute(
 
         return mapping.from_maybe_impl(
             await self._impl_obj.to_have_attribute(
-                name=name, value=value, ignore_case=ignore_case, timeout=timeout
+                name=name, value=value, ignoreCase=ignore_case, timeout=timeout
             )
         )
 
@@ -19511,7 +19511,7 @@ async def not_to_have_attribute(
 
         return mapping.from_maybe_impl(
             await self._impl_obj.not_to_have_attribute(
-                name=name, value=value, ignore_case=ignore_case, timeout=timeout
+                name=name, value=value, ignoreCase=ignore_case, timeout=timeout
             )
         )
 
@@ -20133,9 +20133,9 @@ async def to_have_text(
         return mapping.from_maybe_impl(
             await self._impl_obj.to_have_text(
                 expected=mapping.to_impl(expected),
-                use_inner_text=use_inner_text,
+                useInnerText=use_inner_text,
                 timeout=timeout,
-                ignore_case=ignore_case,
+                ignoreCase=ignore_case,
             )
         )
 
@@ -20174,9 +20174,9 @@ async def not_to_have_text(
         return mapping.from_maybe_impl(
             await self._impl_obj.not_to_have_text(
                 expected=mapping.to_impl(expected),
-                use_inner_text=use_inner_text,
+                useInnerText=use_inner_text,
                 timeout=timeout,
-                ignore_case=ignore_case,
+                ignoreCase=ignore_case,
             )
         )
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index e4383917b..09a308c2c 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -3500,7 +3500,7 @@ def expect_navigation(
         return EventContextManager(
             self,
             self._impl_obj.expect_navigation(
-                url=self._wrap_handler(url), wait_until=wait_until, timeout=timeout
+                url=self._wrap_handler(url), waitUntil=wait_until, timeout=timeout
             ).future,
         )
 
@@ -3553,7 +3553,7 @@ def wait_for_url(
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.wait_for_url(
-                    url=self._wrap_handler(url), wait_until=wait_until, timeout=timeout
+                    url=self._wrap_handler(url), waitUntil=wait_until, timeout=timeout
                 )
             )
         )
@@ -4817,10 +4817,10 @@ def locator(
         return mapping.from_impl(
             self._impl_obj.locator(
                 selector=selector,
-                has_text=has_text,
-                has_not_text=has_not_text,
+                hasText=has_text,
+                hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
-                has_not=has_not._impl_obj if has_not else None,
+                hasNot=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -6382,11 +6382,11 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector_or_locator=selector_or_locator,
-                has_text=has_text,
-                has_not_text=has_not_text,
+                selectorOrLocator=selector_or_locator,
+                hasText=has_text,
+                hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
-                has_not=has_not._impl_obj if has_not else None,
+                hasNot=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -7159,7 +7159,7 @@ def set_test_id_attribute(self, attribute_name: str) -> None:
         """
 
         return mapping.from_maybe_impl(
-            self._impl_obj.set_test_id_attribute(attribute_name=attribute_name)
+            self._impl_obj.set_test_id_attribute(attributeName=attribute_name)
         )
 
 
@@ -9470,7 +9470,7 @@ def wait_for_url(
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.wait_for_url(
-                    url=self._wrap_handler(url), wait_until=wait_until, timeout=timeout
+                    url=self._wrap_handler(url), waitUntil=wait_until, timeout=timeout
                 )
             )
         )
@@ -9970,10 +9970,10 @@ def route_from_har(
                 self._impl_obj.route_from_har(
                     har=har,
                     url=url,
-                    not_found=not_found,
+                    notFound=not_found,
                     update=update,
-                    update_content=update_content,
-                    update_mode=update_mode,
+                    updateContent=update_content,
+                    updateMode=update_mode,
                 )
             )
         )
@@ -10460,10 +10460,10 @@ def locator(
         return mapping.from_impl(
             self._impl_obj.locator(
                 selector=selector,
-                has_text=has_text,
-                has_not_text=has_not_text,
+                hasText=has_text,
+                hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
-                has_not=has_not._impl_obj if has_not else None,
+                hasNot=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -12295,7 +12295,7 @@ def expect_navigation(
         return EventContextManager(
             self,
             self._impl_obj.expect_navigation(
-                url=self._wrap_handler(url), wait_until=wait_until, timeout=timeout
+                url=self._wrap_handler(url), waitUntil=wait_until, timeout=timeout
             ).future,
         )
 
@@ -12384,7 +12384,7 @@ def expect_request(
         return EventContextManager(
             self,
             self._impl_obj.expect_request(
-                url_or_predicate=self._wrap_handler(url_or_predicate), timeout=timeout
+                urlOrPredicate=self._wrap_handler(url_or_predicate), timeout=timeout
             ).future,
         )
 
@@ -12477,7 +12477,7 @@ def expect_response(
         return EventContextManager(
             self,
             self._impl_obj.expect_response(
-                url_or_predicate=self._wrap_handler(url_or_predicate), timeout=timeout
+                urlOrPredicate=self._wrap_handler(url_or_predicate), timeout=timeout
             ).future,
         )
 
@@ -13747,10 +13747,10 @@ def route_from_har(
                 self._impl_obj.route_from_har(
                     har=har,
                     url=url,
-                    not_found=not_found,
+                    notFound=not_found,
                     update=update,
-                    update_content=update_content,
-                    update_mode=update_mode,
+                    updateContent=update_content,
+                    updateMode=update_mode,
                 )
             )
         )
@@ -15226,11 +15226,11 @@ def connect(
         return mapping.from_impl(
             self._sync(
                 self._impl_obj.connect(
-                    ws_endpoint=ws_endpoint,
+                    wsEndpoint=ws_endpoint,
                     timeout=timeout,
-                    slow_mo=slow_mo,
+                    slowMo=slow_mo,
                     headers=mapping.to_impl(headers),
-                    expose_network=expose_network,
+                    exposeNetwork=expose_network,
                 )
             )
         )
@@ -16255,11 +16255,11 @@ def locator(
 
         return mapping.from_impl(
             self._impl_obj.locator(
-                selector_or_locator=selector_or_locator,
-                has_text=has_text,
-                has_not_text=has_not_text,
+                selectorOrLocator=selector_or_locator,
+                hasText=has_text,
+                hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
-                has_not=has_not._impl_obj if has_not else None,
+                hasNot=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -16919,10 +16919,10 @@ def filter(
 
         return mapping.from_impl(
             self._impl_obj.filter(
-                has_text=has_text,
-                has_not_text=has_not_text,
+                hasText=has_text,
+                hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
-                has_not=has_not._impl_obj if has_not else None,
+                hasNot=has_not._impl_obj if has_not else None,
             )
         )
 
@@ -19326,7 +19326,7 @@ def to_have_title(
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.to_have_title(
-                    title_or_reg_exp=title_or_reg_exp, timeout=timeout
+                    titleOrRegExp=title_or_reg_exp, timeout=timeout
                 )
             )
         )
@@ -19353,7 +19353,7 @@ def not_to_have_title(
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.not_to_have_title(
-                    title_or_reg_exp=title_or_reg_exp, timeout=timeout
+                    titleOrRegExp=title_or_reg_exp, timeout=timeout
                 )
             )
         )
@@ -19397,9 +19397,7 @@ def to_have_url(
 
         return mapping.from_maybe_impl(
             self._sync(
-                self._impl_obj.to_have_url(
-                    url_or_reg_exp=url_or_reg_exp, timeout=timeout
-                )
+                self._impl_obj.to_have_url(urlOrRegExp=url_or_reg_exp, timeout=timeout)
             )
         )
 
@@ -19425,7 +19423,7 @@ def not_to_have_url(
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.not_to_have_url(
-                    url_or_reg_exp=url_or_reg_exp, timeout=timeout
+                    urlOrRegExp=url_or_reg_exp, timeout=timeout
                 )
             )
         )
@@ -19547,9 +19545,9 @@ def to_contain_text(
             self._sync(
                 self._impl_obj.to_contain_text(
                     expected=mapping.to_impl(expected),
-                    use_inner_text=use_inner_text,
+                    useInnerText=use_inner_text,
                     timeout=timeout,
-                    ignore_case=ignore_case,
+                    ignoreCase=ignore_case,
                 )
             )
         )
@@ -19590,9 +19588,9 @@ def not_to_contain_text(
             self._sync(
                 self._impl_obj.not_to_contain_text(
                     expected=mapping.to_impl(expected),
-                    use_inner_text=use_inner_text,
+                    useInnerText=use_inner_text,
                     timeout=timeout,
-                    ignore_case=ignore_case,
+                    ignoreCase=ignore_case,
                 )
             )
         )
@@ -19642,7 +19640,7 @@ def to_have_attribute(
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.to_have_attribute(
-                    name=name, value=value, ignore_case=ignore_case, timeout=timeout
+                    name=name, value=value, ignoreCase=ignore_case, timeout=timeout
                 )
             )
         )
@@ -19676,7 +19674,7 @@ def not_to_have_attribute(
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.not_to_have_attribute(
-                    name=name, value=value, ignore_case=ignore_case, timeout=timeout
+                    name=name, value=value, ignoreCase=ignore_case, timeout=timeout
                 )
             )
         )
@@ -20314,9 +20312,9 @@ def to_have_text(
             self._sync(
                 self._impl_obj.to_have_text(
                     expected=mapping.to_impl(expected),
-                    use_inner_text=use_inner_text,
+                    useInnerText=use_inner_text,
                     timeout=timeout,
-                    ignore_case=ignore_case,
+                    ignoreCase=ignore_case,
                 )
             )
         )
@@ -20357,9 +20355,9 @@ def not_to_have_text(
             self._sync(
                 self._impl_obj.not_to_have_text(
                     expected=mapping.to_impl(expected),
-                    use_inner_text=use_inner_text,
+                    useInnerText=use_inner_text,
                     timeout=timeout,
-                    ignore_case=ignore_case,
+                    ignoreCase=ignore_case,
                 )
             )
         )
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index 274740bda..4228a92a7 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -133,6 +133,9 @@ def arguments(func: FunctionType, indent: int) -> str:
         value_str = str(value)
         if name == "return":
             continue
+        assert (
+            "_" not in name
+        ), f"Underscore in impl classes is not allowed, use camel case, func={func}, name={name}"
         if "Callable" in value_str:
             tokens.append(f"{name}=self._wrap_handler({to_snake_case(name)})")
         elif (

From 1928691c21ba85d1c52583914ed44b5b04392b86 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 3 Jan 2024 19:46:59 +0100
Subject: [PATCH 128/438] chore: bump linters and mypy (#2222)

---
 .pre-commit-config.yaml | 6 +++---
 local-requirements.txt  | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index eabece583..5198070e1 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -2,7 +2,7 @@
 # See https://pre-commit.com/hooks.html for more hooks
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
+    rev: v4.5.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -19,7 +19,7 @@ repos:
     hooks:
       - id: black
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.5.1
+    rev: v1.8.0
     hooks:
       - id: mypy
         additional_dependencies: [types-pyOpenSSL==23.2.0.2, types-requests==2.31.0.10]
@@ -28,7 +28,7 @@ repos:
     hooks:
       - id: flake8
   - repo: https://github.com/pycqa/isort
-    rev: 5.12.0
+    rev: 5.13.2
     hooks:
       - id: isort
   - repo: local
diff --git a/local-requirements.txt b/local-requirements.txt
index 4a4a27ada..f710e99b9 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ autobahn==23.1.2
 black==23.9.1
 flake8==6.1.0
 flaky==3.7.0
-mypy==1.5.1
+mypy==1.8.0
 objgraph==3.6.0
 Pillow==10.0.1
 pixelmatch==0.3.0

From 7f35a428f5f2ab64b756df488ff13d66c0a11bfa Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 3 Jan 2024 20:44:29 +0100
Subject: [PATCH 129/438] fix: throw in expect() if unsupported type is passed
 to text matcher (#2221)

---
 playwright/_impl/_assertions.py | 3 +++
 tests/async/test_assertions.py  | 7 +++++++
 2 files changed, 10 insertions(+)

diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index ce8d63816..2c895e527 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -18,6 +18,7 @@
 
 from playwright._impl._api_structures import ExpectedTextValue, FrameExpectOptions
 from playwright._impl._connection import format_call_log
+from playwright._impl._errors import Error
 from playwright._impl._fetch import APIResponse
 from playwright._impl._helper import is_textual_mime_type
 from playwright._impl._locator import Locator
@@ -793,4 +794,6 @@ def to_expected_text_values(
             out.append(
                 expected_regex(item, match_substring, normalize_white_space, ignoreCase)
             )
+        else:
+            raise Error("value must be a string or regular expression")
     return out
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 49b860309..774d60de5 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -96,6 +96,13 @@ async def test_assertions_locator_to_contain_text(page: Page, server: Server) ->
     await expect(page.locator("div")).to_contain_text(["ext     1", re.compile("ext3")])
 
 
+async def test_assertions_locator_to_contain_text_should_throw_if_arg_is_unsupported_type(
+    page: Page,
+) -> None:
+    with pytest.raises(Error, match="value must be a string or regular expression"):
+        await expect(page.locator("div")).to_contain_text(1)  # type: ignore
+
+
 async def test_assertions_locator_to_have_attribute(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content("<div id=foobar>kek</div>")

From 73616f4e0c5cf54f57a016c4876962501ebfb5c7 Mon Sep 17 00:00:00 2001
From: Andreas Motl <andreas.motl@elmyra.de>
Date: Mon, 8 Jan 2024 01:14:12 +0100
Subject: [PATCH 130/438] fix: update to greenlet 3.0.3 (#2227)

---
 meta.yaml | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/meta.yaml b/meta.yaml
index 8eb97274f..ede90909a 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -23,7 +23,7 @@ requirements:
     - setuptools_scm
   run:
     - python
-    - greenlet ==3.0.1
+    - greenlet ==3.0.3
     - pyee ==11.0.1
     - typing_extensions # [py<39]
 test:
diff --git a/setup.py b/setup.py
index 7e77bf8ae..bbf63928c 100644
--- a/setup.py
+++ b/setup.py
@@ -218,7 +218,7 @@ def _download_and_extract_local_driver(
     ],
     include_package_data=True,
     install_requires=[
-        "greenlet==3.0.1",
+        "greenlet==3.0.3",
         "pyee==11.0.1",
         "typing-extensions;python_version<='3.8'",
     ],

From 72de5b39d44596bdcf3242e54a34fa999b637438 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 9 Jan 2024 20:03:09 +0100
Subject: [PATCH 131/438] chore: migrate to own glob parser (#2230)

---
 playwright/_impl/_glob.py                     | 68 +++++++++++++++++++
 playwright/_impl/_helper.py                   |  4 +-
 .../test_browsercontext_request_fallback.py   |  5 +-
 tests/async/test_interception.py              | 45 ++++++++++++
 tests/async/test_page_request_fallback.py     |  5 +-
 .../test_browsercontext_request_fallback.py   |  5 +-
 tests/sync/test_page_request_fallback.py      |  5 +-
 7 files changed, 123 insertions(+), 14 deletions(-)
 create mode 100644 playwright/_impl/_glob.py

diff --git a/playwright/_impl/_glob.py b/playwright/_impl/_glob.py
new file mode 100644
index 000000000..2d899a789
--- /dev/null
+++ b/playwright/_impl/_glob.py
@@ -0,0 +1,68 @@
+# 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 re
+
+#  https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions#escaping
+escaped_chars = {"$", "^", "+", ".", "*", "(", ")", "|", "\\", "?", "{", "}", "[", "]"}
+
+
+def glob_to_regex(glob: str) -> "re.Pattern[str]":
+    tokens = ["^"]
+    in_group = False
+
+    i = 0
+    while i < len(glob):
+        c = glob[i]
+        if c == "\\" and i + 1 < len(glob):
+            char = glob[i + 1]
+            tokens.append("\\" + char if char in escaped_chars else char)
+            i += 1
+        elif c == "*":
+            before_deep = 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
+            after_deep = glob[i + 1] if i + 1 < len(glob) else None
+            is_deep = (
+                star_count > 1
+                and (before_deep == "/" or before_deep is None)
+                and (after_deep == "/" or after_deep is None)
+            )
+            if is_deep:
+                tokens.append("((?:[^/]*(?:/|$))*)")
+                i += 1
+            else:
+                tokens.append("([^/]*)")
+        else:
+            if c == "?":
+                tokens.append(".")
+            elif c == "[":
+                tokens.append("[")
+            elif c == "]":
+                tokens.append("]")
+            elif c == "{":
+                in_group = True
+                tokens.append("(")
+            elif c == "}":
+                in_group = False
+                tokens.append(")")
+            elif c == "," and in_group:
+                tokens.append("|")
+            else:
+                tokens.append("\\" + c if c in escaped_chars else c)
+        i += 1
+
+    tokens.append("$")
+    return re.compile("".join(tokens))
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 1b4902613..b68ad6f0b 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -12,7 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 import asyncio
-import fnmatch
 import inspect
 import math
 import os
@@ -41,6 +40,7 @@
 
 from playwright._impl._api_structures import NameValue
 from playwright._impl._errors import Error, TargetClosedError, TimeoutError
+from playwright._impl._glob import glob_to_regex
 from playwright._impl._str_utils import escape_regex_flags
 
 if sys.version_info >= (3, 8):  # pragma: no cover
@@ -149,7 +149,7 @@ def __init__(self, base_url: Union[str, None], match: URLMatch) -> None:
         if isinstance(match, str):
             if base_url and not match.startswith("*"):
                 match = urljoin(base_url, match)
-            regex = fnmatch.translate(match)
+            regex = glob_to_regex(match)
             self._regex_obj = re.compile(regex)
         elif isinstance(match, Pattern):
             self._regex_obj = match
diff --git a/tests/async/test_browsercontext_request_fallback.py b/tests/async/test_browsercontext_request_fallback.py
index f3959490b..b198a4ebd 100644
--- a/tests/async/test_browsercontext_request_fallback.py
+++ b/tests/async/test_browsercontext_request_fallback.py
@@ -185,10 +185,9 @@ async def handler_with_header_mods(route: Route) -> None:
     await context.route("**/*", handler_with_header_mods)
 
     await page.goto(server.EMPTY_PAGE)
-    async with page.expect_request("/sleep.zzz") as request_info:
+    with server.expect_request("/sleep.zzz") as server_request_info:
         await page.evaluate("() => fetch('/sleep.zzz')")
-    request = await request_info.value
-    values.append(request.headers.get("foo"))
+    values.append(server_request_info.value.getHeader("foo"))
     assert values == ["bar", "bar", "bar"]
 
 
diff --git a/tests/async/test_interception.py b/tests/async/test_interception.py
index 911d7ddd8..01f932360 100644
--- a/tests/async/test_interception.py
+++ b/tests/async/test_interception.py
@@ -20,6 +20,7 @@
 
 import pytest
 
+from playwright._impl._glob import glob_to_regex
 from playwright.async_api import (
     Browser,
     BrowserContext,
@@ -1041,3 +1042,47 @@ async def handle_request(route: Route) -> None:
     assert response
     assert response.status == 200
     assert await response.json() == {"foo": "bar"}
+
+
+async def test_glob_to_regex() -> None:
+    assert glob_to_regex("**/*.js").match("https://localhost:8080/foo.js")
+    assert not glob_to_regex("**/*.css").match("https://localhost:8080/foo.js")
+    assert not glob_to_regex("*.js").match("https://localhost:8080/foo.js")
+    assert glob_to_regex("https://**/*.js").match("https://localhost:8080/foo.js")
+    assert glob_to_regex("http://localhost:8080/simple/path.js").match(
+        "http://localhost:8080/simple/path.js"
+    )
+    assert glob_to_regex("http://localhost:8080/?imple/path.js").match(
+        "http://localhost:8080/Simple/path.js"
+    )
+    assert glob_to_regex("**/{a,b}.js").match("https://localhost:8080/a.js")
+    assert glob_to_regex("**/{a,b}.js").match("https://localhost:8080/b.js")
+    assert not glob_to_regex("**/{a,b}.js").match("https://localhost:8080/c.js")
+
+    assert glob_to_regex("**/*.{png,jpg,jpeg}").match("https://localhost:8080/c.jpg")
+    assert glob_to_regex("**/*.{png,jpg,jpeg}").match("https://localhost:8080/c.jpeg")
+    assert glob_to_regex("**/*.{png,jpg,jpeg}").match("https://localhost:8080/c.png")
+    assert not glob_to_regex("**/*.{png,jpg,jpeg}").match(
+        "https://localhost:8080/c.css"
+    )
+    assert glob_to_regex("foo*").match("foo.js")
+    assert not glob_to_regex("foo*").match("foo/bar.js")
+    assert not glob_to_regex("http://localhost:3000/signin-oidc*").match(
+        "http://localhost:3000/signin-oidc/foo"
+    )
+    assert glob_to_regex("http://localhost:3000/signin-oidc*").match(
+        "http://localhost:3000/signin-oidcnice"
+    )
+
+    assert glob_to_regex("**/three-columns/settings.html?**id=[a-z]**").match(
+        "http://mydomain:8080/blah/blah/three-columns/settings.html?id=settings-e3c58efe-02e9-44b0-97ac-dd138100cf7c&blah"
+    )
+
+    assert glob_to_regex("\\?") == re.compile(r"^\?$")
+    assert glob_to_regex("\\") == re.compile(r"^\\$")
+    assert glob_to_regex("\\\\") == re.compile(r"^\\$")
+    assert glob_to_regex("\\[") == re.compile(r"^\[$")
+    assert glob_to_regex("[a-z]") == re.compile(r"^[a-z]$")
+    assert glob_to_regex("$^+.\\*()|\\?\\{\\}\\[\\]") == re.compile(
+        r"^\$\^\+\.\*\(\)\|\?\{\}\[\]$"
+    )
diff --git a/tests/async/test_page_request_fallback.py b/tests/async/test_page_request_fallback.py
index 456c911a3..1cea1204a 100644
--- a/tests/async/test_page_request_fallback.py
+++ b/tests/async/test_page_request_fallback.py
@@ -164,10 +164,9 @@ async def handler_with_header_mods(route: Route) -> None:
     await page.route("**/*", handler_with_header_mods)
 
     await page.goto(server.EMPTY_PAGE)
-    async with page.expect_request("/sleep.zzz") as request_info:
+    with server.expect_request("/sleep.zzz") as server_request_info:
         await page.evaluate("() => fetch('/sleep.zzz')")
-    request = await request_info.value
-    values.append(request.headers.get("foo"))
+    values.append(server_request_info.value.getHeader("foo"))
     assert values == ["bar", "bar", "bar"]
 
 
diff --git a/tests/sync/test_browsercontext_request_fallback.py b/tests/sync/test_browsercontext_request_fallback.py
index e653800d7..6feb19942 100644
--- a/tests/sync/test_browsercontext_request_fallback.py
+++ b/tests/sync/test_browsercontext_request_fallback.py
@@ -174,10 +174,9 @@ def handler_with_header_mods(route: Route) -> None:
     context.route("**/*", handler_with_header_mods)
 
     page.goto(server.EMPTY_PAGE)
-    with page.expect_request("/sleep.zzz") as request_info:
+    with server.expect_request("/sleep.zzz") as server_request_info:
         page.evaluate("() => fetch('/sleep.zzz')")
-    request = request_info.value
-    values.append(request.headers.get("foo"))
+    values.append(server_request_info.value.getHeader("foo"))
     assert values == ["bar", "bar", "bar"]
 
 
diff --git a/tests/sync/test_page_request_fallback.py b/tests/sync/test_page_request_fallback.py
index 09a3c9845..53570960c 100644
--- a/tests/sync/test_page_request_fallback.py
+++ b/tests/sync/test_page_request_fallback.py
@@ -162,10 +162,9 @@ def handler_with_header_mods(route: Route) -> None:
     page.route("**/*", handler_with_header_mods)
 
     page.goto(server.EMPTY_PAGE)
-    with page.expect_request("/sleep.zzz") as request_info:
+    with server.expect_request("/sleep.zzz") as server_request_info:
         page.evaluate("() => fetch('/sleep.zzz')")
-    request = request_info.value
-    _append_with_return_value(values, request.headers.get("foo"))
+    _append_with_return_value(values, server_request_info.value.getHeader("foo"))
     assert values == ["bar", "bar", "bar"]
 
 

From f2640a3cf97628957f28ea7d9f943ec54610a7e1 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 10 Jan 2024 10:09:38 +0100
Subject: [PATCH 132/438] chore: fix typo in example test

Fixes https://github.com/microsoft/playwright-python/issues/2234
---
 examples/todomvc/mvctests/test_new_todo.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/todomvc/mvctests/test_new_todo.py b/examples/todomvc/mvctests/test_new_todo.py
index 15a0dbbbf..f9e069c7b 100644
--- a/examples/todomvc/mvctests/test_new_todo.py
+++ b/examples/todomvc/mvctests/test_new_todo.py
@@ -64,7 +64,7 @@ def test_new_todo_test_should_clear_text_input_field_when_an_item_is_added(
     assert_number_of_todos_in_local_storage(page, 1)
 
 
-def test_new_todo_test_should_append_new_items_to_the_ottom_of_the_list(
+def test_new_todo_test_should_append_new_items_to_the_bottom_of_the_list(
     page: Page,
 ) -> None:
     # Create 3 items.

From 6e586ed27a7d41db64098f94e919f964d052a035 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 16 Jan 2024 20:29:39 +0100
Subject: [PATCH 133/438] chore(roll): roll to Playwright
 1.41.0-beta-1705101589000 (#2225)

---
 README.md                                     |   4 +-
 playwright/_impl/_browser_context.py          |  52 +-
 playwright/_impl/_element_handle.py           |   1 +
 playwright/_impl/_har_router.py               |   4 +-
 playwright/_impl/_helper.py                   |  71 ++-
 playwright/_impl/_locator.py                  |   1 +
 playwright/_impl/_network.py                  |  67 ++-
 playwright/_impl/_page.py                     |  50 +-
 playwright/_impl/_set_input_files_helpers.py  |  14 +-
 playwright/async_api/_generated.py            | 162 ++++--
 playwright/sync_api/_generated.py             | 162 ++++--
 setup.py                                      |   2 +-
 tests/async/conftest.py                       |  11 +
 tests/async/test_asyncio.py                   |  20 +-
 tests/async/test_browsercontext.py            | 118 +---
 .../test_browsercontext_request_fallback.py   | 104 +---
 tests/async/test_browsercontext_route.py      | 516 ++++++++++++++++++
 tests/async/test_expect_misc.py               |   8 +-
 tests/async/test_har.py                       |  41 +-
 tests/async/test_keyboard.py                  |  19 +-
 ...est_interception.py => test_page_route.py} |  19 +-
 tests/async/test_unroute_behavior.py          | 451 +++++++++++++++
 tests/sync/test_sync.py                       |  18 -
 tests/sync/test_unroute_behavior.py           |  46 ++
 24 files changed, 1558 insertions(+), 403 deletions(-)
 create mode 100644 tests/async/test_browsercontext_route.py
 rename tests/async/{test_interception.py => test_page_route.py} (98%)
 create mode 100644 tests/async/test_unroute_behavior.py
 create mode 100644 tests/sync/test_unroute_behavior.py

diff --git a/README.md b/README.md
index fc5380287..d89a1f0e3 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 -->120.0.6099.28<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->121.0.6167.57<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->119.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->121.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index e7e6f19a8..c05b427f2 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -196,6 +196,7 @@ def __init__(
             self.Events.Close, lambda context: self._closed_future.set_result(True)
         )
         self._close_reason: Optional[str] = None
+        self._har_routers: List[HarRouter] = []
         self._set_event_to_subscription_mapping(
             {
                 BrowserContext.Events.Console: "console",
@@ -219,10 +220,16 @@ def _on_page(self, page: Page) -> None:
 
     async def _on_route(self, route: Route) -> None:
         route._context = self
+        page = route.request._safe_page()
         route_handlers = self._routes.copy()
         for route_handler in route_handlers:
+            # If the page or the context was closed we stall all requests right away.
+            if (page and page._close_was_called) or self._close_was_called:
+                return
             if not route_handler.matches(route.request.url):
                 continue
+            if route_handler not in self._routes:
+                continue
             if route_handler.will_expire:
                 self._routes.remove(route_handler)
             try:
@@ -236,7 +243,12 @@ async def _on_route(self, route: Route) -> None:
                     )
             if handled:
                 return
-        await route._internal_continue(is_internal=True)
+        try:
+            # If the page is closed or unrouteAll() was called without waiting and interception disabled,
+            # the method will throw an error - silence it.
+            await route._internal_continue(is_internal=True)
+        except Exception:
+            pass
 
     def _on_binding(self, binding_call: BindingCall) -> None:
         func = self._bindings.get(binding_call._initializer["name"])
@@ -361,13 +373,37 @@ async def route(
     async def unroute(
         self, url: URLMatch, handler: Optional[RouteHandlerCallback] = None
     ) -> None:
-        self._routes = list(
-            filter(
-                lambda r: r.matcher.match != url or (handler and r.handler != handler),
-                self._routes,
-            )
-        )
+        removed = []
+        remaining = []
+        for route in self._routes:
+            if route.matcher.match != url or (handler and route.handler != handler):
+                remaining.append(route)
+            else:
+                removed.append(route)
+        await self._unroute_internal(removed, remaining, "default")
+
+    async def _unroute_internal(
+        self,
+        removed: List[RouteHandler],
+        remaining: List[RouteHandler],
+        behavior: Literal["default", "ignoreErrors", "wait"] = None,
+    ) -> None:
+        self._routes = remaining
         await self._update_interception_patterns()
+        if behavior is None or behavior == "default":
+            return
+        await asyncio.gather(*map(lambda router: router.stop(behavior), removed))  # type: ignore
+
+    def _dispose_har_routers(self) -> None:
+        for router in self._har_routers:
+            router.dispose()
+        self._har_routers = []
+
+    async def unroute_all(
+        self, behavior: Literal["default", "ignoreErrors", "wait"] = None
+    ) -> None:
+        await self._unroute_internal(self._routes, [], behavior)
+        self._dispose_har_routers()
 
     async def _record_into_har(
         self,
@@ -419,6 +455,7 @@ async def route_from_har(
             not_found_action=notFound or "abort",
             url_matcher=url,
         )
+        self._har_routers.append(router)
         await router.add_context_route(self)
 
     async def _update_interception_patterns(self) -> None:
@@ -450,6 +487,7 @@ def _on_close(self) -> None:
         if self._browser:
             self._browser._contexts.remove(self)
 
+        self._dispose_har_routers()
         self.emit(BrowserContext.Events.Close, self)
 
     async def close(self, reason: str = None) -> None:
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 6c585bb0d..558cf3ac9 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -298,6 +298,7 @@ async def screenshot(
         scale: Literal["css", "device"] = None,
         mask: Sequence["Locator"] = None,
         maskColor: str = None,
+        style: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
         if "path" in params:
diff --git a/playwright/_impl/_har_router.py b/playwright/_impl/_har_router.py
index a96ba70bf..3e56fd019 100644
--- a/playwright/_impl/_har_router.py
+++ b/playwright/_impl/_har_router.py
@@ -102,16 +102,14 @@ async def add_context_route(self, context: "BrowserContext") -> None:
             url=self._options_url_match or "**/*",
             handler=lambda route, _: asyncio.create_task(self._handle(route)),
         )
-        context.once("close", lambda _: self._dispose())
 
     async def add_page_route(self, page: "Page") -> None:
         await page.route(
             url=self._options_url_match or "**/*",
             handler=lambda route, _: asyncio.create_task(self._handle(route)),
         )
-        page.once("close", lambda _: self._dispose())
 
-    def _dispose(self) -> None:
+    def dispose(self) -> None:
         asyncio.create_task(
             self._local_utils._channel.send("harClose", {"harId": self._har_id})
         )
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index b68ad6f0b..615cd5264 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -12,7 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 import asyncio
-import inspect
 import math
 import os
 import re
@@ -25,11 +24,11 @@
     TYPE_CHECKING,
     Any,
     Callable,
-    Coroutine,
     Dict,
     List,
     Optional,
     Pattern,
+    Set,
     TypeVar,
     Union,
     cast,
@@ -257,6 +256,15 @@ def monotonic_time() -> int:
     return math.floor(time.monotonic() * 1000)
 
 
+class RouteHandlerInvocation:
+    complete: "asyncio.Future"
+    route: "Route"
+
+    def __init__(self, complete: "asyncio.Future", route: "Route") -> None:
+        self.complete = complete
+        self.route = route
+
+
 class RouteHandler:
     def __init__(
         self,
@@ -270,32 +278,57 @@ def __init__(
         self._times = times if times else math.inf
         self._handled_count = 0
         self._is_sync = is_sync
+        self._ignore_exception = False
+        self._active_invocations: Set[RouteHandlerInvocation] = set()
 
     def matches(self, request_url: str) -> bool:
         return self.matcher.matches(request_url)
 
     async def handle(self, route: "Route") -> bool:
+        handler_invocation = RouteHandlerInvocation(
+            asyncio.get_running_loop().create_future(), route
+        )
+        self._active_invocations.add(handler_invocation)
+        try:
+            return await self._handle_internal(route)
+        except Exception as e:
+            # If the handler was stopped (without waiting for completion), we ignore all exceptions.
+            if self._ignore_exception:
+                return False
+            raise e
+        finally:
+            handler_invocation.complete.set_result(None)
+            self._active_invocations.remove(handler_invocation)
+
+    async def _handle_internal(self, route: "Route") -> bool:
         handled_future = route._start_handling()
-        handler_task = []
-
-        def impl() -> None:
-            self._handled_count += 1
-            result = cast(
-                Callable[["Route", "Request"], Union[Coroutine, Any]], self.handler
-            )(route, route.request)
-            if inspect.iscoroutine(result):
-                handler_task.append(asyncio.create_task(result))
-
-        # As with event handlers, each route handler is a potentially blocking context
-        # so it needs a fiber.
+
+        self._handled_count += 1
         if self._is_sync:
-            g = greenlet(impl)
+            # As with event handlers, each route handler is a potentially blocking context
+            # so it needs a fiber.
+            g = greenlet(lambda: self.handler(route, route.request))  # type: ignore
             g.switch()
         else:
-            impl()
-
-        [handled, *_] = await asyncio.gather(handled_future, *handler_task)
-        return handled
+            coro_or_future = self.handler(route, route.request)  # type: ignore
+            if coro_or_future:
+                # separate task so that we get a proper stack trace for exceptions / tracing api_name extraction
+                await asyncio.ensure_future(coro_or_future)
+        return await handled_future
+
+    async def stop(self, behavior: Literal["ignoreErrors", "wait"]) -> None:
+        # When a handler is manually unrouted or its page/context is closed we either
+        # - wait for the current handler invocations to finish
+        # - or do not wait, if the user opted out of it, but swallow all exceptions
+        #   that happen after the unroute/close.
+        if behavior == "ignoreErrors":
+            self._ignore_exception = True
+        else:
+            tasks = []
+            for activation in self._active_invocations:
+                if not activation.route._did_throw:
+                    tasks.append(activation.complete)
+            await asyncio.gather(*tasks)
 
     @property
     def will_expire(self) -> bool:
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 55955d089..a9cc92aba 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -523,6 +523,7 @@ async def screenshot(
         scale: Literal["css", "device"] = None,
         mask: Sequence["Locator"] = None,
         maskColor: str = None,
+        style: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
         return await self._with_element(
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 102767cf6..03aa53588 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -267,6 +267,9 @@ def _target_closed_future(self) -> asyncio.Future:
             return asyncio.Future()
         return page._closed_or_crashed_future
 
+    def _safe_page(self) -> "Optional[Page]":
+        return cast("Frame", from_channel(self._initializer["frame"]))._page
+
 
 class Route(ChannelOwner):
     def __init__(
@@ -275,6 +278,7 @@ def __init__(
         super().__init__(parent, type, guid, initializer)
         self._handling_future: Optional[asyncio.Future["bool"]] = None
         self._context: "BrowserContext" = cast("BrowserContext", None)
+        self._did_throw = False
 
     def _start_handling(self) -> "asyncio.Future[bool]":
         self._handling_future = asyncio.Future()
@@ -298,17 +302,17 @@ def request(self) -> Request:
         return from_channel(self._initializer["request"])
 
     async def abort(self, errorCode: str = None) -> None:
-        self._check_not_handled()
-        await self._race_with_page_close(
-            self._channel.send(
-                "abort",
-                {
-                    "errorCode": errorCode,
-                    "requestUrl": self.request._initializer["url"],
-                },
+        await self._handle_route(
+            lambda: self._race_with_page_close(
+                self._channel.send(
+                    "abort",
+                    {
+                        "errorCode": errorCode,
+                        "requestUrl": self.request._initializer["url"],
+                    },
+                )
             )
         )
-        self._report_handled(True)
 
     async def fulfill(
         self,
@@ -320,7 +324,22 @@ async def fulfill(
         contentType: str = None,
         response: "APIResponse" = None,
     ) -> None:
-        self._check_not_handled()
+        await self._handle_route(
+            lambda: self._inner_fulfill(
+                status, headers, body, json, path, contentType, response
+            )
+        )
+
+    async def _inner_fulfill(
+        self,
+        status: int = None,
+        headers: Dict[str, str] = None,
+        body: Union[str, bytes] = None,
+        json: Any = None,
+        path: Union[str, Path] = None,
+        contentType: str = None,
+        response: "APIResponse" = None,
+    ) -> None:
         params = locals_to_params(locals())
 
         if json is not None:
@@ -375,7 +394,15 @@ async def fulfill(
         params["requestUrl"] = self.request._initializer["url"]
 
         await self._race_with_page_close(self._channel.send("fulfill", params))
-        self._report_handled(True)
+
+    async def _handle_route(self, callback: Callable) -> None:
+        self._check_not_handled()
+        try:
+            await callback()
+            self._report_handled(True)
+        except Exception as e:
+            self._did_throw = True
+            raise e
 
     async def fetch(
         self,
@@ -418,10 +445,12 @@ async def continue_(
         postData: Union[Any, str, bytes] = None,
     ) -> None:
         overrides = cast(FallbackOverrideParameters, locals_to_params(locals()))
-        self._check_not_handled()
-        self.request._apply_fallback_overrides(overrides)
-        await self._internal_continue()
-        self._report_handled(True)
+
+        async def _inner() -> None:
+            self.request._apply_fallback_overrides(overrides)
+            await self._internal_continue()
+
+        return await self._handle_route(_inner)
 
     def _internal_continue(
         self, is_internal: bool = False
@@ -458,11 +487,11 @@ async def continue_route() -> None:
         return continue_route()
 
     async def _redirected_navigation_request(self, url: str) -> None:
-        self._check_not_handled()
-        await self._race_with_page_close(
-            self._channel.send("redirectNavigationRequest", {"url": url})
+        await self._handle_route(
+            lambda: self._race_with_page_close(
+                self._channel.send("redirectNavigationRequest", {"url": url})
+            )
         )
-        self._report_handled(True)
 
     async def _race_with_page_close(self, future: Coroutine) -> None:
         fut = asyncio.create_task(future)
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index cfa571f74..ac6a55002 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -152,6 +152,8 @@ def __init__(
         self._video: Optional[Video] = None
         self._opener = cast("Page", from_nullable_channel(initializer.get("opener")))
         self._close_reason: Optional[str] = None
+        self._close_was_called = False
+        self._har_routers: List[HarRouter] = []
 
         self._channel.on(
             "bindingCall",
@@ -238,8 +240,13 @@ async def _on_route(self, route: Route) -> None:
         route._context = self.context
         route_handlers = self._routes.copy()
         for route_handler in route_handlers:
+            # If the page was closed we stall all requests right away.
+            if self._close_was_called or self.context._close_was_called:
+                return
             if not route_handler.matches(route.request.url):
                 continue
+            if route_handler not in self._routes:
+                continue
             if route_handler.will_expire:
                 self._routes.remove(route_handler)
             try:
@@ -272,6 +279,7 @@ def _on_close(self) -> None:
             self._browser_context._pages.remove(self)
         if self in self._browser_context._background_pages:
             self._browser_context._background_pages.remove(self)
+        self._dispose_har_routers()
         self.emit(Page.Events.Close, self)
 
     def _on_crash(self) -> None:
@@ -585,13 +593,42 @@ async def route(
     async def unroute(
         self, url: URLMatch, handler: Optional[RouteHandlerCallback] = None
     ) -> None:
-        self._routes = list(
-            filter(
-                lambda r: r.matcher.match != url or (handler and r.handler != handler),
-                self._routes,
+        removed = []
+        remaining = []
+        for route in self._routes:
+            if route.matcher.match != url or (handler and route.handler != handler):
+                remaining.append(route)
+            else:
+                removed.append(route)
+        await self._unroute_internal(removed, remaining, "default")
+
+    async def _unroute_internal(
+        self,
+        removed: List[RouteHandler],
+        remaining: List[RouteHandler],
+        behavior: Literal["default", "ignoreErrors", "wait"] = None,
+    ) -> None:
+        self._routes = remaining
+        await self._update_interception_patterns()
+        if behavior is None or behavior == "default":
+            return
+        await asyncio.gather(
+            *map(
+                lambda route: route.stop(behavior),  # type: ignore
+                removed,
             )
         )
-        await self._update_interception_patterns()
+
+    def _dispose_har_routers(self) -> None:
+        for router in self._har_routers:
+            router.dispose()
+        self._har_routers = []
+
+    async def unroute_all(
+        self, behavior: Literal["default", "ignoreErrors", "wait"] = None
+    ) -> None:
+        await self._unroute_internal(self._routes, [], behavior)
+        self._dispose_har_routers()
 
     async def route_from_har(
         self,
@@ -617,6 +654,7 @@ async def route_from_har(
             not_found_action=notFound or "abort",
             url_matcher=url,
         )
+        self._har_routers.append(router)
         await router.add_page_route(self)
 
     async def _update_interception_patterns(self) -> None:
@@ -639,6 +677,7 @@ async def screenshot(
         scale: Literal["css", "device"] = None,
         mask: Sequence["Locator"] = None,
         maskColor: str = None,
+        style: str = None,
     ) -> bytes:
         params = locals_to_params(locals())
         if "path" in params:
@@ -667,6 +706,7 @@ async def title(self) -> str:
 
     async def close(self, runBeforeUnload: bool = None, reason: str = None) -> None:
         self._close_reason = reason
+        self._close_was_called = True
         try:
             await self._channel.send("close", locals_to_params(locals()))
             if self._owned_context:
diff --git a/playwright/_impl/_set_input_files_helpers.py b/playwright/_impl/_set_input_files_helpers.py
index a5db6c1da..793144313 100644
--- a/playwright/_impl/_set_input_files_helpers.py
+++ b/playwright/_impl/_set_input_files_helpers.py
@@ -62,12 +62,14 @@ async def convert_input_files(
                 assert isinstance(item, (str, Path))
                 last_modified_ms = int(os.path.getmtime(item) * 1000)
                 stream: WritableStream = from_channel(
-                    await context._channel.send(
-                        "createTempFile",
-                        {
-                            "name": os.path.basename(item),
-                            "lastModifiedMs": last_modified_ms,
-                        },
+                    await context._connection.wrap_api_call(
+                        lambda: context._channel.send(
+                            "createTempFile",
+                            {
+                                "name": os.path.basename(cast(str, item)),
+                                "lastModifiedMs": last_modified_ms,
+                            },
+                        )
                     )
                 )
                 await stream.copy(item)
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index d8276a125..59a92a296 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -2769,7 +2769,8 @@ async def screenshot(
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
-        mask_color: typing.Optional[str] = None
+        mask_color: typing.Optional[str] = None,
+        style: typing.Optional[str] = None
     ) -> bytes:
         """ElementHandle.screenshot
 
@@ -2820,6 +2821,10 @@ async def screenshot(
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
+        style : Union[str, None]
+            Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make
+            elements invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces
+            the Shadow DOM and applies to the inner frames.
 
         Returns
         -------
@@ -2838,6 +2843,7 @@ async def screenshot(
                 scale=scale,
                 mask=mapping.to_impl(mask),
                 maskColor=mask_color,
+                style=style,
             )
         )
 
@@ -2997,9 +3003,8 @@ async def wait_for_element_state(
         Depending on the `state` parameter, this method waits for one of the [actionability](https://playwright.dev/python/docs/actionability) checks to
         pass. This method throws when the element is detached while waiting, unless waiting for the `\"hidden\"` state.
         - `\"visible\"` Wait until the element is [visible](https://playwright.dev/python/docs/actionability#visible).
-        - `\"hidden\"` Wait until the element is [not visible](https://playwright.dev/python/docs/actionability#visible) or
-          [not attached](https://playwright.dev/python/docs/actionability#attached). Note that waiting for hidden does not throw when the element
-          detaches.
+        - `\"hidden\"` Wait until the element is [not visible](https://playwright.dev/python/docs/actionability#visible) or not attached. Note that
+          waiting for hidden does not throw when the element detaches.
         - `\"stable\"` Wait until the element is both [visible](https://playwright.dev/python/docs/actionability#visible) and
           [stable](https://playwright.dev/python/docs/actionability#stable).
         - `\"enabled\"` Wait until the element is [enabled](https://playwright.dev/python/docs/actionability#enabled).
@@ -4709,8 +4714,13 @@ def locator(
             Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
             When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
-            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+            `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not
+            the document root. For example, you can find `content` that has `div` in
+            `<article><content><div>Playwright</div></content></article>`. However, looking for `content` that has `article
+            div` will fail, because the inner locator must be relative and should not use any elements outside the `content`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
         has_not : Union[Locator, None]
@@ -6245,8 +6255,13 @@ def locator(
             Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
             When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
-            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+            `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not
+            the document root. For example, you can find `content` that has `div` in
+            `<article><content><div>Playwright</div></content></article>`. However, looking for `content` that has `article
+            div` will fail, because the inner locator must be relative and should not use any elements outside the `content`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
         has_not : Union[Locator, None]
@@ -9856,6 +9871,30 @@ async def unroute(
             )
         )
 
+    async def unroute_all(
+        self,
+        *,
+        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None
+    ) -> None:
+        """Page.unroute_all
+
+        Removes all routes created with `page.route()` and `page.route_from_har()`.
+
+        Parameters
+        ----------
+        behavior : Union["default", "ignoreErrors", "wait", None]
+            Specifies wether to wait for already running handlers and what to do if they throw errors:
+            - `'default'` - do not wait for current handler calls (if any) to finish, if unrouted handler throws, it may
+              result in unhandled error
+            - `'wait'` - wait for current handler calls (if any) to finish
+            - `'ignoreErrors'` - do not wait for current handler calls (if any) to finish, all errors thrown by the handlers
+              after unrouting are silently caught
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.unroute_all(behavior=behavior)
+        )
+
     async def route_from_har(
         self,
         har: typing.Union[pathlib.Path, str],
@@ -9924,7 +9963,8 @@ async def screenshot(
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
-        mask_color: typing.Optional[str] = None
+        mask_color: typing.Optional[str] = None,
+        style: typing.Optional[str] = None
     ) -> bytes:
         """Page.screenshot
 
@@ -9973,6 +10013,10 @@ async def screenshot(
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
+        style : Union[str, None]
+            Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make
+            elements invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces
+            the Shadow DOM and applies to the inner frames.
 
         Returns
         -------
@@ -9993,6 +10037,7 @@ async def screenshot(
                 scale=scale,
                 mask=mapping.to_impl(mask),
                 maskColor=mask_color,
+                style=style,
             )
         )
 
@@ -10362,8 +10407,13 @@ def locator(
             Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
             When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
-            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+            `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not
+            the document root. For example, you can find `content` that has `div` in
+            `<article><content><div>Playwright</div></content></article>`. However, looking for `content` that has `article
+            div` will fail, because the inner locator must be relative and should not use any elements outside the `content`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
         has_not : Union[Locator, None]
@@ -13640,6 +13690,30 @@ async def unroute(
             )
         )
 
+    async def unroute_all(
+        self,
+        *,
+        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None
+    ) -> None:
+        """BrowserContext.unroute_all
+
+        Removes all routes created with `browser_context.route()` and `browser_context.route_from_har()`.
+
+        Parameters
+        ----------
+        behavior : Union["default", "ignoreErrors", "wait", None]
+            Specifies wether to wait for already running handlers and what to do if they throw errors:
+            - `'default'` - do not wait for current handler calls (if any) to finish, if unrouted handler throws, it may
+              result in unhandled error
+            - `'wait'` - wait for current handler calls (if any) to finish
+            - `'ignoreErrors'` - do not wait for current handler calls (if any) to finish, all errors thrown by the handlers
+              after unrouting are silently caught
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.unroute_all(behavior=behavior)
+        )
+
     async def route_from_har(
         self,
         har: typing.Union[pathlib.Path, str],
@@ -14690,8 +14764,10 @@ async def launch(
             "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
             [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
         args : Union[Sequence[str], None]
+            **NOTE** Use custom browser args at your own risk, as some of them may break Playwright functionality.
+
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
-            [here](http://peter.sh/experiments/chromium-command-line-switches/).
+            [here](https://peter.sh/experiments/chromium-command-line-switches/).
         ignore_default_args : Union[Sequence[str], bool, None]
             If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`. If an array is
             given, then filters out the given default arguments. Dangerous option; use with care. Defaults to `false`.
@@ -14845,8 +14921,10 @@ async def launch_persistent_context(
             resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
             Firefox or WebKit, use at your own risk.
         args : Union[Sequence[str], None]
+            **NOTE** Use custom browser args at your own risk, as some of them may break Playwright functionality.
+
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
-            [here](http://peter.sh/experiments/chromium-command-line-switches/).
+            [here](https://peter.sh/experiments/chromium-command-line-switches/).
         ignore_default_args : Union[Sequence[str], bool, None]
             If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`. If an array is
             given, then filters out the given default arguments. Dangerous option; use with care. Defaults to `false`.
@@ -15323,14 +15401,14 @@ async def start(
         **Usage**
 
         ```py
-        await context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        await context.tracing.start(screenshots=True, snapshots=True)
         page = await context.new_page()
         await page.goto(\"https://playwright.dev\")
         await context.tracing.stop(path = \"trace.zip\")
         ```
 
         ```py
-        context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        context.tracing.start(screenshots=True, snapshots=True)
         page = context.new_page()
         page.goto(\"https://playwright.dev\")
         context.tracing.stop(path = \"trace.zip\")
@@ -15339,8 +15417,9 @@ async def start(
         Parameters
         ----------
         name : Union[str, None]
-            If specified, the trace is going to be saved into the file with the given name inside the `tracesDir` folder
-            specified in `browser_type.launch()`.
+            If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the
+            `tracesDir` folder specified in `browser_type.launch()`. To specify the final trace zip file name, you need
+            to pass `path` option to `tracing.stop()` instead.
         title : Union[str, None]
             Trace name to be shown in the Trace Viewer.
         snapshots : Union[bool, None]
@@ -15375,7 +15454,7 @@ async def start_chunk(
         **Usage**
 
         ```py
-        await context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        await context.tracing.start(screenshots=True, snapshots=True)
         page = await context.new_page()
         await page.goto(\"https://playwright.dev\")
 
@@ -15391,7 +15470,7 @@ async def start_chunk(
         ```
 
         ```py
-        context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        context.tracing.start(screenshots=True, snapshots=True)
         page = context.new_page()
         page.goto(\"https://playwright.dev\")
 
@@ -15411,8 +15490,9 @@ async def start_chunk(
         title : Union[str, None]
             Trace name to be shown in the Trace Viewer.
         name : Union[str, None]
-            If specified, the trace is going to be saved into the file with the given name inside the `tracesDir` folder
-            specified in `browser_type.launch()`.
+            If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the
+            `tracesDir` folder specified in `browser_type.launch()`. To specify the final trace zip file name, you need
+            to pass `path` option to `tracing.stop_chunk()` instead.
         """
 
         return mapping.from_maybe_impl(
@@ -16144,8 +16224,13 @@ def locator(
             Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
             When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
-            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+            `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not
+            the document root. For example, you can find `content` that has `div` in
+            `<article><content><div>Playwright</div></content></article>`. However, looking for `content` that has `article
+            div` will fail, because the inner locator must be relative and should not use any elements outside the `content`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
         has_not : Union[Locator, None]
@@ -16806,8 +16891,13 @@ def filter(
             Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
             When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
-            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+            `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not
+            the document root. For example, you can find `content` that has `div` in
+            `<article><content><div>Playwright</div></content></article>`. However, looking for `content` that has `article
+            div` will fail, because the inner locator must be relative and should not use any elements outside the `content`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
         has_not : Union[Locator, None]
@@ -17510,7 +17600,8 @@ async def screenshot(
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
-        mask_color: typing.Optional[str] = None
+        mask_color: typing.Optional[str] = None,
+        style: typing.Optional[str] = None
     ) -> bytes:
         """Locator.screenshot
 
@@ -17585,6 +17676,10 @@ async def screenshot(
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
+        style : Union[str, None]
+            Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make
+            elements invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces
+            the Shadow DOM and applies to the inner frames.
 
         Returns
         -------
@@ -17603,6 +17698,7 @@ async def screenshot(
                 scale=scale,
                 mask=mapping.to_impl(mask),
                 maskColor=mask_color,
+                style=style,
             )
         )
 
@@ -19293,8 +19389,8 @@ async def to_contain_text(
     ) -> None:
         """LocatorAssertions.to_contain_text
 
-        Ensures the `Locator` points to an element that contains the given text. You can use regular expressions for the
-        value as well.
+        Ensures the `Locator` points to an element that contains the given text. All nested elements will be considered
+        when computing the text content of the element. You can use regular expressions for the value as well.
 
         **Details**
 
@@ -20039,8 +20135,8 @@ async def to_have_text(
     ) -> None:
         """LocatorAssertions.to_have_text
 
-        Ensures the `Locator` points to an element with the given text. You can use regular expressions for the value as
-        well.
+        Ensures the `Locator` points to an element with the given text. All nested elements will be considered when
+        computing the text content of the element. You can use regular expressions for the value as well.
 
         **Details**
 
@@ -20188,7 +20284,8 @@ async def to_be_attached(
     ) -> None:
         """LocatorAssertions.to_be_attached
 
-        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/actionability#attached) DOM node.
+        Ensures that `Locator` points to an element that is
+        [connected](https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected) to a Document or a ShadowRoot.
 
         **Usage**
 
@@ -20569,8 +20666,7 @@ async def to_be_visible(
     ) -> None:
         """LocatorAssertions.to_be_visible
 
-        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/actionability#attached) and
-        [visible](https://playwright.dev/python/docs/actionability#visible) DOM node.
+        Ensures that `Locator` points to an attached and [visible](https://playwright.dev/python/docs/actionability#visible) DOM node.
 
         To check that at least one element from the list is visible, use `locator.first()`.
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 09a308c2c..d64175f4f 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -2803,7 +2803,8 @@ def screenshot(
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
-        mask_color: typing.Optional[str] = None
+        mask_color: typing.Optional[str] = None,
+        style: typing.Optional[str] = None
     ) -> bytes:
         """ElementHandle.screenshot
 
@@ -2854,6 +2855,10 @@ def screenshot(
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
+        style : Union[str, None]
+            Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make
+            elements invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces
+            the Shadow DOM and applies to the inner frames.
 
         Returns
         -------
@@ -2873,6 +2878,7 @@ def screenshot(
                     scale=scale,
                     mask=mapping.to_impl(mask),
                     maskColor=mask_color,
+                    style=style,
                 )
             )
         )
@@ -3037,9 +3043,8 @@ def wait_for_element_state(
         Depending on the `state` parameter, this method waits for one of the [actionability](https://playwright.dev/python/docs/actionability) checks to
         pass. This method throws when the element is detached while waiting, unless waiting for the `\"hidden\"` state.
         - `\"visible\"` Wait until the element is [visible](https://playwright.dev/python/docs/actionability#visible).
-        - `\"hidden\"` Wait until the element is [not visible](https://playwright.dev/python/docs/actionability#visible) or
-          [not attached](https://playwright.dev/python/docs/actionability#attached). Note that waiting for hidden does not throw when the element
-          detaches.
+        - `\"hidden\"` Wait until the element is [not visible](https://playwright.dev/python/docs/actionability#visible) or not attached. Note that
+          waiting for hidden does not throw when the element detaches.
         - `\"stable\"` Wait until the element is both [visible](https://playwright.dev/python/docs/actionability#visible) and
           [stable](https://playwright.dev/python/docs/actionability#stable).
         - `\"enabled\"` Wait until the element is [enabled](https://playwright.dev/python/docs/actionability#enabled).
@@ -4799,8 +4804,13 @@ def locator(
             Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
             When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
-            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+            `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not
+            the document root. For example, you can find `content` that has `div` in
+            `<article><content><div>Playwright</div></content></article>`. However, looking for `content` that has `article
+            div` will fail, because the inner locator must be relative and should not use any elements outside the `content`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
         has_not : Union[Locator, None]
@@ -6365,8 +6375,13 @@ def locator(
             Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
             When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
-            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+            `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not
+            the document root. For example, you can find `content` that has `div` in
+            `<article><content><div>Playwright</div></content></article>`. However, looking for `content` that has `article
+            div` will fail, because the inner locator must be relative and should not use any elements outside the `content`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
         has_not : Union[Locator, None]
@@ -9922,6 +9937,30 @@ def unroute(
             )
         )
 
+    def unroute_all(
+        self,
+        *,
+        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None
+    ) -> None:
+        """Page.unroute_all
+
+        Removes all routes created with `page.route()` and `page.route_from_har()`.
+
+        Parameters
+        ----------
+        behavior : Union["default", "ignoreErrors", "wait", None]
+            Specifies wether to wait for already running handlers and what to do if they throw errors:
+            - `'default'` - do not wait for current handler calls (if any) to finish, if unrouted handler throws, it may
+              result in unhandled error
+            - `'wait'` - wait for current handler calls (if any) to finish
+            - `'ignoreErrors'` - do not wait for current handler calls (if any) to finish, all errors thrown by the handlers
+              after unrouting are silently caught
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.unroute_all(behavior=behavior))
+        )
+
     def route_from_har(
         self,
         har: typing.Union[pathlib.Path, str],
@@ -9992,7 +10031,8 @@ def screenshot(
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
-        mask_color: typing.Optional[str] = None
+        mask_color: typing.Optional[str] = None,
+        style: typing.Optional[str] = None
     ) -> bytes:
         """Page.screenshot
 
@@ -10041,6 +10081,10 @@ def screenshot(
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
+        style : Union[str, None]
+            Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make
+            elements invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces
+            the Shadow DOM and applies to the inner frames.
 
         Returns
         -------
@@ -10062,6 +10106,7 @@ def screenshot(
                     scale=scale,
                     mask=mapping.to_impl(mask),
                     maskColor=mask_color,
+                    style=style,
                 )
             )
         )
@@ -10442,8 +10487,13 @@ def locator(
             Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
             When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
-            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+            `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not
+            the document root. For example, you can find `content` that has `div` in
+            `<article><content><div>Playwright</div></content></article>`. However, looking for `content` that has `article
+            div` will fail, because the inner locator must be relative and should not use any elements outside the `content`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
         has_not : Union[Locator, None]
@@ -13698,6 +13748,30 @@ def unroute(
             )
         )
 
+    def unroute_all(
+        self,
+        *,
+        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None
+    ) -> None:
+        """BrowserContext.unroute_all
+
+        Removes all routes created with `browser_context.route()` and `browser_context.route_from_har()`.
+
+        Parameters
+        ----------
+        behavior : Union["default", "ignoreErrors", "wait", None]
+            Specifies wether to wait for already running handlers and what to do if they throw errors:
+            - `'default'` - do not wait for current handler calls (if any) to finish, if unrouted handler throws, it may
+              result in unhandled error
+            - `'wait'` - wait for current handler calls (if any) to finish
+            - `'ignoreErrors'` - do not wait for current handler calls (if any) to finish, all errors thrown by the handlers
+              after unrouting are silently caught
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.unroute_all(behavior=behavior))
+        )
+
     def route_from_har(
         self,
         har: typing.Union[pathlib.Path, str],
@@ -14756,8 +14830,10 @@ def launch(
             "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
             [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
         args : Union[Sequence[str], None]
+            **NOTE** Use custom browser args at your own risk, as some of them may break Playwright functionality.
+
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
-            [here](http://peter.sh/experiments/chromium-command-line-switches/).
+            [here](https://peter.sh/experiments/chromium-command-line-switches/).
         ignore_default_args : Union[Sequence[str], bool, None]
             If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`. If an array is
             given, then filters out the given default arguments. Dangerous option; use with care. Defaults to `false`.
@@ -14913,8 +14989,10 @@ def launch_persistent_context(
             resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
             Firefox or WebKit, use at your own risk.
         args : Union[Sequence[str], None]
+            **NOTE** Use custom browser args at your own risk, as some of them may break Playwright functionality.
+
             Additional arguments to pass to the browser instance. The list of Chromium flags can be found
-            [here](http://peter.sh/experiments/chromium-command-line-switches/).
+            [here](https://peter.sh/experiments/chromium-command-line-switches/).
         ignore_default_args : Union[Sequence[str], bool, None]
             If `true`, Playwright does not pass its own configurations args and only uses the ones from `args`. If an array is
             given, then filters out the given default arguments. Dangerous option; use with care. Defaults to `false`.
@@ -15397,14 +15475,14 @@ def start(
         **Usage**
 
         ```py
-        await context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        await context.tracing.start(screenshots=True, snapshots=True)
         page = await context.new_page()
         await page.goto(\"https://playwright.dev\")
         await context.tracing.stop(path = \"trace.zip\")
         ```
 
         ```py
-        context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        context.tracing.start(screenshots=True, snapshots=True)
         page = context.new_page()
         page.goto(\"https://playwright.dev\")
         context.tracing.stop(path = \"trace.zip\")
@@ -15413,8 +15491,9 @@ def start(
         Parameters
         ----------
         name : Union[str, None]
-            If specified, the trace is going to be saved into the file with the given name inside the `tracesDir` folder
-            specified in `browser_type.launch()`.
+            If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the
+            `tracesDir` folder specified in `browser_type.launch()`. To specify the final trace zip file name, you need
+            to pass `path` option to `tracing.stop()` instead.
         title : Union[str, None]
             Trace name to be shown in the Trace Viewer.
         snapshots : Union[bool, None]
@@ -15451,7 +15530,7 @@ def start_chunk(
         **Usage**
 
         ```py
-        await context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        await context.tracing.start(screenshots=True, snapshots=True)
         page = await context.new_page()
         await page.goto(\"https://playwright.dev\")
 
@@ -15467,7 +15546,7 @@ def start_chunk(
         ```
 
         ```py
-        context.tracing.start(name=\"trace\", screenshots=True, snapshots=True)
+        context.tracing.start(screenshots=True, snapshots=True)
         page = context.new_page()
         page.goto(\"https://playwright.dev\")
 
@@ -15487,8 +15566,9 @@ def start_chunk(
         title : Union[str, None]
             Trace name to be shown in the Trace Viewer.
         name : Union[str, None]
-            If specified, the trace is going to be saved into the file with the given name inside the `tracesDir` folder
-            specified in `browser_type.launch()`.
+            If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the
+            `tracesDir` folder specified in `browser_type.launch()`. To specify the final trace zip file name, you need
+            to pass `path` option to `tracing.stop_chunk()` instead.
         """
 
         return mapping.from_maybe_impl(
@@ -16238,8 +16318,13 @@ def locator(
             Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
             When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
-            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+            `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not
+            the document root. For example, you can find `content` that has `div` in
+            `<article><content><div>Playwright</div></content></article>`. However, looking for `content` that has `article
+            div` will fail, because the inner locator must be relative and should not use any elements outside the `content`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
         has_not : Union[Locator, None]
@@ -16902,8 +16987,13 @@ def filter(
             Matches elements that do not contain specified text somewhere inside, possibly in a child or a descendant element.
             When passed a [string], matching is case-insensitive and searches for a substring.
         has : Union[Locator, None]
-            Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer
-            one. For example, `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+            Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+            `article` that has `text=Playwright` matches `<article><div>Playwright</div></article>`.
+
+            Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not
+            the document root. For example, you can find `content` that has `div` in
+            `<article><content><div>Playwright</div></content></article>`. However, looking for `content` that has `article
+            div` will fail, because the inner locator must be relative and should not use any elements outside the `content`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
         has_not : Union[Locator, None]
@@ -17626,7 +17716,8 @@ def screenshot(
         caret: typing.Optional[Literal["hide", "initial"]] = None,
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
-        mask_color: typing.Optional[str] = None
+        mask_color: typing.Optional[str] = None,
+        style: typing.Optional[str] = None
     ) -> bytes:
         """Locator.screenshot
 
@@ -17701,6 +17792,10 @@ def screenshot(
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
+        style : Union[str, None]
+            Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make
+            elements invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces
+            the Shadow DOM and applies to the inner frames.
 
         Returns
         -------
@@ -17720,6 +17815,7 @@ def screenshot(
                     scale=scale,
                     mask=mapping.to_impl(mask),
                     maskColor=mask_color,
+                    style=style,
                 )
             )
         )
@@ -19449,8 +19545,8 @@ def to_contain_text(
     ) -> None:
         """LocatorAssertions.to_contain_text
 
-        Ensures the `Locator` points to an element that contains the given text. You can use regular expressions for the
-        value as well.
+        Ensures the `Locator` points to an element that contains the given text. All nested elements will be considered
+        when computing the text content of the element. You can use regular expressions for the value as well.
 
         **Details**
 
@@ -20217,8 +20313,8 @@ def to_have_text(
     ) -> None:
         """LocatorAssertions.to_have_text
 
-        Ensures the `Locator` points to an element with the given text. You can use regular expressions for the value as
-        well.
+        Ensures the `Locator` points to an element with the given text. All nested elements will be considered when
+        computing the text content of the element. You can use regular expressions for the value as well.
 
         **Details**
 
@@ -20370,7 +20466,8 @@ def to_be_attached(
     ) -> None:
         """LocatorAssertions.to_be_attached
 
-        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/actionability#attached) DOM node.
+        Ensures that `Locator` points to an element that is
+        [connected](https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected) to a Document or a ShadowRoot.
 
         **Usage**
 
@@ -20757,8 +20854,7 @@ def to_be_visible(
     ) -> None:
         """LocatorAssertions.to_be_visible
 
-        Ensures that `Locator` points to an [attached](https://playwright.dev/python/docs/actionability#attached) and
-        [visible](https://playwright.dev/python/docs/actionability#visible) DOM node.
+        Ensures that `Locator` points to an attached and [visible](https://playwright.dev/python/docs/actionability#visible) DOM node.
 
         To check that at least one element from the list is visible, use `locator.first()`.
 
diff --git a/setup.py b/setup.py
index bbf63928c..7f40b41a8 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.40.0-beta-1700587209000"
+driver_version = "1.41.0-beta-1705101589000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/conftest.py b/tests/async/conftest.py
index 490f4440a..442d059f4 100644
--- a/tests/async/conftest.py
+++ b/tests/async/conftest.py
@@ -100,6 +100,17 @@ async def launch(**kwargs: Any) -> BrowserContext:
         await context.close()
 
 
+@pytest.fixture(scope="session")
+async def default_same_site_cookie_value(browser_name: str) -> str:
+    if browser_name == "chromium":
+        return "Lax"
+    if browser_name == "firefox":
+        return "None"
+    if browser_name == "webkit":
+        return "None"
+    raise Exception(f"Invalid browser_name: {browser_name}")
+
+
 @pytest.fixture
 async def context(
     context_factory: "Callable[..., asyncio.Future[BrowserContext]]",
diff --git a/tests/async/test_asyncio.py b/tests/async/test_asyncio.py
index 084d9eb41..1d4423afb 100644
--- a/tests/async/test_asyncio.py
+++ b/tests/async/test_asyncio.py
@@ -17,7 +17,7 @@
 
 import pytest
 
-from playwright.async_api import Page, async_playwright
+from playwright.async_api import async_playwright
 from tests.server import Server
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
@@ -67,21 +67,3 @@ async def test_cancel_pending_protocol_call_on_playwright_stop(server: Server) -
     with pytest.raises(Exception) as exc_info:
         await pending_task
     assert TARGET_CLOSED_ERROR_MESSAGE in str(exc_info.value)
-
-
-async def test_should_collect_stale_handles(page: Page, server: Server) -> None:
-    page.on("request", lambda _: None)
-    response = await page.goto(server.PREFIX + "/title.html")
-    assert response
-    for i in range(1000):
-        await page.evaluate(
-            """async () => {
-            const response = await fetch('/');
-            await response.text();
-        }"""
-        )
-    with pytest.raises(Exception) as exc_info:
-        await response.all_headers()
-    assert "The object has been collected to prevent unbounded heap growth." in str(
-        exc_info.value
-    )
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index 23fbd27de..97c365273 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -13,7 +13,6 @@
 # limitations under the License.
 
 import asyncio
-import re
 from typing import Any, List
 from urllib.parse import urlparse
 
@@ -26,8 +25,6 @@
     JSHandle,
     Page,
     Playwright,
-    Request,
-    Route,
 )
 from tests.server import Server
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
@@ -474,114 +471,6 @@ def logme(t: JSHandle) -> int:
     assert result == 17
 
 
-async def test_route_should_intercept(context: BrowserContext, server: Server) -> None:
-    intercepted = []
-
-    def handle(route: Route, request: Request) -> None:
-        intercepted.append(True)
-        assert "empty.html" in request.url
-        assert request.headers["user-agent"]
-        assert request.method == "GET"
-        assert request.post_data is None
-        assert request.is_navigation_request()
-        assert request.resource_type == "document"
-        assert request.frame == page.main_frame
-        assert request.frame.url == "about:blank"
-        asyncio.create_task(route.continue_())
-
-    await context.route("**/empty.html", lambda route, request: handle(route, request))
-    page = await context.new_page()
-    response = await page.goto(server.EMPTY_PAGE)
-    assert response
-    assert response.ok
-    assert intercepted == [True]
-    await context.close()
-
-
-async def test_route_should_unroute(context: BrowserContext, server: Server) -> None:
-    page = await context.new_page()
-
-    intercepted: List[int] = []
-
-    def handler(route: Route, request: Request, ordinal: int) -> None:
-        intercepted.append(ordinal)
-        asyncio.create_task(route.continue_())
-
-    await context.route("**/*", lambda route, request: handler(route, request, 1))
-    await context.route(
-        "**/empty.html", lambda route, request: handler(route, request, 2)
-    )
-    await context.route(
-        "**/empty.html", lambda route, request: handler(route, request, 3)
-    )
-
-    def handler4(route: Route, request: Request) -> None:
-        handler(route, request, 4)
-
-    await context.route(re.compile("empty.html"), handler4)
-
-    await page.goto(server.EMPTY_PAGE)
-    assert intercepted == [4]
-
-    intercepted = []
-    await context.unroute(re.compile("empty.html"), handler4)
-    await page.goto(server.EMPTY_PAGE)
-    assert intercepted == [3]
-
-    intercepted = []
-    await context.unroute("**/empty.html")
-    await page.goto(server.EMPTY_PAGE)
-    assert intercepted == [1]
-
-
-async def test_route_should_yield_to_page_route(
-    context: BrowserContext, server: Server
-) -> None:
-    await context.route(
-        "**/empty.html",
-        lambda route, request: asyncio.create_task(
-            route.fulfill(status=200, body="context")
-        ),
-    )
-
-    page = await context.new_page()
-    await page.route(
-        "**/empty.html",
-        lambda route, request: asyncio.create_task(
-            route.fulfill(status=200, body="page")
-        ),
-    )
-
-    response = await page.goto(server.EMPTY_PAGE)
-    assert response
-    assert response.ok
-    assert await response.text() == "page"
-
-
-async def test_route_should_fall_back_to_context_route(
-    context: BrowserContext, server: Server
-) -> None:
-    await context.route(
-        "**/empty.html",
-        lambda route, request: asyncio.create_task(
-            route.fulfill(status=200, body="context")
-        ),
-    )
-
-    page = await context.new_page()
-    await page.route(
-        "**/non-empty.html",
-        lambda route, request: asyncio.create_task(
-            route.fulfill(status=200, body="page")
-        ),
-    )
-
-    response = await page.goto(server.EMPTY_PAGE)
-    assert response
-    assert response.ok
-    assert await response.text() == "context"
-
-
 async def test_auth_should_fail_without_credentials(
     context: BrowserContext, server: Server
 ) -> None:
@@ -723,12 +612,17 @@ async def test_should_fail_with_correct_credentials_and_mismatching_port(
 
 
 async def test_offline_should_work_with_initial_option(
-    browser: Browser, server: Server
+    browser: Browser,
+    server: Server,
+    browser_name: str,
 ) -> None:
     context = await browser.new_context(offline=True)
     page = await context.new_page()
+    frame_navigated_task = asyncio.create_task(page.wait_for_event("framenavigated"))
     with pytest.raises(Error) as exc_info:
         await page.goto(server.EMPTY_PAGE)
+    if browser_name == "firefox":
+        await frame_navigated_task
     assert exc_info.value
     await context.set_offline(False)
     response = await page.goto(server.EMPTY_PAGE)
diff --git a/tests/async/test_browsercontext_request_fallback.py b/tests/async/test_browsercontext_request_fallback.py
index b198a4ebd..9abb14649 100644
--- a/tests/async/test_browsercontext_request_fallback.py
+++ b/tests/async/test_browsercontext_request_fallback.py
@@ -15,9 +15,7 @@
 import asyncio
 from typing import Any, Callable, Coroutine, cast
 
-import pytest
-
-from playwright.async_api import BrowserContext, Error, Page, Request, Route
+from playwright.async_api import BrowserContext, Page, Request, Route
 from tests.server import Server
 
 
@@ -96,61 +94,6 @@ async def test_should_chain_once(
     assert body == b"fulfilled one"
 
 
-async def test_should_not_chain_fulfill(
-    page: Page, context: BrowserContext, server: Server
-) -> None:
-    failed = [False]
-
-    def handler(route: Route) -> None:
-        failed[0] = True
-
-    await context.route("**/empty.html", handler)
-    await context.route(
-        "**/empty.html",
-        lambda route: asyncio.create_task(route.fulfill(status=200, body="fulfilled")),
-    )
-    await context.route(
-        "**/empty.html", lambda route: asyncio.create_task(route.fallback())
-    )
-
-    response = await page.goto(server.EMPTY_PAGE)
-    assert response
-    body = await response.body()
-    assert body == b"fulfilled"
-    assert not failed[0]
-
-
-async def test_should_not_chain_abort(
-    page: Page,
-    context: BrowserContext,
-    server: Server,
-    is_webkit: bool,
-    is_firefox: bool,
-) -> None:
-    failed = [False]
-
-    def handler(route: Route) -> None:
-        failed[0] = True
-
-    await context.route("**/empty.html", handler)
-    await context.route(
-        "**/empty.html", lambda route: asyncio.create_task(route.abort())
-    )
-    await context.route(
-        "**/empty.html", lambda route: asyncio.create_task(route.fallback())
-    )
-
-    with pytest.raises(Error) as excinfo:
-        await page.goto(server.EMPTY_PAGE)
-    if is_webkit:
-        assert "Blocked by Web Inspector" in excinfo.value.message
-    elif is_firefox:
-        assert "NS_ERROR_FAILURE" in excinfo.value.message
-    else:
-        assert "net::ERR_FAILED" in excinfo.value.message
-    assert not failed[0]
-
-
 async def test_should_fall_back_after_exception(
     page: Page, context: BrowserContext, server: Server
 ) -> None:
@@ -352,48 +295,3 @@ def _handler2(route: Route) -> None:
     assert post_data_buffer == ["\x00\x01\x02\x03\x04"]
     assert server_request.method == b"POST"
     assert server_request.post_body == b"\x00\x01\x02\x03\x04"
-
-
-async def test_should_chain_fallback_into_page(
-    context: BrowserContext, page: Page, server: Server
-) -> None:
-    intercepted = []
-
-    def _handler1(route: Route) -> None:
-        intercepted.append(1)
-        asyncio.create_task(route.fallback())
-
-    await context.route("**/empty.html", _handler1)
-
-    def _handler2(route: Route) -> None:
-        intercepted.append(2)
-        asyncio.create_task(route.fallback())
-
-    await context.route("**/empty.html", _handler2)
-
-    def _handler3(route: Route) -> None:
-        intercepted.append(3)
-        asyncio.create_task(route.fallback())
-
-    await context.route("**/empty.html", _handler3)
-
-    def _handler4(route: Route) -> None:
-        intercepted.append(4)
-        asyncio.create_task(route.fallback())
-
-    await page.route("**/empty.html", _handler4)
-
-    def _handler5(route: Route) -> None:
-        intercepted.append(5)
-        asyncio.create_task(route.fallback())
-
-    await page.route("**/empty.html", _handler5)
-
-    def _handler6(route: Route) -> None:
-        intercepted.append(6)
-        asyncio.create_task(route.fallback())
-
-    await page.route("**/empty.html", _handler6)
-
-    await page.goto(server.EMPTY_PAGE)
-    assert intercepted == [6, 5, 4, 3, 2, 1]
diff --git a/tests/async/test_browsercontext_route.py b/tests/async/test_browsercontext_route.py
new file mode 100644
index 000000000..d629be467
--- /dev/null
+++ b/tests/async/test_browsercontext_route.py
@@ -0,0 +1,516 @@
+# 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 re
+from typing import Awaitable, Callable, List
+
+import pytest
+
+from playwright.async_api import (
+    Browser,
+    BrowserContext,
+    Error,
+    Page,
+    Request,
+    Route,
+    expect,
+)
+from tests.server import Server, TestServerRequest
+from tests.utils import must
+
+
+async def test_route_should_intercept(context: BrowserContext, server: Server) -> None:
+    intercepted = []
+
+    def handle(route: Route, request: Request) -> None:
+        intercepted.append(True)
+        assert "empty.html" in request.url
+        assert request.headers["user-agent"]
+        assert request.method == "GET"
+        assert request.post_data is None
+        assert request.is_navigation_request()
+        assert request.resource_type == "document"
+        assert request.frame == page.main_frame
+        assert request.frame.url == "about:blank"
+        asyncio.create_task(route.continue_())
+
+    await context.route("**/empty.html", lambda route, request: handle(route, request))
+    page = await context.new_page()
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response
+    assert response.ok
+    assert intercepted == [True]
+    await context.close()
+
+
+async def test_route_should_unroute(context: BrowserContext, server: Server) -> None:
+    page = await context.new_page()
+
+    intercepted: List[int] = []
+
+    def handler(route: Route, request: Request, ordinal: int) -> None:
+        intercepted.append(ordinal)
+        asyncio.create_task(route.continue_())
+
+    await context.route("**/*", lambda route, request: handler(route, request, 1))
+    await context.route(
+        "**/empty.html", lambda route, request: handler(route, request, 2)
+    )
+    await context.route(
+        "**/empty.html", lambda route, request: handler(route, request, 3)
+    )
+
+    def handler4(route: Route, request: Request) -> None:
+        handler(route, request, 4)
+
+    await context.route(re.compile("empty.html"), handler4)
+
+    await page.goto(server.EMPTY_PAGE)
+    assert intercepted == [4]
+
+    intercepted = []
+    await context.unroute(re.compile("empty.html"), handler4)
+    await page.goto(server.EMPTY_PAGE)
+    assert intercepted == [3]
+
+    intercepted = []
+    await context.unroute("**/empty.html")
+    await page.goto(server.EMPTY_PAGE)
+    assert intercepted == [1]
+
+
+async def test_route_should_yield_to_page_route(
+    context: BrowserContext, server: Server
+) -> None:
+    await context.route(
+        "**/empty.html",
+        lambda route, request: asyncio.create_task(
+            route.fulfill(status=200, body="context")
+        ),
+    )
+
+    page = await context.new_page()
+    await page.route(
+        "**/empty.html",
+        lambda route, request: asyncio.create_task(
+            route.fulfill(status=200, body="page")
+        ),
+    )
+
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response
+    assert response.ok
+    assert await response.text() == "page"
+
+
+async def test_route_should_fall_back_to_context_route(
+    context: BrowserContext, server: Server
+) -> None:
+    await context.route(
+        "**/empty.html",
+        lambda route, request: asyncio.create_task(
+            route.fulfill(status=200, body="context")
+        ),
+    )
+
+    page = await context.new_page()
+    await page.route(
+        "**/non-empty.html",
+        lambda route, request: asyncio.create_task(
+            route.fulfill(status=200, body="page")
+        ),
+    )
+
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response
+    assert response.ok
+    assert await response.text() == "context"
+
+
+async def test_should_support_set_cookie_header(
+    context_factory: "Callable[..., Awaitable[BrowserContext]]",
+    default_same_site_cookie_value: str,
+) -> None:
+    context = await context_factory()
+    page = await context.new_page()
+    await page.route(
+        "https://example.com/",
+        lambda route: route.fulfill(
+            headers={
+                "Set-Cookie": "name=value; domain=.example.com; Path=/",
+            },
+            content_type="text/html",
+            body="done",
+        ),
+    )
+    await page.goto("https://example.com")
+    cookies = await context.cookies()
+    assert len(cookies) == 1
+    assert cookies[0] == {
+        "sameSite": default_same_site_cookie_value,
+        "name": "name",
+        "value": "value",
+        "domain": ".example.com",
+        "path": "/",
+        "expires": -1,
+        "httpOnly": False,
+        "secure": False,
+    }
+
+
+@pytest.mark.skip_browser("webkit")
+async def test_should_ignore_secure_set_cookie_header_for_insecure_request(
+    context_factory: "Callable[..., Awaitable[BrowserContext]]",
+) -> None:
+    context = await context_factory()
+    page = await context.new_page()
+    await page.route(
+        "http://example.com/",
+        lambda route: route.fulfill(
+            headers={
+                "Set-Cookie": "name=value; domain=.example.com; Path=/; Secure",
+            },
+            content_type="text/html",
+            body="done",
+        ),
+    )
+    await page.goto("http://example.com")
+    cookies = await context.cookies()
+    assert len(cookies) == 0
+
+
+async def test_should_use_set_cookie_header_in_future_requests(
+    context_factory: "Callable[..., Awaitable[BrowserContext]]",
+    server: Server,
+    default_same_site_cookie_value: str,
+) -> None:
+    context = await context_factory()
+    page = await context.new_page()
+
+    await page.route(
+        server.EMPTY_PAGE,
+        lambda route: route.fulfill(
+            headers={
+                "Set-Cookie": "name=value",
+            },
+            content_type="text/html",
+            body="done",
+        ),
+    )
+    await page.goto(server.EMPTY_PAGE)
+    assert await context.cookies() == [
+        {
+            "sameSite": default_same_site_cookie_value,
+            "name": "name",
+            "value": "value",
+            "domain": "localhost",
+            "path": "/",
+            "expires": -1,
+            "httpOnly": False,
+            "secure": False,
+        }
+    ]
+
+    cookie = ""
+
+    def _handle_request(request: TestServerRequest) -> None:
+        nonlocal cookie
+        cookie = must(request.getHeader("cookie"))
+        request.finish()
+
+    server.set_route("/foo.html", _handle_request)
+    await page.goto(server.PREFIX + "/foo.html")
+    assert cookie == "name=value"
+
+
+async def test_should_work_with_ignore_https_errors(
+    browser: Browser, https_server: Server
+) -> None:
+    context = await browser.new_context(ignore_https_errors=True)
+    page = await context.new_page()
+
+    await page.route("**/*", lambda route: route.continue_())
+    response = await page.goto(https_server.EMPTY_PAGE)
+    assert must(response).status == 200
+    await context.close()
+
+
+async def test_should_support_the_times_parameter_with_route_matching(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    intercepted: List[int] = []
+
+    async def _handle_request(route: Route) -> None:
+        intercepted.append(1)
+        await route.continue_()
+
+    await context.route("**/empty.html", _handle_request, times=1)
+    await page.goto(server.EMPTY_PAGE)
+    await page.goto(server.EMPTY_PAGE)
+    await page.goto(server.EMPTY_PAGE)
+    assert len(intercepted) == 1
+
+
+async def test_should_work_if_handler_with_times_parameter_was_removed_from_another_handler(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    intercepted = []
+
+    async def _handler(route: Route) -> None:
+        intercepted.append("first")
+        await route.continue_()
+
+    await context.route("**/*", _handler, times=1)
+
+    async def _handler2(route: Route) -> None:
+        intercepted.append("second")
+        await context.unroute("**/*", _handler)
+        await route.fallback()
+
+    await context.route("**/*", _handler2)
+    await page.goto(server.EMPTY_PAGE)
+    assert intercepted == ["second"]
+    intercepted.clear()
+    await page.goto(server.EMPTY_PAGE)
+    assert intercepted == ["second"]
+
+
+async def test_should_support_async_handler_with_times(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    async def _handler(route: Route) -> None:
+        await asyncio.sleep(0.1)
+        await route.fulfill(
+            body="<html>intercepted</html>",
+            content_type="text/html",
+        )
+
+    await context.route("**/empty.html", _handler, times=1)
+    await page.goto(server.EMPTY_PAGE)
+    await expect(page.locator("body")).to_have_text("intercepted")
+    await page.goto(server.EMPTY_PAGE)
+    await expect(page.locator("body")).not_to_have_text("intercepted")
+
+
+async def test_should_override_post_body_with_empty_string(
+    context: BrowserContext, server: Server, page: Page
+) -> None:
+    await context.route(
+        "**/empty.html",
+        lambda route: route.continue_(
+            post_data="",
+        ),
+    )
+
+    req = await asyncio.gather(
+        server.wait_for_request("/empty.html"),
+        page.set_content(
+            """
+            <script>
+            (async () => {
+                await fetch('%s', {
+                    method: 'POST',
+                    body: 'original',
+                });
+            })()
+            </script>
+            """
+            % server.EMPTY_PAGE
+        ),
+    )
+
+    assert req[0].post_body == b""
+
+
+async def test_should_chain_fallback(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    intercepted: List[int] = []
+
+    async def _handler1(route: Route) -> None:
+        intercepted.append(1)
+        await route.fallback()
+
+    await context.route("**/empty.html", _handler1)
+
+    async def _handler2(route: Route) -> None:
+        intercepted.append(2)
+        await route.fallback()
+
+    await context.route("**/empty.html", _handler2)
+
+    async def _handler3(route: Route) -> None:
+        intercepted.append(3)
+        await route.fallback()
+
+    await context.route("**/empty.html", _handler3)
+    await page.goto(server.EMPTY_PAGE)
+    assert intercepted == [3, 2, 1]
+
+
+async def test_should_chain_fallback_with_dynamic_url(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    intercepted: List[int] = []
+
+    async def _handler1(route: Route) -> None:
+        intercepted.append(1)
+        await route.fallback(url=server.EMPTY_PAGE)
+
+    await context.route("**/bar", _handler1)
+
+    async def _handler2(route: Route) -> None:
+        intercepted.append(2)
+        await route.fallback(url="http://localhost/bar")
+
+    await context.route("**/foo", _handler2)
+
+    async def _handler3(route: Route) -> None:
+        intercepted.append(3)
+        await route.fallback(url="http://localhost/foo")
+
+    await context.route("**/empty.html", _handler3)
+    await page.goto(server.EMPTY_PAGE)
+    assert intercepted == [3, 2, 1]
+
+
+async def test_should_not_chain_fulfill(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    failed = [False]
+
+    def handler(route: Route) -> None:
+        failed[0] = True
+
+    await context.route("**/empty.html", handler)
+    await context.route(
+        "**/empty.html",
+        lambda route: asyncio.create_task(route.fulfill(status=200, body="fulfilled")),
+    )
+    await context.route(
+        "**/empty.html", lambda route: asyncio.create_task(route.fallback())
+    )
+
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response
+    body = await response.body()
+    assert body == b"fulfilled"
+    assert not failed[0]
+
+
+async def test_should_not_chain_abort(
+    page: Page,
+    context: BrowserContext,
+    server: Server,
+    is_webkit: bool,
+    is_firefox: bool,
+) -> None:
+    failed = [False]
+
+    def handler(route: Route) -> None:
+        failed[0] = True
+
+    await context.route("**/empty.html", handler)
+    await context.route(
+        "**/empty.html", lambda route: asyncio.create_task(route.abort())
+    )
+    await context.route(
+        "**/empty.html", lambda route: asyncio.create_task(route.fallback())
+    )
+
+    with pytest.raises(Error) as excinfo:
+        await page.goto(server.EMPTY_PAGE)
+    if is_webkit:
+        assert "Blocked by Web Inspector" in excinfo.value.message
+    elif is_firefox:
+        assert "NS_ERROR_FAILURE" in excinfo.value.message
+    else:
+        assert "net::ERR_FAILED" in excinfo.value.message
+    assert not failed[0]
+
+
+async def test_should_chain_fallback_into_page(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    intercepted = []
+
+    def _handler1(route: Route) -> None:
+        intercepted.append(1)
+        asyncio.create_task(route.fallback())
+
+    await context.route("**/empty.html", _handler1)
+
+    def _handler2(route: Route) -> None:
+        intercepted.append(2)
+        asyncio.create_task(route.fallback())
+
+    await context.route("**/empty.html", _handler2)
+
+    def _handler3(route: Route) -> None:
+        intercepted.append(3)
+        asyncio.create_task(route.fallback())
+
+    await context.route("**/empty.html", _handler3)
+
+    def _handler4(route: Route) -> None:
+        intercepted.append(4)
+        asyncio.create_task(route.fallback())
+
+    await page.route("**/empty.html", _handler4)
+
+    def _handler5(route: Route) -> None:
+        intercepted.append(5)
+        asyncio.create_task(route.fallback())
+
+    await page.route("**/empty.html", _handler5)
+
+    def _handler6(route: Route) -> None:
+        intercepted.append(6)
+        asyncio.create_task(route.fallback())
+
+    await page.route("**/empty.html", _handler6)
+
+    await page.goto(server.EMPTY_PAGE)
+    assert intercepted == [6, 5, 4, 3, 2, 1]
+
+
+async def test_should_fall_back_async(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    intercepted = []
+
+    async def _handler1(route: Route) -> None:
+        intercepted.append(1)
+        await asyncio.sleep(0.1)
+        await route.fallback()
+
+    await context.route("**/empty.html", _handler1)
+
+    async def _handler2(route: Route) -> None:
+        intercepted.append(2)
+        await asyncio.sleep(0.1)
+        await route.fallback()
+
+    await context.route("**/empty.html", _handler2)
+
+    async def _handler3(route: Route) -> None:
+        intercepted.append(3)
+        await asyncio.sleep(0.1)
+        await route.fallback()
+
+    await context.route("**/empty.html", _handler3)
+
+    await page.goto(server.EMPTY_PAGE)
+    assert intercepted == [3, 2, 1]
diff --git a/tests/async/test_expect_misc.py b/tests/async/test_expect_misc.py
index 414909b67..9c6a8aa01 100644
--- a/tests/async/test_expect_misc.py
+++ b/tests/async/test_expect_misc.py
@@ -14,7 +14,7 @@
 
 import pytest
 
-from playwright.async_api import Page, expect
+from playwright.async_api import Page, TimeoutError, expect
 from tests.server import Server
 
 
@@ -72,3 +72,9 @@ async def test_to_be_in_viewport_should_report_intersection_even_if_fully_covere
     """
     )
     await expect(page.locator("h1")).to_be_in_viewport()
+
+
+async def test_should_have_timeout_error_name(page: Page) -> None:
+    with pytest.raises(TimeoutError) as exc_info:
+        await page.wait_for_selector("#not-found", timeout=1)
+    assert exc_info.value.name == "TimeoutError"
diff --git a/tests/async/test_har.py b/tests/async/test_har.py
index 31a34f8fa..7e02776f1 100644
--- a/tests/async/test_har.py
+++ b/tests/async/test_har.py
@@ -18,12 +18,13 @@
 import re
 import zipfile
 from pathlib import Path
-from typing import cast
+from typing import Awaitable, Callable, cast
 
 import pytest
 
 from playwright.async_api import Browser, BrowserContext, Error, Page, Route, expect
 from tests.server import Server
+from tests.utils import must
 
 
 async def test_should_work(browser: Browser, server: Server, tmpdir: Path) -> None:
@@ -647,6 +648,44 @@ async def test_should_update_har_zip_for_context(
     )
 
 
+async def test_page_unroute_all_should_stop_page_route_from_har(
+    context_factory: Callable[[], Awaitable[BrowserContext]],
+    server: Server,
+    assetdir: Path,
+) -> None:
+    har_path = assetdir / "har-fulfill.har"
+    context1 = await context_factory()
+    page1 = await context1.new_page()
+    # The har file contains requests for another domain, so the router
+    # is expected to abort all requests.
+    await page1.route_from_har(har_path, not_found="abort")
+    with pytest.raises(Error) as exc_info:
+        await page1.goto(server.EMPTY_PAGE)
+    assert exc_info.value
+    await page1.unroute_all(behavior="wait")
+    response = must(await page1.goto(server.EMPTY_PAGE))
+    assert response.ok
+
+
+async def test_context_unroute_call_should_stop_context_route_from_har(
+    context_factory: Callable[[], Awaitable[BrowserContext]],
+    server: Server,
+    assetdir: Path,
+) -> None:
+    har_path = assetdir / "har-fulfill.har"
+    context1 = await context_factory()
+    page1 = await context1.new_page()
+    # The har file contains requests for another domain, so the router
+    # is expected to abort all requests.
+    await context1.route_from_har(har_path, not_found="abort")
+    with pytest.raises(Error) as exc_info:
+        await page1.goto(server.EMPTY_PAGE)
+    assert exc_info.value
+    await context1.unroute_all(behavior="wait")
+    response = must(await page1.goto(server.EMPTY_PAGE))
+    assert must(response).ok
+
+
 async def test_should_update_har_zip_for_page(
     browser: Browser, server: Server, tmpdir: Path
 ) -> None:
diff --git a/tests/async/test_keyboard.py b/tests/async/test_keyboard.py
index 8e8a162c9..9f8db104e 100644
--- a/tests/async/test_keyboard.py
+++ b/tests/async/test_keyboard.py
@@ -519,27 +519,16 @@ async def test_should_support_macos_shortcuts(
     )
 
 
-async def test_should_press_the_meta_key(
-    page: Page, server: Server, is_firefox: bool, is_mac: bool
-) -> None:
+async def test_should_press_the_meta_key(page: Page) -> None:
     lastEvent = await captureLastKeydown(page)
     await page.keyboard.press("Meta")
     v = await lastEvent.json_value()
     metaKey = v["metaKey"]
     key = v["key"]
     code = v["code"]
-    if is_firefox and not is_mac:
-        assert key == "OS"
-    else:
-        assert key == "Meta"
-
-    if is_firefox:
-        assert code == "MetaLeft"
-
-    if is_firefox and not is_mac:
-        assert metaKey is False
-    else:
-        assert metaKey
+    assert key == "Meta"
+    assert code == "MetaLeft"
+    assert metaKey
 
 
 async def test_should_work_after_a_cross_origin_navigation(
diff --git a/tests/async/test_interception.py b/tests/async/test_page_route.py
similarity index 98%
rename from tests/async/test_interception.py
rename to tests/async/test_page_route.py
index 01f932360..8e0b74130 100644
--- a/tests/async/test_interception.py
+++ b/tests/async/test_page_route.py
@@ -1010,21 +1010,28 @@ async def handle_request(route: Route) -> None:
     assert len(intercepted) == 1
 
 
-async def test_context_route_should_support_times_parameter(
+async def test_should_work_if_handler_with_times_parameter_was_removed_from_another_handler(
     context: BrowserContext, page: Page, server: Server
 ) -> None:
     intercepted = []
 
-    async def handle_request(route: Route) -> None:
+    async def handler(route: Route) -> None:
+        intercepted.append("first")
         await route.continue_()
-        intercepted.append(True)
 
-    await context.route("**/empty.html", handle_request, times=1)
+    await page.route("**/*", handler, times=1)
 
+    async def handler2(route: Route) -> None:
+        intercepted.append("second")
+        await page.unroute("**/*", handler)
+        await route.fallback()
+
+    await page.route("**/*", handler2)
     await page.goto(server.EMPTY_PAGE)
+    assert intercepted == ["second"]
+    intercepted.clear()
     await page.goto(server.EMPTY_PAGE)
-    await page.goto(server.EMPTY_PAGE)
-    assert len(intercepted) == 1
+    assert intercepted == ["second"]
 
 
 async def test_should_fulfill_with_global_fetch_result(
diff --git a/tests/async/test_unroute_behavior.py b/tests/async/test_unroute_behavior.py
new file mode 100644
index 000000000..8a9b46b3b
--- /dev/null
+++ b/tests/async/test_unroute_behavior.py
@@ -0,0 +1,451 @@
+# 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 re
+
+from playwright.async_api import BrowserContext, Error, Page, Route
+from tests.server import Server
+from tests.utils import must
+
+
+async def test_context_unroute_should_not_wait_for_pending_handlers_to_complete(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    second_handler_called = False
+
+    async def _handler1(route: Route) -> None:
+        nonlocal second_handler_called
+        second_handler_called = True
+        await route.continue_()
+
+    await context.route(
+        re.compile(".*"),
+        _handler1,
+    )
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    route_barrier_future: "asyncio.Future[None]" = asyncio.Future()
+
+    async def _handler2(route: Route) -> None:
+        route_future.set_result(route)
+        await route_barrier_future
+        await route.fallback()
+
+    await context.route(
+        re.compile(".*"),
+        _handler2,
+    )
+    navigation_task = asyncio.create_task(page.goto(server.EMPTY_PAGE))
+    await route_future
+    await context.unroute(
+        re.compile(".*"),
+        _handler2,
+    )
+    route_barrier_future.set_result(None)
+    await navigation_task
+    assert second_handler_called
+
+
+async def test_context_unroute_all_removes_all_handlers(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    await context.route(
+        "**/*",
+        lambda route: route.abort(),
+    )
+    await context.route(
+        "**/empty.html",
+        lambda route: route.abort(),
+    )
+    await context.unroute_all()
+    await page.goto(server.EMPTY_PAGE)
+
+
+async def test_context_unroute_all_should_not_wait_for_pending_handlers_to_complete(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    second_handler_called = False
+
+    async def _handler1(route: Route) -> None:
+        nonlocal second_handler_called
+        second_handler_called = True
+        await route.abort()
+
+    await context.route(
+        re.compile(".*"),
+        _handler1,
+    )
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    route_barrier_future: "asyncio.Future[None]" = asyncio.Future()
+
+    async def _handler2(route: Route) -> None:
+        route_future.set_result(route)
+        await route_barrier_future
+        await route.fallback()
+
+    await context.route(
+        re.compile(".*"),
+        _handler2,
+    )
+    navigation_task = asyncio.create_task(page.goto(server.EMPTY_PAGE))
+    await route_future
+    did_unroute = False
+
+    async def _unroute_promise() -> None:
+        nonlocal did_unroute
+        await context.unroute_all(behavior="wait")
+        did_unroute = True
+
+    unroute_task = asyncio.create_task(_unroute_promise())
+    await asyncio.sleep(0.5)
+    assert did_unroute is False
+    route_barrier_future.set_result(None)
+    await unroute_task
+    assert did_unroute
+    await navigation_task
+    assert second_handler_called is False
+
+
+async def test_context_unroute_all_should_not_wait_for_pending_handlers_to_complete_if_behavior_is_ignore_errors(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    second_handler_called = False
+
+    async def _handler1(route: Route) -> None:
+        nonlocal second_handler_called
+        second_handler_called = True
+        await route.abort()
+
+    await context.route(
+        re.compile(".*"),
+        _handler1,
+    )
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    route_barrier_future: "asyncio.Future[None]" = asyncio.Future()
+
+    async def _handler2(route: Route) -> None:
+        route_future.set_result(route)
+        await route_barrier_future
+        raise Exception("Handler error")
+
+    await context.route(
+        re.compile(".*"),
+        _handler2,
+    )
+    navigation_task = asyncio.create_task(page.goto(server.EMPTY_PAGE))
+    await route_future
+    did_unroute = False
+
+    async def _unroute_promise() -> None:
+        await context.unroute_all(behavior="ignoreErrors")
+        nonlocal did_unroute
+        did_unroute = True
+
+    unroute_task = asyncio.create_task(_unroute_promise())
+    await asyncio.sleep(0.5)
+    await unroute_task
+    assert did_unroute
+    route_barrier_future.set_result(None)
+    try:
+        await navigation_task
+    except Error:
+        pass
+    # The error in the unrouted handler should be silently caught and remaining handler called.
+    assert not second_handler_called
+
+
+async def test_page_close_should_not_wait_for_active_route_handlers_on_the_owning_context(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    await context.route(
+        re.compile(".*"),
+        lambda route: route_future.set_result(route),
+    )
+    await page.route(
+        re.compile(".*"),
+        lambda route: route.fallback(),
+    )
+
+    async def _goto_ignore_exceptions() -> None:
+        try:
+            await page.goto(server.EMPTY_PAGE)
+        except Error:
+            pass
+
+    asyncio.create_task(_goto_ignore_exceptions())
+    await route_future
+    await page.close()
+
+
+async def test_context_close_should_not_wait_for_active_route_handlers_on_the_owned_pages(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    await page.route(
+        re.compile(".*"),
+        lambda route: route_future.set_result(route),
+    )
+    await page.route(re.compile(".*"), lambda route: route.fallback())
+
+    async def _goto_ignore_exceptions() -> None:
+        try:
+            await page.goto(server.EMPTY_PAGE)
+        except Error:
+            pass
+
+    asyncio.create_task(_goto_ignore_exceptions())
+    await route_future
+    await context.close()
+
+
+async def test_page_unroute_should_not_wait_for_pending_handlers_to_complete(
+    page: Page, server: Server
+) -> None:
+    second_handler_called = False
+
+    async def _handler1(route: Route) -> None:
+        nonlocal second_handler_called
+        second_handler_called = True
+        await route.continue_()
+
+    await page.route(
+        re.compile(".*"),
+        _handler1,
+    )
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    route_barrier_future: "asyncio.Future[None]" = asyncio.Future()
+
+    async def _handler2(route: Route) -> None:
+        route_future.set_result(route)
+        await route_barrier_future
+        await route.fallback()
+
+    await page.route(
+        re.compile(".*"),
+        _handler2,
+    )
+    navigation_task = asyncio.create_task(page.goto(server.EMPTY_PAGE))
+    await route_future
+    await page.unroute(
+        re.compile(".*"),
+        _handler2,
+    )
+    route_barrier_future.set_result(None)
+    await navigation_task
+    assert second_handler_called
+
+
+async def test_page_unroute_all_removes_all_routes(page: Page, server: Server) -> None:
+    await page.route(
+        "**/*",
+        lambda route: route.abort(),
+    )
+    await page.route(
+        "**/empty.html",
+        lambda route: route.abort(),
+    )
+    await page.unroute_all()
+    response = must(await page.goto(server.EMPTY_PAGE))
+    assert response.ok
+
+
+async def test_page_unroute_should_wait_for_pending_handlers_to_complete(
+    page: Page, server: Server
+) -> None:
+    second_handler_called = False
+
+    async def _handler1(route: Route) -> None:
+        nonlocal second_handler_called
+        second_handler_called = True
+        await route.abort()
+
+    await page.route(
+        "**/*",
+        _handler1,
+    )
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    route_barrier_future: "asyncio.Future[None]" = asyncio.Future()
+
+    async def _handler2(route: Route) -> None:
+        route_future.set_result(route)
+        await route_barrier_future
+        await route.fallback()
+
+    await page.route(
+        "**/*",
+        _handler2,
+    )
+    navigation_task = asyncio.create_task(page.goto(server.EMPTY_PAGE))
+    await route_future
+    did_unroute = False
+
+    async def _unroute_promise() -> None:
+        await page.unroute_all(behavior="wait")
+        nonlocal did_unroute
+        did_unroute = True
+
+    unroute_task = asyncio.create_task(_unroute_promise())
+    await asyncio.sleep(0.5)
+    assert did_unroute is False
+    route_barrier_future.set_result(None)
+    await unroute_task
+    assert did_unroute
+    await navigation_task
+    assert second_handler_called is False
+
+
+async def test_page_unroute_all_should_not_wait_for_pending_handlers_to_complete_if_behavior_is_ignore_errors(
+    page: Page, server: Server
+) -> None:
+    second_handler_called = False
+
+    async def _handler1(route: Route) -> None:
+        nonlocal second_handler_called
+        second_handler_called = True
+        await route.abort()
+
+    await page.route(re.compile(".*"), _handler1)
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    route_barrier_future: "asyncio.Future[None]" = asyncio.Future()
+
+    async def _handler2(route: Route) -> None:
+        route_future.set_result(route)
+        await route_barrier_future
+        raise Exception("Handler error")
+
+    await page.route(re.compile(".*"), _handler2)
+    navigation_task = asyncio.create_task(page.goto(server.EMPTY_PAGE))
+    await route_future
+    did_unroute = False
+
+    async def _unroute_promise() -> None:
+        await page.unroute_all(behavior="ignoreErrors")
+        nonlocal did_unroute
+        did_unroute = True
+
+    unroute_task = asyncio.create_task(_unroute_promise())
+    await asyncio.sleep(0.5)
+    await unroute_task
+    assert did_unroute
+    route_barrier_future.set_result(None)
+    try:
+        await navigation_task
+    except Error:
+        pass
+    # The error in the unrouted handler should be silently caught.
+    assert not second_handler_called
+
+
+async def test_page_close_does_not_wait_for_active_route_handlers(
+    page: Page, server: Server
+) -> None:
+    second_handler_called = False
+
+    def _handler1(route: Route) -> None:
+        nonlocal second_handler_called
+        second_handler_called = True
+
+    await page.route(
+        "**/*",
+        _handler1,
+    )
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+
+    async def _handler2(route: Route) -> None:
+        route_future.set_result(route)
+        await asyncio.Future()
+
+    await page.route(
+        "**/*",
+        _handler2,
+    )
+
+    async def _goto_ignore_exceptions() -> None:
+        try:
+            await page.goto(server.EMPTY_PAGE)
+        except Error:
+            pass
+
+    asyncio.create_task(_goto_ignore_exceptions())
+    await route_future
+    await page.close()
+    await asyncio.sleep(0.5)
+    assert not second_handler_called
+
+
+async def test_route_continue_should_not_throw_if_page_has_been_closed(
+    page: Page, server: Server
+) -> None:
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    await page.route(
+        re.compile(".*"),
+        lambda route: route_future.set_result(route),
+    )
+
+    async def _goto_ignore_exceptions() -> None:
+        try:
+            await page.goto(server.EMPTY_PAGE)
+        except Error:
+            pass
+
+    asyncio.create_task(_goto_ignore_exceptions())
+    route = await route_future
+    await page.close()
+    # Should not throw.
+    await route.continue_()
+
+
+async def test_route_fallback_should_not_throw_if_page_has_been_closed(
+    page: Page, server: Server
+) -> None:
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    await page.route(
+        re.compile(".*"),
+        lambda route: route_future.set_result(route),
+    )
+
+    async def _goto_ignore_exceptions() -> None:
+        try:
+            await page.goto(server.EMPTY_PAGE)
+        except Error:
+            pass
+
+    asyncio.create_task(_goto_ignore_exceptions())
+    route = await route_future
+    await page.close()
+    # Should not throw.
+    await route.fallback()
+
+
+async def test_route_fulfill_should_not_throw_if_page_has_been_closed(
+    page: Page, server: Server
+) -> None:
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+    await page.route(
+        "**/*",
+        lambda route: route_future.set_result(route),
+    )
+
+    async def _goto_ignore_exceptions() -> None:
+        try:
+            await page.goto(server.EMPTY_PAGE)
+        except Error:
+            pass
+
+    asyncio.create_task(_goto_ignore_exceptions())
+    route = await route_future
+    await page.close()
+    # Should not throw.
+    await route.fulfill()
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index 3f27a4140..fbd94b932 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -344,21 +344,3 @@ def test_call_sync_method_after_playwright_close_with_own_loop(
     p.start()
     p.join()
     assert p.exitcode == 0
-
-
-def test_should_collect_stale_handles(page: Page, server: Server) -> None:
-    page.on("request", lambda request: None)
-    response = page.goto(server.PREFIX + "/title.html")
-    assert response
-    for i in range(1000):
-        page.evaluate(
-            """async () => {
-            const response = await fetch('/');
-            await response.text();
-        }"""
-        )
-    with pytest.raises(Exception) as exc_info:
-        response.all_headers()
-    assert "The object has been collected to prevent unbounded heap growth." in str(
-        exc_info.value
-    )
diff --git a/tests/sync/test_unroute_behavior.py b/tests/sync/test_unroute_behavior.py
new file mode 100644
index 000000000..12ae9e22d
--- /dev/null
+++ b/tests/sync/test_unroute_behavior.py
@@ -0,0 +1,46 @@
+# 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, Page
+from tests.server import Server
+from tests.utils import must
+
+
+def test_context_unroute_all_removes_all_handlers(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    context.route(
+        "**/*",
+        lambda route: route.abort(),
+    )
+    context.route(
+        "**/empty.html",
+        lambda route: route.abort(),
+    )
+    context.unroute_all()
+    page.goto(server.EMPTY_PAGE)
+
+
+def test_page_unroute_all_removes_all_routes(page: Page, server: Server) -> None:
+    page.route(
+        "**/*",
+        lambda route: route.abort(),
+    )
+    page.route(
+        "**/empty.html",
+        lambda route: route.abort(),
+    )
+    page.unroute_all()
+    response = must(page.goto(server.EMPTY_PAGE))
+    assert response.ok

From a45f6adcd6c622e4036adb0449b4d6ee772392a5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 22 Jan 2024 23:24:01 +0100
Subject: [PATCH 134/438] build(deps): bump pillow from 10.0.1 to 10.2.0
 (#2255)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index f710e99b9..d7d5bc28f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -5,7 +5,7 @@ flake8==6.1.0
 flaky==3.7.0
 mypy==1.8.0
 objgraph==3.6.0
-Pillow==10.0.1
+Pillow==10.2.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==23.2.0

From 0cfb23fe76ca46526578a327848152944eb0ab4e Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 30 Jan 2024 09:05:06 +0100
Subject: [PATCH 135/438] fix: only render sync/async code blocks in generated
 classes (#2262)

---
 playwright/async_api/_generated.py | 1621 ---------------------------
 playwright/sync_api/_generated.py  | 1661 +---------------------------
 scripts/documentation_provider.py  |   34 +-
 3 files changed, 36 insertions(+), 3280 deletions(-)

diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 59a92a296..831d8dcfb 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -210,11 +210,6 @@ def redirected_from(self) -> typing.Optional["Request"]:
         print(response.request.redirected_from.url) # \"http://example.com\"
         ```
 
-        ```py
-        response = page.goto(\"http://example.com\")
-        print(response.request.redirected_from.url) # \"http://example.com\"
-        ```
-
         If the website `https://google.com` has no redirects:
 
         ```py
@@ -222,11 +217,6 @@ def redirected_from(self) -> typing.Optional["Request"]:
         print(response.request.redirected_from) # None
         ```
 
-        ```py
-        response = page.goto(\"https://google.com\")
-        print(response.request.redirected_from) # None
-        ```
-
         Returns
         -------
         Union[Request, None]
@@ -290,13 +280,6 @@ def timing(self) -> ResourceTiming:
         print(request.timing)
         ```
 
-        ```py
-        with page.expect_event(\"requestfinished\") as request_info:
-            page.goto(\"http://example.com\")
-        request = request_info.value
-        print(request.timing)
-        ```
-
         Returns
         -------
         {startTime: float, domainLookupStart: float, domainLookupEnd: float, connectStart: float, secureConnectionStart: float, connectEnd: float, requestStart: float, responseStart: float, responseEnd: float}
@@ -707,23 +690,12 @@ async def fulfill(
             body=\"not found!\"))
         ```
 
-        ```py
-        page.route(\"**/*\", lambda route: route.fulfill(
-            status=404,
-            content_type=\"text/plain\",
-            body=\"not found!\"))
-        ```
-
         An example of serving static file:
 
         ```py
         await page.route(\"**/xhr_endpoint\", lambda route: route.fulfill(path=\"mock_data.json\"))
         ```
 
-        ```py
-        page.route(\"**/xhr_endpoint\", lambda route: route.fulfill(path=\"mock_data.json\"))
-        ```
-
         Parameters
         ----------
         status : Union[int, None]
@@ -783,16 +755,6 @@ async def handle(route):
         await page.route(\"https://dog.ceo/api/breeds/list/all\", handle)
         ```
 
-        ```py
-        def handle(route):
-            response = route.fetch()
-            json = response.json()
-            json[\"message\"][\"big_red_dog\"] = []
-            route.fulfill(response=response, json=json)
-
-        page.route(\"https://dog.ceo/api/breeds/list/all\", handle)
-        ```
-
         **Details**
 
         Note that `headers` option will apply to the fetched request as well as any redirects initiated by it. If you want
@@ -856,12 +818,6 @@ async def fallback(
         await page.route(\"**/*\", lambda route: route.fallback())  # Runs first.
         ```
 
-        ```py
-        page.route(\"**/*\", lambda route: route.abort())  # Runs last.
-        page.route(\"**/*\", lambda route: route.fallback())  # Runs second.
-        page.route(\"**/*\", lambda route: route.fallback())  # Runs first.
-        ```
-
         Registering multiple routes is useful when you want separate handlers to handle different kinds of requests, for
         example API calls vs page resources or GET requests vs POST requests as in the example below.
 
@@ -886,27 +842,6 @@ def handle_post(route):
         await page.route(\"**/*\", handle_post)
         ```
 
-        ```py
-        # Handle GET requests.
-        def handle_get(route):
-            if route.request.method != \"GET\":
-                route.fallback()
-                return
-          # Handling GET only.
-          # ...
-
-        # Handle POST requests.
-        def handle_post(route):
-            if route.request.method != \"POST\":
-                route.fallback()
-                return
-          # Handling POST only.
-          # ...
-
-        page.route(\"**/*\", handle_get)
-        page.route(\"**/*\", handle_post)
-        ```
-
         One can also modify request while falling back to the subsequent handler, that way intermediate route handler can
         modify url, method, headers and postData of the request.
 
@@ -923,19 +858,6 @@ async def handle(route, request):
         await page.route(\"**/*\", handle)
         ```
 
-        ```py
-        def handle(route, request):
-            # override headers
-            headers = {
-                **request.headers,
-                \"foo\": \"foo-value\", # set \"foo\" header
-                \"bar\": None # remove \"bar\" header
-            }
-            route.fallback(headers=headers)
-
-        page.route(\"**/*\", handle)
-        ```
-
         Parameters
         ----------
         url : Union[str, None]
@@ -985,19 +907,6 @@ async def handle(route, request):
         await page.route(\"**/*\", handle)
         ```
 
-        ```py
-        def handle(route, request):
-            # override headers
-            headers = {
-                **request.headers,
-                \"foo\": \"foo-value\", # set \"foo\" header
-                \"bar\": None # remove \"bar\" header
-            }
-            route.continue_(headers=headers)
-
-        page.route(\"**/*\", handle)
-        ```
-
         **Details**
 
         Note that any overrides such as `url` or `headers` only apply to the request being routed. If this request results
@@ -1284,10 +1193,6 @@ async def insert_text(self, text: str) -> None:
         await page.keyboard.insert_text(\"嗨\")
         ```
 
-        ```py
-        page.keyboard.insert_text(\"嗨\")
-        ```
-
         **NOTE** Modifier keys DO NOT effect `keyboard.insertText`. Holding down `Shift` will not type the text in upper
         case.
 
@@ -1316,11 +1221,6 @@ async def type(self, text: str, *, delay: typing.Optional[float] = None) -> None
         await page.keyboard.type(\"World\", delay=100) # types slower, like a user
         ```
 
-        ```py
-        page.keyboard.type(\"Hello\") # types instantly
-        page.keyboard.type(\"World\", delay=100) # types slower, like a user
-        ```
-
         **NOTE** Modifier keys DO NOT effect `keyboard.type`. Holding down `Shift` will not type the text in upper case.
 
         **NOTE** For characters that are not on a US keyboard, only an `input` event will be sent.
@@ -1375,18 +1275,6 @@ async def press(self, key: str, *, delay: typing.Optional[float] = None) -> None
         await browser.close()
         ```
 
-        ```py
-        page = browser.new_page()
-        page.goto(\"https://keycode.info\")
-        page.keyboard.press(\"a\")
-        page.screenshot(path=\"a.png\")
-        page.keyboard.press(\"ArrowLeft\")
-        page.screenshot(path=\"arrow_left.png\")
-        page.keyboard.press(\"Shift+O\")
-        page.screenshot(path=\"o.png\")
-        browser.close()
-        ```
-
         Shortcut for `keyboard.down()` and `keyboard.up()`.
 
         Parameters
@@ -1587,11 +1475,6 @@ async def evaluate(
         assert await tweet_handle.evaluate(\"node => node.innerText\") == \"10 retweets\"
         ```
 
-        ```py
-        tweet_handle = page.query_selector(\".tweet .retweets\")
-        assert tweet_handle.evaluate(\"node => node.innerText\") == \"10 retweets\"
-        ```
-
         Parameters
         ----------
         expression : str
@@ -1681,14 +1564,6 @@ async def get_properties(self) -> typing.Dict[str, "JSHandle"]:
         await handle.dispose()
         ```
 
-        ```py
-        handle = page.evaluate_handle(\"({ window, document })\")
-        properties = handle.get_properties()
-        window_handle = properties.get(\"window\")
-        document_handle = properties.get(\"document\")
-        handle.dispose()
-        ```
-
         Returns
         -------
         Dict[str, JSHandle]
@@ -1912,10 +1787,6 @@ async def dispatch_event(
         await element_handle.dispatch_event(\"click\")
         ```
 
-        ```py
-        element_handle.dispatch_event(\"click\")
-        ```
-
         Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
@@ -1939,12 +1810,6 @@ async def dispatch_event(
         await element_handle.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
         ```
 
-        ```py
-        # note you can only create data_transfer in chromium and firefox
-        data_transfer = page.evaluate_handle(\"new DataTransfer()\")
-        element_handle.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
-        ```
-
         Parameters
         ----------
         type : str
@@ -2217,15 +2082,6 @@ async def select_option(
         await handle.select_option(value=[\"red\", \"green\", \"blue\"])
         ```
 
-        ```py
-        # Single selection matching the value or label
-        handle.select_option(\"blue\")
-        # single selection matching both the label
-        handle.select_option(label=\"blue\")
-        # multiple selection
-        handle.select_option(value=[\"red\", \"green\", \"blue\"])
-        ```
-
         Parameters
         ----------
         value : Union[Sequence[str], str, None]
@@ -2745,11 +2601,6 @@ async def bounding_box(self) -> typing.Optional[FloatRect]:
         await page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
         ```
 
-        ```py
-        box = element_handle.bounding_box()
-        page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
-        ```
-
         Returns
         -------
         Union[{x: float, y: float, width: float, height: float}, None]
@@ -2908,12 +2759,6 @@ async def eval_on_selector(
         assert await tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") == \"10\"
         ```
 
-        ```py
-        tweet_handle = page.query_selector(\".tweet\")
-        assert tweet_handle.eval_on_selector(\".like\", \"node => node.innerText\") == \"100\"
-        assert tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") == \"10\"
-        ```
-
         Parameters
         ----------
         selector : str
@@ -2962,11 +2807,6 @@ async def eval_on_selector_all(
         assert await feed_handle.eval_on_selector_all(\".tweet\", \"nodes => nodes.map(n => n.innerText)\") == [\"hello!\", \"hi!\"]
         ```
 
-        ```py
-        feed_handle = page.query_selector(\".feed\")
-        assert feed_handle.eval_on_selector_all(\".tweet\", \"nodes => nodes.map(n => n.innerText)\") == [\"hello!\", \"hi!\"]
-        ```
-
         Parameters
         ----------
         selector : str
@@ -3055,13 +2895,6 @@ async def wait_for_selector(
         span = await div.wait_for_selector(\"span\", state=\"attached\")
         ```
 
-        ```py
-        page.set_content(\"<div><span></span></div>\")
-        div = page.query_selector(\"div\")
-        # waiting for the \"span\" selector relative to the div.
-        span = div.wait_for_selector(\"span\", state=\"attached\")
-        ```
-
         **NOTE** This method does not work across navigations, use `page.wait_for_selector()` instead.
 
         Parameters
@@ -3123,11 +2956,6 @@ async def snapshot(
         print(snapshot)
         ```
 
-        ```py
-        snapshot = page.accessibility.snapshot()
-        print(snapshot)
-        ```
-
         An example of logging the focused node's name:
 
         ```py
@@ -3146,22 +2974,6 @@ def find_focused_node(node):
             print(node[\"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]
@@ -3417,12 +3229,6 @@ def expect_navigation(
         # Resolves after navigation has finished
         ```
 
-        ```py
-        with frame.expect_navigation():
-            frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
-        # Resolves after navigation has finished
-        ```
-
         **NOTE** Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL
         is considered a navigation.
 
@@ -3477,11 +3283,6 @@ async def wait_for_url(
         await frame.wait_for_url(\"**/target.html\")
         ```
 
-        ```py
-        frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
-        frame.wait_for_url(\"**/target.html\")
-        ```
-
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
@@ -3532,11 +3333,6 @@ async def wait_for_load_state(
         await frame.wait_for_load_state() # the promise resolves after \"load\" event.
         ```
 
-        ```py
-        frame.click(\"button\") # click triggers navigation.
-        frame.wait_for_load_state() # the promise resolves after \"load\" event.
-        ```
-
         Parameters
         ----------
         state : Union["domcontentloaded", "load", "networkidle", None]
@@ -3575,12 +3371,6 @@ async def frame_element(self) -> "ElementHandle":
         assert frame == content_frame
         ```
 
-        ```py
-        frame_element = frame.frame_element()
-        content_frame = frame_element.content_frame()
-        assert frame == content_frame
-        ```
-
         Returns
         -------
         ElementHandle
@@ -3609,11 +3399,6 @@ async def evaluate(
         print(result) # prints \"56\"
         ```
 
-        ```py
-        result = frame.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
-        print(result) # prints \"56\"
-        ```
-
         A string can also be passed in instead of a function.
 
         ```py
@@ -3622,12 +3407,6 @@ async def evaluate(
         print(await frame.evaluate(f\"1 + {x}\")) # prints \"11\"
         ```
 
-        ```py
-        print(frame.evaluate(\"1 + 2\")) # prints \"3\"
-        x = 10
-        print(frame.evaluate(f\"1 + {x}\")) # prints \"11\"
-        ```
-
         `ElementHandle` instances can be passed as an argument to the `frame.evaluate()`:
 
         ```py
@@ -3636,12 +3415,6 @@ async def evaluate(
         await body_handle.dispose()
         ```
 
-        ```py
-        body_handle = frame.evaluate(\"document.body\")
-        html = frame.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
-        body_handle.dispose()
-        ```
-
         Parameters
         ----------
         expression : str
@@ -3681,21 +3454,12 @@ async def evaluate_handle(
         a_window_handle # handle for the window object.
         ```
 
-        ```py
-        a_window_handle = frame.evaluate_handle(\"Promise.resolve(window)\")
-        a_window_handle # handle for the window object.
-        ```
-
         A string can also be passed in instead of a function.
 
         ```py
         a_handle = await page.evaluate_handle(\"document\") # handle for the \"document\"
         ```
 
-        ```py
-        a_handle = page.evaluate_handle(\"document\") # handle for the \"document\"
-        ```
-
         `JSHandle` instances can be passed as an argument to the `frame.evaluate_handle()`:
 
         ```py
@@ -3705,13 +3469,6 @@ async def evaluate_handle(
         await result_handle.dispose()
         ```
 
-        ```py
-        a_handle = page.evaluate_handle(\"document.body\")
-        result_handle = page.evaluate_handle(\"body => body.innerHTML\", a_handle)
-        print(result_handle.json_value())
-        result_handle.dispose()
-        ```
-
         Parameters
         ----------
         expression : str
@@ -3830,23 +3587,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        ```py
-        from playwright.sync_api import sync_playwright, Playwright
-
-        def run(playwright: Playwright):
-            chromium = playwright.chromium
-            browser = chromium.launch()
-            page = browser.new_page()
-            for current_url in [\"https://google.com\", \"https://bbc.com\"]:
-                page.goto(current_url, wait_until=\"domcontentloaded\")
-                element = page.main_frame.wait_for_selector(\"img\")
-                print(\"Loaded image: \" + str(element.get_attribute(\"src\")))
-            browser.close()
-
-        with sync_playwright() as playwright:
-            run(playwright)
-        ```
-
         Parameters
         ----------
         selector : str
@@ -4102,10 +3842,6 @@ async def dispatch_event(
         await frame.dispatch_event(\"button#submit\", \"click\")
         ```
 
-        ```py
-        frame.dispatch_event(\"button#submit\", \"click\")
-        ```
-
         Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
@@ -4129,12 +3865,6 @@ async def dispatch_event(
         await frame.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
         ```
 
-        ```py
-        # note you can only create data_transfer in chromium and firefox
-        data_transfer = frame.evaluate_handle(\"new DataTransfer()\")
-        frame.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
-        ```
-
         Parameters
         ----------
         selector : str
@@ -4188,12 +3918,6 @@ async def eval_on_selector(
         html = await frame.eval_on_selector(\".main-container\", \"(e, suffix) => e.outerHTML + suffix\", \"hello\")
         ```
 
-        ```py
-        search_value = frame.eval_on_selector(\"#search\", \"el => el.value\")
-        preload_href = frame.eval_on_selector(\"link[rel=preload]\", \"el => el.href\")
-        html = frame.eval_on_selector(\".main-container\", \"(e, suffix) => e.outerHTML + suffix\", \"hello\")
-        ```
-
         Parameters
         ----------
         selector : str
@@ -4240,10 +3964,6 @@ async def eval_on_selector_all(
         divs_counts = await frame.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
         ```
 
-        ```py
-        divs_counts = frame.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
-        ```
-
         Parameters
         ----------
         selector : str
@@ -4766,10 +4486,6 @@ def get_by_alt_text(
         await page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
-        ```py
-        page.get_by_alt_text(\"Playwright logo\").click()
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -4811,11 +4527,6 @@ def get_by_label(
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
-        ```py
-        page.get_by_label(\"Username\").fill(\"john\")
-        page.get_by_label(\"Password\").fill(\"secret\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -4855,10 +4566,6 @@ def get_by_placeholder(
         await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
-        ```py
-        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -5002,14 +4709,6 @@ def get_by_role(
         await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
         ```
 
-        ```py
-        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
-
-        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
-
-        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
-        ```
-
         **Details**
 
         Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
@@ -5105,10 +4804,6 @@ def get_by_test_id(
         await page.get_by_test_id(\"directions\").click()
         ```
 
-        ```py
-        page.get_by_test_id(\"directions\").click()
-        ```
-
         **Details**
 
         By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
@@ -5167,23 +4862,6 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        ```py
-        # Matches <span>
-        page.get_by_text(\"world\")
-
-        # Matches first <div>
-        page.get_by_text(\"Hello world\")
-
-        # Matches second <div>
-        page.get_by_text(\"Hello\", exact=True)
-
-        # Matches both <div>s
-        page.get_by_text(re.compile(\"Hello\"))
-
-        # Matches second <div>
-        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
-        ```
-
         **Details**
 
         Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
@@ -5231,10 +4909,6 @@ def get_by_title(
         await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
-        ```py
-        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -5266,11 +4940,6 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         await locator.click()
         ```
 
-        ```py
-        locator = frame.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
-        locator.click()
-        ```
-
         Parameters
         ----------
         selector : str
@@ -5621,15 +5290,6 @@ async def select_option(
         await frame.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
         ```
 
-        ```py
-        # Single selection matching the value or label
-        frame.select_option(\"select#colors\", \"blue\")
-        # single selection matching both the label
-        frame.select_option(\"select#colors\", label=\"blue\")
-        # multiple selection
-        frame.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
-        ```
-
         Parameters
         ----------
         selector : str
@@ -6061,21 +5721,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        ```py
-        from playwright.sync_api import sync_playwright, Playwright
-
-        def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = webkit.launch()
-            page = browser.new_page()
-            page.evaluate(\"window.x = 0; setTimeout(() => { window.x = 100 }, 1000);\")
-            page.main_frame.wait_for_function(\"() => window.x > 0\")
-            browser.close()
-
-        with sync_playwright() as playwright:
-            run(playwright)
-        ```
-
         To pass an argument to the predicate of `frame.waitForFunction` function:
 
         ```py
@@ -6083,11 +5728,6 @@ def run(playwright: Playwright):
         await frame.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
         ```
 
-        ```py
-        selector = \".foo\"
-        frame.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
-        ```
-
         Parameters
         ----------
         expression : str
@@ -6307,10 +5947,6 @@ def get_by_alt_text(
         await page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
-        ```py
-        page.get_by_alt_text(\"Playwright logo\").click()
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -6352,11 +5988,6 @@ def get_by_label(
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
-        ```py
-        page.get_by_label(\"Username\").fill(\"john\")
-        page.get_by_label(\"Password\").fill(\"secret\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -6396,10 +6027,6 @@ def get_by_placeholder(
         await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
-        ```py
-        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -6543,14 +6170,6 @@ def get_by_role(
         await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
         ```
 
-        ```py
-        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
-
-        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
-
-        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
-        ```
-
         **Details**
 
         Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
@@ -6646,10 +6265,6 @@ def get_by_test_id(
         await page.get_by_test_id(\"directions\").click()
         ```
 
-        ```py
-        page.get_by_test_id(\"directions\").click()
-        ```
-
         **Details**
 
         By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
@@ -6708,23 +6323,6 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        ```py
-        # Matches <span>
-        page.get_by_text(\"world\")
-
-        # Matches first <div>
-        page.get_by_text(\"Hello world\")
-
-        # Matches second <div>
-        page.get_by_text(\"Hello\", exact=True)
-
-        # Matches both <div>s
-        page.get_by_text(re.compile(\"Hello\"))
-
-        # Matches second <div>
-        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
-        ```
-
         **Details**
 
         Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
@@ -6772,10 +6370,6 @@ def get_by_title(
         await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
-        ```py
-        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -6985,41 +6579,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        ```py
-        from playwright.sync_api import sync_playwright, Playwright
-
-        def run(playwright: Playwright):
-            tag_selector = \"\"\"
-              {
-                  // Returns the first element matching given selector in the root's subtree.
-                  query(root, selector) {
-                      return root.querySelector(selector);
-                  },
-                  // Returns all elements matching given selector in the root's subtree.
-                  queryAll(root, selector) {
-                      return Array.from(root.querySelectorAll(selector));
-                  }
-              }\"\"\"
-
-            # Register the engine. Selectors will be prefixed with \"tag=\".
-            playwright.selectors.register(\"tag\", tag_selector)
-            browser = playwright.chromium.launch()
-            page = browser.new_page()
-            page.set_content('<div><button>Click me</button></div>')
-
-            # Use the selector prefixed with its name.
-            button = page.locator('tag=button')
-            # Combine it with built-in locators.
-            page.locator('tag=div').get_by_text('Click me').click()
-            # Can use it in any methods supporting selectors.
-            button_count = page.locator('tag=button').count()
-            print(button_count)
-            browser.close()
-
-        with sync_playwright() as playwright:
-            run(playwright)
-        ```
-
         Parameters
         ----------
         name : str
@@ -7290,10 +6849,6 @@ async def save_as(self, path: typing.Union[str, pathlib.Path]) -> None:
         await download.save_as(\"/path/to/save/at/\" + download.suggested_filename)
         ```
 
-        ```py
-        download.save_as(\"/path/to/save/at/\" + download.suggested_filename)
-        ```
-
         Parameters
         ----------
         path : Union[pathlib.Path, str]
@@ -7390,15 +6945,6 @@ async def print_args(msg):
 
         page.on(\"console\", print_args)
         await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
-        ```
-
-        ```py
-        def print_args(msg):
-            for arg in msg.args:
-                print(arg.json_value())
-
-        page.on(\"console\", print_args)
-        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```"""
 
     @typing.overload
@@ -7422,17 +6968,6 @@ def on(
         except Error as e:
             pass
             # when the page crashes, exception message contains \"crash\".
-        ```
-
-        ```py
-        try:
-            # crash might happen during a click.
-            page.click(\"button\")
-            # or while waiting for an event.
-            page.wait_for_event(\"popup\")
-        except Error as e:
-            pass
-            # when the page crashes, exception message contains \"crash\".
         ```"""
 
     @typing.overload
@@ -7545,14 +7080,6 @@ def on(
 
         # Navigate to a page with an exception.
         await page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
-        ```
-
-        ```py
-        # Log all uncaught errors to the terminal
-        page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
-
-        # Navigate to a page with an exception.
-        page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
         ```"""
 
     @typing.overload
@@ -7576,13 +7103,6 @@ def on(
         print(await popup.evaluate(\"location.href\"))
         ```
 
-        ```py
-        with page.expect_event(\"popup\") as page_info:
-            page.get_by_text(\"open the popup\").click()
-        popup = page_info.value
-        print(popup.evaluate(\"location.href\"))
-        ```
-
         **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
         need it in most cases)."""
 
@@ -7694,15 +7214,6 @@ async def print_args(msg):
 
         page.on(\"console\", print_args)
         await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
-        ```
-
-        ```py
-        def print_args(msg):
-            for arg in msg.args:
-                print(arg.json_value())
-
-        page.on(\"console\", print_args)
-        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```"""
 
     @typing.overload
@@ -7726,17 +7237,6 @@ def once(
         except Error as e:
             pass
             # when the page crashes, exception message contains \"crash\".
-        ```
-
-        ```py
-        try:
-            # crash might happen during a click.
-            page.click(\"button\")
-            # or while waiting for an event.
-            page.wait_for_event(\"popup\")
-        except Error as e:
-            pass
-            # when the page crashes, exception message contains \"crash\".
         ```"""
 
     @typing.overload
@@ -7849,14 +7349,6 @@ def once(
 
         # Navigate to a page with an exception.
         await page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
-        ```
-
-        ```py
-        # Log all uncaught errors to the terminal
-        page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
-
-        # Navigate to a page with an exception.
-        page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
         ```"""
 
     @typing.overload
@@ -7880,13 +7372,6 @@ def once(
         print(await popup.evaluate(\"location.href\"))
         ```
 
-        ```py
-        with page.expect_event(\"popup\") as page_info:
-            page.get_by_text(\"open the popup\").click()
-        popup = page_info.value
-        print(popup.evaluate(\"location.href\"))
-        ```
-
         **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
         need it in most cases)."""
 
@@ -8131,10 +7616,6 @@ def frame(
         frame = page.frame(name=\"frame-name\")
         ```
 
-        ```py
-        frame = page.frame(url=r\".*domain.*\")
-        ```
-
         Parameters
         ----------
         name : Union[str, None]
@@ -8284,23 +7765,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        ```py
-        from playwright.sync_api import sync_playwright, Playwright
-
-        def run(playwright: Playwright):
-            chromium = playwright.chromium
-            browser = chromium.launch()
-            page = browser.new_page()
-            for current_url in [\"https://google.com\", \"https://bbc.com\"]:
-                page.goto(current_url, wait_until=\"domcontentloaded\")
-                element = page.wait_for_selector(\"img\")
-                print(\"Loaded image: \" + str(element.get_attribute(\"src\")))
-            browser.close()
-
-        with sync_playwright() as playwright:
-            run(playwright)
-        ```
-
         Parameters
         ----------
         selector : str
@@ -8556,10 +8020,6 @@ async def dispatch_event(
         await page.dispatch_event(\"button#submit\", \"click\")
         ```
 
-        ```py
-        page.dispatch_event(\"button#submit\", \"click\")
-        ```
-
         Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit`
         properties and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
 
@@ -8583,12 +8043,6 @@ async def dispatch_event(
         await page.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
         ```
 
-        ```py
-        # note you can only create data_transfer in chromium and firefox
-        data_transfer = page.evaluate_handle(\"new DataTransfer()\")
-        page.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
-        ```
-
         Parameters
         ----------
         selector : str
@@ -8639,11 +8093,6 @@ async def evaluate(
         print(result) # prints \"56\"
         ```
 
-        ```py
-        result = page.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
-        print(result) # prints \"56\"
-        ```
-
         A string can also be passed in instead of a function:
 
         ```py
@@ -8652,12 +8101,6 @@ async def evaluate(
         print(await page.evaluate(f\"1 + {x}\")) # prints \"11\"
         ```
 
-        ```py
-        print(page.evaluate(\"1 + 2\")) # prints \"3\"
-        x = 10
-        print(page.evaluate(f\"1 + {x}\")) # prints \"11\"
-        ```
-
         `ElementHandle` instances can be passed as an argument to the `page.evaluate()`:
 
         ```py
@@ -8666,12 +8109,6 @@ async def evaluate(
         await body_handle.dispose()
         ```
 
-        ```py
-        body_handle = page.evaluate(\"document.body\")
-        html = page.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
-        body_handle.dispose()
-        ```
-
         Parameters
         ----------
         expression : str
@@ -8711,21 +8148,12 @@ async def evaluate_handle(
         a_window_handle # handle for the window object.
         ```
 
-        ```py
-        a_window_handle = page.evaluate_handle(\"Promise.resolve(window)\")
-        a_window_handle # handle for the window object.
-        ```
-
         A string can also be passed in instead of a function:
 
         ```py
         a_handle = await page.evaluate_handle(\"document\") # handle for the \"document\"
         ```
 
-        ```py
-        a_handle = page.evaluate_handle(\"document\") # handle for the \"document\"
-        ```
-
         `JSHandle` instances can be passed as an argument to the `page.evaluate_handle()`:
 
         ```py
@@ -8735,13 +8163,6 @@ async def evaluate_handle(
         await result_handle.dispose()
         ```
 
-        ```py
-        a_handle = page.evaluate_handle(\"document.body\")
-        result_handle = page.evaluate_handle(\"body => body.innerHTML\", a_handle)
-        print(result_handle.json_value())
-        result_handle.dispose()
-        ```
-
         Parameters
         ----------
         expression : str
@@ -8785,12 +8206,6 @@ async def eval_on_selector(
         html = await page.eval_on_selector(\".main-container\", \"(e, suffix) => e.outer_html + suffix\", \"hello\")
         ```
 
-        ```py
-        search_value = page.eval_on_selector(\"#search\", \"el => el.value\")
-        preload_href = page.eval_on_selector(\"link[rel=preload]\", \"el => el.href\")
-        html = page.eval_on_selector(\".main-container\", \"(e, suffix) => e.outer_html + suffix\", \"hello\")
-        ```
-
         Parameters
         ----------
         selector : str
@@ -8835,10 +8250,6 @@ async def eval_on_selector_all(
         div_counts = await page.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
         ```
 
-        ```py
-        div_counts = page.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
-        ```
-
         Parameters
         ----------
         selector : str
@@ -8976,35 +8387,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        ```py
-        import hashlib
-        from playwright.sync_api import sync_playwright, Playwright
-
-        def sha256(text):
-            m = hashlib.sha256()
-            m.update(bytes(text, \"utf8\"))
-            return m.hexdigest()
-
-        def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = webkit.launch(headless=False)
-            page = browser.new_page()
-            page.expose_function(\"sha256\", sha256)
-            page.set_content(\"\"\"
-                <script>
-                  async function onClick() {
-                    document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
-                  }
-                </script>
-                <button onclick=\"onClick()\">Click me</button>
-                <div></div>
-            \"\"\")
-            page.click(\"button\")
-
-        with sync_playwright() as playwright:
-            run(playwright)
-        ```
-
         Parameters
         ----------
         name : str
@@ -9070,30 +8452,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        ```py
-        from playwright.sync_api import sync_playwright, Playwright
-
-        def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = webkit.launch(headless=False)
-            context = browser.new_context()
-            page = context.new_page()
-            page.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
-            page.set_content(\"\"\"
-            <script>
-              async function onClick() {
-                document.querySelector('div').textContent = await window.pageURL();
-              }
-            </script>
-            <button onclick=\"onClick()\">Click me</button>
-            <div></div>
-            \"\"\")
-            page.click(\"button\")
-
-        with sync_playwright() as playwright:
-            run(playwright)
-        ```
-
         An example of passing an element handle:
 
         ```py
@@ -9110,20 +8468,6 @@ async def print(source, element):
         \"\"\")
         ```
 
-        ```py
-        def print(source, element):
-            print(element.text_content())
-
-        page.expose_binding(\"clicked\", print, handle=true)
-        page.set_content(\"\"\"
-          <script>
-            document.addEventListener('click', event => window.clicked(event.target));
-          </script>
-          <div>Click me</div>
-          <div>Or click me</div>
-        \"\"\")
-        ```
-
         Parameters
         ----------
         name : str
@@ -9339,11 +8683,6 @@ async def wait_for_load_state(
         await page.wait_for_load_state() # the promise resolves after \"load\" event.
         ```
 
-        ```py
-        page.get_by_role(\"button\").click() # click triggers navigation.
-        page.wait_for_load_state() # the promise resolves after \"load\" event.
-        ```
-
         ```py
         async with page.expect_popup() as page_info:
             await page.get_by_role(\"button\").click() # click triggers a popup.
@@ -9353,15 +8692,6 @@ async def wait_for_load_state(
         print(await popup.title()) # popup is ready to use.
         ```
 
-        ```py
-        with page.expect_popup() as page_info:
-            page.get_by_role(\"button\").click() # click triggers a popup.
-        popup = page_info.value
-        # Wait for the \"DOMContentLoaded\" event.
-        popup.wait_for_load_state(\"domcontentloaded\")
-        print(popup.title()) # popup is ready to use.
-        ```
-
         Parameters
         ----------
         state : Union["domcontentloaded", "load", "networkidle", None]
@@ -9402,11 +8732,6 @@ async def wait_for_url(
         await page.wait_for_url(\"**/target.html\")
         ```
 
-        ```py
-        page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
-        page.wait_for_url(\"**/target.html\")
-        ```
-
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
@@ -9588,25 +8913,6 @@ async def emulate_media(
         # → False
         ```
 
-        ```py
-        page.evaluate(\"matchMedia('screen').matches\")
-        # → True
-        page.evaluate(\"matchMedia('print').matches\")
-        # → False
-
-        page.emulate_media(media=\"print\")
-        page.evaluate(\"matchMedia('screen').matches\")
-        # → False
-        page.evaluate(\"matchMedia('print').matches\")
-        # → True
-
-        page.emulate_media()
-        page.evaluate(\"matchMedia('screen').matches\")
-        # → True
-        page.evaluate(\"matchMedia('print').matches\")
-        # → False
-        ```
-
         ```py
         await page.emulate_media(color_scheme=\"dark\")
         await page.evaluate(\"matchMedia('(prefers-color-scheme: dark)').matches\")
@@ -9617,15 +8923,6 @@ async def emulate_media(
         # → False
         ```
 
-        ```py
-        page.emulate_media(color_scheme=\"dark\")
-        page.evaluate(\"matchMedia('(prefers-color-scheme: dark)').matches\")
-        # → True
-        page.evaluate(\"matchMedia('(prefers-color-scheme: light)').matches\")
-        # → False
-        page.evaluate(\"matchMedia('(prefers-color-scheme: no-preference)').matches\")
-        ```
-
         Parameters
         ----------
         media : Union["null", "print", "screen", None]
@@ -9668,12 +8965,6 @@ async def set_viewport_size(self, viewport_size: ViewportSize) -> None:
         await page.goto(\"https://example.com\")
         ```
 
-        ```py
-        page = browser.new_page()
-        page.set_viewport_size({\"width\": 640, \"height\": 480})
-        page.goto(\"https://example.com\")
-        ```
-
         Parameters
         ----------
         viewport_size : {width: int, height: int}
@@ -9716,11 +9007,6 @@ async def add_init_script(
         await page.add_init_script(path=\"./preload.js\")
         ```
 
-        ```py
-        # in your playwright script, assuming the preload.js file is in same directory
-        page.add_init_script(path=\"./preload.js\")
-        ```
-
         **NOTE** The order of evaluation of multiple scripts installed via `browser_context.add_init_script()` and
         `page.add_init_script()` is not defined.
 
@@ -9771,13 +9057,6 @@ async def route(
         await browser.close()
         ```
 
-        ```py
-        page = browser.new_page()
-        page.route(\"**/*.{png,jpg,jpeg}\", lambda route: route.abort())
-        page.goto(\"https://example.com\")
-        browser.close()
-        ```
-
         or the same snippet using a regex pattern instead:
 
         ```py
@@ -9787,13 +9066,6 @@ async def route(
         await browser.close()
         ```
 
-        ```py
-        page = browser.new_page()
-        page.route(re.compile(r\"(\\.png$)|(\\.jpg$)\"), lambda route: route.abort())
-        page.goto(\"https://example.com\")
-        browser.close()
-        ```
-
         It is possible to examine the request to decide the route action. For example, mocking all requests that contain
         some post data, and leaving all other requests as is:
 
@@ -9806,15 +9078,6 @@ def handle_route(route):
         await page.route(\"/api/**\", handle_route)
         ```
 
-        ```py
-        def handle_route(route):
-          if (\"my-string\" in route.request.post_data):
-            route.fulfill(body=\"mocked-data\")
-          else:
-            route.continue_()
-        page.route(\"/api/**\", handle_route)
-        ```
-
         Page routes take precedence over browser context routes (set up with `browser_context.route()`) when request
         matches both handlers.
 
@@ -10459,10 +9722,6 @@ def get_by_alt_text(
         await page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
-        ```py
-        page.get_by_alt_text(\"Playwright logo\").click()
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -10504,11 +9763,6 @@ def get_by_label(
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
-        ```py
-        page.get_by_label(\"Username\").fill(\"john\")
-        page.get_by_label(\"Password\").fill(\"secret\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -10548,10 +9802,6 @@ def get_by_placeholder(
         await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
-        ```py
-        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -10695,14 +9945,6 @@ def get_by_role(
         await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
         ```
 
-        ```py
-        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
-
-        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
-
-        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
-        ```
-
         **Details**
 
         Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
@@ -10798,10 +10040,6 @@ def get_by_test_id(
         await page.get_by_test_id(\"directions\").click()
         ```
 
-        ```py
-        page.get_by_test_id(\"directions\").click()
-        ```
-
         **Details**
 
         By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
@@ -10860,23 +10098,6 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        ```py
-        # Matches <span>
-        page.get_by_text(\"world\")
-
-        # Matches first <div>
-        page.get_by_text(\"Hello world\")
-
-        # Matches second <div>
-        page.get_by_text(\"Hello\", exact=True)
-
-        # Matches both <div>s
-        page.get_by_text(re.compile(\"Hello\"))
-
-        # Matches second <div>
-        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
-        ```
-
         **Details**
 
         Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
@@ -10924,10 +10145,6 @@ def get_by_title(
         await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
-        ```py
-        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -10959,11 +10176,6 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         await locator.click()
         ```
 
-        ```py
-        locator = page.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
-        locator.click()
-        ```
-
         Parameters
         ----------
         selector : str
@@ -11245,17 +10457,6 @@ async def drag_and_drop(
         )
         ```
 
-        ```py
-        page.drag_and_drop(\"#source\", \"#target\")
-        # or specify exact positions relative to the top-left corners of the elements:
-        page.drag_and_drop(
-          \"#source\",
-          \"#target\",
-          source_position={\"x\": 34, \"y\": 7},
-          target_position={\"x\": 10, \"y\": 20}
-        )
-        ```
-
         Parameters
         ----------
         source : str
@@ -11341,15 +10542,6 @@ async def select_option(
         await page.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
         ```
 
-        ```py
-        # Single selection matching the value or label
-        page.select_option(\"select#colors\", \"blue\")
-        # single selection matching both the label
-        page.select_option(\"select#colors\", label=\"blue\")
-        # multiple selection
-        page.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
-        ```
-
         Parameters
         ----------
         selector : str
@@ -11586,18 +10778,6 @@ async def press(
         await browser.close()
         ```
 
-        ```py
-        page = browser.new_page()
-        page.goto(\"https://keycode.info\")
-        page.press(\"body\", \"A\")
-        page.screenshot(path=\"a.png\")
-        page.press(\"body\", \"ArrowLeft\")
-        page.screenshot(path=\"arrow_left.png\")
-        page.press(\"body\", \"Shift+O\")
-        page.screenshot(path=\"o.png\")
-        browser.close()
-        ```
-
         Parameters
         ----------
         selector : str
@@ -11773,11 +10953,6 @@ async def wait_for_timeout(self, timeout: float) -> None:
         await page.wait_for_timeout(1000)
         ```
 
-        ```py
-        # wait for 1 second
-        page.wait_for_timeout(1000)
-        ```
-
         Parameters
         ----------
         timeout : float
@@ -11822,21 +10997,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        ```py
-        from playwright.sync_api import sync_playwright, Playwright
-
-        def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = webkit.launch()
-            page = browser.new_page()
-            page.evaluate(\"window.x = 0; setTimeout(() => { window.x = 100 }, 1000);\")
-            page.wait_for_function(\"() => window.x > 0\")
-            browser.close()
-
-        with sync_playwright() as playwright:
-            run(playwright)
-        ```
-
         To pass an argument to the predicate of `page.wait_for_function()` function:
 
         ```py
@@ -11844,11 +11004,6 @@ def run(playwright: Playwright):
         await page.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
         ```
 
-        ```py
-        selector = \".foo\"
-        page.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
-        ```
-
         Parameters
         ----------
         expression : str
@@ -11932,12 +11087,6 @@ async def pdf(
         await page.pdf(path=\"page.pdf\")
         ```
 
-        ```py
-        # generates a pdf with \"screen\" media type.
-        page.emulate_media(media=\"screen\")
-        page.pdf(path=\"page.pdf\")
-        ```
-
         The `width`, `height`, and `margin` options accept values labeled with units. Unlabeled values are treated as
         pixels.
 
@@ -12048,12 +11197,6 @@ def expect_event(
         frame = await event_info.value
         ```
 
-        ```py
-        with page.expect_event(\"framenavigated\") as event_info:
-            page.get_by_role(\"button\")
-        frame = event_info.value
-        ```
-
         Parameters
         ----------
         event : str
@@ -12198,13 +11341,6 @@ def expect_navigation(
         # Resolves after navigation has finished
         ```
 
-        ```py
-        with page.expect_navigation():
-            # This action triggers the navigation after a timeout.
-            page.get_by_text(\"Navigate after timeout\").click()
-        # Resolves after navigation has finished
-        ```
-
         **NOTE** Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL
         is considered a navigation.
 
@@ -12296,17 +11432,6 @@ def expect_request(
         second_request = await second.value
         ```
 
-        ```py
-        with page.expect_request(\"http://example.com/resource\") as first:
-            page.get_by_text(\"trigger request\").click()
-        first_request = first.value
-
-        # or with a lambda
-        with page.expect_request(lambda request: request.url == \"http://example.com\" and request.method == \"get\") as second:
-            page.get_by_text(\"trigger request\").click()
-        second_request = second.value
-        ```
-
         Parameters
         ----------
         url_or_predicate : Union[Callable[[Request], bool], Pattern[str], str]
@@ -12387,19 +11512,6 @@ def expect_response(
         return response.ok
         ```
 
-        ```py
-        with page.expect_response(\"https://example.com/resource\") as response_info:
-            page.get_by_text(\"trigger response\").click()
-        response = response_info.value
-        return response.ok
-
-        # or with a lambda
-        with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200) as response_info:
-            page.get_by_text(\"trigger response\").click()
-        response = response_info.value
-        return response.ok
-        ```
-
         Parameters
         ----------
         url_or_predicate : Union[Callable[[Response], bool], Pattern[str], str]
@@ -12598,10 +11710,6 @@ def on(
 
         ```py
         background_page = await context.wait_for_event(\"backgroundpage\")
-        ```
-
-        ```py
-        background_page = context.wait_for_event(\"backgroundpage\")
         ```"""
 
     @typing.overload
@@ -12643,15 +11751,6 @@ async def print_args(msg):
 
         context.on(\"console\", print_args)
         await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
-        ```
-
-        ```py
-        def print_args(msg):
-            for arg in msg.args:
-                print(arg.json_value())
-
-        context.on(\"console\", print_args)
-        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```"""
 
     @typing.overload
@@ -12697,13 +11796,6 @@ def on(
         print(await page.evaluate(\"location.href\"))
         ```
 
-        ```py
-        with context.expect_page() as page_info:
-            page.get_by_text(\"open new page\").click(),
-        page = page_info.value
-        print(page.evaluate(\"location.href\"))
-        ```
-
         **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
         need it in most cases)."""
 
@@ -12797,10 +11889,6 @@ def once(
 
         ```py
         background_page = await context.wait_for_event(\"backgroundpage\")
-        ```
-
-        ```py
-        background_page = context.wait_for_event(\"backgroundpage\")
         ```"""
 
     @typing.overload
@@ -12842,15 +11930,6 @@ async def print_args(msg):
 
         context.on(\"console\", print_args)
         await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
-        ```
-
-        ```py
-        def print_args(msg):
-            for arg in msg.args:
-                print(arg.json_value())
-
-        context.on(\"console\", print_args)
-        page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
         ```"""
 
     @typing.overload
@@ -12896,13 +11975,6 @@ def once(
         print(await page.evaluate(\"location.href\"))
         ```
 
-        ```py
-        with context.expect_page() as page_info:
-            page.get_by_text(\"open new page\").click(),
-        page = page_info.value
-        print(page.evaluate(\"location.href\"))
-        ```
-
         **NOTE** Use `page.wait_for_load_state()` to wait until the page gets to a particular state (you should not
         need it in most cases)."""
 
@@ -13146,10 +12218,6 @@ async def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
         await browser_context.add_cookies([cookie_object1, cookie_object2])
         ```
 
-        ```py
-        browser_context.add_cookies([cookie_object1, cookie_object2])
-        ```
-
         Parameters
         ----------
         cookies : Sequence[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
@@ -13220,13 +12288,6 @@ async def clear_permissions(self) -> None:
         # do stuff ..
         context.clear_permissions()
         ```
-
-        ```py
-        context = browser.new_context()
-        context.grant_permissions([\"clipboard-read\"])
-        # do stuff ..
-        context.clear_permissions()
-        ```
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.clear_permissions())
@@ -13244,10 +12305,6 @@ async def set_geolocation(
         await browser_context.set_geolocation({\"latitude\": 59.95, \"longitude\": 30.31667})
         ```
 
-        ```py
-        browser_context.set_geolocation({\"latitude\": 59.95, \"longitude\": 30.31667})
-        ```
-
         **NOTE** Consider using `browser_context.grant_permissions()` to grant permissions for the browser context
         pages to read its geolocation.
 
@@ -13320,11 +12377,6 @@ async def add_init_script(
         await browser_context.add_init_script(path=\"preload.js\")
         ```
 
-        ```py
-        # in your playwright script, assuming the preload.js file is in same directory.
-        browser_context.add_init_script(path=\"preload.js\")
-        ```
-
         **NOTE** The order of evaluation of multiple scripts installed via `browser_context.add_init_script()` and
         `page.add_init_script()` is not defined.
 
@@ -13390,30 +12442,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        ```py
-        from playwright.sync_api import sync_playwright, Playwright
-
-        def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = webkit.launch(headless=False)
-            context = browser.new_context()
-            context.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
-            page = context.new_page()
-            page.set_content(\"\"\"
-            <script>
-              async function onClick() {
-                document.querySelector('div').textContent = await window.pageURL();
-              }
-            </script>
-            <button onclick=\"onClick()\">Click me</button>
-            <div></div>
-            \"\"\")
-            page.get_by_role(\"button\").click()
-
-        with sync_playwright() as playwright:
-            run(playwright)
-        ```
-
         An example of passing an element handle:
 
         ```py
@@ -13430,20 +12458,6 @@ async def print(source, element):
         \"\"\")
         ```
 
-        ```py
-        def print(source, element):
-            print(element.text_content())
-
-        context.expose_binding(\"clicked\", print, handle=true)
-        page.set_content(\"\"\"
-          <script>
-            document.addEventListener('click', event => window.clicked(event.target));
-          </script>
-          <div>Click me</div>
-          <div>Or click me</div>
-        \"\"\")
-        ```
-
         Parameters
         ----------
         name : str
@@ -13508,36 +12522,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        ```py
-        import hashlib
-        from playwright.sync_api import sync_playwright
-
-        def sha256(text: str) -> str:
-            m = hashlib.sha256()
-            m.update(bytes(text, \"utf8\"))
-            return m.hexdigest()
-
-        def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = webkit.launch(headless=False)
-            context = browser.new_context()
-            context.expose_function(\"sha256\", sha256)
-            page = context.new_page()
-            page.set_content(\"\"\"
-                <script>
-                  async function onClick() {
-                    document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
-                  }
-                </script>
-                <button onclick=\"onClick()\">Click me</button>
-                <div></div>
-            \"\"\")
-            page.get_by_role(\"button\").click()
-
-        with sync_playwright() as playwright:
-            run(playwright)
-        ```
-
         Parameters
         ----------
         name : str
@@ -13583,14 +12567,6 @@ async def route(
         await browser.close()
         ```
 
-        ```py
-        context = browser.new_context()
-        page = context.new_page()
-        context.route(\"**/*.{png,jpg,jpeg}\", lambda route: route.abort())
-        page.goto(\"https://example.com\")
-        browser.close()
-        ```
-
         or the same snippet using a regex pattern instead:
 
         ```py
@@ -13602,16 +12578,6 @@ async def route(
         await browser.close()
         ```
 
-        ```py
-        context = browser.new_context()
-        page = context.new_page()
-        context.route(re.compile(r\"(\\.png$)|(\\.jpg$)\"), lambda route: route.abort())
-        page = await context.new_page()
-        page = context.new_page()
-        page.goto(\"https://example.com\")
-        browser.close()
-        ```
-
         It is possible to examine the request to decide the route action. For example, mocking all requests that contain
         some post data, and leaving all other requests as is:
 
@@ -13624,15 +12590,6 @@ def handle_route(route):
         await context.route(\"/api/**\", handle_route)
         ```
 
-        ```py
-        def handle_route(route):
-          if (\"my-string\" in route.request.post_data):
-            route.fulfill(body=\"mocked-data\")
-          else:
-            route.continue_()
-        context.route(\"/api/**\", handle_route)
-        ```
-
         Page routes (set up with `page.route()`) take precedence over browser context routes when request matches
         both handlers.
 
@@ -13789,12 +12746,6 @@ def expect_event(
         page = await event_info.value
         ```
 
-        ```py
-        with context.expect_event(\"page\") as event_info:
-            page.get_by_role(\"button\").click()
-        page = event_info.value
-        ```
-
         Parameters
         ----------
         event : str
@@ -14051,13 +13002,6 @@ def contexts(self) -> typing.List["BrowserContext"]:
         print(len(browser.contexts())) # prints `1`
         ```
 
-        ```py
-        browser = pw.webkit.launch()
-        print(len(browser.contexts())) # prints `0`
-        context = browser.new_context()
-        print(len(browser.contexts())) # prints `1`
-        ```
-
         Returns
         -------
         List[BrowserContext]
@@ -14170,19 +13114,6 @@ async def new_context(
         await browser.close()
         ```
 
-        ```py
-        browser = playwright.firefox.launch() # or \"chromium\" or \"webkit\".
-        # create a new incognito browser context.
-        context = browser.new_context()
-        # create a new page in a pristine context.
-        page = context.new_page()
-        page.goto(\"https://example.com\")
-
-        # gracefully close up everything
-        context.close()
-        browser.close()
-        ```
-
         Parameters
         ----------
         viewport : Union[{width: int, height: int}, None]
@@ -14620,12 +13551,6 @@ async def start_tracing(
         await browser.stop_tracing()
         ```
 
-        ```py
-        browser.start_tracing(page, path=\"trace.json\")
-        page.goto(\"https://www.google.com\")
-        browser.stop_tracing()
-        ```
-
         Parameters
         ----------
         page : Union[Page, None]
@@ -14732,12 +13657,6 @@ async def launch(
         )
         ```
 
-        ```py
-        browser = playwright.chromium.launch( # or \"firefox\" or \"webkit\".
-            ignore_default_args=[\"--mute-audio\"]
-        )
-        ```
-
         > **Chromium-only** Playwright can also be used to control the Google Chrome or Microsoft Edge browsers, but it
         works best with the version of Chromium it is bundled with. There is no guarantee it will work with any other
         version. Use `executablePath` option with extreme caution.
@@ -15149,12 +14068,6 @@ async def connect_over_cdp(
         page = default_context.pages[0]
         ```
 
-        ```py
-        browser = playwright.chromium.connect_over_cdp(\"http://localhost:9222\")
-        default_context = browser.contexts[0]
-        page = default_context.pages[0]
-        ```
-
         Parameters
         ----------
         endpoint_url : str
@@ -15270,23 +14183,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        ```py
-        from playwright.sync_api import sync_playwright, Playwright
-
-        def run(playwright: Playwright):
-            webkit = playwright.webkit
-            iphone = playwright.devices[\"iPhone 6\"]
-            browser = webkit.launch()
-            context = browser.new_context(**iphone)
-            page = context.new_page()
-            page.goto(\"http://example.com\")
-            # other actions...
-            browser.close()
-
-        with sync_playwright() as playwright:
-            run(playwright)
-        ```
-
         Returns
         -------
         Dict
@@ -15407,13 +14303,6 @@ async def start(
         await context.tracing.stop(path = \"trace.zip\")
         ```
 
-        ```py
-        context.tracing.start(screenshots=True, snapshots=True)
-        page = context.new_page()
-        page.goto(\"https://playwright.dev\")
-        context.tracing.stop(path = \"trace.zip\")
-        ```
-
         Parameters
         ----------
         name : Union[str, None]
@@ -15469,22 +14358,6 @@ async def start_chunk(
         await context.tracing.stop_chunk(path = \"trace2.zip\")
         ```
 
-        ```py
-        context.tracing.start(screenshots=True, snapshots=True)
-        page = context.new_page()
-        page.goto(\"https://playwright.dev\")
-
-        context.tracing.start_chunk()
-        page.get_by_text(\"Get Started\").click()
-        # Everything between start_chunk and stop_chunk will be recorded in the trace.
-        context.tracing.stop_chunk(path = \"trace1.zip\")
-
-        context.tracing.start_chunk()
-        page.goto(\"http://example.com\")
-        # Save a second trace file with different actions.
-        context.tracing.stop_chunk(path = \"trace2.zip\")
-        ```
-
         Parameters
         ----------
         title : Union[str, None]
@@ -15570,10 +14443,6 @@ def last(self) -> "Locator":
         banana = await page.get_by_role(\"listitem\").last
         ```
 
-        ```py
-        banana = page.get_by_role(\"listitem\").last
-        ```
-
         Returns
         -------
         Locator
@@ -15608,11 +14477,6 @@ async def bounding_box(
         await page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
         ```
 
-        ```py
-        box = page.get_by_role(\"button\").bounding_box()
-        page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -15663,10 +14527,6 @@ async def check(
         await page.get_by_role(\"checkbox\").check()
         ```
 
-        ```py
-        page.get_by_role(\"checkbox\").check()
-        ```
-
         Parameters
         ----------
         position : Union[{x: float, y: float}, None]
@@ -15736,10 +14596,6 @@ async def click(
         await page.get_by_role(\"button\").click()
         ```
 
-        ```py
-        page.get_by_role(\"button\").click()
-        ```
-
         Shift-right-click at a specific position on a canvas:
 
         ```py
@@ -15748,12 +14604,6 @@ async def click(
         )
         ```
 
-        ```py
-        page.locator(\"canvas\").click(
-            button=\"right\", modifiers=[\"Shift\"], position={\"x\": 23, \"y\": 32}
-        )
-        ```
-
         Parameters
         ----------
         modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
@@ -15886,10 +14736,6 @@ async def dispatch_event(
         await locator.dispatch_event(\"click\")
         ```
 
-        ```py
-        locator.dispatch_event(\"click\")
-        ```
-
         **Details**
 
         The snippet above dispatches the `click` event on the element. Regardless of the visibility state of the element,
@@ -15919,12 +14765,6 @@ async def dispatch_event(
         await locator.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
         ```
 
-        ```py
-        # note you can only create data_transfer in chromium and firefox
-        data_transfer = page.evaluate_handle(\"new DataTransfer()\")
-        locator.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
-        ```
-
         Parameters
         ----------
         type : str
@@ -15969,11 +14809,6 @@ async def evaluate(
         assert await tweets.evaluate(\"node => node.innerText\") == \"10 retweets\"
         ```
 
-        ```py
-        tweets = page.locator(\".tweet .retweets\")
-        assert tweets.evaluate(\"node => node.innerText\") == \"10 retweets\"
-        ```
-
         Parameters
         ----------
         expression : str
@@ -16019,11 +14854,6 @@ async def evaluate_all(
         more_than_ten = await locator.evaluate_all(\"(divs, min) => divs.length > min\", 10)
         ```
 
-        ```py
-        locator = page.locator(\"div\")
-        more_than_ten = locator.evaluate_all(\"(divs, min) => divs.length > min\", 10)
-        ```
-
         Parameters
         ----------
         expression : str
@@ -16109,10 +14939,6 @@ async def fill(
         await page.get_by_role(\"textbox\").fill(\"example value\")
         ```
 
-        ```py
-        page.get_by_role(\"textbox\").fill(\"example value\")
-        ```
-
         **Details**
 
         This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, fills it and triggers an
@@ -16173,10 +14999,6 @@ async def clear(
         await page.get_by_role(\"textbox\").clear()
         ```
 
-        ```py
-        page.get_by_role(\"textbox\").clear()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16276,10 +15098,6 @@ def get_by_alt_text(
         await page.get_by_alt_text(\"Playwright logo\").click()
         ```
 
-        ```py
-        page.get_by_alt_text(\"Playwright logo\").click()
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -16321,11 +15139,6 @@ def get_by_label(
         await page.get_by_label(\"Password\").fill(\"secret\")
         ```
 
-        ```py
-        page.get_by_label(\"Username\").fill(\"john\")
-        page.get_by_label(\"Password\").fill(\"secret\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -16365,10 +15178,6 @@ def get_by_placeholder(
         await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
 
-        ```py
-        page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -16512,14 +15321,6 @@ def get_by_role(
         await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
         ```
 
-        ```py
-        expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
-
-        page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
-
-        page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
-        ```
-
         **Details**
 
         Role selector **does not replace** accessibility audits and conformance tests, but rather gives early feedback
@@ -16615,10 +15416,6 @@ def get_by_test_id(
         await page.get_by_test_id(\"directions\").click()
         ```
 
-        ```py
-        page.get_by_test_id(\"directions\").click()
-        ```
-
         **Details**
 
         By default, the `data-testid` attribute is used as a test id. Use `selectors.set_test_id_attribute()` to
@@ -16677,23 +15474,6 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        ```py
-        # Matches <span>
-        page.get_by_text(\"world\")
-
-        # Matches first <div>
-        page.get_by_text(\"Hello world\")
-
-        # Matches second <div>
-        page.get_by_text(\"Hello\", exact=True)
-
-        # Matches both <div>s
-        page.get_by_text(re.compile(\"Hello\"))
-
-        # Matches second <div>
-        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
-        ```
-
         **Details**
 
         Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
@@ -16741,10 +15521,6 @@ def get_by_title(
         await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
 
-        ```py
-        expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
-        ```
-
         Parameters
         ----------
         text : Union[Pattern[str], str]
@@ -16773,11 +15549,6 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         await locator.click()
         ```
 
-        ```py
-        locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
-        locator.click()
-        ```
-
         Parameters
         ----------
         selector : str
@@ -16834,10 +15605,6 @@ def nth(self, index: int) -> "Locator":
         banana = await page.get_by_role(\"listitem\").nth(2)
         ```
 
-        ```py
-        banana = page.get_by_role(\"listitem\").nth(2)
-        ```
-
         Parameters
         ----------
         index : int
@@ -16873,14 +15640,6 @@ def filter(
 
         ```
 
-        ```py
-        row_locator = page.locator(\"tr\")
-        # ...
-        row_locator.filter(has_text=\"text in column 1\").filter(
-            has=page.get_by_role(\"button\", name=\"column 2 button\")
-        ).screenshot()
-        ```
-
         Parameters
         ----------
         has_text : Union[Pattern[str], str, None]
@@ -16939,15 +15698,6 @@ def or_(self, locator: "Locator") -> "Locator":
         await new_email.click()
         ```
 
-        ```py
-        new_email = page.get_by_role(\"button\", name=\"New\")
-        dialog = page.get_by_text(\"Confirm security settings\")
-        expect(new_email.or_(dialog)).to_be_visible()
-        if (dialog.is_visible()):
-          page.get_by_role(\"button\", name=\"Dismiss\").click()
-        new_email.click()
-        ```
-
         Parameters
         ----------
         locator : Locator
@@ -16973,10 +15723,6 @@ def and_(self, locator: "Locator") -> "Locator":
         button = page.get_by_role(\"button\").and_(page.getByTitle(\"Subscribe\"))
         ```
 
-        ```py
-        button = page.get_by_role(\"button\").and_(page.getByTitle(\"Subscribe\"))
-        ```
-
         Parameters
         ----------
         locator : Locator
@@ -17035,11 +15781,6 @@ async def all(self) -> typing.List["Locator"]:
           await li.click();
         ```
 
-        ```py
-        for li in page.get_by_role('listitem').all():
-          li.click();
-        ```
-
         Returns
         -------
         List[Locator]
@@ -17061,10 +15802,6 @@ async def count(self) -> int:
         count = await page.get_by_role(\"listitem\").count()
         ```
 
-        ```py
-        count = page.get_by_role(\"listitem\").count()
-        ```
-
         Returns
         -------
         int
@@ -17107,19 +15844,6 @@ async def drag_to(
         )
         ```
 
-        ```py
-        source = page.locator(\"#source\")
-        target = page.locator(\"#target\")
-
-        source.drag_to(target)
-        # or specify exact positions relative to the top-left corners of the elements:
-        source.drag_to(
-          target,
-          source_position={\"x\": 34, \"y\": 7},
-          target_position={\"x\": 10, \"y\": 20}
-        )
-        ```
-
         Parameters
         ----------
         target : Locator
@@ -17205,10 +15929,6 @@ async def hover(
         await page.get_by_role(\"link\").hover()
         ```
 
-        ```py
-        page.get_by_role(\"link\").hover()
-        ```
-
         **Details**
 
         This method hovers over the element by performing the following steps:
@@ -17308,10 +16028,6 @@ async def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
         value = await page.get_by_role(\"textbox\").input_value()
         ```
 
-        ```py
-        value = page.get_by_role(\"textbox\").input_value()
-        ```
-
         **Details**
 
         Throws elements that are not an input, textarea or a select. However, if the element is inside the `<label>`
@@ -17348,10 +16064,6 @@ async def is_checked(self, *, timeout: typing.Optional[float] = None) -> bool:
         checked = await page.get_by_role(\"checkbox\").is_checked()
         ```
 
-        ```py
-        checked = page.get_by_role(\"checkbox\").is_checked()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17379,10 +16091,6 @@ async def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
         disabled = await page.get_by_role(\"button\").is_disabled()
         ```
 
-        ```py
-        disabled = page.get_by_role(\"button\").is_disabled()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17412,10 +16120,6 @@ async def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
         editable = await page.get_by_role(\"textbox\").is_editable()
         ```
 
-        ```py
-        editable = page.get_by_role(\"textbox\").is_editable()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17445,10 +16149,6 @@ async def is_enabled(self, *, timeout: typing.Optional[float] = None) -> bool:
         enabled = await page.get_by_role(\"button\").is_enabled()
         ```
 
-        ```py
-        enabled = page.get_by_role(\"button\").is_enabled()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17476,10 +16176,6 @@ async def is_hidden(self, *, timeout: typing.Optional[float] = None) -> bool:
         hidden = await page.get_by_role(\"button\").is_hidden()
         ```
 
-        ```py
-        hidden = page.get_by_role(\"button\").is_hidden()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17506,10 +16202,6 @@ async def is_visible(self, *, timeout: typing.Optional[float] = None) -> bool:
         visible = await page.get_by_role(\"button\").is_visible()
         ```
 
-        ```py
-        visible = page.get_by_role(\"button\").is_visible()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -17540,10 +16232,6 @@ async def press(
         await page.get_by_role(\"textbox\").press(\"Backspace\")
         ```
 
-        ```py
-        page.get_by_role(\"textbox\").press(\"Backspace\")
-        ```
-
         **Details**
 
         Focuses the element, and then uses `keyboard.down()` and `keyboard.up()`.
@@ -17613,20 +16301,12 @@ async def screenshot(
         await page.get_by_role(\"link\").screenshot()
         ```
 
-        ```py
-        page.get_by_role(\"link\").screenshot()
-        ```
-
         Disable animations and save screenshot to a file:
 
         ```py
         await page.get_by_role(\"link\").screenshot(animations=\"disabled\", path=\"link.png\")
         ```
 
-        ```py
-        page.get_by_role(\"link\").screenshot(animations=\"disabled\", path=\"link.png\")
-        ```
-
         **Details**
 
         This method captures a screenshot of the page, clipped to the size and position of a particular element matching
@@ -17772,15 +16452,6 @@ async def select_option(
         await element.select_option(value=[\"red\", \"green\", \"blue\"])
         ```
 
-        ```py
-        # single selection matching the value or label
-        element.select_option(\"blue\")
-        # single selection matching the label
-        element.select_option(label=\"blue\")
-        # multiple selection for blue, red and second option
-        element.select_option(value=[\"red\", \"green\", \"blue\"])
-        ```
-
         Parameters
         ----------
         value : Union[Sequence[str], str, None]
@@ -17885,24 +16556,6 @@ async def set_input_files(
         )
         ```
 
-        ```py
-        # Select one file
-        page.get_by_label(\"Upload file\").set_input_files('myfile.pdf')
-
-        # Select multiple files
-        page.get_by_label(\"Upload files\").set_input_files(['file1.txt', 'file2.txt'])
-
-        # Remove all the selected files
-        page.get_by_label(\"Upload file\").set_input_files([])
-
-        # Upload buffer from memory
-        page.get_by_label(\"Upload file\").set_input_files(
-            files=[
-                {\"name\": \"test.txt\", \"mimeType\": \"text/plain\", \"buffer\": b\"this is a test\"}
-            ],
-        )
-        ```
-
         **Details**
 
         Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
@@ -18083,11 +16736,6 @@ async def press_sequentially(
         await locator.press_sequentially(\"world\", delay=100) # types slower, like a user
         ```
 
-        ```py
-        locator.press_sequentially(\"hello\") # types instantly
-        locator.press_sequentially(\"world\", delay=100) # types slower, like a user
-        ```
-
         An example of typing into a text field and then submitting the form:
 
         ```py
@@ -18096,12 +16744,6 @@ async def press_sequentially(
         await locator.press(\"Enter\")
         ```
 
-        ```py
-        locator = page.get_by_label(\"Password\")
-        locator.press_sequentially(\"my password\")
-        locator.press(\"Enter\")
-        ```
-
         Parameters
         ----------
         text : str
@@ -18142,10 +16784,6 @@ async def uncheck(
         await page.get_by_role(\"checkbox\").uncheck()
         ```
 
-        ```py
-        page.get_by_role(\"checkbox\").uncheck()
-        ```
-
         **Details**
 
         This method unchecks the element by performing the following steps:
@@ -18205,10 +16843,6 @@ async def all_inner_texts(self) -> typing.List[str]:
         texts = await page.get_by_role(\"link\").all_inner_texts()
         ```
 
-        ```py
-        texts = page.get_by_role(\"link\").all_inner_texts()
-        ```
-
         Returns
         -------
         List[str]
@@ -18230,10 +16864,6 @@ async def all_text_contents(self) -> typing.List[str]:
         texts = await page.get_by_role(\"link\").all_text_contents()
         ```
 
-        ```py
-        texts = page.get_by_role(\"link\").all_text_contents()
-        ```
-
         Returns
         -------
         List[str]
@@ -18263,11 +16893,6 @@ async def wait_for(
         await order_sent.wait_for()
         ```
 
-        ```py
-        order_sent = page.locator(\"#order-sent\")
-        order_sent.wait_for()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -18307,10 +16932,6 @@ async def set_checked(
         await page.get_by_role(\"checkbox\").set_checked(True)
         ```
 
-        ```py
-        page.get_by_role(\"checkbox\").set_checked(True)
-        ```
-
         **Details**
 
         This method checks or unchecks an element by performing the following steps:
@@ -18948,14 +17569,6 @@ async def post(
         `application/x-www-form-urlencoded` encoding (see below how to use `multipart/form-data` form encoding to send
         files):
 
-        ```python
-        formData = {
-            \"title\": \"Book Title\",
-            \"body\": \"John Doe\",
-        }
-        api_request_context.post(\"https://example.com/api/findBook\", form=formData)
-        ```
-
         The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
         encoding. You can achieve that with Playwright API like this:
 
@@ -19063,19 +17676,6 @@ async def fetch(
         The common way to send file(s) in the body of a request is to encode it as form fields with `multipart/form-data`
         encoding. You can achieve that with Playwright API like this:
 
-        ```python
-        api_request_context.fetch(
-          \"https://example.com/api/uploadScrip'\",
-          method=\"post\",
-          multipart={
-            \"fileField\": {
-              \"name\": \"f.js\",
-              \"mimeType\": \"text/javascript\",
-              \"buffer\": b\"console.log(2022);\",
-            },
-          })
-        ```
-
         Parameters
         ----------
         url_or_request : Union[Request, str]
@@ -19252,14 +17852,6 @@ async def to_have_title(
         await expect(page).to_have_title(re.compile(r\".*checkout\"))
         ```
 
-        ```py
-        import re
-        from playwright.sync_api import expect
-
-        # ...
-        expect(page).to_have_title(re.compile(r\".*checkout\"))
-        ```
-
         Parameters
         ----------
         title_or_reg_exp : Union[Pattern[str], str]
@@ -19320,14 +17912,6 @@ async def to_have_url(
         await expect(page).to_have_url(re.compile(\".*checkout\"))
         ```
 
-        ```py
-        import re
-        from playwright.sync_api import expect
-
-        # ...
-        expect(page).to_have_url(re.compile(\".*checkout\"))
-        ```
-
         Parameters
         ----------
         url_or_reg_exp : Union[Pattern[str], str]
@@ -19408,15 +17992,6 @@ async def to_contain_text(
         await expect(locator).to_contain_text(re.compile(r\"\\d messages\"))
         ```
 
-        ```py
-        import re
-        from playwright.sync_api import expect
-
-        locator = page.locator('.title')
-        expect(locator).to_contain_text(\"substring\")
-        expect(locator).to_contain_text(re.compile(r\"\\d messages\"))
-        ```
-
         If you pass an array as an expected value, the expectations are:
         1. Locator resolves to a list of elements.
         1. Elements from a **subset** of this list contain text from the expected array, respectively.
@@ -19451,22 +18026,6 @@ async def to_contain_text(
         await expect(page.locator(\"ul\")).to_contain_text([\"Text 3\"])
         ```
 
-        ```py
-        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\"])
-
-        # ✖ Wrong order
-        expect(page.locator(\"ul > li\")).to_contain_text([\"Text 3\", \"Text 2\"])
-
-        # ✖ No item contains this text
-        expect(page.locator(\"ul > li\")).to_contain_text([\"Some 33\"])
-
-        # ✖ Locator points to the outer list element, not to the list items
-        expect(page.locator(\"ul\")).to_contain_text([\"Text 3\"])
-        ```
-
         Parameters
         ----------
         expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
@@ -19552,13 +18111,6 @@ async def to_have_attribute(
         await expect(locator).to_have_attribute(\"type\", \"text\")
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator(\"input\")
-        expect(locator).to_have_attribute(\"type\", \"text\")
-        ```
-
         Parameters
         ----------
         name : str
@@ -19642,14 +18194,6 @@ async def to_have_class(
         await expect(locator).to_have_class(\"selected row\")
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator(\"#component\")
-        expect(locator).to_have_class(re.compile(r\"selected\"))
-        expect(locator).to_have_class(\"selected row\")
-        ```
-
         Note that if array is passed as an expected value, entire lists of elements can be asserted:
 
         ```py
@@ -19659,13 +18203,6 @@ async def to_have_class(
         await expect(locator).to_have_class([\"component\", \"component selected\", \"component\"])
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator(\"list > .component\")
-        expect(locator).to_have_class([\"component\", \"component selected\", \"component\"])
-        ```
-
         Parameters
         ----------
         expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
@@ -19728,13 +18265,6 @@ async def to_have_count(
         await expect(locator).to_have_count(3)
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator(\"list > .component\")
-        expect(locator).to_have_count(3)
-        ```
-
         Parameters
         ----------
         count : int
@@ -19788,13 +18318,6 @@ async def to_have_css(
         await expect(locator).to_have_css(\"display\", \"flex\")
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.get_by_role(\"button\")
-        expect(locator).to_have_css(\"display\", \"flex\")
-        ```
-
         Parameters
         ----------
         name : str
@@ -19857,13 +18380,6 @@ async def to_have_id(
         await expect(locator).to_have_id(\"lastname\")
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.get_by_role(\"textbox\")
-        expect(locator).to_have_id(\"lastname\")
-        ```
-
         Parameters
         ----------
         id : Union[Pattern[str], str]
@@ -19917,13 +18433,6 @@ async def to_have_js_property(
         await expect(locator).to_have_js_property(\"loaded\", True)
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator(\".component\")
-        expect(locator).to_have_js_property(\"loaded\", True)
-        ```
-
         Parameters
         ----------
         name : str
@@ -19986,14 +18495,6 @@ async def to_have_value(
         await expect(locator).to_have_value(re.compile(r\"[0-9]\"))
         ```
 
-        ```py
-        import re
-        from playwright.sync_api import expect
-
-        locator = page.locator(\"input[type=number]\")
-        expect(locator).to_have_value(re.compile(r\"[0-9]\"))
-        ```
-
         Parameters
         ----------
         value : Union[Pattern[str], str]
@@ -20066,15 +18567,6 @@ async def to_have_values(
         await expect(locator).to_have_values([re.compile(r\"R\"), re.compile(r\"G\")])
         ```
 
-        ```py
-        import re
-        from playwright.sync_api import expect
-
-        locator = page.locator(\"id=favorite-colors\")
-        locator.select_option([\"R\", \"G\"])
-        expect(locator).to_have_values([re.compile(r\"R\"), re.compile(r\"G\")])
-        ```
-
         Parameters
         ----------
         values : Union[Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str]]
@@ -20154,15 +18646,6 @@ async def to_have_text(
         await expect(locator).to_have_text(re.compile(r\"Welcome, .*\"))
         ```
 
-        ```py
-        import re
-        from playwright.sync_api import expect
-
-        locator = page.locator(\".title\")
-        expect(locator).to_have_text(re.compile(r\"Welcome, Test User\"))
-        expect(locator).to_have_text(re.compile(r\"Welcome, .*\"))
-        ```
-
         If you pass an array as an expected value, the expectations are:
         1. Locator resolves to a list of elements.
         1. The number of elements equals the number of expected values in the array.
@@ -20196,22 +18679,6 @@ async def to_have_text(
         await expect(page.locator(\"ul\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        # ✓ Has the right items in the right order
-        expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
-
-        # ✖ Wrong order
-        expect(page.locator(\"ul > li\")).to_have_text([\"Text 3\", \"Text 2\", \"Text 1\"])
-
-        # ✖ Last item does not match
-        expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text\"])
-
-        # ✖ Locator points to the outer list element, not to the list items
-        expect(page.locator(\"ul\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
-        ```
-
         Parameters
         ----------
         expected : Union[Pattern[str], Sequence[Pattern[str]], Sequence[Union[Pattern[str], str]], Sequence[str], str]
@@ -20293,10 +18760,6 @@ async def to_be_attached(
         await expect(page.get_by_text(\"Hidden text\")).to_be_attached()
         ```
 
-        ```py
-        expect(page.get_by_text(\"Hidden text\")).to_be_attached()
-        ```
-
         Parameters
         ----------
         attached : Union[bool, None]
@@ -20328,13 +18791,6 @@ async def to_be_checked(
         await expect(locator).to_be_checked()
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.get_by_label(\"Subscribe to newsletter\")
-        expect(locator).to_be_checked()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -20405,13 +18861,6 @@ async def to_be_disabled(self, *, timeout: typing.Optional[float] = None) -> Non
         await expect(locator).to_be_disabled()
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator(\"button.submit\")
-        expect(locator).to_be_disabled()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -20460,13 +18909,6 @@ async def to_be_editable(
         await expect(locator).to_be_editable()
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.get_by_role(\"textbox\")
-        expect(locator).to_be_editable()
-        ```
-
         Parameters
         ----------
         editable : Union[bool, None]
@@ -20515,13 +18957,6 @@ async def to_be_empty(self, *, timeout: typing.Optional[float] = None) -> None:
         await expect(locator).to_be_empty()
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator(\"div.warning\")
-        expect(locator).to_be_empty()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -20568,13 +19003,6 @@ async def to_be_enabled(
         await expect(locator).to_be_enabled()
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator(\"button.submit\")
-        expect(locator).to_be_enabled()
-        ```
-
         Parameters
         ----------
         enabled : Union[bool, None]
@@ -20624,13 +19052,6 @@ async def to_be_hidden(self, *, timeout: typing.Optional[float] = None) -> None:
         await expect(locator).to_be_hidden()
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.locator('.my-element')
-        expect(locator).to_be_hidden()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -20687,21 +19108,6 @@ async def to_be_visible(
         ).to_be_visible()
         ```
 
-        ```py
-        # A specific element is visible.
-        expect(page.get_by_text(\"Welcome\")).to_be_visible()
-
-        # At least one item in the list is visible.
-        expect(page.get_by_test_id(\"todo-item\").first).to_be_visible()
-
-        # At least one of the two elements is visible, possibly both.
-        expect(
-            page.get_by_role(\"button\", name=\"Sign in\")
-            .or_(page.get_by_role(\"button\", name=\"Sign up\"))
-            .first
-        ).to_be_visible()
-        ```
-
         Parameters
         ----------
         visible : Union[bool, None]
@@ -20750,13 +19156,6 @@ async def to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None
         await expect(locator).to_be_focused()
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.get_by_role(\"textbox\")
-        expect(locator).to_be_focused()
-        ```
-
         Parameters
         ----------
         timeout : Union[float, None]
@@ -20811,18 +19210,6 @@ async def to_be_in_viewport(
         await expect(locator).to_be_in_viewport(ratio=0.5)
         ```
 
-        ```py
-        from playwright.sync_api import expect
-
-        locator = page.get_by_role(\"button\")
-        # Make sure at least some part of element intersects viewport.
-        expect(locator).to_be_in_viewport()
-        # Make sure element is fully outside of viewport.
-        expect(locator).not_to_be_in_viewport()
-        # Make sure that at least half of the element intersects viewport.
-        expect(locator).to_be_in_viewport(ratio=0.5)
-        ```
-
         Parameters
         ----------
         ratio : Union[float, None]
@@ -20877,14 +19264,6 @@ async def to_be_ok(self) -> None:
         # ...
         await expect(response).to_be_ok()
         ```
-
-        ```py
-        import re
-        from playwright.sync_api import expect
-
-        # ...
-        expect(response).to_be_ok()
-        ```
         """
         __tracebackhide__ = True
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index d64175f4f..34e54b313 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -205,11 +205,6 @@ def redirected_from(self) -> typing.Optional["Request"]:
 
         For example, if the website `http://example.com` redirects to `https://example.com`:
 
-        ```py
-        response = await page.goto(\"http://example.com\")
-        print(response.request.redirected_from.url) # \"http://example.com\"
-        ```
-
         ```py
         response = page.goto(\"http://example.com\")
         print(response.request.redirected_from.url) # \"http://example.com\"
@@ -217,11 +212,6 @@ def redirected_from(self) -> typing.Optional["Request"]:
 
         If the website `https://google.com` has no redirects:
 
-        ```py
-        response = await page.goto(\"https://google.com\")
-        print(response.request.redirected_from) # None
-        ```
-
         ```py
         response = page.goto(\"https://google.com\")
         print(response.request.redirected_from) # None
@@ -283,13 +273,6 @@ def timing(self) -> ResourceTiming:
 
         **Usage**
 
-        ```py
-        async with page.expect_event(\"requestfinished\") as request_info:
-            await page.goto(\"http://example.com\")
-        request = await request_info.value
-        print(request.timing)
-        ```
-
         ```py
         with page.expect_event(\"requestfinished\") as request_info:
             page.goto(\"http://example.com\")
@@ -708,13 +691,6 @@ def fulfill(
 
         An example of fulfilling all requests with 404 responses:
 
-        ```py
-        await page.route(\"**/*\", lambda route: route.fulfill(
-            status=404,
-            content_type=\"text/plain\",
-            body=\"not found!\"))
-        ```
-
         ```py
         page.route(\"**/*\", lambda route: route.fulfill(
             status=404,
@@ -724,10 +700,6 @@ def fulfill(
 
         An example of serving static file:
 
-        ```py
-        await page.route(\"**/xhr_endpoint\", lambda route: route.fulfill(path=\"mock_data.json\"))
-        ```
-
         ```py
         page.route(\"**/xhr_endpoint\", lambda route: route.fulfill(path=\"mock_data.json\"))
         ```
@@ -783,16 +755,6 @@ def fetch(
 
         **Usage**
 
-        ```py
-        async def handle(route):
-            response = await route.fetch()
-            json = await response.json()
-            json[\"message\"][\"big_red_dog\"] = []
-            await route.fulfill(response=response, json=json)
-
-        await page.route(\"https://dog.ceo/api/breeds/list/all\", handle)
-        ```
-
         ```py
         def handle(route):
             response = route.fetch()
@@ -862,12 +824,6 @@ def fallback(
 
         **Usage**
 
-        ```py
-        await page.route(\"**/*\", lambda route: route.abort())  # Runs last.
-        await page.route(\"**/*\", lambda route: route.fallback())  # Runs second.
-        await page.route(\"**/*\", lambda route: route.fallback())  # Runs first.
-        ```
-
         ```py
         page.route(\"**/*\", lambda route: route.abort())  # Runs last.
         page.route(\"**/*\", lambda route: route.fallback())  # Runs second.
@@ -877,27 +833,6 @@ def fallback(
         Registering multiple routes is useful when you want separate handlers to handle different kinds of requests, for
         example API calls vs page resources or GET requests vs POST requests as in the example below.
 
-        ```py
-        # Handle GET requests.
-        def handle_get(route):
-            if route.request.method != \"GET\":
-                route.fallback()
-                return
-          # Handling GET only.
-          # ...
-
-        # Handle POST requests.
-        def handle_post(route):
-            if route.request.method != \"POST\":
-                route.fallback()
-                return
-          # Handling POST only.
-          # ...
-
-        await page.route(\"**/*\", handle_get)
-        await page.route(\"**/*\", handle_post)
-        ```
-
         ```py
         # Handle GET requests.
         def handle_get(route):
@@ -922,19 +857,6 @@ def handle_post(route):
         One can also modify request while falling back to the subsequent handler, that way intermediate route handler can
         modify url, method, headers and postData of the request.
 
-        ```py
-        async def handle(route, request):
-            # override headers
-            headers = {
-                **request.headers,
-                \"foo\": \"foo-value\", # set \"foo\" header
-                \"bar\": None # remove \"bar\" header
-            }
-            await route.fallback(headers=headers)
-
-        await page.route(\"**/*\", handle)
-        ```
-
         ```py
         def handle(route, request):
             # override headers
@@ -986,19 +908,6 @@ def continue_(
 
         **Usage**
 
-        ```py
-        async def handle(route, request):
-            # override headers
-            headers = {
-                **request.headers,
-                \"foo\": \"foo-value\", # set \"foo\" header
-                \"bar\": None # remove \"bar\" header
-            }
-            await route.continue_(headers=headers)
-
-        await page.route(\"**/*\", handle)
-        ```
-
         ```py
         def handle(route, request):
             # override headers
@@ -1276,10 +1185,6 @@ def insert_text(self, text: str) -> None:
 
         **Usage**
 
-        ```py
-        await page.keyboard.insert_text(\"嗨\")
-        ```
-
         ```py
         page.keyboard.insert_text(\"嗨\")
         ```
@@ -1309,11 +1214,6 @@ def type(self, text: str, *, delay: typing.Optional[float] = None) -> None:
 
         **Usage**
 
-        ```py
-        await page.keyboard.type(\"Hello\") # types instantly
-        await page.keyboard.type(\"World\", delay=100) # types slower, like a user
-        ```
-
         ```py
         page.keyboard.type(\"Hello\") # types instantly
         page.keyboard.type(\"World\", delay=100) # types slower, like a user
@@ -1361,18 +1261,6 @@ def press(self, key: str, *, delay: typing.Optional[float] = None) -> None:
 
         **Usage**
 
-        ```py
-        page = await browser.new_page()
-        await page.goto(\"https://keycode.info\")
-        await page.keyboard.press(\"a\")
-        await page.screenshot(path=\"a.png\")
-        await page.keyboard.press(\"ArrowLeft\")
-        await page.screenshot(path=\"arrow_left.png\")
-        await page.keyboard.press(\"Shift+O\")
-        await page.screenshot(path=\"o.png\")
-        await browser.close()
-        ```
-
         ```py
         page = browser.new_page()
         page.goto(\"https://keycode.info\")
@@ -1584,11 +1472,6 @@ def evaluate(
 
         **Usage**
 
-        ```py
-        tweet_handle = await page.query_selector(\".tweet .retweets\")
-        assert await tweet_handle.evaluate(\"node => node.innerText\") == \"10 retweets\"
-        ```
-
         ```py
         tweet_handle = page.query_selector(\".tweet .retweets\")
         assert tweet_handle.evaluate(\"node => node.innerText\") == \"10 retweets\"
@@ -1677,14 +1560,6 @@ def get_properties(self) -> typing.Dict[str, "JSHandle"]:
 
         **Usage**
 
-        ```py
-        handle = await page.evaluate_handle(\"({ window, document })\")
-        properties = await handle.get_properties()
-        window_handle = properties.get(\"window\")
-        document_handle = properties.get(\"document\")
-        await handle.dispose()
-        ```
-
         ```py
         handle = page.evaluate_handle(\"({ window, document })\")
         properties = handle.get_properties()
@@ -1914,10 +1789,6 @@ def dispatch_event(
 
         **Usage**
 
-        ```py
-        await element_handle.dispatch_event(\"click\")
-        ```
-
         ```py
         element_handle.dispatch_event(\"click\")
         ```
@@ -1939,12 +1810,6 @@ def dispatch_event(
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
-        ```py
-        # note you can only create data_transfer in chromium and firefox
-        data_transfer = await page.evaluate_handle(\"new DataTransfer()\")
-        await element_handle.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
-        ```
-
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = page.evaluate_handle(\"new DataTransfer()\")
@@ -2222,15 +2087,6 @@ def select_option(
 
         **Usage**
 
-        ```py
-        # Single selection matching the value or label
-        await handle.select_option(\"blue\")
-        # single selection matching the label
-        await handle.select_option(label=\"blue\")
-        # multiple selection
-        await handle.select_option(value=[\"red\", \"green\", \"blue\"])
-        ```
-
         ```py
         # Single selection matching the value or label
         handle.select_option(\"blue\")
@@ -2774,11 +2630,6 @@ def bounding_box(self) -> typing.Optional[FloatRect]:
 
         **Usage**
 
-        ```py
-        box = await element_handle.bounding_box()
-        await page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
-        ```
-
         ```py
         box = element_handle.bounding_box()
         page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
@@ -2938,12 +2789,6 @@ def eval_on_selector(
 
         **Usage**
 
-        ```py
-        tweet_handle = await page.query_selector(\".tweet\")
-        assert await tweet_handle.eval_on_selector(\".like\", \"node => node.innerText\") == \"100\"
-        assert await tweet_handle.eval_on_selector(\".retweets\", \"node => node.innerText\") == \"10\"
-        ```
-
         ```py
         tweet_handle = page.query_selector(\".tweet\")
         assert tweet_handle.eval_on_selector(\".like\", \"node => node.innerText\") == \"100\"
@@ -2995,11 +2840,6 @@ def eval_on_selector_all(
         </div>
         ```
 
-        ```py
-        feed_handle = await page.query_selector(\".feed\")
-        assert await feed_handle.eval_on_selector_all(\".tweet\", \"nodes => nodes.map(n => n.innerText)\") == [\"hello!\", \"hi!\"]
-        ```
-
         ```py
         feed_handle = page.query_selector(\".feed\")
         assert feed_handle.eval_on_selector_all(\".tweet\", \"nodes => nodes.map(n => n.innerText)\") == [\"hello!\", \"hi!\"]
@@ -3090,13 +2930,6 @@ def wait_for_selector(
 
         **Usage**
 
-        ```py
-        await page.set_content(\"<div><span></span></div>\")
-        div = await page.query_selector(\"div\")
-        # waiting for the \"span\" selector relative to the div.
-        span = await div.wait_for_selector(\"span\", state=\"attached\")
-        ```
-
         ```py
         page.set_content(\"<div><span></span></div>\")
         div = page.query_selector(\"div\")
@@ -3162,11 +2995,6 @@ def snapshot(
 
         An example of dumping the entire accessibility tree:
 
-        ```py
-        snapshot = await page.accessibility.snapshot()
-        print(snapshot)
-        ```
-
         ```py
         snapshot = page.accessibility.snapshot()
         print(snapshot)
@@ -3174,22 +3002,6 @@ def 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\"])
-        ```
-
         ```py
         def find_focused_node(node):
             if node.get(\"focused\"):
@@ -3463,12 +3275,6 @@ def expect_navigation(
         This method waits for the frame to navigate to a new URL. It is useful for when you run code which will indirectly
         cause the frame to navigate. Consider this example:
 
-        ```py
-        async with frame.expect_navigation():
-            await frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
-        # Resolves after navigation has finished
-        ```
-
         ```py
         with frame.expect_navigation():
             frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
@@ -3524,11 +3330,6 @@ def wait_for_url(
 
         **Usage**
 
-        ```py
-        await frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
-        await frame.wait_for_url(\"**/target.html\")
-        ```
-
         ```py
         frame.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
         frame.wait_for_url(\"**/target.html\")
@@ -3581,11 +3382,6 @@ def wait_for_load_state(
 
         **Usage**
 
-        ```py
-        await frame.click(\"button\") # click triggers navigation.
-        await frame.wait_for_load_state() # the promise resolves after \"load\" event.
-        ```
-
         ```py
         frame.click(\"button\") # click triggers navigation.
         frame.wait_for_load_state() # the promise resolves after \"load\" event.
@@ -3623,12 +3419,6 @@ def frame_element(self) -> "ElementHandle":
 
         **Usage**
 
-        ```py
-        frame_element = await frame.frame_element()
-        content_frame = await frame_element.content_frame()
-        assert frame == content_frame
-        ```
-
         ```py
         frame_element = frame.frame_element()
         content_frame = frame_element.content_frame()
@@ -3658,11 +3448,6 @@ def evaluate(
 
         **Usage**
 
-        ```py
-        result = await frame.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
-        print(result) # prints \"56\"
-        ```
-
         ```py
         result = frame.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
         print(result) # prints \"56\"
@@ -3670,12 +3455,6 @@ def evaluate(
 
         A string can also be passed in instead of a function.
 
-        ```py
-        print(await frame.evaluate(\"1 + 2\")) # prints \"3\"
-        x = 10
-        print(await frame.evaluate(f\"1 + {x}\")) # prints \"11\"
-        ```
-
         ```py
         print(frame.evaluate(\"1 + 2\")) # prints \"3\"
         x = 10
@@ -3684,12 +3463,6 @@ def evaluate(
 
         `ElementHandle` instances can be passed as an argument to the `frame.evaluate()`:
 
-        ```py
-        body_handle = await frame.evaluate(\"document.body\")
-        html = await frame.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
-        await body_handle.dispose()
-        ```
-
         ```py
         body_handle = frame.evaluate(\"document.body\")
         html = frame.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
@@ -3730,11 +3503,6 @@ def evaluate_handle(
 
         **Usage**
 
-        ```py
-        a_window_handle = await frame.evaluate_handle(\"Promise.resolve(window)\")
-        a_window_handle # handle for the window object.
-        ```
-
         ```py
         a_window_handle = frame.evaluate_handle(\"Promise.resolve(window)\")
         a_window_handle # handle for the window object.
@@ -3742,23 +3510,12 @@ def evaluate_handle(
 
         A string can also be passed in instead of a function.
 
-        ```py
-        a_handle = await page.evaluate_handle(\"document\") # handle for the \"document\"
-        ```
-
         ```py
         a_handle = page.evaluate_handle(\"document\") # handle for the \"document\"
         ```
 
         `JSHandle` instances can be passed as an argument to the `frame.evaluate_handle()`:
 
-        ```py
-        a_handle = await page.evaluate_handle(\"document.body\")
-        result_handle = await page.evaluate_handle(\"body => body.innerHTML\", a_handle)
-        print(await result_handle.json_value())
-        await result_handle.dispose()
-        ```
-
         ```py
         a_handle = page.evaluate_handle(\"document.body\")
         result_handle = page.evaluate_handle(\"body => body.innerHTML\", a_handle)
@@ -3866,26 +3623,6 @@ def wait_for_selector(
 
         This method works across navigations:
 
-        ```py
-        import asyncio
-        from playwright.async_api import async_playwright, Playwright
-
-        async def run(playwright: Playwright):
-            chromium = playwright.chromium
-            browser = await chromium.launch()
-            page = await browser.new_page()
-            for current_url in [\"https://google.com\", \"https://bbc.com\"]:
-                await page.goto(current_url, wait_until=\"domcontentloaded\")
-                element = await page.main_frame.wait_for_selector(\"img\")
-                print(\"Loaded image: \" + str(await element.get_attribute(\"src\")))
-            await browser.close()
-
-        async def main():
-            async with async_playwright() as playwright:
-                await run(playwright)
-        asyncio.run(main())
-        ```
-
         ```py
         from playwright.sync_api import sync_playwright, Playwright
 
@@ -4168,10 +3905,6 @@ def dispatch_event(
 
         **Usage**
 
-        ```py
-        await frame.dispatch_event(\"button#submit\", \"click\")
-        ```
-
         ```py
         frame.dispatch_event(\"button#submit\", \"click\")
         ```
@@ -4193,12 +3926,6 @@ def dispatch_event(
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
-        ```py
-        # note you can only create data_transfer in chromium and firefox
-        data_transfer = await frame.evaluate_handle(\"new DataTransfer()\")
-        await frame.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
-        ```
-
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = frame.evaluate_handle(\"new DataTransfer()\")
@@ -4254,12 +3981,6 @@ def eval_on_selector(
 
         **Usage**
 
-        ```py
-        search_value = await frame.eval_on_selector(\"#search\", \"el => el.value\")
-        preload_href = await frame.eval_on_selector(\"link[rel=preload]\", \"el => el.href\")
-        html = await frame.eval_on_selector(\".main-container\", \"(e, suffix) => e.outerHTML + suffix\", \"hello\")
-        ```
-
         ```py
         search_value = frame.eval_on_selector(\"#search\", \"el => el.value\")
         preload_href = frame.eval_on_selector(\"link[rel=preload]\", \"el => el.href\")
@@ -4310,10 +4031,6 @@ def eval_on_selector_all(
 
         **Usage**
 
-        ```py
-        divs_counts = await frame.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
-        ```
-
         ```py
         divs_counts = frame.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
         ```
@@ -4852,10 +4569,6 @@ def get_by_alt_text(
         <img alt='Playwright logo'>
         ```
 
-        ```py
-        await page.get_by_alt_text(\"Playwright logo\").click()
-        ```
-
         ```py
         page.get_by_alt_text(\"Playwright logo\").click()
         ```
@@ -4896,11 +4609,6 @@ def get_by_label(
         <input id=\"password-input\">
         ```
 
-        ```py
-        await page.get_by_label(\"Username\").fill(\"john\")
-        await page.get_by_label(\"Password\").fill(\"secret\")
-        ```
-
         ```py
         page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
@@ -4941,10 +4649,6 @@ def get_by_placeholder(
 
         You can fill the input after locating it by the placeholder text:
 
-        ```py
-        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
-        ```
-
         ```py
         page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
@@ -5084,14 +4788,6 @@ def get_by_role(
 
         You can locate each element by it's implicit role:
 
-        ```py
-        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
-
-        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
-
-        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
-        ```
-
         ```py
         expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
 
@@ -5191,10 +4887,6 @@ def get_by_test_id(
 
         You can locate the element by it's test id:
 
-        ```py
-        await page.get_by_test_id(\"directions\").click()
-        ```
-
         ```py
         page.get_by_test_id(\"directions\").click()
         ```
@@ -5257,23 +4949,6 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        ```py
-        # Matches <span>
-        page.get_by_text(\"world\")
-
-        # Matches first <div>
-        page.get_by_text(\"Hello world\")
-
-        # Matches second <div>
-        page.get_by_text(\"Hello\", exact=True)
-
-        # Matches both <div>s
-        page.get_by_text(re.compile(\"Hello\"))
-
-        # Matches second <div>
-        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
-        ```
-
         **Details**
 
         Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
@@ -5317,10 +4992,6 @@ def get_by_title(
 
         You can check the issues count after locating it by the title text:
 
-        ```py
-        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
-        ```
-
         ```py
         expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
@@ -5351,11 +5022,6 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         Following snippet locates element with text \"Submit\" in the iframe with id `my-frame`, like `<iframe
         id=\"my-frame\">`:
 
-        ```py
-        locator = frame.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
-        await locator.click()
-        ```
-
         ```py
         locator = frame.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
         locator.click()
@@ -5714,15 +5380,6 @@ def select_option(
 
         **Usage**
 
-        ```py
-        # Single selection matching the value or label
-        await frame.select_option(\"select#colors\", \"blue\")
-        # single selection matching the label
-        await frame.select_option(\"select#colors\", label=\"blue\")
-        # multiple selection
-        await frame.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
-        ```
-
         ```py
         # Single selection matching the value or label
         frame.select_option(\"select#colors\", \"blue\")
@@ -6159,24 +5816,6 @@ def wait_for_function(
 
         The `frame.wait_for_function()` can be used to observe viewport size change:
 
-        ```py
-        import asyncio
-        from playwright.async_api import async_playwright, Playwright
-
-        async def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = await webkit.launch()
-            page = await browser.new_page()
-            await page.evaluate(\"window.x = 0; setTimeout(() => { window.x = 100 }, 1000);\")
-            await page.main_frame.wait_for_function(\"() => window.x > 0\")
-            await browser.close()
-
-        async def main():
-            async with async_playwright() as playwright:
-                await run(playwright)
-        asyncio.run(main())
-        ```
-
         ```py
         from playwright.sync_api import sync_playwright, Playwright
 
@@ -6194,11 +5833,6 @@ def run(playwright: Playwright):
 
         To pass an argument to the predicate of `frame.waitForFunction` function:
 
-        ```py
-        selector = \".foo\"
-        await frame.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
-        ```
-
         ```py
         selector = \".foo\"
         frame.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
@@ -6423,10 +6057,6 @@ def get_by_alt_text(
         <img alt='Playwright logo'>
         ```
 
-        ```py
-        await page.get_by_alt_text(\"Playwright logo\").click()
-        ```
-
         ```py
         page.get_by_alt_text(\"Playwright logo\").click()
         ```
@@ -6467,11 +6097,6 @@ def get_by_label(
         <input id=\"password-input\">
         ```
 
-        ```py
-        await page.get_by_label(\"Username\").fill(\"john\")
-        await page.get_by_label(\"Password\").fill(\"secret\")
-        ```
-
         ```py
         page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
@@ -6512,10 +6137,6 @@ def get_by_placeholder(
 
         You can fill the input after locating it by the placeholder text:
 
-        ```py
-        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
-        ```
-
         ```py
         page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
@@ -6655,14 +6276,6 @@ def get_by_role(
 
         You can locate each element by it's implicit role:
 
-        ```py
-        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
-
-        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
-
-        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
-        ```
-
         ```py
         expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
 
@@ -6763,11 +6376,7 @@ def get_by_test_id(
         You can locate the element by it's test id:
 
         ```py
-        await page.get_by_test_id(\"directions\").click()
-        ```
-
-        ```py
-        page.get_by_test_id(\"directions\").click()
+        page.get_by_test_id(\"directions\").click()
         ```
 
         **Details**
@@ -6828,23 +6437,6 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        ```py
-        # Matches <span>
-        page.get_by_text(\"world\")
-
-        # Matches first <div>
-        page.get_by_text(\"Hello world\")
-
-        # Matches second <div>
-        page.get_by_text(\"Hello\", exact=True)
-
-        # Matches both <div>s
-        page.get_by_text(re.compile(\"Hello\"))
-
-        # Matches second <div>
-        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
-        ```
-
         **Details**
 
         Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
@@ -6888,10 +6480,6 @@ def get_by_title(
 
         You can check the issues count after locating it by the title text:
 
-        ```py
-        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
-        ```
-
         ```py
         expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
@@ -7064,45 +6652,6 @@ def register(
 
         An example of registering selector engine that queries elements based on a tag name:
 
-        ```py
-        import asyncio
-        from playwright.async_api import async_playwright, Playwright
-
-        async def run(playwright: Playwright):
-            tag_selector = \"\"\"
-              {
-                  // Returns the first element matching given selector in the root's subtree.
-                  query(root, selector) {
-                      return root.querySelector(selector);
-                  },
-                  // Returns all elements matching given selector in the root's subtree.
-                  queryAll(root, selector) {
-                      return Array.from(root.querySelectorAll(selector));
-                  }
-              }\"\"\"
-
-            # Register the engine. Selectors will be prefixed with \"tag=\".
-            await playwright.selectors.register(\"tag\", tag_selector)
-            browser = await playwright.chromium.launch()
-            page = await browser.new_page()
-            await page.set_content('<div><button>Click me</button></div>')
-
-            # Use the selector prefixed with its name.
-            button = await page.query_selector('tag=button')
-            # Combine it with built-in locators.
-            await page.locator('tag=div').get_by_text('Click me').click()
-            # Can use it in any methods supporting selectors.
-            button_count = await page.locator('tag=button').count()
-            print(button_count)
-            await browser.close()
-
-        async def main():
-            async with async_playwright() as playwright:
-                await run(playwright)
-
-        asyncio.run(main())
-        ```
-
         ```py
         from playwright.sync_api import sync_playwright, Playwright
 
@@ -7406,10 +6955,6 @@ def save_as(self, path: typing.Union[str, pathlib.Path]) -> None:
 
         **Usage**
 
-        ```py
-        await download.save_as(\"/path/to/save/at/\" + download.suggested_filename)
-        ```
-
         ```py
         download.save_as(\"/path/to/save/at/\" + download.suggested_filename)
         ```
@@ -7493,17 +7038,6 @@ def on(
 
         **Usage**
 
-        ```py
-        async def print_args(msg):
-            values = []
-            for arg in msg.args:
-                values.append(await arg.json_value())
-            print(values)
-
-        page.on(\"console\", print_args)
-        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
-        ```
-
         ```py
         def print_args(msg):
             for arg in msg.args:
@@ -7521,17 +7055,6 @@ def on(self, event: Literal["crash"], f: typing.Callable[["Page"], "None"]) -> N
 
         The most common way to deal with crashes is to catch an exception:
 
-        ```py
-        try:
-            # crash might happen during a click.
-            await page.click(\"button\")
-            # or while waiting for an event.
-            await page.wait_for_event(\"popup\")
-        except Error as e:
-            pass
-            # when the page crashes, exception message contains \"crash\".
-        ```
-
         ```py
         try:
             # crash might happen during a click.
@@ -7629,14 +7152,6 @@ def on(
         # Log all uncaught errors to the terminal
         page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
 
-        # Navigate to a page with an exception.
-        await page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
-        ```
-
-        ```py
-        # Log all uncaught errors to the terminal
-        page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
-
         # Navigate to a page with an exception.
         page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
         ```"""
@@ -7651,13 +7166,6 @@ def on(self, event: Literal["popup"], f: typing.Callable[["Page"], "None"]) -> N
         popup with `window.open('http://example.com')`, this event will fire when the network request to
         \"http://example.com\" is done and its response has started loading in the popup.
 
-        ```py
-        async with page.expect_event(\"popup\") as page_info:
-            await page.get_by_text(\"open the popup\").click()
-        popup = await page_info.value
-        print(await popup.evaluate(\"location.href\"))
-        ```
-
         ```py
         with page.expect_event(\"popup\") as page_info:
             page.get_by_text(\"open the popup\").click()
@@ -7745,17 +7253,6 @@ def once(
 
         **Usage**
 
-        ```py
-        async def print_args(msg):
-            values = []
-            for arg in msg.args:
-                values.append(await arg.json_value())
-            print(values)
-
-        page.on(\"console\", print_args)
-        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
-        ```
-
         ```py
         def print_args(msg):
             for arg in msg.args:
@@ -7775,17 +7272,6 @@ def once(
 
         The most common way to deal with crashes is to catch an exception:
 
-        ```py
-        try:
-            # crash might happen during a click.
-            await page.click(\"button\")
-            # or while waiting for an event.
-            await page.wait_for_event(\"popup\")
-        except Error as e:
-            pass
-            # when the page crashes, exception message contains \"crash\".
-        ```
-
         ```py
         try:
             # crash might happen during a click.
@@ -7885,14 +7371,6 @@ def once(
         # Log all uncaught errors to the terminal
         page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
 
-        # Navigate to a page with an exception.
-        await page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
-        ```
-
-        ```py
-        # Log all uncaught errors to the terminal
-        page.on(\"pageerror\", lambda exc: print(f\"uncaught exception: {exc}\"))
-
         # Navigate to a page with an exception.
         page.goto(\"data:text/html,<script>throw new Error('test')</script>\")
         ```"""
@@ -7909,13 +7387,6 @@ def once(
         popup with `window.open('http://example.com')`, this event will fire when the network request to
         \"http://example.com\" is done and its response has started loading in the popup.
 
-        ```py
-        async with page.expect_event(\"popup\") as page_info:
-            await page.get_by_text(\"open the popup\").click()
-        popup = await page_info.value
-        print(await popup.evaluate(\"location.href\"))
-        ```
-
         ```py
         with page.expect_event(\"popup\") as page_info:
             page.get_by_text(\"open the popup\").click()
@@ -8147,10 +7618,6 @@ def frame(
 
         **Usage**
 
-        ```py
-        frame = page.frame(name=\"frame-name\")
-        ```
-
         ```py
         frame = page.frame(url=r\".*domain.*\")
         ```
@@ -8284,26 +7751,6 @@ def wait_for_selector(
 
         This method works across navigations:
 
-        ```py
-        import asyncio
-        from playwright.async_api import async_playwright, Playwright
-
-        async def run(playwright: Playwright):
-            chromium = playwright.chromium
-            browser = await chromium.launch()
-            page = await browser.new_page()
-            for current_url in [\"https://google.com\", \"https://bbc.com\"]:
-                await page.goto(current_url, wait_until=\"domcontentloaded\")
-                element = await page.wait_for_selector(\"img\")
-                print(\"Loaded image: \" + str(await element.get_attribute(\"src\")))
-            await browser.close()
-
-        async def main():
-            async with async_playwright() as playwright:
-                await run(playwright)
-        asyncio.run(main())
-        ```
-
         ```py
         from playwright.sync_api import sync_playwright, Playwright
 
@@ -8586,10 +8033,6 @@ def dispatch_event(
 
         **Usage**
 
-        ```py
-        await page.dispatch_event(\"button#submit\", \"click\")
-        ```
-
         ```py
         page.dispatch_event(\"button#submit\", \"click\")
         ```
@@ -8611,12 +8054,6 @@ def dispatch_event(
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
-        ```py
-        # note you can only create data_transfer in chromium and firefox
-        data_transfer = await page.evaluate_handle(\"new DataTransfer()\")
-        await page.dispatch_event(\"#source\", \"dragstart\", { \"dataTransfer\": data_transfer })
-        ```
-
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = page.evaluate_handle(\"new DataTransfer()\")
@@ -8670,11 +8107,6 @@ def evaluate(
 
         Passing argument to `expression`:
 
-        ```py
-        result = await page.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
-        print(result) # prints \"56\"
-        ```
-
         ```py
         result = page.evaluate(\"([x, y]) => Promise.resolve(x * y)\", [7, 8])
         print(result) # prints \"56\"
@@ -8682,12 +8114,6 @@ def evaluate(
 
         A string can also be passed in instead of a function:
 
-        ```py
-        print(await page.evaluate(\"1 + 2\")) # prints \"3\"
-        x = 10
-        print(await page.evaluate(f\"1 + {x}\")) # prints \"11\"
-        ```
-
         ```py
         print(page.evaluate(\"1 + 2\")) # prints \"3\"
         x = 10
@@ -8696,12 +8122,6 @@ def evaluate(
 
         `ElementHandle` instances can be passed as an argument to the `page.evaluate()`:
 
-        ```py
-        body_handle = await page.evaluate(\"document.body\")
-        html = await page.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
-        await body_handle.dispose()
-        ```
-
         ```py
         body_handle = page.evaluate(\"document.body\")
         html = page.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
@@ -8742,11 +8162,6 @@ def evaluate_handle(
 
         **Usage**
 
-        ```py
-        a_window_handle = await page.evaluate_handle(\"Promise.resolve(window)\")
-        a_window_handle # handle for the window object.
-        ```
-
         ```py
         a_window_handle = page.evaluate_handle(\"Promise.resolve(window)\")
         a_window_handle # handle for the window object.
@@ -8754,23 +8169,12 @@ def evaluate_handle(
 
         A string can also be passed in instead of a function:
 
-        ```py
-        a_handle = await page.evaluate_handle(\"document\") # handle for the \"document\"
-        ```
-
         ```py
         a_handle = page.evaluate_handle(\"document\") # handle for the \"document\"
         ```
 
         `JSHandle` instances can be passed as an argument to the `page.evaluate_handle()`:
 
-        ```py
-        a_handle = await page.evaluate_handle(\"document.body\")
-        result_handle = await page.evaluate_handle(\"body => body.innerHTML\", a_handle)
-        print(await result_handle.json_value())
-        await result_handle.dispose()
-        ```
-
         ```py
         a_handle = page.evaluate_handle(\"document.body\")
         result_handle = page.evaluate_handle(\"body => body.innerHTML\", a_handle)
@@ -8817,12 +8221,6 @@ def eval_on_selector(
 
         **Usage**
 
-        ```py
-        search_value = await page.eval_on_selector(\"#search\", \"el => el.value\")
-        preload_href = await page.eval_on_selector(\"link[rel=preload]\", \"el => el.href\")
-        html = await page.eval_on_selector(\".main-container\", \"(e, suffix) => e.outer_html + suffix\", \"hello\")
-        ```
-
         ```py
         search_value = page.eval_on_selector(\"#search\", \"el => el.value\")
         preload_href = page.eval_on_selector(\"link[rel=preload]\", \"el => el.href\")
@@ -8871,10 +8269,6 @@ def eval_on_selector_all(
 
         **Usage**
 
-        ```py
-        div_counts = await page.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
-        ```
-
         ```py
         div_counts = page.eval_on_selector_all(\"div\", \"(divs, min) => divs.length >= min\", 10)
         ```
@@ -8990,38 +8384,6 @@ def expose_function(self, name: str, callback: typing.Callable) -> None:
 
         An example of adding a `sha256` function to the page:
 
-        ```py
-        import asyncio
-        import hashlib
-        from playwright.async_api import async_playwright, Playwright
-
-        def sha256(text):
-            m = hashlib.sha256()
-            m.update(bytes(text, \"utf8\"))
-            return m.hexdigest()
-
-        async def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = await webkit.launch(headless=False)
-            page = await browser.new_page()
-            await page.expose_function(\"sha256\", sha256)
-            await page.set_content(\"\"\"
-                <script>
-                  async function onClick() {
-                    document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
-                  }
-                </script>
-                <button onclick=\"onClick()\">Click me</button>
-                <div></div>
-            \"\"\")
-            await page.click(\"button\")
-
-        async def main():
-            async with async_playwright() as playwright:
-                await run(playwright)
-        asyncio.run(main())
-        ```
-
         ```py
         import hashlib
         from playwright.sync_api import sync_playwright, Playwright
@@ -9091,33 +8453,6 @@ def expose_binding(
 
         An example of exposing page URL to all frames in a page:
 
-        ```py
-        import asyncio
-        from playwright.async_api import async_playwright, Playwright
-
-        async def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = await webkit.launch(headless=False)
-            context = await browser.new_context()
-            page = await context.new_page()
-            await page.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
-            await page.set_content(\"\"\"
-            <script>
-              async function onClick() {
-                document.querySelector('div').textContent = await window.pageURL();
-              }
-            </script>
-            <button onclick=\"onClick()\">Click me</button>
-            <div></div>
-            \"\"\")
-            await page.click(\"button\")
-
-        async def main():
-            async with async_playwright() as playwright:
-                await run(playwright)
-        asyncio.run(main())
-        ```
-
         ```py
         from playwright.sync_api import sync_playwright, Playwright
 
@@ -9144,20 +8479,6 @@ def run(playwright: Playwright):
 
         An example of passing an element handle:
 
-        ```py
-        async def print(source, element):
-            print(await element.text_content())
-
-        await page.expose_binding(\"clicked\", print, handle=true)
-        await page.set_content(\"\"\"
-          <script>
-            document.addEventListener('click', event => window.clicked(event.target));
-          </script>
-          <div>Click me</div>
-          <div>Or click me</div>
-        \"\"\")
-        ```
-
         ```py
         def print(source, element):
             print(element.text_content())
@@ -9388,25 +8709,11 @@ def wait_for_load_state(
 
         **Usage**
 
-        ```py
-        await page.get_by_role(\"button\").click() # click triggers navigation.
-        await page.wait_for_load_state() # the promise resolves after \"load\" event.
-        ```
-
         ```py
         page.get_by_role(\"button\").click() # click triggers navigation.
         page.wait_for_load_state() # the promise resolves after \"load\" event.
         ```
 
-        ```py
-        async with page.expect_popup() as page_info:
-            await page.get_by_role(\"button\").click() # click triggers a popup.
-        popup = await page_info.value
-        # Wait for the \"DOMContentLoaded\" event.
-        await popup.wait_for_load_state(\"domcontentloaded\")
-        print(await popup.title()) # popup is ready to use.
-        ```
-
         ```py
         with page.expect_popup() as page_info:
             page.get_by_role(\"button\").click() # click triggers a popup.
@@ -9451,11 +8758,6 @@ def wait_for_url(
 
         **Usage**
 
-        ```py
-        await page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
-        await page.wait_for_url(\"**/target.html\")
-        ```
-
         ```py
         page.click(\"a.delayed-navigation\") # clicking the link will indirectly cause a navigation
         page.wait_for_url(\"**/target.html\")
@@ -9629,25 +8931,6 @@ def emulate_media(
 
         **Usage**
 
-        ```py
-        await page.evaluate(\"matchMedia('screen').matches\")
-        # → True
-        await page.evaluate(\"matchMedia('print').matches\")
-        # → False
-
-        await page.emulate_media(media=\"print\")
-        await page.evaluate(\"matchMedia('screen').matches\")
-        # → False
-        await page.evaluate(\"matchMedia('print').matches\")
-        # → True
-
-        await page.emulate_media()
-        await page.evaluate(\"matchMedia('screen').matches\")
-        # → True
-        await page.evaluate(\"matchMedia('print').matches\")
-        # → False
-        ```
-
         ```py
         page.evaluate(\"matchMedia('screen').matches\")
         # → True
@@ -9667,16 +8950,6 @@ def emulate_media(
         # → False
         ```
 
-        ```py
-        await page.emulate_media(color_scheme=\"dark\")
-        await page.evaluate(\"matchMedia('(prefers-color-scheme: dark)').matches\")
-        # → True
-        await page.evaluate(\"matchMedia('(prefers-color-scheme: light)').matches\")
-        # → False
-        await page.evaluate(\"matchMedia('(prefers-color-scheme: no-preference)').matches\")
-        # → False
-        ```
-
         ```py
         page.emulate_media(color_scheme=\"dark\")
         page.evaluate(\"matchMedia('(prefers-color-scheme: dark)').matches\")
@@ -9724,12 +8997,6 @@ def set_viewport_size(self, viewport_size: ViewportSize) -> None:
 
         **Usage**
 
-        ```py
-        page = await browser.new_page()
-        await page.set_viewport_size({\"width\": 640, \"height\": 480})
-        await page.goto(\"https://example.com\")
-        ```
-
         ```py
         page = browser.new_page()
         page.set_viewport_size({\"width\": 640, \"height\": 480})
@@ -9773,11 +9040,6 @@ def add_init_script(
 
         An example of overriding `Math.random` before the page loads:
 
-        ```py
-        # in your playwright script, assuming the preload.js file is in same directory
-        await page.add_init_script(path=\"./preload.js\")
-        ```
-
         ```py
         # in your playwright script, assuming the preload.js file is in same directory
         page.add_init_script(path=\"./preload.js\")
@@ -9826,13 +9088,6 @@ def route(
 
         An example of a naive handler that aborts all image requests:
 
-        ```py
-        page = await browser.new_page()
-        await page.route(\"**/*.{png,jpg,jpeg}\", lambda route: route.abort())
-        await page.goto(\"https://example.com\")
-        await browser.close()
-        ```
-
         ```py
         page = browser.new_page()
         page.route(\"**/*.{png,jpg,jpeg}\", lambda route: route.abort())
@@ -9842,13 +9097,6 @@ def route(
 
         or the same snippet using a regex pattern instead:
 
-        ```py
-        page = await browser.new_page()
-        await page.route(re.compile(r\"(\\.png$)|(\\.jpg$)\"), lambda route: route.abort())
-        await page.goto(\"https://example.com\")
-        await browser.close()
-        ```
-
         ```py
         page = browser.new_page()
         page.route(re.compile(r\"(\\.png$)|(\\.jpg$)\"), lambda route: route.abort())
@@ -9859,15 +9107,6 @@ def route(
         It is possible to examine the request to decide the route action. For example, mocking all requests that contain
         some post data, and leaving all other requests as is:
 
-        ```py
-        def handle_route(route):
-          if (\"my-string\" in route.request.post_data):
-            route.fulfill(body=\"mocked-data\")
-          else:
-            route.continue_()
-        await page.route(\"/api/**\", handle_route)
-        ```
-
         ```py
         def handle_route(route):
           if (\"my-string\" in route.request.post_data):
@@ -10535,10 +9774,6 @@ def get_by_alt_text(
         <img alt='Playwright logo'>
         ```
 
-        ```py
-        await page.get_by_alt_text(\"Playwright logo\").click()
-        ```
-
         ```py
         page.get_by_alt_text(\"Playwright logo\").click()
         ```
@@ -10579,11 +9814,6 @@ def get_by_label(
         <input id=\"password-input\">
         ```
 
-        ```py
-        await page.get_by_label(\"Username\").fill(\"john\")
-        await page.get_by_label(\"Password\").fill(\"secret\")
-        ```
-
         ```py
         page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
@@ -10624,10 +9854,6 @@ def get_by_placeholder(
 
         You can fill the input after locating it by the placeholder text:
 
-        ```py
-        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
-        ```
-
         ```py
         page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
@@ -10767,14 +9993,6 @@ def get_by_role(
 
         You can locate each element by it's implicit role:
 
-        ```py
-        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
-
-        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
-
-        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
-        ```
-
         ```py
         expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
 
@@ -10874,10 +10092,6 @@ def get_by_test_id(
 
         You can locate the element by it's test id:
 
-        ```py
-        await page.get_by_test_id(\"directions\").click()
-        ```
-
         ```py
         page.get_by_test_id(\"directions\").click()
         ```
@@ -10940,24 +10154,7 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        ```py
-        # Matches <span>
-        page.get_by_text(\"world\")
-
-        # Matches first <div>
-        page.get_by_text(\"Hello world\")
-
-        # Matches second <div>
-        page.get_by_text(\"Hello\", exact=True)
-
-        # Matches both <div>s
-        page.get_by_text(re.compile(\"Hello\"))
-
-        # Matches second <div>
-        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
-        ```
-
-        **Details**
+        **Details**
 
         Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
         one, turns line breaks into spaces and ignores leading and trailing whitespace.
@@ -11000,10 +10197,6 @@ def get_by_title(
 
         You can check the issues count after locating it by the title text:
 
-        ```py
-        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
-        ```
-
         ```py
         expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
@@ -11034,11 +10227,6 @@ def frame_locator(self, selector: str) -> "FrameLocator":
         Following snippet locates element with text \"Submit\" in the iframe with id `my-frame`, like `<iframe
         id=\"my-frame\">`:
 
-        ```py
-        locator = page.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
-        await locator.click()
-        ```
-
         ```py
         locator = page.frame_locator(\"#my-iframe\").get_by_text(\"Submit\")
         locator.click()
@@ -11324,17 +10512,6 @@ def drag_and_drop(
 
         **Usage**
 
-        ```py
-        await page.drag_and_drop(\"#source\", \"#target\")
-        # or specify exact positions relative to the top-left corners of the elements:
-        await page.drag_and_drop(
-          \"#source\",
-          \"#target\",
-          source_position={\"x\": 34, \"y\": 7},
-          target_position={\"x\": 10, \"y\": 20}
-        )
-        ```
-
         ```py
         page.drag_and_drop(\"#source\", \"#target\")
         # or specify exact positions relative to the top-left corners of the elements:
@@ -11424,15 +10601,6 @@ def select_option(
 
         **Usage**
 
-        ```py
-        # Single selection matching the value or label
-        await page.select_option(\"select#colors\", \"blue\")
-        # single selection matching the label
-        await page.select_option(\"select#colors\", label=\"blue\")
-        # multiple selection
-        await page.select_option(\"select#colors\", value=[\"red\", \"green\", \"blue\"])
-        ```
-
         ```py
         # Single selection matching the value or label
         page.select_option(\"select#colors\", \"blue\")
@@ -11674,18 +10842,6 @@ def press(
 
         **Usage**
 
-        ```py
-        page = await browser.new_page()
-        await page.goto(\"https://keycode.info\")
-        await page.press(\"body\", \"A\")
-        await page.screenshot(path=\"a.png\")
-        await page.press(\"body\", \"ArrowLeft\")
-        await page.screenshot(path=\"arrow_left.png\")
-        await page.press(\"body\", \"Shift+O\")
-        await page.screenshot(path=\"o.png\")
-        await browser.close()
-        ```
-
         ```py
         page = browser.new_page()
         page.goto(\"https://keycode.info\")
@@ -11874,11 +11030,6 @@ def wait_for_timeout(self, timeout: float) -> None:
 
         **Usage**
 
-        ```py
-        # wait for 1 second
-        await page.wait_for_timeout(1000)
-        ```
-
         ```py
         # wait for 1 second
         page.wait_for_timeout(1000)
@@ -11910,24 +11061,6 @@ def wait_for_function(
 
         The `page.wait_for_function()` can be used to observe viewport size change:
 
-        ```py
-        import asyncio
-        from playwright.async_api import async_playwright, Playwright
-
-        async def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = await webkit.launch()
-            page = await browser.new_page()
-            await page.evaluate(\"window.x = 0; setTimeout(() => { window.x = 100 }, 1000);\")
-            await page.wait_for_function(\"() => window.x > 0\")
-            await browser.close()
-
-        async def main():
-            async with async_playwright() as playwright:
-                await run(playwright)
-        asyncio.run(main())
-        ```
-
         ```py
         from playwright.sync_api import sync_playwright, Playwright
 
@@ -11945,11 +11078,6 @@ def run(playwright: Playwright):
 
         To pass an argument to the predicate of `page.wait_for_function()` function:
 
-        ```py
-        selector = \".foo\"
-        await page.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
-        ```
-
         ```py
         selector = \".foo\"
         page.wait_for_function(\"selector => !!document.querySelector(selector)\", selector)
@@ -12034,12 +11162,6 @@ def pdf(
 
         **Usage**
 
-        ```py
-        # generates a pdf with \"screen\" media type.
-        await page.emulate_media(media=\"screen\")
-        await page.pdf(path=\"page.pdf\")
-        ```
-
         ```py
         # generates a pdf with \"screen\" media type.
         page.emulate_media(media=\"screen\")
@@ -12152,12 +11274,6 @@ def expect_event(
 
         **Usage**
 
-        ```py
-        async with page.expect_event(\"framenavigated\") as event_info:
-            await page.get_by_role(\"button\")
-        frame = await event_info.value
-        ```
-
         ```py
         with page.expect_event(\"framenavigated\") as event_info:
             page.get_by_role(\"button\")
@@ -12301,13 +11417,6 @@ def expect_navigation(
         indirectly cause the page to navigate. e.g. The click target has an `onclick` handler that triggers navigation from
         a `setTimeout`. Consider this example:
 
-        ```py
-        async with page.expect_navigation():
-            # This action triggers the navigation after a timeout.
-            await page.get_by_text(\"Navigate after timeout\").click()
-        # Resolves after navigation has finished
-        ```
-
         ```py
         with page.expect_navigation():
             # This action triggers the navigation after a timeout.
@@ -12395,17 +11504,6 @@ def expect_request(
 
         **Usage**
 
-        ```py
-        async with page.expect_request(\"http://example.com/resource\") as first:
-            await page.get_by_text(\"trigger request\").click()
-        first_request = await first.value
-
-        # or with a lambda
-        async with page.expect_request(lambda request: request.url == \"http://example.com\" and request.method == \"get\") as second:
-            await page.get_by_text(\"trigger request\").click()
-        second_request = await second.value
-        ```
-
         ```py
         with page.expect_request(\"http://example.com/resource\") as first:
             page.get_by_text(\"trigger request\").click()
@@ -12484,19 +11582,6 @@ def expect_response(
 
         **Usage**
 
-        ```py
-        async with page.expect_response(\"https://example.com/resource\") as response_info:
-            await page.get_by_text(\"trigger response\").click()
-        response = await response_info.value
-        return response.ok
-
-        # or with a lambda
-        async with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200) as response_info:
-            await page.get_by_text(\"trigger response\").click()
-        response = await response_info.value
-        return response.ok
-        ```
-
         ```py
         with page.expect_response(\"https://example.com/resource\") as response_info:
             page.get_by_text(\"trigger response\").click()
@@ -12706,10 +11791,6 @@ def on(
 
         Emitted when new background page is created in the context.
 
-        ```py
-        background_page = await context.wait_for_event(\"backgroundpage\")
-        ```
-
         ```py
         background_page = context.wait_for_event(\"backgroundpage\")
         ```"""
@@ -12736,17 +11817,6 @@ def on(
 
         **Usage**
 
-        ```py
-        async def print_args(msg):
-            values = []
-            for arg in msg.args:
-                values.append(await arg.json_value())
-            print(values)
-
-        context.on(\"console\", print_args)
-        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
-        ```
-
         ```py
         def print_args(msg):
             for arg in msg.args:
@@ -12786,13 +11856,6 @@ def on(self, event: Literal["page"], f: typing.Callable[["Page"], "None"]) -> No
         popup with `window.open('http://example.com')`, this event will fire when the network request to
         \"http://example.com\" is done and its response has started loading in the popup.
 
-        ```py
-        async with context.expect_page() as page_info:
-            await page.get_by_text(\"open new page\").click(),
-        page = await page_info.value
-        print(await page.evaluate(\"location.href\"))
-        ```
-
         ```py
         with context.expect_page() as page_info:
             page.get_by_text(\"open new page\").click(),
@@ -12873,10 +11936,6 @@ def once(
 
         Emitted when new background page is created in the context.
 
-        ```py
-        background_page = await context.wait_for_event(\"backgroundpage\")
-        ```
-
         ```py
         background_page = context.wait_for_event(\"backgroundpage\")
         ```"""
@@ -12903,17 +11962,6 @@ def once(
 
         **Usage**
 
-        ```py
-        async def print_args(msg):
-            values = []
-            for arg in msg.args:
-                values.append(await arg.json_value())
-            print(values)
-
-        context.on(\"console\", print_args)
-        await page.evaluate(\"console.log('hello', 5, { foo: 'bar' })\")
-        ```
-
         ```py
         def print_args(msg):
             for arg in msg.args:
@@ -12955,13 +12003,6 @@ def once(
         popup with `window.open('http://example.com')`, this event will fire when the network request to
         \"http://example.com\" is done and its response has started loading in the popup.
 
-        ```py
-        async with context.expect_page() as page_info:
-            await page.get_by_text(\"open new page\").click(),
-        page = await page_info.value
-        print(await page.evaluate(\"location.href\"))
-        ```
-
         ```py
         with context.expect_page() as page_info:
             page.get_by_text(\"open new page\").click(),
@@ -13192,10 +12233,6 @@ def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
 
         **Usage**
 
-        ```py
-        await browser_context.add_cookies([cookie_object1, cookie_object2])
-        ```
-
         ```py
         browser_context.add_cookies([cookie_object1, cookie_object2])
         ```
@@ -13266,13 +12303,6 @@ def clear_permissions(self) -> None:
 
         **Usage**
 
-        ```py
-        context = await browser.new_context()
-        await context.grant_permissions([\"clipboard-read\"])
-        # do stuff ..
-        context.clear_permissions()
-        ```
-
         ```py
         context = browser.new_context()
         context.grant_permissions([\"clipboard-read\"])
@@ -13290,10 +12320,6 @@ def set_geolocation(self, geolocation: typing.Optional[Geolocation] = None) -> N
 
         **Usage**
 
-        ```py
-        await browser_context.set_geolocation({\"latitude\": 59.95, \"longitude\": 30.31667})
-        ```
-
         ```py
         browser_context.set_geolocation({\"latitude\": 59.95, \"longitude\": 30.31667})
         ```
@@ -13365,11 +12391,6 @@ def add_init_script(
 
         An example of overriding `Math.random` before the page loads:
 
-        ```py
-        # in your playwright script, assuming the preload.js file is in same directory.
-        await browser_context.add_init_script(path=\"preload.js\")
-        ```
-
         ```py
         # in your playwright script, assuming the preload.js file is in same directory.
         browser_context.add_init_script(path=\"preload.js\")
@@ -13413,33 +12434,6 @@ def expose_binding(
 
         An example of exposing page URL to all frames in all pages in the context:
 
-        ```py
-        import asyncio
-        from playwright.async_api import async_playwright, Playwright
-
-        async def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = await webkit.launch(headless=False)
-            context = await browser.new_context()
-            await context.expose_binding(\"pageURL\", lambda source: source[\"page\"].url)
-            page = await context.new_page()
-            await page.set_content(\"\"\"
-            <script>
-              async function onClick() {
-                document.querySelector('div').textContent = await window.pageURL();
-              }
-            </script>
-            <button onclick=\"onClick()\">Click me</button>
-            <div></div>
-            \"\"\")
-            await page.get_by_role(\"button\").click()
-
-        async def main():
-            async with async_playwright() as playwright:
-                await run(playwright)
-        asyncio.run(main())
-        ```
-
         ```py
         from playwright.sync_api import sync_playwright, Playwright
 
@@ -13466,20 +12460,6 @@ def run(playwright: Playwright):
 
         An example of passing an element handle:
 
-        ```py
-        async def print(source, element):
-            print(await element.text_content())
-
-        await context.expose_binding(\"clicked\", print, handle=true)
-        await page.set_content(\"\"\"
-          <script>
-            document.addEventListener('click', event => window.clicked(event.target));
-          </script>
-          <div>Click me</div>
-          <div>Or click me</div>
-        \"\"\")
-        ```
-
         ```py
         def print(source, element):
             print(element.text_content())
@@ -13527,39 +12507,6 @@ def expose_function(self, name: str, callback: typing.Callable) -> None:
 
         An example of adding a `sha256` function to all pages in the context:
 
-        ```py
-        import asyncio
-        import hashlib
-        from playwright.async_api import async_playwright, Playwright
-
-        def sha256(text: str) -> str:
-            m = hashlib.sha256()
-            m.update(bytes(text, \"utf8\"))
-            return m.hexdigest()
-
-        async def run(playwright: Playwright):
-            webkit = playwright.webkit
-            browser = await webkit.launch(headless=False)
-            context = await browser.new_context()
-            await context.expose_function(\"sha256\", sha256)
-            page = await context.new_page()
-            await page.set_content(\"\"\"
-                <script>
-                  async function onClick() {
-                    document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
-                  }
-                </script>
-                <button onclick=\"onClick()\">Click me</button>
-                <div></div>
-            \"\"\")
-            await page.get_by_role(\"button\").click()
-
-        async def main():
-            async with async_playwright() as playwright:
-                await run(playwright)
-        asyncio.run(main())
-        ```
-
         ```py
         import hashlib
         from playwright.sync_api import sync_playwright
@@ -13629,14 +12576,6 @@ def route(
 
         An example of a naive handler that aborts all image requests:
 
-        ```py
-        context = await browser.new_context()
-        page = await context.new_page()
-        await context.route(\"**/*.{png,jpg,jpeg}\", lambda route: route.abort())
-        await page.goto(\"https://example.com\")
-        await browser.close()
-        ```
-
         ```py
         context = browser.new_context()
         page = context.new_page()
@@ -13647,15 +12586,6 @@ def route(
 
         or the same snippet using a regex pattern instead:
 
-        ```py
-        context = await browser.new_context()
-        page = await context.new_page()
-        await context.route(re.compile(r\"(\\.png$)|(\\.jpg$)\"), lambda route: route.abort())
-        page = await context.new_page()
-        await page.goto(\"https://example.com\")
-        await browser.close()
-        ```
-
         ```py
         context = browser.new_context()
         page = context.new_page()
@@ -13669,15 +12599,6 @@ def route(
         It is possible to examine the request to decide the route action. For example, mocking all requests that contain
         some post data, and leaving all other requests as is:
 
-        ```py
-        def handle_route(route):
-          if (\"my-string\" in route.request.post_data):
-            route.fulfill(body=\"mocked-data\")
-          else:
-            route.continue_()
-        await context.route(\"/api/**\", handle_route)
-        ```
-
         ```py
         def handle_route(route):
           if (\"my-string\" in route.request.post_data):
@@ -13843,12 +12764,6 @@ def expect_event(
 
         **Usage**
 
-        ```py
-        async with context.expect_event(\"page\") as event_info:
-            await page.get_by_role(\"button\").click()
-        page = await event_info.value
-        ```
-
         ```py
         with context.expect_event(\"page\") as event_info:
             page.get_by_role(\"button\").click()
@@ -14104,13 +13019,6 @@ def contexts(self) -> typing.List["BrowserContext"]:
 
         **Usage**
 
-        ```py
-        browser = await pw.webkit.launch()
-        print(len(browser.contexts())) # prints `0`
-        context = await browser.new_context()
-        print(len(browser.contexts())) # prints `1`
-        ```
-
         ```py
         browser = pw.webkit.launch()
         print(len(browser.contexts())) # prints `0`
@@ -14217,19 +13125,6 @@ def new_context(
 
         **Usage**
 
-        ```py
-        browser = await playwright.firefox.launch() # or \"chromium\" or \"webkit\".
-        # create a new incognito browser context.
-        context = await browser.new_context()
-        # create a new page in a pristine context.
-        page = await context.new_page()
-        await page.goto(\"https://example.com\")
-
-        # gracefully close up everything
-        await context.close()
-        await browser.close()
-        ```
-
         ```py
         browser = playwright.firefox.launch() # or \"chromium\" or \"webkit\".
         # create a new incognito browser context.
@@ -14678,12 +13573,6 @@ def start_tracing(
 
         **Usage**
 
-        ```py
-        await browser.start_tracing(page, path=\"trace.json\")
-        await page.goto(\"https://www.google.com\")
-        await browser.stop_tracing()
-        ```
-
         ```py
         browser.start_tracing(page, path=\"trace.json\")
         page.goto(\"https://www.google.com\")
@@ -14792,12 +13681,6 @@ def launch(
 
         You can use `ignoreDefaultArgs` to filter out `--mute-audio` from default arguments:
 
-        ```py
-        browser = await playwright.chromium.launch( # or \"firefox\" or \"webkit\".
-            ignore_default_args=[\"--mute-audio\"]
-        )
-        ```
-
         ```py
         browser = playwright.chromium.launch( # or \"firefox\" or \"webkit\".
             ignore_default_args=[\"--mute-audio\"]
@@ -15213,12 +14096,6 @@ def connect_over_cdp(
 
         **Usage**
 
-        ```py
-        browser = await playwright.chromium.connect_over_cdp(\"http://localhost:9222\")
-        default_context = browser.contexts[0]
-        page = default_context.pages[0]
-        ```
-
         ```py
         browser = playwright.chromium.connect_over_cdp(\"http://localhost:9222\")
         default_context = browser.contexts[0]
@@ -15324,26 +14201,6 @@ def devices(self) -> typing.Dict:
 
         Returns a dictionary of devices to be used with `browser.new_context()` or `browser.new_page()`.
 
-        ```py
-        import asyncio
-        from playwright.async_api import async_playwright, Playwright
-
-        async def run(playwright: Playwright):
-            webkit = playwright.webkit
-            iphone = playwright.devices[\"iPhone 6\"]
-            browser = await webkit.launch()
-            context = await browser.new_context(**iphone)
-            page = await context.new_page()
-            await page.goto(\"http://example.com\")
-            # other actions...
-            await browser.close()
-
-        async def main():
-            async with async_playwright() as playwright:
-                await run(playwright)
-        asyncio.run(main())
-        ```
-
         ```py
         from playwright.sync_api import sync_playwright, Playwright
 
@@ -15474,13 +14331,6 @@ def start(
 
         **Usage**
 
-        ```py
-        await context.tracing.start(screenshots=True, snapshots=True)
-        page = await context.new_page()
-        await page.goto(\"https://playwright.dev\")
-        await context.tracing.stop(path = \"trace.zip\")
-        ```
-
         ```py
         context.tracing.start(screenshots=True, snapshots=True)
         page = context.new_page()
@@ -15529,22 +14379,6 @@ def start_chunk(
 
         **Usage**
 
-        ```py
-        await context.tracing.start(screenshots=True, snapshots=True)
-        page = await context.new_page()
-        await page.goto(\"https://playwright.dev\")
-
-        await context.tracing.start_chunk()
-        await page.get_by_text(\"Get Started\").click()
-        # Everything between start_chunk and stop_chunk will be recorded in the trace.
-        await context.tracing.stop_chunk(path = \"trace1.zip\")
-
-        await context.tracing.start_chunk()
-        await page.goto(\"http://example.com\")
-        # Save a second trace file with different actions.
-        await context.tracing.stop_chunk(path = \"trace2.zip\")
-        ```
-
         ```py
         context.tracing.start(screenshots=True, snapshots=True)
         page = context.new_page()
@@ -15642,10 +14476,6 @@ def last(self) -> "Locator":
 
         **Usage**
 
-        ```py
-        banana = await page.get_by_role(\"listitem\").last
-        ```
-
         ```py
         banana = page.get_by_role(\"listitem\").last
         ```
@@ -15679,11 +14509,6 @@ def bounding_box(
 
         **Usage**
 
-        ```py
-        box = await page.get_by_role(\"button\").bounding_box()
-        await page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
-        ```
-
         ```py
         box = page.get_by_role(\"button\").bounding_box()
         page.mouse.click(box[\"x\"] + box[\"width\"] / 2, box[\"y\"] + box[\"height\"] / 2)
@@ -15735,10 +14560,6 @@ def check(
 
         **Usage**
 
-        ```py
-        await page.get_by_role(\"checkbox\").check()
-        ```
-
         ```py
         page.get_by_role(\"checkbox\").check()
         ```
@@ -15810,22 +14631,12 @@ def click(
 
         Click a button:
 
-        ```py
-        await page.get_by_role(\"button\").click()
-        ```
-
         ```py
         page.get_by_role(\"button\").click()
         ```
 
         Shift-right-click at a specific position on a canvas:
 
-        ```py
-        await page.locator(\"canvas\").click(
-            button=\"right\", modifiers=[\"Shift\"], position={\"x\": 23, \"y\": 32}
-        )
-        ```
-
         ```py
         page.locator(\"canvas\").click(
             button=\"right\", modifiers=[\"Shift\"], position={\"x\": 23, \"y\": 32}
@@ -15964,10 +14775,6 @@ def dispatch_event(
 
         **Usage**
 
-        ```py
-        await locator.dispatch_event(\"click\")
-        ```
-
         ```py
         locator.dispatch_event(\"click\")
         ```
@@ -15995,12 +14802,6 @@ def dispatch_event(
 
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
-        ```py
-        # note you can only create data_transfer in chromium and firefox
-        data_transfer = await page.evaluate_handle(\"new DataTransfer()\")
-        await locator.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
-        ```
-
         ```py
         # note you can only create data_transfer in chromium and firefox
         data_transfer = page.evaluate_handle(\"new DataTransfer()\")
@@ -16048,11 +14849,6 @@ def evaluate(
 
         **Usage**
 
-        ```py
-        tweets = page.locator(\".tweet .retweets\")
-        assert await tweets.evaluate(\"node => node.innerText\") == \"10 retweets\"
-        ```
-
         ```py
         tweets = page.locator(\".tweet .retweets\")
         assert tweets.evaluate(\"node => node.innerText\") == \"10 retweets\"
@@ -16102,12 +14898,7 @@ def evaluate_all(
 
         ```py
         locator = page.locator(\"div\")
-        more_than_ten = await locator.evaluate_all(\"(divs, min) => divs.length > min\", 10)
-        ```
-
-        ```py
-        locator = page.locator(\"div\")
-        more_than_ten = locator.evaluate_all(\"(divs, min) => divs.length > min\", 10)
+        more_than_ten = locator.evaluate_all(\"(divs, min) => divs.length > min\", 10)
         ```
 
         Parameters
@@ -16195,10 +14986,6 @@ def fill(
 
         **Usage**
 
-        ```py
-        await page.get_by_role(\"textbox\").fill(\"example value\")
-        ```
-
         ```py
         page.get_by_role(\"textbox\").fill(\"example value\")
         ```
@@ -16261,10 +15048,6 @@ def clear(
 
         **Usage**
 
-        ```py
-        await page.get_by_role(\"textbox\").clear()
-        ```
-
         ```py
         page.get_by_role(\"textbox\").clear()
         ```
@@ -16366,10 +15149,6 @@ def get_by_alt_text(
         <img alt='Playwright logo'>
         ```
 
-        ```py
-        await page.get_by_alt_text(\"Playwright logo\").click()
-        ```
-
         ```py
         page.get_by_alt_text(\"Playwright logo\").click()
         ```
@@ -16410,11 +15189,6 @@ def get_by_label(
         <input id=\"password-input\">
         ```
 
-        ```py
-        await page.get_by_label(\"Username\").fill(\"john\")
-        await page.get_by_label(\"Password\").fill(\"secret\")
-        ```
-
         ```py
         page.get_by_label(\"Username\").fill(\"john\")
         page.get_by_label(\"Password\").fill(\"secret\")
@@ -16455,10 +15229,6 @@ def get_by_placeholder(
 
         You can fill the input after locating it by the placeholder text:
 
-        ```py
-        await page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
-        ```
-
         ```py
         page.get_by_placeholder(\"name@example.com\").fill(\"playwright@microsoft.com\")
         ```
@@ -16598,14 +15368,6 @@ def get_by_role(
 
         You can locate each element by it's implicit role:
 
-        ```py
-        await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
-
-        await page.get_by_role(\"checkbox\", name=\"Subscribe\").check()
-
-        await page.get_by_role(\"button\", name=re.compile(\"submit\", re.IGNORECASE)).click()
-        ```
-
         ```py
         expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
 
@@ -16705,10 +15467,6 @@ def get_by_test_id(
 
         You can locate the element by it's test id:
 
-        ```py
-        await page.get_by_test_id(\"directions\").click()
-        ```
-
         ```py
         page.get_by_test_id(\"directions\").click()
         ```
@@ -16771,23 +15529,6 @@ def get_by_text(
         page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
         ```
 
-        ```py
-        # Matches <span>
-        page.get_by_text(\"world\")
-
-        # Matches first <div>
-        page.get_by_text(\"Hello world\")
-
-        # Matches second <div>
-        page.get_by_text(\"Hello\", exact=True)
-
-        # Matches both <div>s
-        page.get_by_text(re.compile(\"Hello\"))
-
-        # Matches second <div>
-        page.get_by_text(re.compile(\"^hello$\", re.IGNORECASE))
-        ```
-
         **Details**
 
         Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
@@ -16831,10 +15572,6 @@ def get_by_title(
 
         You can check the issues count after locating it by the title text:
 
-        ```py
-        await expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
-        ```
-
         ```py
         expect(page.get_by_title(\"Issues count\")).to_have_text(\"25 issues\")
         ```
@@ -16862,11 +15599,6 @@ def frame_locator(self, selector: str) -> "FrameLocator":
 
         **Usage**
 
-        ```py
-        locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
-        await locator.click()
-        ```
-
         ```py
         locator = page.frame_locator(\"iframe\").get_by_text(\"Submit\")
         locator.click()
@@ -16926,10 +15658,6 @@ def nth(self, index: int) -> "Locator":
 
         **Usage**
 
-        ```py
-        banana = await page.get_by_role(\"listitem\").nth(2)
-        ```
-
         ```py
         banana = page.get_by_role(\"listitem\").nth(2)
         ```
@@ -16960,15 +15688,6 @@ def filter(
 
         **Usage**
 
-        ```py
-        row_locator = page.locator(\"tr\")
-        # ...
-        await row_locator.filter(has_text=\"text in column 1\").filter(
-            has=page.get_by_role(\"button\", name=\"column 2 button\")
-        ).screenshot()
-
-        ```
-
         ```py
         row_locator = page.locator(\"tr\")
         # ...
@@ -17026,15 +15745,6 @@ def or_(self, locator: "Locator") -> "Locator":
         Consider a scenario where you'd like to click on a \"New email\" button, but sometimes a security settings dialog
         shows up instead. In this case, you can wait for either a \"New email\" button, or a dialog and act accordingly.
 
-        ```py
-        new_email = page.get_by_role(\"button\", name=\"New\")
-        dialog = page.get_by_text(\"Confirm security settings\")
-        await expect(new_email.or_(dialog)).to_be_visible()
-        if (await dialog.is_visible()):
-          await page.get_by_role(\"button\", name=\"Dismiss\").click()
-        await new_email.click()
-        ```
-
         ```py
         new_email = page.get_by_role(\"button\", name=\"New\")
         dialog = page.get_by_text(\"Confirm security settings\")
@@ -17069,10 +15779,6 @@ def and_(self, locator: "Locator") -> "Locator":
         button = page.get_by_role(\"button\").and_(page.getByTitle(\"Subscribe\"))
         ```
 
-        ```py
-        button = page.get_by_role(\"button\").and_(page.getByTitle(\"Subscribe\"))
-        ```
-
         Parameters
         ----------
         locator : Locator
@@ -17128,11 +15834,6 @@ def all(self) -> typing.List["Locator"]:
 
         **Usage**
 
-        ```py
-        for li in await page.get_by_role('listitem').all():
-          await li.click();
-        ```
-
         ```py
         for li in page.get_by_role('listitem').all():
           li.click();
@@ -17155,10 +15856,6 @@ def count(self) -> int:
 
         **Usage**
 
-        ```py
-        count = await page.get_by_role(\"listitem\").count()
-        ```
-
         ```py
         count = page.get_by_role(\"listitem\").count()
         ```
@@ -17196,19 +15893,6 @@ def drag_to(
         source = page.locator(\"#source\")
         target = page.locator(\"#target\")
 
-        await source.drag_to(target)
-        # or specify exact positions relative to the top-left corners of the elements:
-        await source.drag_to(
-          target,
-          source_position={\"x\": 34, \"y\": 7},
-          target_position={\"x\": 10, \"y\": 20}
-        )
-        ```
-
-        ```py
-        source = page.locator(\"#source\")
-        target = page.locator(\"#target\")
-
         source.drag_to(target)
         # or specify exact positions relative to the top-left corners of the elements:
         source.drag_to(
@@ -17301,10 +15985,6 @@ def hover(
 
         **Usage**
 
-        ```py
-        await page.get_by_role(\"link\").hover()
-        ```
-
         ```py
         page.get_by_role(\"link\").hover()
         ```
@@ -17410,10 +16090,6 @@ def input_value(self, *, timeout: typing.Optional[float] = None) -> str:
 
         **Usage**
 
-        ```py
-        value = await page.get_by_role(\"textbox\").input_value()
-        ```
-
         ```py
         value = page.get_by_role(\"textbox\").input_value()
         ```
@@ -17450,10 +16126,6 @@ def is_checked(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         **Usage**
 
-        ```py
-        checked = await page.get_by_role(\"checkbox\").is_checked()
-        ```
-
         ```py
         checked = page.get_by_role(\"checkbox\").is_checked()
         ```
@@ -17483,10 +16155,6 @@ def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         **Usage**
 
-        ```py
-        disabled = await page.get_by_role(\"button\").is_disabled()
-        ```
-
         ```py
         disabled = page.get_by_role(\"button\").is_disabled()
         ```
@@ -17516,10 +16184,6 @@ def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         **Usage**
 
-        ```py
-        editable = await page.get_by_role(\"textbox\").is_editable()
-        ```
-
         ```py
         editable = page.get_by_role(\"textbox\").is_editable()
         ```
@@ -17549,10 +16213,6 @@ def is_enabled(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         **Usage**
 
-        ```py
-        enabled = await page.get_by_role(\"button\").is_enabled()
-        ```
-
         ```py
         enabled = page.get_by_role(\"button\").is_enabled()
         ```
@@ -17582,10 +16242,6 @@ def is_hidden(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         **Usage**
 
-        ```py
-        hidden = await page.get_by_role(\"button\").is_hidden()
-        ```
-
         ```py
         hidden = page.get_by_role(\"button\").is_hidden()
         ```
@@ -17614,10 +16270,6 @@ def is_visible(self, *, timeout: typing.Optional[float] = None) -> bool:
 
         **Usage**
 
-        ```py
-        visible = await page.get_by_role(\"button\").is_visible()
-        ```
-
         ```py
         visible = page.get_by_role(\"button\").is_visible()
         ```
@@ -17650,10 +16302,6 @@ def press(
 
         **Usage**
 
-        ```py
-        await page.get_by_role(\"textbox\").press(\"Backspace\")
-        ```
-
         ```py
         page.get_by_role(\"textbox\").press(\"Backspace\")
         ```
@@ -17725,20 +16373,12 @@ def screenshot(
 
         **Usage**
 
-        ```py
-        await page.get_by_role(\"link\").screenshot()
-        ```
-
         ```py
         page.get_by_role(\"link\").screenshot()
         ```
 
         Disable animations and save screenshot to a file:
 
-        ```py
-        await page.get_by_role(\"link\").screenshot(animations=\"disabled\", path=\"link.png\")
-        ```
-
         ```py
         page.get_by_role(\"link\").screenshot(animations=\"disabled\", path=\"link.png\")
         ```
@@ -17881,15 +16521,6 @@ def select_option(
         </select>
         ```
 
-        ```py
-        # single selection matching the value or label
-        await element.select_option(\"blue\")
-        # single selection matching the label
-        await element.select_option(label=\"blue\")
-        # multiple selection for blue, red and second option
-        await element.select_option(value=[\"red\", \"green\", \"blue\"])
-        ```
-
         ```py
         # single selection matching the value or label
         element.select_option(\"blue\")
@@ -17987,24 +16618,6 @@ def set_input_files(
 
         **Usage**
 
-        ```py
-        # Select one file
-        await page.get_by_label(\"Upload file\").set_input_files('myfile.pdf')
-
-        # Select multiple files
-        await page.get_by_label(\"Upload files\").set_input_files(['file1.txt', 'file2.txt'])
-
-        # Remove all the selected files
-        await page.get_by_label(\"Upload file\").set_input_files([])
-
-        # Upload buffer from memory
-        await page.get_by_label(\"Upload file\").set_input_files(
-            files=[
-                {\"name\": \"test.txt\", \"mimeType\": \"text/plain\", \"buffer\": b\"this is a test\"}
-            ],
-        )
-        ```
-
         ```py
         # Select one file
         page.get_by_label(\"Upload file\").set_input_files('myfile.pdf')
@@ -18206,11 +16819,6 @@ def press_sequentially(
 
         **Usage**
 
-        ```py
-        await locator.press_sequentially(\"hello\") # types instantly
-        await locator.press_sequentially(\"world\", delay=100) # types slower, like a user
-        ```
-
         ```py
         locator.press_sequentially(\"hello\") # types instantly
         locator.press_sequentially(\"world\", delay=100) # types slower, like a user
@@ -18218,12 +16826,6 @@ def press_sequentially(
 
         An example of typing into a text field and then submitting the form:
 
-        ```py
-        locator = page.get_by_label(\"Password\")
-        await locator.press_sequentially(\"my password\")
-        await locator.press(\"Enter\")
-        ```
-
         ```py
         locator = page.get_by_label(\"Password\")
         locator.press_sequentially(\"my password\")
@@ -18268,10 +16870,6 @@ def uncheck(
 
         **Usage**
 
-        ```py
-        await page.get_by_role(\"checkbox\").uncheck()
-        ```
-
         ```py
         page.get_by_role(\"checkbox\").uncheck()
         ```
@@ -18333,10 +16931,6 @@ def all_inner_texts(self) -> typing.List[str]:
 
         **Usage**
 
-        ```py
-        texts = await page.get_by_role(\"link\").all_inner_texts()
-        ```
-
         ```py
         texts = page.get_by_role(\"link\").all_inner_texts()
         ```
@@ -18358,10 +16952,6 @@ def all_text_contents(self) -> typing.List[str]:
 
         **Usage**
 
-        ```py
-        texts = await page.get_by_role(\"link\").all_text_contents()
-        ```
-
         ```py
         texts = page.get_by_role(\"link\").all_text_contents()
         ```
@@ -18390,11 +16980,6 @@ def wait_for(
 
         **Usage**
 
-        ```py
-        order_sent = page.locator(\"#order-sent\")
-        await order_sent.wait_for()
-        ```
-
         ```py
         order_sent = page.locator(\"#order-sent\")
         order_sent.wait_for()
@@ -18435,10 +17020,6 @@ def set_checked(
 
         **Usage**
 
-        ```py
-        await page.get_by_role(\"checkbox\").set_checked(True)
-        ```
-
         ```py
         page.get_by_role(\"checkbox\").set_checked(True)
         ```
@@ -19080,14 +17661,6 @@ def post(
 
         JSON objects can be passed directly to the request:
 
-        ```python
-        data = {
-            \"title\": \"Book Title\",
-            \"body\": \"John Doe\",
-        }
-        api_request_context.post(\"https://example.com/api/createBook\", data=data)
-        ```
-
         To send form data to the server use `form` option. Its value will be encoded into the request body with
         `application/x-www-form-urlencoded` encoding (see below how to use `multipart/form-data` form encoding to send
         files):
@@ -19198,14 +17771,6 @@ def fetch(
 
         **Usage**
 
-        ```python
-        data = {
-            \"title\": \"Book Title\",
-            \"body\": \"John Doe\",
-        }
-        api_request_context.fetch(\"https://example.com/api/createBook\", method=\"post\", data=data)
-        ```
-
         The common way to send file(s) in the body of a request is to encode it as form fields with `multipart/form-data`
         encoding. You can achieve that with Playwright API like this:
 
@@ -19394,14 +17959,6 @@ def to_have_title(
 
         **Usage**
 
-        ```py
-        import re
-        from playwright.async_api import expect
-
-        # ...
-        await expect(page).to_have_title(re.compile(r\".*checkout\"))
-        ```
-
         ```py
         import re
         from playwright.sync_api import expect
@@ -19466,14 +18023,6 @@ def to_have_url(
 
         **Usage**
 
-        ```py
-        import re
-        from playwright.async_api import expect
-
-        # ...
-        await expect(page).to_have_url(re.compile(\".*checkout\"))
-        ```
-
         ```py
         import re
         from playwright.sync_api import expect
@@ -19555,15 +18104,6 @@ def to_contain_text(
 
         **Usage**
 
-        ```py
-        import re
-        from playwright.async_api import expect
-
-        locator = page.locator('.title')
-        await expect(locator).to_contain_text(\"substring\")
-        await expect(locator).to_contain_text(re.compile(r\"\\d messages\"))
-        ```
-
         ```py
         import re
         from playwright.sync_api import expect
@@ -19591,22 +18131,6 @@ def to_contain_text(
 
         Let's see how we can use the assertion:
 
-        ```py
-        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\"])
-
-        # ✖ Wrong order
-        await expect(page.locator(\"ul > li\")).to_contain_text([\"Text 3\", \"Text 2\"])
-
-        # ✖ No item contains this text
-        await expect(page.locator(\"ul > li\")).to_contain_text([\"Some 33\"])
-
-        # ✖ Locator points to the outer list element, not to the list items
-        await expect(page.locator(\"ul\")).to_contain_text([\"Text 3\"])
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -19705,13 +18229,6 @@ def to_have_attribute(
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.locator(\"input\")
-        await expect(locator).to_have_attribute(\"type\", \"text\")
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -19798,14 +18315,6 @@ def to_have_class(
         <div class='selected row' id='component'></div>
         ```
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.locator(\"#component\")
-        await expect(locator).to_have_class(re.compile(r\"selected\"))
-        await expect(locator).to_have_class(\"selected row\")
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -19816,13 +18325,6 @@ def to_have_class(
 
         Note that if array is passed as an expected value, entire lists of elements can be asserted:
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.locator(\"list > .component\")
-        await expect(locator).to_have_class([\"component\", \"component selected\", \"component\"])
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -19889,13 +18391,6 @@ def to_have_count(
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.locator(\"list > .component\")
-        await expect(locator).to_have_count(3)
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -19949,13 +18444,6 @@ def to_have_css(
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.get_by_role(\"button\")
-        await expect(locator).to_have_css(\"display\", \"flex\")
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20020,13 +18508,6 @@ def to_have_id(
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.get_by_role(\"textbox\")
-        await expect(locator).to_have_id(\"lastname\")
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20080,13 +18561,6 @@ def to_have_js_property(
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.locator(\".component\")
-        await expect(locator).to_have_js_property(\"loaded\", True)
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20152,14 +18626,6 @@ def to_have_value(
 
         **Usage**
 
-        ```py
-        import re
-        from playwright.async_api import expect
-
-        locator = page.locator(\"input[type=number]\")
-        await expect(locator).to_have_value(re.compile(r\"[0-9]\"))
-        ```
-
         ```py
         import re
         from playwright.sync_api import expect
@@ -20231,15 +18697,6 @@ def to_have_values(
         </select>
         ```
 
-        ```py
-        import re
-        from playwright.async_api import expect
-
-        locator = page.locator(\"id=favorite-colors\")
-        await locator.select_option([\"R\", \"G\"])
-        await expect(locator).to_have_values([re.compile(r\"R\"), re.compile(r\"G\")])
-        ```
-
         ```py
         import re
         from playwright.sync_api import expect
@@ -20323,15 +18780,6 @@ def to_have_text(
 
         **Usage**
 
-        ```py
-        import re
-        from playwright.async_api import expect
-
-        locator = page.locator(\".title\")
-        await expect(locator).to_have_text(re.compile(r\"Welcome, Test User\"))
-        await expect(locator).to_have_text(re.compile(r\"Welcome, .*\"))
-        ```
-
         ```py
         import re
         from playwright.sync_api import expect
@@ -20358,22 +18806,6 @@ def to_have_text(
 
         Let's see how we can use the assertion:
 
-        ```py
-        from playwright.async_api import expect
-
-        # ✓ Has the right items in the right order
-        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
-
-        # ✖ Wrong order
-        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 3\", \"Text 2\", \"Text 1\"])
-
-        # ✖ Last item does not match
-        await expect(page.locator(\"ul > li\")).to_have_text([\"Text 1\", \"Text 2\", \"Text\"])
-
-        # ✖ Locator points to the outer list element, not to the list items
-        await expect(page.locator(\"ul\")).to_have_text([\"Text 1\", \"Text 2\", \"Text 3\"])
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20471,10 +18903,6 @@ def to_be_attached(
 
         **Usage**
 
-        ```py
-        await expect(page.get_by_text(\"Hidden text\")).to_be_attached()
-        ```
-
         ```py
         expect(page.get_by_text(\"Hidden text\")).to_be_attached()
         ```
@@ -20505,13 +18933,6 @@ def to_be_checked(
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.get_by_label(\"Subscribe to newsletter\")
-        await expect(locator).to_be_checked()
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20582,13 +19003,6 @@ def to_be_disabled(self, *, timeout: typing.Optional[float] = None) -> None:
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.locator(\"button.submit\")
-        await expect(locator).to_be_disabled()
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20635,13 +19049,6 @@ def to_be_editable(
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.get_by_role(\"textbox\")
-        await expect(locator).to_be_editable()
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20694,13 +19101,6 @@ def to_be_empty(self, *, timeout: typing.Optional[float] = None) -> None:
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.locator(\"div.warning\")
-        await expect(locator).to_be_empty()
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20747,13 +19147,6 @@ def to_be_enabled(
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.locator(\"button.submit\")
-        await expect(locator).to_be_enabled()
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20805,13 +19198,6 @@ def to_be_hidden(self, *, timeout: typing.Optional[float] = None) -> None:
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.locator('.my-element')
-        await expect(locator).to_be_hidden()
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20860,21 +19246,6 @@ def to_be_visible(
 
         **Usage**
 
-        ```py
-        # A specific element is visible.
-        await expect(page.get_by_text(\"Welcome\")).to_be_visible()
-
-        # At least one item in the list is visible.
-        await expect(page.get_by_test_id(\"todo-item\").first).to_be_visible()
-
-        # At least one of the two elements is visible, possibly both.
-        await expect(
-            page.get_by_role(\"button\", name=\"Sign in\")
-            .or_(page.get_by_role(\"button\", name=\"Sign up\"))
-            .first
-        ).to_be_visible()
-        ```
-
         ```py
         # A specific element is visible.
         expect(page.get_by_text(\"Welcome\")).to_be_visible()
@@ -20933,13 +19304,6 @@ def to_be_focused(self, *, timeout: typing.Optional[float] = None) -> None:
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.get_by_role(\"textbox\")
-        await expect(locator).to_be_focused()
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -20987,18 +19351,6 @@ def to_be_in_viewport(
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        locator = page.get_by_role(\"button\")
-        # Make sure at least some part of element intersects viewport.
-        await expect(locator).to_be_in_viewport()
-        # Make sure element is fully outside of viewport.
-        await expect(locator).not_to_be_in_viewport()
-        # Make sure that at least half of the element intersects viewport.
-        await expect(locator).to_be_in_viewport(ratio=0.5)
-        ```
-
         ```py
         from playwright.sync_api import expect
 
@@ -21061,13 +19413,6 @@ def to_be_ok(self) -> None:
 
         **Usage**
 
-        ```py
-        from playwright.async_api import expect
-
-        # ...
-        await expect(response).to_be_ok()
-        ```
-
         ```py
         import re
         from playwright.sync_api import expect
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 2d03ebc04..457212913 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -222,7 +222,7 @@ def print_events(self, class_name: str) -> None:
                         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)}"""'
+                        f'        """{self.beautify_method_comment(event["comment"], " " * 8)}"""'
                     )
                     doc.append(impl)
                 if len(events) > 1:
@@ -240,6 +240,7 @@ def indent_paragraph(self, p: str, indent: str) -> str:
         return "\n".join(result)
 
     def beautify_method_comment(self, comment: str, indent: str) -> str:
+        comment = self.filter_out_redudant_python_code_snippets(comment)
         comment = comment.replace("\\", "\\\\")
         comment = comment.replace('"', '\\"')
         lines = comment.split("\n")
@@ -270,6 +271,37 @@ def beautify_method_comment(self, comment: str, indent: str) -> str:
         comment = self.indent_paragraph("\n".join(result), indent)
         return self.resolve_playwright_dev_links(comment)
 
+    def filter_out_redudant_python_code_snippets(self, comment: str) -> str:
+        groups = []
+        current_group = []
+        lines = comment.split("\n")
+        start_pos = None
+        for i in range(len(lines)):
+            line = lines[i].strip()
+            if line.startswith("```py"):
+                start_pos = i
+            elif line == "```" and start_pos is not None:
+                current_group.append((start_pos, i))
+                start_pos = None
+            elif (
+                (line.startswith("```") or i == len(lines) - 1)
+                and start_pos is None
+                and len(current_group) == 2
+            ):
+                groups.append(current_group)
+                current_group = []
+        groups.reverse()
+        for first_pos, second_pos in groups:
+            # flake8: noqa: E203
+            second_snippet_is_async = "await" in lines[second_pos[0] : second_pos[1]]
+            if second_snippet_is_async == self.is_async:
+                # flake8: noqa: E203
+                del lines[first_pos[0] : first_pos[1] + 1]
+            else:
+                # flake8: noqa: E203
+                del lines[second_pos[0] : second_pos[1] + 1]
+        return "\n".join(lines)
+
     def resolve_playwright_dev_links(self, comment: str) -> str:
         def replace_callback(m: re.Match) -> str:
             link_text = m.group(1)

From 5cc10781b9c1e7727d6bb61461a028d547c07003 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 6 Feb 2024 11:14:49 +0100
Subject: [PATCH 136/438] chore: new issue templates (#2277)

---
 .github/ISSUE_TEMPLATE/bug.md             | 58 --------------
 .github/ISSUE_TEMPLATE/bug.yml            | 96 +++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml         |  1 +
 .github/ISSUE_TEMPLATE/documentation.yml  | 29 +++++++
 .github/ISSUE_TEMPLATE/feature.yml        | 30 +++++++
 .github/ISSUE_TEMPLATE/feature_request.md | 11 ---
 .github/ISSUE_TEMPLATE/question.yml       | 27 +++++++
 .github/ISSUE_TEMPLATE/regression.md      | 32 --------
 .github/ISSUE_TEMPLATE/regression.yml     | 92 ++++++++++++++++++++++
 9 files changed, 275 insertions(+), 101 deletions(-)
 delete mode 100644 .github/ISSUE_TEMPLATE/bug.md
 create mode 100644 .github/ISSUE_TEMPLATE/bug.yml
 create mode 100644 .github/ISSUE_TEMPLATE/documentation.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature.yml
 delete mode 100644 .github/ISSUE_TEMPLATE/feature_request.md
 create mode 100644 .github/ISSUE_TEMPLATE/question.yml
 delete mode 100644 .github/ISSUE_TEMPLATE/regression.md
 create mode 100644 .github/ISSUE_TEMPLATE/regression.yml

diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md
deleted file mode 100644
index b74140629..000000000
--- a/.github/ISSUE_TEMPLATE/bug.md
+++ /dev/null
@@ -1,58 +0,0 @@
----
-name: Bug Report
-about: Something doesn't work like it should? Tell us!
-title: "[BUG]"
-labels: ''
-assignees: ''
-
----
-
-<!-- ⚠️⚠️ Do not delete this template ⚠️⚠️ -->
-
-<!-- 🔎 Search existing issues to avoid creating duplicates. -->
-<!-- 🧪 Test using the latest Playwright release to see if your issue has already been fixed -->
-<!-- 💡 Provide enough information for us to be able to reproduce your issue locally -->
-
-### System info
-- Playwright Version: [v1.XX]
-- Operating System: [All, Windows 11, Ubuntu 20, macOS 13.2, etc.]
-- Browser: [All, Chromium, Firefox, WebKit]
-- Other info:
-
-### Source code
-
-- [ ] I provided exact source code that allows reproducing the issue locally.
-
-<!-- For simple cases, please provide a self-contained test file along with the config file -->
-<!-- For larger cases, you can provide a GitHub repo you created for this issue -->
-<!-- If we can not reproduce the problem locally, we won't be able to act on it -->
-<!-- You can still file without the exact code and we will try to help, but if we can't repro, it will be closed -->
-
-**Link to the GitHub repository with the repro**
-
-[https://github.com/your_profile/playwright_issue_title]
-
-or
-
-**Test file (self-contained)**
-
-```python
-from playwright.sync_api import sync_playwright
-with sync_playwright() as p:
-    browser = p.chromium.launch()
-    page = browser.new_page()
-    # ...
-    browser.close()
-```
-
-**Steps**
-- [Run the test]
-- [...]
-
-**Expected**
-
-[Describe expected behavior]
-
-**Actual**
-
-[Describe actual behavior]
diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml
new file mode 100644
index 000000000..620ff4109
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.yml
@@ -0,0 +1,96 @@
+name: Bug Report 🪲
+description: Create a bug report to help us improve
+title: '[Bug]: '
+body:
+  - type: markdown
+    attributes:
+      value: |
+        # Please follow these steps first:
+  - type: markdown
+    attributes:
+      value: |
+        ## Troubleshoot
+        If Playwright is not behaving the way you expect, we'd ask you to look at the [documentation](https://playwright.dev/python/docs/intro) and search the issue tracker for evidence supporting your expectation.
+        Please make reasonable efforts to troubleshoot and rule out issues with your code, the configuration, or any 3rd party libraries you might be using.
+        Playwright offers [several debugging tools](https://playwright.dev/python/docs/debug) that you can use to troubleshoot your issues.
+  - type: markdown
+    attributes:
+      value: |
+        ## Ask for help through appropriate channels
+        If you feel unsure about the cause of the problem, consider asking for help on for example [StackOverflow](https://stackoverflow.com/questions/ask) or our [Discord channel](https://aka.ms/playwright/discord) before posting a bug report. The issue tracker is not a help forum.
+  - type: markdown
+    attributes:
+      value: |
+        ## Make a minimal reproduction
+        To file the report, you will need a GitHub repository with a minimal (but complete) example and simple/clear steps on how to reproduce the bug.
+        The simpler you can make it, the more likely we are to successfully verify and fix the bug.
+  - type: markdown
+    attributes:
+      value: |
+        > [!IMPORTANT]
+        > Bug reports without a minimal reproduction will be rejected.
+
+        ---
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: |
+        The version of Playwright you are using.
+        Is it the [latest](https://github.com/microsoft/playwright-python/releases)? Test and see if the bug has already been fixed.
+      placeholder: ex. 1.41.1
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      description: Please link to a repository with a minimal reproduction and describe accurately how we can reproduce/verify the bug.
+      value: |
+        Example steps (replace with your own):
+        1. Clone my repo at https://github.com/<myuser>/example
+        2. pip install -r requirements.txt
+        3. python test.py
+        4. You should see the error come up
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: A description of what you expect to happen.
+      placeholder: I expect to see X or Y
+    validations:
+      required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: Actual behavior
+      description: |
+        A clear and concise description of the unexpected behavior.
+        Please include any relevant output here, especially any error messages.
+      placeholder: A bug happened!
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Anything else that might be relevant
+    validations:
+      required: false
+  - type: textarea
+    id: envinfo
+    attributes:
+      label: Environment
+      description: |
+        Please provide information about the environment you are running in.
+      value: |
+        - Operating System: [Ubuntu 22.04]
+        - CPU: [arm64]
+        - Browser: [All, Chromium, Firefox, WebKit]
+        - Python Version: [3.12]
+        - Other info:
+      render: Text
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index 726c186c0..13b5b0a96 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,3 +1,4 @@
+blank_issues_enabled: false
 contact_links:
   - name: Join our Discord Server
     url: https://aka.ms/playwright/discord
diff --git a/.github/ISSUE_TEMPLATE/documentation.yml b/.github/ISSUE_TEMPLATE/documentation.yml
new file mode 100644
index 000000000..eaf31b8bd
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/documentation.yml
@@ -0,0 +1,29 @@
+name: Documentation 📖
+description: Submit a request to add or update documentation
+title: '[Docs]: '
+labels: ['Documentation :book:']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### Thank you for helping us improve our documentation!
+        Please be sure you are looking at [the Next version of the documentation](https://playwright.dev/python/docs/next/intro) before opening an issue here.
+  - type: textarea
+    id: links
+    attributes:
+      label: Page(s)
+      description: |
+        Links to one or more documentation pages that should be modified.
+        If you are reporting an issue with a specific section of a page, try to link directly to the nearest anchor.
+        If you are suggesting that a new page be created, link to the parent of the proposed page.
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: |
+        Describe the change you are requesting.
+        If the issue pertains to a single function or matcher, be sure to specify the entire call signature.
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/feature.yml b/.github/ISSUE_TEMPLATE/feature.yml
new file mode 100644
index 000000000..efec3315c
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature.yml
@@ -0,0 +1,30 @@
+name: Feature Request 🚀
+description: Submit a proposal for a new feature
+title: '[Feature]: '
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### Thank you for taking the time to suggest a new feature!
+  - type: textarea
+    id: description
+    attributes:
+      label: '🚀 Feature Request'
+      description: A clear and concise description of what the feature is.
+    validations:
+      required: true
+  - type: textarea
+    id: example
+    attributes:
+      label: Example
+      description: Describe how this feature would be used.
+    validations:
+      required: false
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation
+      description: |
+        Outline your motivation for the proposal. How will it make Playwright better?
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
deleted file mode 100644
index 37ec8a7d2..000000000
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-name: Feature request
-about: Request new features to be added
-title: "[Feature]"
-labels: ''
-assignees: ''
-
----
-
-Let us know what functionality you'd like to see in Playwright and what your use case is.
-Do you think others might benefit from this as well?
diff --git a/.github/ISSUE_TEMPLATE/question.yml b/.github/ISSUE_TEMPLATE/question.yml
new file mode 100644
index 000000000..9615afdc8
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/question.yml
@@ -0,0 +1,27 @@
+name: 'Questions / Help 💬'
+description: If you have questions, please check StackOverflow or Discord
+title: '[Please read the message below]'
+labels: [':speech_balloon: Question']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## Questions and Help 💬
+
+        This issue tracker is reserved for bug reports and feature requests.
+
+        For anything else, such as questions or getting help, please see:
+
+        - [The Playwright documentation](https://playwright.dev)
+        - [Our Discord server](https://aka.ms/playwright/discord)
+  - type: checkboxes
+    id: no-post
+    attributes:
+      label: |
+        Please do not submit this issue.
+      description: |
+        > [!IMPORTANT]
+        > This issue will be closed.
+      options:
+        - label: I understand
+          required: true
diff --git a/.github/ISSUE_TEMPLATE/regression.md b/.github/ISSUE_TEMPLATE/regression.md
deleted file mode 100644
index 44a903108..000000000
--- a/.github/ISSUE_TEMPLATE/regression.md
+++ /dev/null
@@ -1,32 +0,0 @@
----
-name: Report regression
-about: Functionality that used to work and does not any more
-title: "[REGRESSION]: "
-labels: ''
-assignees: ''
-
----
-
-**Context:**
-- GOOD Playwright Version: [what Playwright version worked nicely?]
-- BAD Playwright Version: [what Playwright version doesn't work any more?]
-- Operating System: [e.g. Windows, Linux or Mac]
-- Extra: [any specific details about your environment]
-
-**Code Snippet**
-
-Help us help you! Put down a short code snippet that illustrates your bug and
-that we can run and debug locally. For example:
-
-```python
-from playwright.sync_api import sync_playwright
-with sync_playwright() as p:
-    browser = p.chromium.launch()
-    page = browser.new_page()
-    # ...
-    browser.close()
-```
-
-**Describe the bug**
-
-Add any other details about the problem here.
diff --git a/.github/ISSUE_TEMPLATE/regression.yml b/.github/ISSUE_TEMPLATE/regression.yml
new file mode 100644
index 000000000..35879ad72
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/regression.yml
@@ -0,0 +1,92 @@
+name: Report regression
+description: Functionality that used to work and does not any more
+title: "[Regression]: "
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        # Please follow these steps first:
+  - type: markdown
+    attributes:
+      value: |
+        ## Make a minimal reproduction
+        To file the report, you will need a GitHub repository with a minimal (but complete) example and simple/clear steps on how to reproduce the regression.
+        The simpler you can make it, the more likely we are to successfully verify and fix the regression.
+  - type: markdown
+    attributes:
+      value: |
+        > [!IMPORTANT]
+        > Regression reports without a minimal reproduction will be rejected.
+
+        ---
+  - type: input
+    id: goodVersion
+    attributes:
+      label: Last Good Version
+      description: |
+        Last version of Playwright where the feature was working.
+      placeholder: ex. 1.40.1
+    validations:
+      required: true
+  - type: input
+    id: badVersion
+    attributes:
+      label: First Bad Version
+      description: |
+        First version of Playwright where the feature was broken.
+        Is it the [latest](https://github.com/microsoft/playwright-python/releases)? Test and see if the regression has already been fixed.
+      placeholder: ex. 1.41.1
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      description: Please link to a repository with a minimal reproduction and describe accurately how we can reproduce/verify the bug.
+      value: |
+        Example steps (replace with your own):
+        1. Clone my repo at https://github.com/<myuser>/example
+        2. pip -r requirements.txt
+        3. python test.py
+        4. You should see the error come up
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: A description of what you expect to happen.
+      placeholder: I expect to see X or Y
+    validations:
+      required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: Actual behavior
+      description: A clear and concise description of the unexpected behavior.
+      placeholder: A bug happened!
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Anything else that might be relevant
+    validations:
+      required: false
+  - type: textarea
+    id: envinfo
+    attributes:
+      label: Environment
+      description: |
+        Please provide information about the environment you are running in.
+      value: |
+        - Operating System: [Ubuntu 22.04]
+        - CPU: [arm64]
+        - Browser: [All, Chromium, Firefox, WebKit]
+        - Python Version: [3.12]
+        - Other info:
+      render: Text
+    validations:
+      required: true

From 0fbd4095b417b66b31b172765c50b53661273768 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 6 Feb 2024 21:37:56 +0100
Subject: [PATCH 137/438] devops: migrate to 1ES PT templates (#2278)

---
 .azure-pipelines/publish.yml | 83 +++++++++++++++++++++---------------
 1 file changed, 48 insertions(+), 35 deletions(-)

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index 74c85ea53..e7f2aa385 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -1,38 +1,51 @@
-# don't trigger for Pull Requests
+trigger: none
 pr: none
 
-trigger:
-  tags:
-    include:
-    - '*'
+resources:
+  repositories:
+  - repository: 1esPipelines
+    type: git
+    name: 1ESPipelineTemplates/1ESPipelineTemplates
+    ref: refs/tags/release
 
-pool:
-  vmImage: ubuntu-latest
-
-steps:
-- task: UsePythonVersion@0
-  inputs:
-    versionSpec: '3.8'
-  displayName: 'Use Python'
-
-- script: |
-    python -m pip install --upgrade pip
-    pip install -r local-requirements.txt
-    pip install -e .
-    python setup.py bdist_wheel --all
-  displayName: 'Install & Build'
-
-- task: EsrpRelease@4
-  inputs:
-    ConnectedServiceName: 'Playwright-ESRP'
-    Intent: 'PackageDistribution'
-    ContentType: 'PyPi'
-    ContentSource: 'Folder'
-    FolderLocation: './dist/'
-    WaitForReleaseCompletion: true
-    Owners: 'maxschmitt@microsoft.com'
-    Approvers: 'maxschmitt@microsoft.com'
-    ServiceEndpointUrl: 'https://api.esrp.microsoft.com'
-    MainPublisher: 'Playwright'
-    DomainTenantId: '72f988bf-86f1-41af-91ab-2d7cd011db47'
-  displayName: 'ESRP Release to PIP'
+extends:
+  template: v1/1ES.Official.PipelineTemplate.yml@1esPipelines
+  parameters:
+    pool:
+      name: DevDivPlaywrightAzurePipelinesUbuntu2204
+      os: linux
+    sdl:
+      sourceAnalysisPool:
+        name: DevDivPlaywrightAzurePipelinesWindows2022
+        # The image must be windows-based due to restrictions of the SDL tools. See: https://aka.ms/AAo6v8e
+        # In the case of a windows build, this can be the same as the above pool image.
+        os: windows
+    stages:
+    - stage: Stage
+      jobs:
+      - job: HostJob
+        steps:
+        - task: UsePythonVersion@0
+          inputs:
+            versionSpec: '3.8'
+          displayName: 'Use Python'
+        - script: |
+            python -m pip install --upgrade pip
+            pip install -r local-requirements.txt
+            pip install -e .
+            python setup.py bdist_wheel --all
+          displayName: 'Install & Build'
+        - task: EsrpRelease@4
+          inputs:
+            ConnectedServiceName: 'Playwright-ESRP'
+            Intent: 'PackageDistribution'
+            ContentType: 'PyPi'
+            ContentSource: 'Folder'
+            FolderLocation: './dist/'
+            WaitForReleaseCompletion: true
+            Owners: 'maxschmitt@microsoft.com'
+            Approvers: 'maxschmitt@microsoft.com'
+            ServiceEndpointUrl: 'https://api.esrp.microsoft.com'
+            MainPublisher: 'Playwright'
+            DomainTenantId: '72f988bf-86f1-41af-91ab-2d7cd011db47'
+          displayName: 'ESRP Release to PIP'

From 1b3594aa9f17746d71d6cd34de6f8a8253f42610 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 6 Feb 2024 21:42:17 +0100
Subject: [PATCH 138/438] devops: migrate to 1ES PT templates follow-up

---
 .azure-pipelines/publish.yml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index e7f2aa385..fa2d014ce 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -1,6 +1,10 @@
-trigger: none
 pr: none
 
+trigger:
+  tags:
+    include:
+    - '*'
+
 resources:
   repositories:
   - repository: 1esPipelines

From d7b3569cc480baecd1e30fa342b638db3b0a1f06 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 6 Feb 2024 22:49:22 +0100
Subject: [PATCH 139/438] devops: suppress test artifact SDL warnings (#2279)

---
 .azure-pipelines/guardian/SDL/.gdnsuppress | 105 +++++++++++++++++++++
 .azure-pipelines/publish.yml               |   2 +
 2 files changed, 107 insertions(+)
 create mode 100644 .azure-pipelines/guardian/SDL/.gdnsuppress

diff --git a/.azure-pipelines/guardian/SDL/.gdnsuppress b/.azure-pipelines/guardian/SDL/.gdnsuppress
new file mode 100644
index 000000000..2d1eca140
--- /dev/null
+++ b/.azure-pipelines/guardian/SDL/.gdnsuppress
@@ -0,0 +1,105 @@
+{
+  "hydrated": false,
+  "properties": {
+    "helpUri": "https://eng.ms/docs/microsoft-security/security/azure-security/cloudai-security-fundamentals-engineering/security-integration/guardian-wiki/microsoft-guardian/general/suppressions",
+    "hydrationStatus": "This file does not contain identifying data. It is safe to check into your repo. To hydrate this file with identifying data, run `guardian hydrate --help` and follow the guidance."
+  },
+  "version": "1.0.0",
+  "suppressionSets": {
+    "default": {
+      "name": "default",
+      "createdDate": "2024-02-06 21:00:02Z",
+      "lastUpdatedDate": "2024-02-06 21:00:02Z"
+    }
+  },
+  "results": {
+    "bffa73d7410f5963f2538f06124ac5524c076da77867a0a19ccf60e508062dff": {
+      "signature": "bffa73d7410f5963f2538f06124ac5524c076da77867a0a19ccf60e508062dff",
+      "alternativeSignatures": [],
+      "memberOf": [
+        "default"
+      ],
+      "createdDate": "2024-02-06 21:00:02Z"
+    },
+    "964642e3cd0f022d5b63f5d3c467d034df4b1664e58dd132b6cd54c98bdae6a1": {
+      "signature": "964642e3cd0f022d5b63f5d3c467d034df4b1664e58dd132b6cd54c98bdae6a1",
+      "alternativeSignatures": [
+        "f2d5560538c833834ca11e62fa6509618ab5454e1e71faf2847cb6fd07f4c4e0"
+      ],
+      "memberOf": [
+        "default"
+      ],
+      "createdDate": "2024-02-06 21:00:02Z"
+    },
+    "5b0f97262e176cd67207fd63a2c74b9984829286e9229d10efc32d6b73130e37": {
+      "signature": "5b0f97262e176cd67207fd63a2c74b9984829286e9229d10efc32d6b73130e37",
+      "alternativeSignatures": [
+        "29a18985690880b8caeebc339c7d2afd107510838cdc6561c1f5493478712581"
+      ],
+      "memberOf": [
+        "default"
+      ],
+      "createdDate": "2024-02-06 21:00:02Z"
+    },
+    "636fe8a4848f24231e94dc13a238022f90a2894cd47a483e351e467eeb98de52": {
+      "signature": "636fe8a4848f24231e94dc13a238022f90a2894cd47a483e351e467eeb98de52",
+      "alternativeSignatures": [
+        "e20632aa7941af4239fd857f802e05582c841fb9ae84e17c71ca6c7fc713246b"
+      ],
+      "memberOf": [
+        "default"
+      ],
+      "createdDate": "2024-02-06 21:00:02Z"
+    },
+    "67ae7118600b0793ec3f0a58a753888e13ce4badcc15575614ee6aa622e5009c": {
+      "signature": "67ae7118600b0793ec3f0a58a753888e13ce4badcc15575614ee6aa622e5009c",
+      "alternativeSignatures": [
+        "d1e68c2c7d9815f47331dd34c31db2634804b45b078a53d00843082747155ac9"
+      ],
+      "memberOf": [
+        "default"
+      ],
+      "createdDate": "2024-02-06 21:00:02Z"
+    },
+    "9b7d0de03b9e0e0b2711e31df7c804528c357bf5aa2d689fb5a5f42750e84077": {
+      "signature": "9b7d0de03b9e0e0b2711e31df7c804528c357bf5aa2d689fb5a5f42750e84077",
+      "alternativeSignatures": [
+        "e42bf5a49be2b1b815d1fde98ebf9d463fd2e70be1e8ca661f1210ce5b0c4953"
+      ],
+      "memberOf": [
+        "default"
+      ],
+      "createdDate": "2024-02-06 21:00:02Z"
+    },
+    "06ecbceae8bfd10acf8c35f21af3926d172c7930f24a204cc58b61efc6c4c770": {
+      "signature": "06ecbceae8bfd10acf8c35f21af3926d172c7930f24a204cc58b61efc6c4c770",
+      "alternativeSignatures": [
+        "035d6eb1444a809987923a39793fbb1ab9e4462405f38f94bc425c579705a9f2"
+      ],
+      "memberOf": [
+        "default"
+      ],
+      "createdDate": "2024-02-06 21:00:02Z"
+    },
+    "c103671af429c32de81f2dc2e7a92999de88a517d916a8f75c8e37448bb2efe9": {
+      "signature": "c103671af429c32de81f2dc2e7a92999de88a517d916a8f75c8e37448bb2efe9",
+      "alternativeSignatures": [
+        "3f904a503c12b62c2922900a2e689632e06272a815448939b1fdd435bcf74388"
+      ],
+      "memberOf": [
+        "default"
+      ],
+      "createdDate": "2024-02-06 21:00:02Z"
+    },
+    "d1196285a4e64cf6f0f7f22a29bf5b33b540137da1a89ed2af0c880d2a8c1d64": {
+      "signature": "d1196285a4e64cf6f0f7f22a29bf5b33b540137da1a89ed2af0c880d2a8c1d64",
+      "alternativeSignatures": [
+        "1c24094ca9e68a76a81c747853860e46fd139c9f47f0fdbad9133538e7d064b2"
+      ],
+      "memberOf": [
+        "default"
+      ],
+      "createdDate": "2024-02-06 21:00:02Z"
+    }
+  }
+}
diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index fa2d014ce..10d6ead8b 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -24,6 +24,8 @@ extends:
         # The image must be windows-based due to restrictions of the SDL tools. See: https://aka.ms/AAo6v8e
         # In the case of a windows build, this can be the same as the above pool image.
         os: windows
+      suppression:
+        suppressionFile: $(Build.SourcesDirectory)\.azure-pipelines\guardian\SDL\.gdnsuppress
     stages:
     - stage: Stage
       jobs:

From 752467d1a40f9ec0af38c0b79dc07fcba5e6a2e9 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 9 Feb 2024 14:52:17 +0100
Subject: [PATCH 140/438] test: fix stalling future (#2282)

---
 tests/async/test_unroute_behavior.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/tests/async/test_unroute_behavior.py b/tests/async/test_unroute_behavior.py
index 8a9b46b3b..036423cdc 100644
--- a/tests/async/test_unroute_behavior.py
+++ b/tests/async/test_unroute_behavior.py
@@ -351,6 +351,7 @@ async def _unroute_promise() -> None:
 async def test_page_close_does_not_wait_for_active_route_handlers(
     page: Page, server: Server
 ) -> None:
+    stalling_future: "asyncio.Future[None]" = asyncio.Future()
     second_handler_called = False
 
     def _handler1(route: Route) -> None:
@@ -365,7 +366,7 @@ def _handler1(route: Route) -> None:
 
     async def _handler2(route: Route) -> None:
         route_future.set_result(route)
-        await asyncio.Future()
+        await stalling_future
 
     await page.route(
         "**/*",
@@ -383,6 +384,7 @@ async def _goto_ignore_exceptions() -> None:
     await page.close()
     await asyncio.sleep(0.5)
     assert not second_handler_called
+    stalling_future.cancel()
 
 
 async def test_route_continue_should_not_throw_if_page_has_been_closed(

From f13474810343b812694e1f6a450a91e3abf7e81e Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 9 Feb 2024 14:54:25 +0100
Subject: [PATCH 141/438] devops: simplify Docker publishing (#2283)

---
 .github/workflows/publish_canary_docker.yml   | 34 -------------------
 ..._release_docker.yml => publish_docker.yml} |  2 +-
 utils/docker/publish_docker.sh                |  6 ----
 3 files changed, 1 insertion(+), 41 deletions(-)
 delete mode 100644 .github/workflows/publish_canary_docker.yml
 rename .github/workflows/{publish_release_docker.yml => publish_docker.yml} (98%)

diff --git a/.github/workflows/publish_canary_docker.yml b/.github/workflows/publish_canary_docker.yml
deleted file mode 100644
index 757dee7b5..000000000
--- a/.github/workflows/publish_canary_docker.yml
+++ /dev/null
@@ -1,34 +0,0 @@
-name: "publish canary docker"
-
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: "10 0 * * *"
-
-jobs:
-  publish-canary:
-    name: "Publish canary Docker"
-    runs-on: ubuntu-20.04
-    if: github.repository == 'microsoft/playwright-python'
-    steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python
-      uses: actions/setup-python@v4
-      with:
-        python-version: "3.10"
-    - name: Install dependencies & browsers
-      run: |
-        python -m pip install --upgrade pip
-        pip install -r local-requirements.txt
-        pip install -e .
-    - uses: azure/docker-login@v1
-      with:
-        login-server: playwright.azurecr.io
-        username: playwright
-        password: ${{ secrets.DOCKER_PASSWORD }}
-    - name: Set up Docker QEMU for arm64 docker builds
-      uses: docker/setup-qemu-action@v2
-      with:
-        platforms: arm64
-    - name: publish docker canary
-      run: ./utils/docker/publish_docker.sh canary
diff --git a/.github/workflows/publish_release_docker.yml b/.github/workflows/publish_docker.yml
similarity index 98%
rename from .github/workflows/publish_release_docker.yml
rename to .github/workflows/publish_docker.yml
index 8bb9c5c7b..d69645bee 100644
--- a/.github/workflows/publish_release_docker.yml
+++ b/.github/workflows/publish_docker.yml
@@ -14,7 +14,7 @@ on:
 jobs:
   publish-docker-release:
     name: "publish to DockerHub"
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     if: github.repository == 'microsoft/playwright-python'
     steps:
     - uses: actions/checkout@v3
diff --git a/utils/docker/publish_docker.sh b/utils/docker/publish_docker.sh
index e5bba0eb9..d47df4c1d 100755
--- a/utils/docker/publish_docker.sh
+++ b/utils/docker/publish_docker.sh
@@ -26,11 +26,6 @@ else
   exit 1
 fi
 
-if [[ -z "${GITHUB_SHA}" ]]; then
-  echo "ERROR: GITHUB_SHA env variable must be specified"
-  exit 1
-fi
-
 FOCAL_TAGS=(
   "next-focal"
 )
@@ -42,7 +37,6 @@ fi
 JAMMY_TAGS=(
   "next"
   "next-jammy"
-  "sha-${GITHUB_SHA}"
 )
 if [[ "$RELEASE_CHANNEL" == "stable" ]]; then
   JAMMY_TAGS+=("latest")

From ba6f7834ae6111a037dd6a34e2971316d1d06cfa Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 9 Feb 2024 20:46:30 +0100
Subject: [PATCH 142/438] devops: setup Dependabot (#2284)

---
 .github/dependabot.yml | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 .github/dependabot.yml

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 000000000..6a7695c06
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"

From 3019fb7da140de238eb5061df6b3406afcc5c0a8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 9 Feb 2024 20:52:30 +0100
Subject: [PATCH 143/438] build(deps): bump black from 23.9.1 to 24.1.1 (#2289)

Bumps [black](https://github.com/psf/black) from 23.9.1 to 24.1.1.
- [Release notes](https://github.com/psf/black/releases)
- [Changelog](https://github.com/psf/black/blob/main/CHANGES.md)
- [Commits](https://github.com/psf/black/compare/23.9.1...24.1.1)

---
updated-dependencies:
- dependency-name: black
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index d7d5bc28f..55492d189 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,6 +1,6 @@
 auditwheel==5.4.0
 autobahn==23.1.2
-black==23.9.1
+black==24.1.1
 flake8==6.1.0
 flaky==3.7.0
 mypy==1.8.0

From d9214342fb811b8a6ba77cd3dcf0b01fa1860734 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 9 Feb 2024 22:08:56 +0100
Subject: [PATCH 144/438] build(deps): bump pytest from 7.4.2 to 8.0.0 (#2288)

Bumps [pytest](https://github.com/pytest-dev/pytest) from 7.4.2 to 8.0.0.
- [Release notes](https://github.com/pytest-dev/pytest/releases)
- [Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pytest-dev/pytest/compare/7.4.2...8.0.0)

---
updated-dependencies:
- dependency-name: pytest
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 55492d189..db5419793 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,7 +9,7 @@ Pillow==10.2.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==23.2.0
-pytest==7.4.2
+pytest==8.0.0
 pytest-asyncio==0.21.1
 pytest-cov==4.1.0
 pytest-repeat==0.9.1

From 57ba22ee351e2633efd8bdbbde035880ee194218 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Sun, 11 Feb 2024 21:25:47 +0100
Subject: [PATCH 145/438] test: unflake
 test_locators_should_support_locator_and (#2290)

---
 tests/async/test_selector_generator.py | 49 ++++++++++++++------------
 1 file changed, 26 insertions(+), 23 deletions(-)

diff --git a/tests/async/test_selector_generator.py b/tests/async/test_selector_generator.py
index c03e575d3..1239973a5 100644
--- a/tests/async/test_selector_generator.py
+++ b/tests/async/test_selector_generator.py
@@ -21,27 +21,30 @@ async def test_should_use_data_test_id_in_strict_errors(
     page: Page, playwright: Playwright
 ) -> None:
     playwright.selectors.set_test_id_attribute("data-custom-id")
-    await page.set_content(
+    try:
+        await page.set_content(
+            """
+          <div>
+            <div></div>
+            <div>
+              <div></div>
+              <div></div>
+            </div>
+          </div>
+          <div>
+            <div class='foo bar:0' data-custom-id='One'>
+            </div>
+            <div class='foo bar:1' data-custom-id='Two'>
+            </div>
+          </div>
         """
-      <div>
-        <div></div>
-        <div>
-          <div></div>
-          <div></div>
-        </div>
-      </div>
-      <div>
-        <div class='foo bar:0' data-custom-id='One'>
-        </div>
-        <div class='foo bar:1' data-custom-id='Two'>
-        </div>
-      </div>
-    """
-    )
-    with pytest.raises(Error) as exc_info:
-        await page.locator(".foo").hover(timeout=200)
-    assert "strict mode violation" in exc_info.value.message
-    assert '<div class="foo bar:0' in exc_info.value.message
-    assert '<div class="foo bar:1' in exc_info.value.message
-    assert 'aka get_by_test_id("One")' in exc_info.value.message
-    assert 'aka get_by_test_id("Two")' in exc_info.value.message
+        )
+        with pytest.raises(Error) as exc_info:
+            await page.locator(".foo").hover(timeout=200)
+        assert "strict mode violation" in exc_info.value.message
+        assert '<div class="foo bar:0' in exc_info.value.message
+        assert '<div class="foo bar:1' in exc_info.value.message
+        assert 'aka get_by_test_id("One")' in exc_info.value.message
+        assert 'aka get_by_test_id("Two")' in exc_info.value.message
+    finally:
+        playwright.selectors.set_test_id_attribute("data-testid")

From 2d53c7f1f85a51326cfa6fdb73722a2e9b4af4bd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 12 Feb 2024 20:04:02 +0100
Subject: [PATCH 146/438] build(deps): bump types-pyopenssl from 23.2.0.2 to
 24.0.0.20240130 (#2296)

Bumps [types-pyopenssl](https://github.com/python/typeshed) from 23.2.0.2 to 24.0.0.20240130.
- [Commits](https://github.com/python/typeshed/commits)

---
updated-dependencies:
- dependency-name: types-pyopenssl
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index db5419793..a19d972e5 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,6 +19,6 @@ requests==2.31.0
 service_identity==23.1.0
 setuptools==68.2.2
 twisted==23.10.0
-types-pyOpenSSL==23.2.0.2
+types-pyOpenSSL==24.0.0.20240130
 types-requests==2.31.0.10
 wheel==0.41.2

From 566fe5c8b4b585beda7a3409608b131f78a9599d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 12 Feb 2024 20:04:10 +0100
Subject: [PATCH 147/438] build(deps): bump pytest-xdist from 3.3.1 to 3.5.0
 (#2295)

Bumps [pytest-xdist](https://github.com/pytest-dev/pytest-xdist) from 3.3.1 to 3.5.0.
- [Release notes](https://github.com/pytest-dev/pytest-xdist/releases)
- [Changelog](https://github.com/pytest-dev/pytest-xdist/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/pytest-dev/pytest-xdist/compare/v3.3.1...v3.5.0)

---
updated-dependencies:
- dependency-name: pytest-xdist
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index a19d972e5..aadd02b36 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -14,7 +14,7 @@ pytest-asyncio==0.21.1
 pytest-cov==4.1.0
 pytest-repeat==0.9.1
 pytest-timeout==2.1.0
-pytest-xdist==3.3.1
+pytest-xdist==3.5.0
 requests==2.31.0
 service_identity==23.1.0
 setuptools==68.2.2

From e682b1dbfc0f02aa159f3f8e840d87e6c4f78edd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 12 Feb 2024 20:04:22 +0100
Subject: [PATCH 148/438] build(deps): bump auditwheel from 5.4.0 to 6.0.0
 (#2293)

Bumps [auditwheel](https://github.com/pypa/auditwheel) from 5.4.0 to 6.0.0.
- [Release notes](https://github.com/pypa/auditwheel/releases)
- [Changelog](https://github.com/pypa/auditwheel/blob/main/CHANGELOG.md)
- [Commits](https://github.com/pypa/auditwheel/compare/5.4.0...6.0.0)

---
updated-dependencies:
- dependency-name: auditwheel
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index aadd02b36..899b0040d 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,4 +1,4 @@
-auditwheel==5.4.0
+auditwheel==6.0.0
 autobahn==23.1.2
 black==24.1.1
 flake8==6.1.0

From 38a36bf3da14a4496d711f2f5e5dac755480d08c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 12 Feb 2024 20:04:30 +0100
Subject: [PATCH 149/438] build(deps): bump pytest-repeat from 0.9.1 to 0.9.3
 (#2294)

Bumps [pytest-repeat](https://github.com/pytest-dev/pytest-repeat) from 0.9.1 to 0.9.3.
- [Release notes](https://github.com/pytest-dev/pytest-repeat/releases)
- [Changelog](https://github.com/pytest-dev/pytest-repeat/blob/main/CHANGES.rst)
- [Commits](https://github.com/pytest-dev/pytest-repeat/compare/v0.9.1...v0.9.3)

---
updated-dependencies:
- dependency-name: pytest-repeat
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 899b0040d..24f15a179 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -12,7 +12,7 @@ pyOpenSSL==23.2.0
 pytest==8.0.0
 pytest-asyncio==0.21.1
 pytest-cov==4.1.0
-pytest-repeat==0.9.1
+pytest-repeat==0.9.3
 pytest-timeout==2.1.0
 pytest-xdist==3.5.0
 requests==2.31.0

From 8cd06e5190d8da8c3e6920596e5fc377d6a88c42 Mon Sep 17 00:00:00 2001
From: Daniel Henderson <77417639+danphenderson@users.noreply.github.com>
Date: Wed, 14 Feb 2024 01:44:05 -0800
Subject: [PATCH 150/438] feat: make `TimeoutError` extend 
 `builtins.TimeoutError` (#2297)

---
 .gitignore                  | 2 ++
 playwright/_impl/_errors.py | 3 ++-
 tests/async/test_click.py   | 4 ++++
 3 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 919e041a6..ce5522f8a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,3 +18,5 @@ coverage.xml
 junit/
 htmldocs/
 utils/docker/dist/
+.venv/
+Pipfile*
diff --git a/playwright/_impl/_errors.py b/playwright/_impl/_errors.py
index 9bd6ab901..e052d25bf 100644
--- a/playwright/_impl/_errors.py
+++ b/playwright/_impl/_errors.py
@@ -16,6 +16,7 @@
 # stable API.
 
 
+from builtins import TimeoutError as TimeoutErrorBuiltin
 from typing import Optional
 
 
@@ -43,7 +44,7 @@ def stack(self) -> Optional[str]:
         return self._stack
 
 
-class TimeoutError(Error):
+class TimeoutError(Error, TimeoutErrorBuiltin):
     pass
 
 
diff --git a/tests/async/test_click.py b/tests/async/test_click.py
index 8143a6b3d..98d0a49c1 100644
--- a/tests/async/test_click.py
+++ b/tests/async/test_click.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import asyncio
+import builtins
 from typing import Optional
 
 import pytest
@@ -638,6 +639,9 @@ async def test_timeout_waiting_for_hit_target(page: Page, server: Server) -> Non
     assert "Timeout 5000ms exceeded." in error.message
     assert '<div id="blocker"></div> intercepts pointer events' in error.message
     assert "retrying click action" in error.message
+    assert isinstance(error, Error)
+    assert isinstance(error, TimeoutError)
+    assert isinstance(error, builtins.TimeoutError)
 
 
 async def test_fail_when_obscured_and_not_waiting_for_hit_target(

From 5b4f8c7e871569bcbe09a8f1c9e27f916960fd27 Mon Sep 17 00:00:00 2001
From: Daniel Henderson <77417639+danphenderson@users.noreply.github.com>
Date: Thu, 15 Feb 2024 00:38:47 -0800
Subject: [PATCH 151/438] docs(readme): update broken link (#2299)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d89a1f0e3..130d40b3d 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # 🎭 [Playwright](https://playwright.dev) for Python [![PyPI version](https://badge.fury.io/py/playwright.svg)](https://pypi.python.org/pypi/playwright/) [![Anaconda version](https://img.shields.io/conda/v/microsoft/playwright)](https://anaconda.org/Microsoft/playwright) [![Join Discord](https://img.shields.io/badge/join-discord-infomational)](https://aka.ms/playwright/discord)
 
-Playwright is a Python library to automate [Chromium](https://www.chromium.org/Home), [Firefox](https://www.mozilla.org/en-US/firefox/new/) and [WebKit](https://webkit.org/) browsers with a single API. Playwright delivers automation that is **ever-green**, **capable**, **reliable** and **fast**. [See how Playwright is better](https://playwright.dev/python/docs/why-playwright).
+Playwright is a Python library to automate [Chromium](https://www.chromium.org/Home), [Firefox](https://www.mozilla.org/en-US/firefox/new/) and [WebKit](https://webkit.org/) browsers with a single API. Playwright delivers automation that is **ever-green**, **capable**, **reliable** and **fast**. [See how Playwright is better](https://playwright.dev/python).
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |

From 3da0d2b41d9c46e78ab18c8cc86a5caa9bed0741 Mon Sep 17 00:00:00 2001
From: Daniel Henderson <77417639+danphenderson@users.noreply.github.com>
Date: Fri, 16 Feb 2024 00:48:42 -0800
Subject: [PATCH 152/438] chore: remove unnecessary 'type-extensions'
 requirement (#2302)

---
 meta.yaml                                    | 1 -
 playwright/_impl/_api_structures.py          | 8 +-------
 playwright/_impl/_browser_context.py         | 7 +------
 playwright/_impl/_connection.py              | 7 +------
 playwright/_impl/_element_handle.py          | 7 +------
 playwright/_impl/_frame.py                   | 7 +------
 playwright/_impl/_helper.py                  | 9 ++-------
 playwright/_impl/_locator.py                 | 7 +------
 playwright/_impl/_network.py                 | 8 +-------
 playwright/_impl/_page.py                    | 6 +-----
 playwright/_impl/_set_input_files_helpers.py | 8 +-------
 playwright/async_api/_generated.py           | 7 +------
 playwright/sync_api/_generated.py            | 7 +------
 scripts/generate_api.py                      | 6 +-----
 setup.py                                     | 1 -
 15 files changed, 14 insertions(+), 82 deletions(-)

diff --git a/meta.yaml b/meta.yaml
index ede90909a..85deaf23b 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -25,7 +25,6 @@ requirements:
     - python
     - greenlet ==3.0.3
     - pyee ==11.0.1
-    - typing_extensions # [py<39]
 test:
   requires:
     - pip
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index c20f8d845..f06a6247e 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -12,13 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import sys
-from typing import Any, Dict, List, Optional, Sequence, Union
-
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import Literal, TypedDict
-else:  # pragma: no cover
-    from typing_extensions import Literal, TypedDict
+from typing import Any, Dict, List, Literal, Optional, Sequence, TypedDict, Union
 
 # These are the structures that we like keeping in a JSON form for their potential
 # reuse between SDKs / services. They are public and are a part of the
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index c05b427f2..6ea934323 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -14,7 +14,6 @@
 
 import asyncio
 import json
-import sys
 from pathlib import Path
 from types import SimpleNamespace
 from typing import (
@@ -23,6 +22,7 @@
     Callable,
     Dict,
     List,
+    Literal,
     Optional,
     Pattern,
     Sequence,
@@ -77,11 +77,6 @@
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._browser import Browser
 
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import Literal
-else:  # pragma: no cover
-    from typing_extensions import Literal
-
 
 class BrowserContext(ChannelOwner):
     Events = SimpleNamespace(
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index f1e0dd34f..444329a44 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -28,6 +28,7 @@
     List,
     Mapping,
     Optional,
+    TypedDict,
     Union,
     cast,
 )
@@ -46,12 +47,6 @@
     from playwright._impl._playwright import Playwright
 
 
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import TypedDict
-else:  # pragma: no cover
-    from typing_extensions import TypedDict
-
-
 class Channel(AsyncIOEventEmitter):
     def __init__(self, connection: "Connection", object: "ChannelOwner") -> None:
         super().__init__()
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 558cf3ac9..74e5bdff9 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -13,7 +13,6 @@
 # limitations under the License.
 
 import base64
-import sys
 from pathlib import Path
 from typing import (
     TYPE_CHECKING,
@@ -21,6 +20,7 @@
     Callable,
     Dict,
     List,
+    Literal,
     Optional,
     Sequence,
     Union,
@@ -45,11 +45,6 @@
 )
 from playwright._impl._set_input_files_helpers import convert_input_files
 
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import Literal
-else:  # pragma: no cover
-    from typing_extensions import Literal
-
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._frame import Frame
     from playwright._impl._locator import Locator
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 75047ff79..556395a5b 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -13,7 +13,6 @@
 # limitations under the License.
 
 import asyncio
-import sys
 from pathlib import Path
 from typing import (
     TYPE_CHECKING,
@@ -43,6 +42,7 @@
     DocumentLoadState,
     FrameNavigatedEvent,
     KeyboardModifier,
+    Literal,
     MouseButton,
     URLMatch,
     URLMatcher,
@@ -72,11 +72,6 @@
 from playwright._impl._set_input_files_helpers import convert_input_files
 from playwright._impl._waiter import Waiter
 
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import Literal
-else:  # pragma: no cover
-    from typing_extensions import Literal
-
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._page import Page
 
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 615cd5264..4fd92e6a2 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -15,7 +15,6 @@
 import math
 import os
 import re
-import sys
 import time
 import traceback
 from pathlib import Path
@@ -26,9 +25,11 @@
     Callable,
     Dict,
     List,
+    Literal,
     Optional,
     Pattern,
     Set,
+    TypedDict,
     TypeVar,
     Union,
     cast,
@@ -42,12 +43,6 @@
 from playwright._impl._glob import glob_to_regex
 from playwright._impl._str_utils import escape_regex_flags
 
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import Literal, TypedDict
-else:  # pragma: no cover
-    from typing_extensions import Literal, TypedDict
-
-
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._api_structures import HeadersArray
     from playwright._impl._network import Request, Response, Route
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index a9cc92aba..5d220f13b 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -14,7 +14,6 @@
 
 import json
 import pathlib
-import sys
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -22,6 +21,7 @@
     Callable,
     Dict,
     List,
+    Literal,
     Optional,
     Pattern,
     Sequence,
@@ -53,11 +53,6 @@
     escape_for_text_selector,
 )
 
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import Literal
-else:  # pragma: no cover
-    from typing_extensions import Literal
-
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._frame import Frame
     from playwright._impl._js_handle import JSHandle
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 03aa53588..ecce43571 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -18,7 +18,6 @@
 import json
 import json as json_utils
 import mimetypes
-import sys
 from collections import defaultdict
 from pathlib import Path
 from types import SimpleNamespace
@@ -30,15 +29,10 @@
     Dict,
     List,
     Optional,
+    TypedDict,
     Union,
     cast,
 )
-
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import TypedDict
-else:  # pragma: no cover
-    from typing_extensions import TypedDict
-
 from urllib import parse
 
 from playwright._impl._api_structures import (
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index ac6a55002..cffde68c1 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -25,6 +25,7 @@
     Callable,
     Dict,
     List,
+    Literal,
     Optional,
     Pattern,
     Sequence,
@@ -88,11 +89,6 @@
 from playwright._impl._video import Video
 from playwright._impl._waiter import Waiter
 
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import Literal
-else:  # pragma: no cover
-    from typing_extensions import Literal
-
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._browser_context import BrowserContext
     from playwright._impl._fetch import APIRequestContext
diff --git a/playwright/_impl/_set_input_files_helpers.py b/playwright/_impl/_set_input_files_helpers.py
index 793144313..e47946be7 100644
--- a/playwright/_impl/_set_input_files_helpers.py
+++ b/playwright/_impl/_set_input_files_helpers.py
@@ -14,14 +14,8 @@
 import base64
 import collections.abc
 import os
-import sys
 from pathlib import Path
-from typing import TYPE_CHECKING, Dict, List, Optional, Sequence, Union, cast
-
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import TypedDict
-else:  # pragma: no cover
-    from typing_extensions import TypedDict
+from typing import TYPE_CHECKING, Dict, List, Optional, Sequence, TypedDict, Union, cast
 
 from playwright._impl._connection import Channel, from_channel
 from playwright._impl._helper import Error
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 831d8dcfb..f05e69639 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -14,13 +14,8 @@
 
 
 import pathlib
-import sys
 import typing
-
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import Literal
-else:  # pragma: no cover
-    from typing_extensions import Literal
+from typing import Literal
 
 from playwright._impl._accessibility import Accessibility as AccessibilityImpl
 from playwright._impl._api_structures import (
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 34e54b313..13a4ade12 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -14,13 +14,8 @@
 
 
 import pathlib
-import sys
 import typing
-
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import Literal
-else:  # pragma: no cover
-    from typing_extensions import Literal
+from typing import Literal
 
 from playwright._impl._accessibility import Accessibility as AccessibilityImpl
 from playwright._impl._api_structures import (
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index 4228a92a7..b35c91cff 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -211,13 +211,9 @@ def return_value(value: Any) -> List[str]:
 
 
 import typing
-import sys
 import pathlib
 
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import Literal
-else:  # pragma: no cover
-    from typing_extensions import Literal
+from typing import Literal
 
 
 from playwright._impl._accessibility import Accessibility as AccessibilityImpl
diff --git a/setup.py b/setup.py
index 7f40b41a8..8edb3f4ce 100644
--- a/setup.py
+++ b/setup.py
@@ -220,7 +220,6 @@ def _download_and_extract_local_driver(
     install_requires=[
         "greenlet==3.0.3",
         "pyee==11.0.1",
-        "typing-extensions;python_version<='3.8'",
     ],
     # TODO: Can be removed once we migrate to pypa/build or pypa/installer.
     setup_requires=["setuptools-scm==8.0.4", "wheel==0.41.2"],

From 9bd030d26bccd9d791241b940233552ad6b6cd0e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 19 Feb 2024 19:21:34 +0100
Subject: [PATCH 153/438] build(deps): bump black from 24.1.1 to 24.2.0 (#2310)

Bumps [black](https://github.com/psf/black) from 24.1.1 to 24.2.0.
- [Release notes](https://github.com/psf/black/releases)
- [Changelog](https://github.com/psf/black/blob/main/CHANGES.md)
- [Commits](https://github.com/psf/black/compare/24.1.1...24.2.0)

---
updated-dependencies:
- dependency-name: black
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 24f15a179..f97ee89be 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,6 +1,6 @@
 auditwheel==6.0.0
 autobahn==23.1.2
-black==24.1.1
+black==24.2.0
 flake8==6.1.0
 flaky==3.7.0
 mypy==1.8.0

From d2b7e7113174b5b5db9cc490250d4c2fe4fee894 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 19 Feb 2024 19:21:45 +0100
Subject: [PATCH 154/438] build(deps): bump pytest-timeout from 2.1.0 to 2.2.0
 (#2309)

Bumps [pytest-timeout](https://github.com/pytest-dev/pytest-timeout) from 2.1.0 to 2.2.0.
- [Commits](https://github.com/pytest-dev/pytest-timeout/compare/2.1.0...2.2.0)

---
updated-dependencies:
- dependency-name: pytest-timeout
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index f97ee89be..42c8a711e 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -13,7 +13,7 @@ pytest==8.0.0
 pytest-asyncio==0.21.1
 pytest-cov==4.1.0
 pytest-repeat==0.9.3
-pytest-timeout==2.1.0
+pytest-timeout==2.2.0
 pytest-xdist==3.5.0
 requests==2.31.0
 service_identity==23.1.0

From d6e8142591a50f9bba4f2691aba014af0d2ce8d1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 19 Feb 2024 19:21:57 +0100
Subject: [PATCH 155/438] build(deps): bump service-identity from 23.1.0 to
 24.1.0 (#2307)

Bumps [service-identity](https://github.com/sponsors/hynek) from 23.1.0 to 24.1.0.
- [Commits](https://github.com/sponsors/hynek/commits)

---
updated-dependencies:
- dependency-name: service-identity
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 42c8a711e..aa2ce3db8 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -16,7 +16,7 @@ pytest-repeat==0.9.3
 pytest-timeout==2.2.0
 pytest-xdist==3.5.0
 requests==2.31.0
-service_identity==23.1.0
+service_identity==24.1.0
 setuptools==68.2.2
 twisted==23.10.0
 types-pyOpenSSL==24.0.0.20240130

From 9625376b28f9430f16ec8e59288450812bc11934 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 20 Feb 2024 19:26:05 +0100
Subject: [PATCH 156/438] build(deps): bump flake8 from 6.1.0 to 7.0.0 (#2308)

Bumps [flake8](https://github.com/pycqa/flake8) from 6.1.0 to 7.0.0.
- [Commits](https://github.com/pycqa/flake8/compare/6.1.0...7.0.0)

---
updated-dependencies:
- dependency-name: flake8
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index aa2ce3db8..a65c17974 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,7 +1,7 @@
 auditwheel==6.0.0
 autobahn==23.1.2
 black==24.2.0
-flake8==6.1.0
+flake8==7.0.0
 flaky==3.7.0
 mypy==1.8.0
 objgraph==3.6.0

From 516bdad803d5d7c3a850ab034cbb5492b4d37904 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 20 Feb 2024 19:53:16 +0100
Subject: [PATCH 157/438] Revert "feat: make `TimeoutError` extend 
 `builtins.TimeoutError` (#2297)" (#2312)

This reverts commit 8cd06e5190d8da8c3e6920596e5fc377d6a88c42.
---
 .gitignore                  | 2 --
 playwright/_impl/_errors.py | 3 +--
 tests/async/test_click.py   | 4 ----
 3 files changed, 1 insertion(+), 8 deletions(-)

diff --git a/.gitignore b/.gitignore
index ce5522f8a..919e041a6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,5 +18,3 @@ coverage.xml
 junit/
 htmldocs/
 utils/docker/dist/
-.venv/
-Pipfile*
diff --git a/playwright/_impl/_errors.py b/playwright/_impl/_errors.py
index e052d25bf..9bd6ab901 100644
--- a/playwright/_impl/_errors.py
+++ b/playwright/_impl/_errors.py
@@ -16,7 +16,6 @@
 # stable API.
 
 
-from builtins import TimeoutError as TimeoutErrorBuiltin
 from typing import Optional
 
 
@@ -44,7 +43,7 @@ def stack(self) -> Optional[str]:
         return self._stack
 
 
-class TimeoutError(Error, TimeoutErrorBuiltin):
+class TimeoutError(Error):
     pass
 
 
diff --git a/tests/async/test_click.py b/tests/async/test_click.py
index 98d0a49c1..8143a6b3d 100644
--- a/tests/async/test_click.py
+++ b/tests/async/test_click.py
@@ -13,7 +13,6 @@
 # limitations under the License.
 
 import asyncio
-import builtins
 from typing import Optional
 
 import pytest
@@ -639,9 +638,6 @@ async def test_timeout_waiting_for_hit_target(page: Page, server: Server) -> Non
     assert "Timeout 5000ms exceeded." in error.message
     assert '<div id="blocker"></div> intercepts pointer events' in error.message
     assert "retrying click action" in error.message
-    assert isinstance(error, Error)
-    assert isinstance(error, TimeoutError)
-    assert isinstance(error, builtins.TimeoutError)
 
 
 async def test_fail_when_obscured_and_not_waiting_for_hit_target(

From c4ffd453c124fb491bb6a2cdc9899ba448eb909d Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 21 Feb 2024 17:41:24 +0100
Subject: [PATCH 158/438] fix: datetime serialisation (#2314)

---
 playwright/_impl/_js_handle.py | 2 +-
 tests/sync/test_assertions.py  | 8 ++++++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 4bd8146b1..c7b869857 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -128,7 +128,7 @@ def serialize_value(
         if math.isnan(value):
             return dict(v="NaN")
     if isinstance(value, datetime):
-        return dict(d=value.isoformat() + "Z")
+        return dict(d=value.isoformat())
     if isinstance(value, bool):
         return {"b": value}
     if isinstance(value, (int, float)):
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index f2df44ab5..d7180fc94 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -12,8 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import datetime
 import re
-from datetime import datetime
 
 import pytest
 
@@ -163,7 +163,11 @@ def test_assertions_locator_to_have_js_property(page: Page, server: Server) -> N
     )
     expect(page.locator("div")).to_have_js_property(
         "foo",
-        {"a": 1, "b": "string", "c": datetime.utcfromtimestamp(1627503992000 / 1000)},
+        {
+            "a": 1,
+            "b": "string",
+            "c": datetime.datetime.fromtimestamp(1627503992000 / 1000),
+        },
     )
 
 

From 3e4446433f1b194df9be7c07d285b85a7ca5ea70 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 22 Feb 2024 18:06:34 +0100
Subject: [PATCH 159/438] test: move SyncBase._gather into tests (#2316)

---
 playwright/_impl/_sync_base.py | 34 -----------------------------
 tests/sync/conftest.py         | 40 +++++++++++++++++++++++++++++++++-
 tests/sync/test_sync.py        |  8 ++++---
 3 files changed, 44 insertions(+), 38 deletions(-)

diff --git a/playwright/_impl/_sync_base.py b/playwright/_impl/_sync_base.py
index 0eefbba13..50a2c647e 100644
--- a/playwright/_impl/_sync_base.py
+++ b/playwright/_impl/_sync_base.py
@@ -20,10 +20,8 @@
     Any,
     Callable,
     Coroutine,
-    Dict,
     Generator,
     Generic,
-    List,
     Type,
     TypeVar,
     Union,
@@ -133,38 +131,6 @@ def remove_listener(self, event: Any, f: Any) -> None:
         """Removes the function ``f`` from ``event``."""
         self._impl_obj.remove_listener(event, self._wrap_handler(f))
 
-    def _gather(self, *actions: Callable) -> List[Any]:
-        g_self = greenlet.getcurrent()
-        results: Dict[Callable, Any] = {}
-        exceptions: List[Exception] = []
-
-        def action_wrapper(action: Callable) -> Callable:
-            def body() -> Any:
-                try:
-                    results[action] = action()
-                except Exception as e:
-                    results[action] = e
-                    exceptions.append(e)
-                g_self.switch()
-
-            return body
-
-        async def task() -> None:
-            for action in actions:
-                g = greenlet.greenlet(action_wrapper(action))
-                g.switch()
-
-        self._loop.create_task(task())
-
-        while len(results) < len(actions):
-            self._dispatcher_fiber.switch()
-
-        asyncio._set_running_loop(self._loop)
-        if exceptions:
-            raise exceptions[0]
-
-        return list(map(lambda action: results[action], actions))
-
 
 class SyncContextManager(SyncBase):
     def __enter__(self: Self) -> Self:
diff --git a/tests/sync/conftest.py b/tests/sync/conftest.py
index 075cccde2..68221b216 100644
--- a/tests/sync/conftest.py
+++ b/tests/sync/conftest.py
@@ -13,9 +13,11 @@
 # limitations under the License.
 
 
-from typing import Dict, Generator
+import asyncio
+from typing import Any, Callable, Dict, Generator, List
 
 import pytest
+from greenlet import greenlet
 
 from playwright.sync_api import (
     Browser,
@@ -83,3 +85,39 @@ def page(context: BrowserContext) -> Generator[Page, None, None]:
 @pytest.fixture(scope="session")
 def selectors(playwright: Playwright) -> Selectors:
     return playwright.selectors
+
+
+@pytest.fixture(scope="session")
+def sync_gather(playwright: Playwright) -> Generator[Callable, None, None]:
+    def _sync_gather_impl(*actions: Callable) -> List[Any]:
+        g_self = greenlet.getcurrent()
+        results: Dict[Callable, Any] = {}
+        exceptions: List[Exception] = []
+
+        def action_wrapper(action: Callable) -> Callable:
+            def body() -> Any:
+                try:
+                    results[action] = action()
+                except Exception as e:
+                    results[action] = e
+                    exceptions.append(e)
+                g_self.switch()
+
+            return body
+
+        async def task() -> None:
+            for action in actions:
+                g = greenlet(action_wrapper(action))
+                g.switch()
+
+        asyncio.create_task(task())
+
+        while len(results) < len(actions):
+            playwright._dispatcher_fiber.switch()
+
+        if exceptions:
+            raise exceptions[0]
+
+        return list(map(lambda action: results[action], actions))
+
+    yield _sync_gather_impl
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index fbd94b932..64eace1e9 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -14,7 +14,7 @@
 
 import multiprocessing
 import os
-from typing import Any, Dict
+from typing import Any, Callable, Dict
 
 import pytest
 
@@ -266,10 +266,12 @@ def test_sync_set_default_timeout(page: Page) -> None:
     assert "Timeout 1ms exceeded." in exc.value.message
 
 
-def test_close_should_reject_all_promises(context: BrowserContext) -> None:
+def test_close_should_reject_all_promises(
+    context: BrowserContext, sync_gather: Callable
+) -> None:
     new_page = context.new_page()
     with pytest.raises(Error) as exc_info:
-        new_page._gather(
+        sync_gather(
             lambda: new_page.evaluate("() => new Promise(r => {})"),
             lambda: new_page.close(),
         )

From bdd9c5d635a881b99fac7ac6365b9cbbee56b7db Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 23 Feb 2024 08:40:26 +0100
Subject: [PATCH 160/438] chore(roll): roll Playwright to
 1.42.0-alpha-2024-02-19 (#2313)

---
 README.md                                     |   4 +-
 playwright/_impl/_connection.py               |   4 +-
 playwright/_impl/_frame.py                    |   7 +-
 playwright/_impl/_greenlets.py                |  49 +++++
 playwright/_impl/_har_router.py               |   7 +
 playwright/_impl/_helper.py                   |   5 +-
 playwright/_impl/_js_handle.py                |   7 +-
 playwright/_impl/_page.py                     |  77 ++++++-
 playwright/async_api/_generated.py            | 150 ++++++++++---
 playwright/sync_api/_context_manager.py       |   3 +-
 playwright/sync_api/_generated.py             | 134 ++++++++++--
 setup.py                                      |   2 +-
 tests/assets/headings.html                    |  15 ++
 tests/assets/input/handle-locator.html        |  82 ++++++++
 .../test_browsercontext_storage_state.py      |  15 +-
 tests/async/test_click.py                     |  12 +-
 tests/async/test_element_handle.py            |   3 +-
 tests/async/test_har.py                       |  57 ++++-
 tests/async/test_page_add_locator_handler.py  | 198 ++++++++++++++++++
 tests/async/test_pdf.py                       |  18 +-
 tests/conftest.py                             |   2 +-
 tests/sync/conftest.py                        |   2 +-
 tests/sync/test_element_handle.py             |   3 +-
 tests/sync/test_page_add_locator_handler.py   | 197 +++++++++++++++++
 24 files changed, 965 insertions(+), 88 deletions(-)
 create mode 100644 playwright/_impl/_greenlets.py
 create mode 100644 tests/assets/headings.html
 create mode 100644 tests/assets/input/handle-locator.html
 create mode 100644 tests/async/test_page_add_locator_handler.py
 create mode 100644 tests/sync/test_page_add_locator_handler.py

diff --git a/README.md b/README.md
index 130d40b3d..be1ab9fb8 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 -->121.0.6167.57<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->122.0.6261.39<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->121.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->122.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 444329a44..dd9c709ef 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -33,12 +33,12 @@
     cast,
 )
 
-from greenlet import greenlet
 from pyee import EventEmitter
 from pyee.asyncio import AsyncIOEventEmitter
 
 import playwright
 from playwright._impl._errors import TargetClosedError
+from playwright._impl._greenlets import EventGreenlet
 from playwright._impl._helper import Error, ParsedMessagePayload, parse_error
 from playwright._impl._transport import Transport
 
@@ -417,7 +417,7 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
                     # Each event handler is a potentilly blocking context, create a fiber for each
                     # and switch to them in order, until they block inside and pass control to each
                     # other and then eventually back to dispatcher as listener functions return.
-                    g = greenlet(listener)
+                    g = EventGreenlet(listener)
                     if should_replace_guids_with_channels:
                         g.switch(self._replace_guids_with_channels(params))
                     else:
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 556395a5b..bfeef1489 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -53,6 +53,7 @@
 from playwright._impl._js_handle import (
     JSHandle,
     Serializable,
+    add_source_url_to_script,
     parse_result,
     serialize_argument,
 )
@@ -450,10 +451,8 @@ async def add_script_tag(
     ) -> ElementHandle:
         params = locals_to_params(locals())
         if path:
-            params["content"] = (
-                (await async_readfile(path)).decode()
-                + "\n//# sourceURL="
-                + str(Path(path))
+            params["content"] = add_source_url_to_script(
+                (await async_readfile(path)).decode(), path
             )
             del params["path"]
         return from_channel(await self._channel.send("addScriptTag", params))
diff --git a/playwright/_impl/_greenlets.py b/playwright/_impl/_greenlets.py
new file mode 100644
index 000000000..a381e6e53
--- /dev/null
+++ b/playwright/_impl/_greenlets.py
@@ -0,0 +1,49 @@
+# 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
+from typing import Tuple
+
+import greenlet
+
+
+def _greenlet_trace_callback(
+    event: str, args: Tuple[greenlet.greenlet, greenlet.greenlet]
+) -> None:
+    if event in ("switch", "throw"):
+        origin, target = args
+        print(f"Transfer from {origin} to {target} with {event}")
+
+
+if os.environ.get("INTERNAL_PW_GREENLET_DEBUG"):
+    greenlet.settrace(_greenlet_trace_callback)
+
+
+class MainGreenlet(greenlet.greenlet):
+    def __str__(self) -> str:
+        return "<MainGreenlet>"
+
+
+class RouteGreenlet(greenlet.greenlet):
+    def __str__(self) -> str:
+        return "<RouteGreenlet>"
+
+
+class LocatorHandlerGreenlet(greenlet.greenlet):
+    def __str__(self) -> str:
+        return "<LocatorHandlerGreenlet>"
+
+
+class EventGreenlet(greenlet.greenlet):
+    def __str__(self) -> str:
+        return "<EventGreenlet>"
diff --git a/playwright/_impl/_har_router.py b/playwright/_impl/_har_router.py
index 3e56fd019..33ff37871 100644
--- a/playwright/_impl/_har_router.py
+++ b/playwright/_impl/_har_router.py
@@ -75,6 +75,13 @@ async def _handle(self, route: "Route") -> None:
             return
 
         if action == "fulfill":
+            # If the response status is -1, the request was canceled or stalled, so we just stall it here.
+            # See https://github.com/microsoft/playwright/issues/29311.
+            # TODO: it'd be better to abort such requests, but then we likely need to respect the timing,
+            # because the request might have been stalled for a long time until the very end of the
+            # test when HAR was recorded but we'd abort it immediately.
+            if response.get("status") == -1:
+                return
             body = response["body"]
             assert body is not None
             await route.fulfill(
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 4fd92e6a2..cd6a1d68c 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -36,11 +36,10 @@
 )
 from urllib.parse import urljoin
 
-from greenlet import greenlet
-
 from playwright._impl._api_structures import NameValue
 from playwright._impl._errors import Error, TargetClosedError, TimeoutError
 from playwright._impl._glob import glob_to_regex
+from playwright._impl._greenlets import RouteGreenlet
 from playwright._impl._str_utils import escape_regex_flags
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -302,7 +301,7 @@ async def _handle_internal(self, route: "Route") -> bool:
         if self._is_sync:
             # As with event handlers, each route handler is a potentially blocking context
             # so it needs a fiber.
-            g = greenlet(lambda: self.handler(route, route.request))  # type: ignore
+            g = RouteGreenlet(lambda: self.handler(route, route.request))  # type: ignore
             g.switch()
         else:
             coro_or_future = self.handler(route, route.request)  # type: ignore
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index c7b869857..01625ec3f 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -15,7 +15,8 @@
 import collections.abc
 import math
 from datetime import datetime
-from typing import TYPE_CHECKING, Any, Dict, List, Optional
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union
 from urllib.parse import ParseResult, urlparse, urlunparse
 
 from playwright._impl._connection import Channel, ChannelOwner, from_channel
@@ -226,3 +227,7 @@ def parse_value(value: Any, refs: Optional[Dict[int, Any]] = None) -> Any:
 
 def parse_result(result: Any) -> Any:
     return parse_value(result)
+
+
+def add_source_url_to_script(source: str, path: Union[str, Path]) -> str:
+    return source + "\n//# sourceURL=" + str(path).replace("\n", "")
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index cffde68c1..414ef46aa 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -55,6 +55,7 @@
 from playwright._impl._event_context_manager import EventContextManagerImpl
 from playwright._impl._file_chooser import FileChooser
 from playwright._impl._frame import Frame
+from playwright._impl._greenlets import LocatorHandlerGreenlet
 from playwright._impl._har_router import HarRouter
 from playwright._impl._helper import (
     ColorScheme,
@@ -82,6 +83,7 @@
 from playwright._impl._js_handle import (
     JSHandle,
     Serializable,
+    add_source_url_to_script,
     parse_result,
     serialize_argument,
 )
@@ -150,6 +152,7 @@ def __init__(
         self._close_reason: Optional[str] = None
         self._close_was_called = False
         self._har_routers: List[HarRouter] = []
+        self._locator_handlers: Dict[str, Callable] = {}
 
         self._channel.on(
             "bindingCall",
@@ -175,6 +178,12 @@ def __init__(
             "frameDetached",
             lambda params: self._on_frame_detached(from_channel(params["frame"])),
         )
+        self._channel.on(
+            "locatorHandlerTriggered",
+            lambda params: asyncio.create_task(
+                self._on_locator_handler_triggered(params["uid"])
+            ),
+        )
         self._channel.on(
             "route",
             lambda params: asyncio.create_task(
@@ -194,17 +203,21 @@ def __init__(
         self._closed_or_crashed_future: asyncio.Future = asyncio.Future()
         self.on(
             Page.Events.Close,
-            lambda _: self._closed_or_crashed_future.set_result(
-                self._close_error_with_reason()
-            )
-            if not self._closed_or_crashed_future.done()
-            else None,
+            lambda _: (
+                self._closed_or_crashed_future.set_result(
+                    self._close_error_with_reason()
+                )
+                if not self._closed_or_crashed_future.done()
+                else None
+            ),
         )
         self.on(
             Page.Events.Crash,
-            lambda _: self._closed_or_crashed_future.set_result(TargetClosedError())
-            if not self._closed_or_crashed_future.done()
-            else None,
+            lambda _: (
+                self._closed_or_crashed_future.set_result(TargetClosedError())
+                if not self._closed_or_crashed_future.done()
+                else None
+            ),
         )
 
         self._set_event_to_subscription_mapping(
@@ -567,7 +580,9 @@ async def add_init_script(
         self, script: str = None, path: Union[str, Path] = None
     ) -> None:
         if path:
-            script = (await async_readfile(path)).decode()
+            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", dict(source=script))
@@ -1029,6 +1044,8 @@ async def pdf(
         preferCSSPageSize: bool = None,
         margin: PdfMargins = None,
         path: Union[str, Path] = None,
+        outline: bool = None,
+        tagged: bool = None,
     ) -> bytes:
         params = locals_to_params(locals())
         if "path" in params:
@@ -1238,6 +1255,48 @@ async def set_checked(
                 trial=trial,
             )
 
+    async def add_locator_handler(self, locator: "Locator", handler: Callable) -> None:
+        if locator._frame != self._main_frame:
+            raise Error("Locator must belong to the main frame of this page")
+        uid = await self._channel.send(
+            "registerLocatorHandler",
+            {
+                "selector": locator._selector,
+            },
+        )
+        self._locator_handlers[uid] = handler
+
+    async def _on_locator_handler_triggered(self, uid: str) -> None:
+        try:
+            if self._dispatcher_fiber:
+                handler_finished_future = self._loop.create_future()
+
+                def _handler() -> None:
+                    try:
+                        self._locator_handlers[uid]()
+                        handler_finished_future.set_result(None)
+                    except Exception as e:
+                        handler_finished_future.set_exception(e)
+
+                g = LocatorHandlerGreenlet(_handler)
+                g.switch()
+                await handler_finished_future
+            else:
+                coro_or_future = self._locator_handlers[uid]()
+                if coro_or_future:
+                    await coro_or_future
+
+        finally:
+            try:
+                await self._connection.wrap_api_call(
+                    lambda: self._channel.send(
+                        "resolveLocatorHandlerNoReply", {"uid": uid}
+                    ),
+                    is_internal=True,
+                )
+            except Error:
+                pass
+
 
 class Worker(ChannelOwner):
     Events = SimpleNamespace(Close="close")
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index f05e69639..e484baa09 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -818,17 +818,17 @@ async def fallback(
 
         ```py
         # Handle GET requests.
-        def handle_get(route):
+        async def handle_get(route):
             if route.request.method != \"GET\":
-                route.fallback()
+                await route.fallback()
                 return
           # Handling GET only.
           # ...
 
         # Handle POST requests.
-        def handle_post(route):
+        async def handle_post(route):
             if route.request.method != \"POST\":
-                route.fallback()
+                await route.fallback()
                 return
           # Handling POST only.
           # ...
@@ -1253,8 +1253,8 @@ async def press(self, key: str, *, delay: typing.Optional[float] = None) -> None
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
-        modifier, modifier is pressed and being held while the subsequent key is being pressed.
+        Shortcuts such as `key: \"Control+o\"`, `key: \"Control++` or `key: \"Control+Shift+T\"` are supported as well. When
+        specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
         **Usage**
 
@@ -2384,8 +2384,8 @@ async def press(
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
-        modifier, modifier is pressed and being held while the subsequent key is being pressed.
+        Shortcuts such as `key: \"Control+o\"`, `key: \"Control++` or `key: \"Control+Shift+T\"` are supported as well. When
+        specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
         Parameters
         ----------
@@ -5501,8 +5501,8 @@ async def press(
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
-        modifier, modifier is pressed and being held while the subsequent key is being pressed.
+        Shortcuts such as `key: \"Control+o\"`, `key: \"Control++` or `key: \"Control+Shift+T\"` are supported as well. When
+        specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
         Parameters
         ----------
@@ -6924,8 +6924,7 @@ def on(
         ],
     ) -> None:
         """
-        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
-        emitted if the page throws an error or a warning.
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`.
 
         The arguments passed into `console.log` are available on the `ConsoleMessage` event handler argument.
 
@@ -7193,8 +7192,7 @@ def once(
         ],
     ) -> None:
         """
-        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
-        emitted if the page throws an error or a warning.
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`.
 
         The arguments passed into `console.log` are available on the `ConsoleMessage` event handler argument.
 
@@ -9065,11 +9063,11 @@ async def route(
         some post data, and leaving all other requests as is:
 
         ```py
-        def handle_route(route):
+        async def handle_route(route: Route):
           if (\"my-string\" in route.request.post_data):
-            route.fulfill(body=\"mocked-data\")
+            await route.fulfill(body=\"mocked-data\")
           else:
-            route.continue_()
+            await route.continue_()
         await page.route(\"/api/**\", handle_route)
         ```
 
@@ -10756,8 +10754,8 @@ async def press(
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
-        modifier, modifier is pressed and being held while the subsequent key is being pressed.
+        Shortcuts such as `key: \"Control+o\"`, `key: \"Control++` or `key: \"Control+Shift+T\"` are supported as well. When
+        specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
         **Usage**
 
@@ -11059,7 +11057,9 @@ async def pdf(
         height: typing.Optional[typing.Union[str, float]] = None,
         prefer_css_page_size: typing.Optional[bool] = None,
         margin: typing.Optional[PdfMargins] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        outline: typing.Optional[bool] = None,
+        tagged: typing.Optional[bool] = None
     ) -> bytes:
         """Page.pdf
 
@@ -11148,6 +11148,10 @@ async def pdf(
         path : Union[pathlib.Path, str, None]
             The file path to save the PDF to. If `path` is a relative path, then it is resolved relative to the current working
             directory. If no path is provided, the PDF won't be saved to the disk.
+        outline : Union[bool, None]
+            Whether or not to embed the document outline into the PDF. Defaults to `false`.
+        tagged : Union[bool, None]
+            Whether or not to generate tagged (accessible) PDF. Defaults to `false`.
 
         Returns
         -------
@@ -11169,6 +11173,8 @@ async def pdf(
                 preferCSSPageSize=prefer_css_page_size,
                 margin=margin,
                 path=path,
+                outline=outline,
+                tagged=tagged,
             )
         )
 
@@ -11658,6 +11664,94 @@ async def set_checked(
             )
         )
 
+    async def add_locator_handler(
+        self, locator: "Locator", handler: typing.Callable
+    ) -> None:
+        """Page.add_locator_handler
+
+        Sometimes, the web page can show an overlay that obstructs elements behind it and prevents certain actions, like
+        click, from completing. When such an overlay is shown predictably, we recommend dismissing it as a part of your
+        test flow. However, sometimes such an overlay may appear non-deterministically, for example certain cookies consent
+        dialogs behave this way. In this case, `page.add_locator_handler()` allows handling an overlay during an
+        action that it would block.
+
+        This method registers a handler for an overlay that is executed once the locator is visible on the page. The
+        handler should get rid of the overlay so that actions blocked by it can proceed. This is useful for
+        nondeterministic interstitial pages or dialogs, like a cookie consent dialog.
+
+        Note that execution time of the handler counts towards the timeout of the action/assertion that executed the
+        handler.
+
+        You can register multiple handlers. However, only a single handler will be running at a time. Any actions inside a
+        handler must not require another handler to run.
+
+        **NOTE** Running the interceptor will alter your page state mid-test. For example it will change the currently
+        focused element and move the mouse. Make sure that the actions that run after the interceptor are self-contained
+        and do not rely on the focus and mouse state. <br /> <br /> For example, consider a test that calls
+        `locator.focus()` followed by `keyboard.press()`. If your handler clicks a button between these two
+        actions, the focused element most likely will be wrong, and key press will happen on the unexpected element. Use
+        `locator.press()` instead to avoid this problem. <br /> <br /> Another example is a series of mouse
+        actions, where `mouse.move()` is followed by `mouse.down()`. Again, when the handler runs between
+        these two actions, the mouse position will be wrong during the mouse down. Prefer methods like
+        `locator.click()` that are self-contained.
+
+        **Usage**
+
+        An example that closes a cookie dialog when it appears:
+
+        ```py
+        # Setup the handler.
+        def handler():
+          page.get_by_role(\"button\", name=\"Reject all cookies\").click()
+        page.add_locator_handler(page.get_by_role(\"button\", name=\"Accept all cookies\"), handler)
+
+        # Write the test as usual.
+        page.goto(\"https://example.com\")
+        page.get_by_role(\"button\", name=\"Start here\").click()
+        ```
+
+        An example that skips the \"Confirm your security details\" page when it is shown:
+
+        ```py
+        # Setup the handler.
+        def handler():
+          page.get_by_role(\"button\", name=\"Remind me later\").click()
+        page.add_locator_handler(page.get_by_text(\"Confirm your security details\"), handler)
+
+        # Write the test as usual.
+        page.goto(\"https://example.com\")
+        page.get_by_role(\"button\", name=\"Start here\").click()
+        ```
+
+        An example with a custom callback on every actionability check. It uses a `<body>` locator that is always visible,
+        so the handler is called before every actionability check:
+
+        ```py
+        # Setup the handler.
+        def handler():
+          page.evaluate(\"window.removeObstructionsForTestIfNeeded()\")
+        page.add_locator_handler(page.locator(\"body\"), handler)
+
+        # Write the test as usual.
+        page.goto(\"https://example.com\")
+        page.get_by_role(\"button\", name=\"Start here\").click()
+        ```
+
+        Parameters
+        ----------
+        locator : Locator
+            Locator that triggers the handler.
+        handler : Callable
+            Function that should be run once `locator` appears. This function should get rid of the element that blocks actions
+            like click.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.add_locator_handler(
+                locator=locator._impl_obj, handler=self._wrap_handler(handler)
+            )
+        )
+
 
 mapping.register(PageImpl, Page)
 
@@ -11730,8 +11824,7 @@ def on(
         ],
     ) -> None:
         """
-        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
-        emitted if the page throws an error or a warning.
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`.
 
         The arguments passed into `console.log` and the page are available on the `ConsoleMessage` event handler argument.
 
@@ -11909,8 +12002,7 @@ def once(
         ],
     ) -> None:
         """
-        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
-        emitted if the page throws an error or a warning.
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`.
 
         The arguments passed into `console.log` and the page are available on the `ConsoleMessage` event handler argument.
 
@@ -12577,11 +12669,11 @@ async def route(
         some post data, and leaving all other requests as is:
 
         ```py
-        def handle_route(route):
+        async def handle_route(route: Route):
           if (\"my-string\" in route.request.post_data):
-            route.fulfill(body=\"mocked-data\")
+            await route.fulfill(body=\"mocked-data\")
           else:
-            route.continue_()
+            await route.continue_()
         await context.route(\"/api/**\", handle_route)
         ```
 
@@ -16247,8 +16339,8 @@ async def press(
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
-        modifier, modifier is pressed and being held while the subsequent key is being pressed.
+        Shortcuts such as `key: \"Control+o\"`, `key: \"Control++` or `key: \"Control+Shift+T\"` are supported as well. When
+        specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
         Parameters
         ----------
diff --git a/playwright/sync_api/_context_manager.py b/playwright/sync_api/_context_manager.py
index 3efc01e91..c27a25e32 100644
--- a/playwright/sync_api/_context_manager.py
+++ b/playwright/sync_api/_context_manager.py
@@ -20,6 +20,7 @@
 from playwright._impl._connection import ChannelOwner, Connection
 from playwright._impl._driver import compute_driver_executable
 from playwright._impl._errors import Error
+from playwright._impl._greenlets import MainGreenlet
 from playwright._impl._object_factory import create_remote_object
 from playwright._impl._playwright import Playwright
 from playwright._impl._transport import PipeTransport
@@ -55,7 +56,7 @@ def __enter__(self) -> SyncPlaywright:
         def greenlet_main() -> None:
             self._loop.run_until_complete(self._connection.run_as_sync())
 
-        dispatcher_fiber = greenlet(greenlet_main)
+        dispatcher_fiber = MainGreenlet(greenlet_main)
 
         self._connection = Connection(
             dispatcher_fiber,
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 13a4ade12..a861367be 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -1251,8 +1251,8 @@ def press(self, key: str, *, delay: typing.Optional[float] = None) -> None:
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
-        modifier, modifier is pressed and being held while the subsequent key is being pressed.
+        Shortcuts such as `key: \"Control+o\"`, `key: \"Control++` or `key: \"Control+Shift+T\"` are supported as well. When
+        specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
         **Usage**
 
@@ -2410,8 +2410,8 @@ def press(
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
-        modifier, modifier is pressed and being held while the subsequent key is being pressed.
+        Shortcuts such as `key: \"Control+o\"`, `key: \"Control++` or `key: \"Control+Shift+T\"` are supported as well. When
+        specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
         Parameters
         ----------
@@ -5608,8 +5608,8 @@ def press(
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
-        modifier, modifier is pressed and being held while the subsequent key is being pressed.
+        Shortcuts such as `key: \"Control+o\"`, `key: \"Control++` or `key: \"Control+Shift+T\"` are supported as well. When
+        specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
         Parameters
         ----------
@@ -7026,8 +7026,7 @@ def on(
         self, event: Literal["console"], f: typing.Callable[["ConsoleMessage"], "None"]
     ) -> None:
         """
-        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
-        emitted if the page throws an error or a warning.
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`.
 
         The arguments passed into `console.log` are available on the `ConsoleMessage` event handler argument.
 
@@ -7241,8 +7240,7 @@ def once(
         self, event: Literal["console"], f: typing.Callable[["ConsoleMessage"], "None"]
     ) -> None:
         """
-        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
-        emitted if the page throws an error or a warning.
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`.
 
         The arguments passed into `console.log` are available on the `ConsoleMessage` event handler argument.
 
@@ -9103,7 +9101,7 @@ def route(
         some post data, and leaving all other requests as is:
 
         ```py
-        def handle_route(route):
+        def handle_route(route: Route):
           if (\"my-string\" in route.request.post_data):
             route.fulfill(body=\"mocked-data\")
           else:
@@ -10832,8 +10830,8 @@ def press(
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
-        modifier, modifier is pressed and being held while the subsequent key is being pressed.
+        Shortcuts such as `key: \"Control+o\"`, `key: \"Control++` or `key: \"Control+Shift+T\"` are supported as well. When
+        specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
         **Usage**
 
@@ -11140,7 +11138,9 @@ def pdf(
         height: typing.Optional[typing.Union[str, float]] = None,
         prefer_css_page_size: typing.Optional[bool] = None,
         margin: typing.Optional[PdfMargins] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        outline: typing.Optional[bool] = None,
+        tagged: typing.Optional[bool] = None
     ) -> bytes:
         """Page.pdf
 
@@ -11229,6 +11229,10 @@ def pdf(
         path : Union[pathlib.Path, str, None]
             The file path to save the PDF to. If `path` is a relative path, then it is resolved relative to the current working
             directory. If no path is provided, the PDF won't be saved to the disk.
+        outline : Union[bool, None]
+            Whether or not to embed the document outline into the PDF. Defaults to `false`.
+        tagged : Union[bool, None]
+            Whether or not to generate tagged (accessible) PDF. Defaults to `false`.
 
         Returns
         -------
@@ -11251,6 +11255,8 @@ def pdf(
                     preferCSSPageSize=prefer_css_page_size,
                     margin=margin,
                     path=path,
+                    outline=outline,
+                    tagged=tagged,
                 )
             )
         )
@@ -11743,6 +11749,94 @@ def set_checked(
             )
         )
 
+    def add_locator_handler(self, locator: "Locator", handler: typing.Callable) -> None:
+        """Page.add_locator_handler
+
+        Sometimes, the web page can show an overlay that obstructs elements behind it and prevents certain actions, like
+        click, from completing. When such an overlay is shown predictably, we recommend dismissing it as a part of your
+        test flow. However, sometimes such an overlay may appear non-deterministically, for example certain cookies consent
+        dialogs behave this way. In this case, `page.add_locator_handler()` allows handling an overlay during an
+        action that it would block.
+
+        This method registers a handler for an overlay that is executed once the locator is visible on the page. The
+        handler should get rid of the overlay so that actions blocked by it can proceed. This is useful for
+        nondeterministic interstitial pages or dialogs, like a cookie consent dialog.
+
+        Note that execution time of the handler counts towards the timeout of the action/assertion that executed the
+        handler.
+
+        You can register multiple handlers. However, only a single handler will be running at a time. Any actions inside a
+        handler must not require another handler to run.
+
+        **NOTE** Running the interceptor will alter your page state mid-test. For example it will change the currently
+        focused element and move the mouse. Make sure that the actions that run after the interceptor are self-contained
+        and do not rely on the focus and mouse state. <br /> <br /> For example, consider a test that calls
+        `locator.focus()` followed by `keyboard.press()`. If your handler clicks a button between these two
+        actions, the focused element most likely will be wrong, and key press will happen on the unexpected element. Use
+        `locator.press()` instead to avoid this problem. <br /> <br /> Another example is a series of mouse
+        actions, where `mouse.move()` is followed by `mouse.down()`. Again, when the handler runs between
+        these two actions, the mouse position will be wrong during the mouse down. Prefer methods like
+        `locator.click()` that are self-contained.
+
+        **Usage**
+
+        An example that closes a cookie dialog when it appears:
+
+        ```py
+        # Setup the handler.
+        def handler():
+          await page.get_by_role(\"button\", name=\"Reject all cookies\").click()
+        await page.add_locator_handler(page.get_by_role(\"button\", name=\"Accept all cookies\"), handler)
+
+        # Write the test as usual.
+        await page.goto(\"https://example.com\")
+        await page.get_by_role(\"button\", name=\"Start here\").click()
+        ```
+
+        An example that skips the \"Confirm your security details\" page when it is shown:
+
+        ```py
+        # Setup the handler.
+        def handler():
+          await page.get_by_role(\"button\", name=\"Remind me later\").click()
+        await page.add_locator_handler(page.get_by_text(\"Confirm your security details\"), handler)
+
+        # Write the test as usual.
+        await page.goto(\"https://example.com\")
+        await page.get_by_role(\"button\", name=\"Start here\").click()
+        ```
+
+        An example with a custom callback on every actionability check. It uses a `<body>` locator that is always visible,
+        so the handler is called before every actionability check:
+
+        ```py
+        # Setup the handler.
+        def handler():
+          await page.evaluate(\"window.removeObstructionsForTestIfNeeded()\")
+        await page.add_locator_handler(page.locator(\"body\"), handler)
+
+        # Write the test as usual.
+        await page.goto(\"https://example.com\")
+        await page.get_by_role(\"button\", name=\"Start here\").click()
+        ```
+
+        Parameters
+        ----------
+        locator : Locator
+            Locator that triggers the handler.
+        handler : Callable
+            Function that should be run once `locator` appears. This function should get rid of the element that blocks actions
+            like click.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.add_locator_handler(
+                    locator=locator._impl_obj, handler=self._wrap_handler(handler)
+                )
+            )
+        )
+
 
 mapping.register(PageImpl, Page)
 
@@ -11805,8 +11899,7 @@ def on(
         self, event: Literal["console"], f: typing.Callable[["ConsoleMessage"], "None"]
     ) -> None:
         """
-        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
-        emitted if the page throws an error or a warning.
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`.
 
         The arguments passed into `console.log` and the page are available on the `ConsoleMessage` event handler argument.
 
@@ -11950,8 +12043,7 @@ def once(
         self, event: Literal["console"], f: typing.Callable[["ConsoleMessage"], "None"]
     ) -> None:
         """
-        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also
-        emitted if the page throws an error or a warning.
+        Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`.
 
         The arguments passed into `console.log` and the page are available on the `ConsoleMessage` event handler argument.
 
@@ -12595,7 +12687,7 @@ def route(
         some post data, and leaving all other requests as is:
 
         ```py
-        def handle_route(route):
+        def handle_route(route: Route):
           if (\"my-string\" in route.request.post_data):
             route.fulfill(body=\"mocked-data\")
           else:
@@ -16321,8 +16413,8 @@ def press(
         If `key` is a single character, it is case-sensitive, so the values `a` and `A` will generate different respective
         texts.
 
-        Shortcuts such as `key: \"Control+o\"` or `key: \"Control+Shift+T\"` are supported as well. When specified with the
-        modifier, modifier is pressed and being held while the subsequent key is being pressed.
+        Shortcuts such as `key: \"Control+o\"`, `key: \"Control++` or `key: \"Control+Shift+T\"` are supported as well. When
+        specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
         Parameters
         ----------
diff --git a/setup.py b/setup.py
index 8edb3f4ce..c190f3794 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.41.0-beta-1705101589000"
+driver_version = "1.42.0-alpha-2024-02-19"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/assets/headings.html b/tests/assets/headings.html
new file mode 100644
index 000000000..ba770fa4e
--- /dev/null
+++ b/tests/assets/headings.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <title>Headings</title>
+</head>
+
+<body>
+    <h1>Title</h1>
+    <h2>Subtitle</h2>
+    <h3>Subsubtitle</h3>
+    <h2>Subtitle</h2>
+</body>
+
+</html>
diff --git a/tests/assets/input/handle-locator.html b/tests/assets/input/handle-locator.html
new file mode 100644
index 000000000..865fb5364
--- /dev/null
+++ b/tests/assets/input/handle-locator.html
@@ -0,0 +1,82 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Interstitial test</title>
+  </head>
+  <body>
+    <style>
+      body {
+        position: relative;
+      }
+      #target.removed {
+        display: none;
+      }
+      #target.hidden {
+        visibility: hidden;
+      }
+      #target:hover {
+        background: yellow;
+      }
+      #interstitial {
+        position: absolute;
+        top: 0;
+        left: 0;
+        width: 300px;
+        height: 300px;
+        border: 1px solid black;
+        background: rgba(255, 180, 180);
+        display: none;
+      }
+      #interstitial.visible {
+        display: block;
+      }
+      #close {
+        margin: 50px;
+      }
+    </style>
+    <div><button id="target">Click me</button></div>
+    <div id="aside">A place on the side to hover</div>
+    <div id="interstitial">
+      <div>This interstitial covers the button</div>
+      <button id="close">Close the interstitial</button>
+    </div>
+    <script>
+      const target = document.querySelector('#target');
+      const interstitial = document.querySelector('#interstitial');
+      const close = document.querySelector('#close');
+
+      target.addEventListener('click', () => {
+        window.clicked = (window.clicked ?? 0) + 1;
+      }, false);
+
+      close.addEventListener('click', () => {
+        interstitial.classList.remove('visible');
+        target.classList.remove('hidden');
+        target.classList.remove('removed');
+      });
+
+      let timesToShow = 0;
+      function setupAnnoyingInterstitial(event, times, capture) {
+        timesToShow = times;
+        const listener = () => {
+          timesToShow--;
+          interstitial.classList.add('visible');
+          interstitial.getBoundingClientRect();
+          if (!timesToShow && event !== 'none')
+            target.removeEventListener(event, listener, capture === 'capture');
+        };
+        if (event === 'hide') {
+          target.classList.add('hidden');
+          listener();
+        } else if (event === 'remove') {
+          target.classList.add('removed');
+          listener();
+        } else if (event === 'none') {
+          listener();
+        } else {
+          target.addEventListener(event, listener, capture === 'capture');
+        }
+      }
+    </script>
+  </body>
+</html>
diff --git a/tests/async/test_browsercontext_storage_state.py b/tests/async/test_browsercontext_storage_state.py
index 4a00da1c3..9aca1865b 100644
--- a/tests/async/test_browsercontext_storage_state.py
+++ b/tests/async/test_browsercontext_storage_state.py
@@ -16,7 +16,8 @@
 import json
 from pathlib import Path
 
-from playwright.async_api import Browser, BrowserContext
+from playwright.async_api import Browser, BrowserContext, Page
+from tests.server import Server
 
 
 async def test_should_capture_local_storage(context: BrowserContext) -> None:
@@ -99,3 +100,15 @@ async def test_should_round_trip_through_the_file(
     cookie = await page2.evaluate("document.cookie")
     assert cookie == "username=John Doe"
     await context2.close()
+
+
+async def test_should_serialiser_storage_state_with_lone_surrogates(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.evaluate(
+        """chars => window.localStorage.setItem('foo', String.fromCharCode(55934))"""
+    )
+    storage_state = await context.storage_state()
+    # 65533 is the Unicode replacement character
+    assert storage_state["origins"][0]["localStorage"][0]["value"] == chr(65533)
diff --git a/tests/async/test_click.py b/tests/async/test_click.py
index 8143a6b3d..038d6239d 100644
--- a/tests/async/test_click.py
+++ b/tests/async/test_click.py
@@ -242,7 +242,8 @@ async def test_timeout_waiting_for_display_none_to_be_gone(
         error = e
     assert "Timeout 5000ms exceeded" in error.message
     assert "waiting for element to be visible, enabled and stable" in error.message
-    assert "element is not visible - waiting" in error.message
+    assert "element is not visible" in error.message
+    assert "retrying click action" in error.message
 
 
 async def test_timeout_waiting_for_visbility_hidden_to_be_gone(
@@ -256,7 +257,8 @@ async def test_timeout_waiting_for_visbility_hidden_to_be_gone(
         error = e
     assert "Timeout 5000ms exceeded" in error.message
     assert "waiting for element to be visible, enabled and stable" in error.message
-    assert "element is not visible - waiting" in error.message
+    assert "element is not visible" in error.message
+    assert "retrying click action" in error.message
 
 
 async def test_waitFor_visible_when_parent_is_hidden(
@@ -568,7 +570,8 @@ async def test_timeout_waiting_for_stable_position(page: Page, server: Server) -
     error = exc_info.value
     assert "Timeout 3000ms exceeded." in error.message
     assert "waiting for element to be visible, enabled and stable" in error.message
-    assert "element is not stable - waiting" in error.message
+    assert "element is not stable" in error.message
+    assert "retrying click action" in error.message
 
 
 async def test_wait_for_becoming_hit_target(page: Page, server: Server) -> None:
@@ -696,7 +699,8 @@ async def test_timeout_waiting_for_button_to_be_enabled(
     assert await page.evaluate("window.__CLICKED") is None
     assert error
     assert "Timeout 3000ms exceeded" in error.message
-    assert "element is not enabled - waiting" in error.message
+    assert "element is not enabled" in error.message
+    assert "retrying click action" in error.message
 
 
 async def test_wait_for_input_to_be_enabled(page: Page, server: Server) -> None:
diff --git a/tests/async/test_element_handle.py b/tests/async/test_element_handle.py
index 3de959186..379e78c18 100644
--- a/tests/async/test_element_handle.py
+++ b/tests/async/test_element_handle.py
@@ -495,7 +495,8 @@ async def test_should_timeout_waiting_for_visible(page: Page) -> None:
     assert div
     with pytest.raises(Error) as exc_info:
         await div.scroll_into_view_if_needed(timeout=3000)
-    assert "element is not displayed, retrying in 100ms" in exc_info.value.message
+    assert "element is not visible" in exc_info.value.message
+    assert "retrying scroll into view action" in exc_info.value.message
 
 
 async def test_fill_input(page: Page, server: Server) -> None:
diff --git a/tests/async/test_har.py b/tests/async/test_har.py
index 7e02776f1..d039273cc 100644
--- a/tests/async/test_har.py
+++ b/tests/async/test_har.py
@@ -23,7 +23,7 @@
 import pytest
 
 from playwright.async_api import Browser, BrowserContext, Error, Page, Route, expect
-from tests.server import Server
+from tests.server import Server, TestServerRequest
 from tests.utils import must
 
 
@@ -453,9 +453,6 @@ async def test_should_go_back_to_redirected_navigation(
     assert await page.evaluate("window.location.href") == "https://www.theverge.com/"
 
 
-@pytest.mark.skip_browser(
-    "firefox"
-)  # skipped upstream (https://github.com/microsoft/playwright/blob/6a8d835145e2f4002ee00b67a80a1f70af956703/tests/library/browsercontext-har.spec.ts#L214)
 async def test_should_go_forward_to_redirected_navigation(
     context: BrowserContext, server: Server, assetdir: Path
 ) -> None:
@@ -755,3 +752,55 @@ async def test_should_update_extracted_har_zip_for_page(
     await expect(page_2.locator("body")).to_have_css(
         "background-color", "rgb(255, 192, 203)"
     )
+
+
+async def test_should_ignore_aborted_requests(
+    context_factory: Callable[[], Awaitable[BrowserContext]],
+    server: Server,
+    tmpdir: Path,
+) -> None:
+    path = tmpdir / "test.har"
+    server.set_route("/x", lambda request: request.transport.loseConnection())
+    context1 = await context_factory()
+    await context1.route_from_har(har=path, update=True)
+    page1 = await context1.new_page()
+    await page1.goto(server.EMPTY_PAGE)
+    req_promise = asyncio.create_task(server.wait_for_request("/x"))
+    eval_task = asyncio.create_task(
+        page1.evaluate(
+            "url => fetch(url).catch(e => 'cancelled')", server.PREFIX + "/x"
+        )
+    )
+    await req_promise
+    req = await eval_task
+    assert req == "cancelled"
+    await context1.close()
+
+    server.reset()
+
+    def _handle_route(req: TestServerRequest) -> None:
+        req.setHeader("Content-Type", "text/plain")
+        req.write(b"test")
+        req.finish()
+
+    server.set_route("/x", _handle_route)
+    context2 = await context_factory()
+    await context2.route_from_har(path)
+    page2 = await context2.new_page()
+    await page2.goto(server.EMPTY_PAGE)
+    eval_task = asyncio.create_task(
+        page2.evaluate(
+            "url => fetch(url).catch(e => 'cancelled')", server.PREFIX + "/x"
+        )
+    )
+
+    async def _timeout() -> str:
+        await asyncio.sleep(1)
+        return "timeout"
+
+    done, _ = await asyncio.wait(
+        [eval_task, asyncio.create_task(_timeout())],
+        return_when=asyncio.FIRST_COMPLETED,
+    )
+    assert next(iter(done)).result() == "timeout"
+    eval_task.cancel()
diff --git a/tests/async/test_page_add_locator_handler.py b/tests/async/test_page_add_locator_handler.py
new file mode 100644
index 000000000..8eb08c59d
--- /dev/null
+++ b/tests/async/test_page_add_locator_handler.py
@@ -0,0 +1,198 @@
+# 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 Error, Page, expect
+from tests.server import Server
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
+
+
+async def test_should_work(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    before_count = 0
+    after_count = 0
+
+    async def handler() -> None:
+        nonlocal before_count
+        nonlocal after_count
+        before_count += 1
+        await page.locator("#close").click()
+        after_count += 1
+
+    await page.add_locator_handler(
+        page.locator("text=This interstitial covers the button"), handler
+    )
+
+    for args in [
+        ["mouseover", 1],
+        ["mouseover", 1, "capture"],
+        ["mouseover", 2],
+        ["mouseover", 2, "capture"],
+        ["pointerover", 1],
+        ["pointerover", 1, "capture"],
+        ["none", 1],
+        ["remove", 1],
+        ["hide", 1],
+    ]:
+        await page.locator("#aside").hover()
+        before_count = 0
+        after_count = 0
+        await page.evaluate(
+            "(args) => { window.clicked = 0; window.setupAnnoyingInterstitial(...args); }",
+            args,
+        )
+        assert before_count == 0
+        assert after_count == 0
+        await page.locator("#target").click()
+        assert before_count == args[1]
+        assert after_count == args[1]
+        assert await page.evaluate("window.clicked") == 1
+        await expect(page.locator("#interstitial")).not_to_be_visible()
+
+
+async def test_should_work_with_a_custom_check(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    async def handler() -> None:
+        if await page.get_by_text("This interstitial covers the button").is_visible():
+            await page.locator("#close").click()
+
+    await page.add_locator_handler(page.locator("body"), handler)
+
+    for args in [
+        ["mouseover", 2],
+        ["none", 1],
+        ["remove", 1],
+        ["hide", 1],
+    ]:
+        await page.locator("#aside").hover()
+        await page.evaluate(
+            "(args) => { window.clicked = 0; window.setupAnnoyingInterstitial(...args); }",
+            args,
+        )
+        await page.locator("#target").click()
+        assert await page.evaluate("window.clicked") == 1
+        await expect(page.locator("#interstitial")).not_to_be_visible()
+
+
+async def test_should_work_with_locator_hover(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    await page.add_locator_handler(
+        page.get_by_text("This interstitial covers the button"),
+        lambda: page.locator("#close").click(),
+    )
+
+    await page.locator("#aside").hover()
+    await page.evaluate(
+        '() => { window.setupAnnoyingInterstitial("pointerover", 1, "capture"); }'
+    )
+    await page.locator("#target").hover()
+    await expect(page.locator("#interstitial")).not_to_be_visible()
+    assert (
+        await page.eval_on_selector(
+            "#target", "e => window.getComputedStyle(e).backgroundColor"
+        )
+        == "rgb(255, 255, 0)"
+    )
+
+
+async def test_should_not_work_with_force_true(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    await page.add_locator_handler(
+        page.get_by_text("This interstitial covers the button"),
+        lambda: page.locator("#close").click(),
+    )
+
+    await page.locator("#aside").hover()
+    await page.evaluate('() => { window.setupAnnoyingInterstitial("none", 1); }')
+    await page.locator("#target").click(force=True, timeout=2000)
+    assert await page.locator("#interstitial").is_visible()
+    assert await page.evaluate("window.clicked") is None
+
+
+async def test_should_throw_when_page_closes(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    await page.add_locator_handler(
+        page.get_by_text("This interstitial covers the button"), lambda: page.close()
+    )
+
+    await page.locator("#aside").hover()
+    await page.evaluate(
+        '() => { window.clicked = 0; window.setupAnnoyingInterstitial("mouseover", 1); }'
+    )
+    with pytest.raises(Error) as exc:
+        await page.locator("#target").click()
+    assert TARGET_CLOSED_ERROR_MESSAGE in exc.value.message
+
+
+async def test_should_throw_when_handler_times_out(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    called = 0
+    stall_future: asyncio.Future[None] = asyncio.Future()
+
+    async def handler() -> None:
+        nonlocal called
+        called += 1
+        # Deliberately timeout.
+        await stall_future
+
+    await page.add_locator_handler(
+        page.get_by_text("This interstitial covers the button"), handler
+    )
+
+    await page.locator("#aside").hover()
+    await page.evaluate(
+        '() => { window.clicked = 0; window.setupAnnoyingInterstitial("mouseover", 1); }'
+    )
+    with pytest.raises(Error) as exc:
+        await page.locator("#target").click(timeout=3000)
+    assert "Timeout 3000ms exceeded" in exc.value.message
+
+    with pytest.raises(Error) as exc:
+        await page.locator("#target").click(timeout=3000)
+    assert "Timeout 3000ms exceeded" in exc.value.message
+
+    # Should not enter the same handler while it is still running.
+    assert called == 1
+    stall_future.cancel()
+
+
+async def test_should_work_with_to_be_visible(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    called = 0
+
+    async def handler() -> None:
+        nonlocal called
+        called += 1
+        await page.locator("#close").click()
+
+    await page.add_locator_handler(
+        page.get_by_text("This interstitial covers the button"), handler
+    )
+
+    await page.evaluate(
+        '() => { window.clicked = 0; window.setupAnnoyingInterstitial("remove", 1); }'
+    )
+    await expect(page.locator("#target")).to_be_visible()
+    await expect(page.locator("#interstitial")).not_to_be_visible()
+    assert called == 1
diff --git a/tests/async/test_pdf.py b/tests/async/test_pdf.py
index a57a33d05..7e916dc11 100644
--- a/tests/async/test_pdf.py
+++ b/tests/async/test_pdf.py
@@ -18,16 +18,30 @@
 import pytest
 
 from playwright.async_api import Page
+from tests.server import Server
+
+pytestmark = pytest.mark.only_browser("chromium")
 
 
-@pytest.mark.only_browser("chromium")
 async def test_should_be_able_to_save_pdf_file(page: Page, tmpdir: Path) -> None:
     output_file = tmpdir / "foo.png"
     await page.pdf(path=str(output_file))
     assert os.path.getsize(output_file) > 0
 
 
-@pytest.mark.only_browser("chromium")
 async def test_should_be_able_capture_pdf_without_path(page: Page) -> None:
     buffer = await page.pdf()
     assert buffer
+
+
+async def test_should_be_able_to_generate_outline(
+    page: Page, server: Server, tmpdir: Path
+) -> None:
+    await page.goto(server.PREFIX + "/headings.html")
+    output_file_no_outline = tmpdir / "outputNoOutline.pdf"
+    output_file_outline = tmpdir / "outputOutline.pdf"
+    await page.pdf(path=output_file_no_outline)
+    await page.pdf(path=output_file_outline, tagged=True, outline=True)
+    assert os.path.getsize(output_file_outline) > os.path.getsize(
+        output_file_no_outline
+    )
diff --git a/tests/conftest.py b/tests/conftest.py
index 6dbd34478..d5e9226f1 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -233,7 +233,7 @@ def __init__(
             node_executable = driver_dir / "node.exe"
         else:
             node_executable = driver_dir / "node"
-        cli_js = driver_dir / "package" / "lib" / "cli" / "cli.js"
+        cli_js = driver_dir / "package" / "cli.js"
         tmpfile.write_text(json.dumps(launch_server_options))
         self.process = subprocess.Popen(
             [
diff --git a/tests/sync/conftest.py b/tests/sync/conftest.py
index 68221b216..b825ca2fe 100644
--- a/tests/sync/conftest.py
+++ b/tests/sync/conftest.py
@@ -55,7 +55,7 @@ def browser_type(
         browser_type = playwright.firefox
     elif browser_name == "webkit":
         browser_type = playwright.webkit
-    assert browser_type
+    assert browser_type, f"Unkown browser name '{browser_name}'"
     yield browser_type
 
 
diff --git a/tests/sync/test_element_handle.py b/tests/sync/test_element_handle.py
index d5e1055ce..89f6ae2b1 100644
--- a/tests/sync/test_element_handle.py
+++ b/tests/sync/test_element_handle.py
@@ -401,7 +401,8 @@ def test_should_timeout_waiting_for_visible(page: Page) -> None:
     assert div
     with pytest.raises(Error) as exc_info:
         div.scroll_into_view_if_needed(timeout=3000)
-    assert "element is not displayed, retrying in 100ms" in exc_info.value.message
+    assert "element is not visible" in exc_info.value.message
+    assert "retrying scroll into view action" in exc_info.value.message
 
 
 def test_fill_input(page: Page, server: Server) -> None:
diff --git a/tests/sync/test_page_add_locator_handler.py b/tests/sync/test_page_add_locator_handler.py
new file mode 100644
index 000000000..e4ba14462
--- /dev/null
+++ b/tests/sync/test_page_add_locator_handler.py
@@ -0,0 +1,197 @@
+# 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 Error, Page, expect
+from tests.server import Server
+from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
+
+
+def test_should_work(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    before_count = 0
+    after_count = 0
+
+    def handler() -> None:
+        nonlocal before_count
+        nonlocal after_count
+        before_count += 1
+        page.locator("#close").click()
+        after_count += 1
+
+    page.add_locator_handler(
+        page.locator("text=This interstitial covers the button"), handler
+    )
+
+    for args in [
+        ["mouseover", 1],
+        ["mouseover", 1, "capture"],
+        ["mouseover", 2],
+        ["mouseover", 2, "capture"],
+        ["pointerover", 1],
+        ["pointerover", 1, "capture"],
+        ["none", 1],
+        ["remove", 1],
+        ["hide", 1],
+    ]:
+        page.locator("#aside").hover()
+        before_count = 0
+        after_count = 0
+        page.evaluate(
+            "(args) => { window.clicked = 0; window.setupAnnoyingInterstitial(...args); }",
+            args,
+        )
+        assert before_count == 0
+        assert after_count == 0
+        page.locator("#target").click()
+        assert before_count == args[1]
+        assert after_count == args[1]
+        assert page.evaluate("window.clicked") == 1
+        expect(page.locator("#interstitial")).not_to_be_visible()
+
+
+def test_should_work_with_a_custom_check(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    def handler() -> None:
+        if page.get_by_text("This interstitial covers the button").is_visible():
+            page.locator("#close").click()
+
+    page.add_locator_handler(page.locator("body"), handler)
+
+    for args in [
+        ["mouseover", 2],
+        ["none", 1],
+        ["remove", 1],
+        ["hide", 1],
+    ]:
+        page.locator("#aside").hover()
+        page.evaluate(
+            "(args) => { window.clicked = 0; window.setupAnnoyingInterstitial(...args); }",
+            args,
+        )
+        page.locator("#target").click()
+        assert page.evaluate("window.clicked") == 1
+        expect(page.locator("#interstitial")).not_to_be_visible()
+
+
+def test_should_work_with_locator_hover(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    page.add_locator_handler(
+        page.get_by_text("This interstitial covers the button"),
+        lambda: page.locator("#close").click(),
+    )
+
+    page.locator("#aside").hover()
+    page.evaluate(
+        '() => { window.setupAnnoyingInterstitial("pointerover", 1, "capture"); }'
+    )
+    page.locator("#target").hover()
+    expect(page.locator("#interstitial")).not_to_be_visible()
+    assert (
+        page.eval_on_selector(
+            "#target", "e => window.getComputedStyle(e).backgroundColor"
+        )
+        == "rgb(255, 255, 0)"
+    )
+
+
+def test_should_not_work_with_force_true(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    page.add_locator_handler(
+        page.get_by_text("This interstitial covers the button"),
+        lambda: page.locator("#close").click(),
+    )
+
+    page.locator("#aside").hover()
+    page.evaluate('() => { window.setupAnnoyingInterstitial("none", 1); }')
+    page.locator("#target").click(force=True, timeout=2000)
+    assert page.locator("#interstitial").is_visible()
+    assert page.evaluate("window.clicked") is None
+
+
+def test_should_throw_when_page_closes(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    page.add_locator_handler(
+        page.get_by_text("This interstitial covers the button"), lambda: page.close()
+    )
+
+    page.locator("#aside").hover()
+    page.evaluate(
+        '() => { window.clicked = 0; window.setupAnnoyingInterstitial("mouseover", 1); }'
+    )
+    with pytest.raises(Error) as exc:
+        page.locator("#target").click()
+    assert TARGET_CLOSED_ERROR_MESSAGE in exc.value.message
+
+
+def test_should_throw_when_handler_times_out(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    called = 0
+
+    def handler() -> None:
+        nonlocal called
+        called += 1
+        # Deliberately timeout.
+        try:
+            page.wait_for_timeout(9999999)
+        except Error:
+            pass
+
+    page.add_locator_handler(
+        page.get_by_text("This interstitial covers the button"), handler
+    )
+
+    page.locator("#aside").hover()
+    page.evaluate(
+        '() => { window.clicked = 0; window.setupAnnoyingInterstitial("mouseover", 1); }'
+    )
+    with pytest.raises(Error) as exc:
+        page.locator("#target").click(timeout=3000)
+    assert "Timeout 3000ms exceeded" in exc.value.message
+
+    with pytest.raises(Error) as exc:
+        page.locator("#target").click(timeout=3000)
+    assert "Timeout 3000ms exceeded" in exc.value.message
+
+    # Should not enter the same handler while it is still running.
+    assert called == 1
+
+
+def test_should_work_with_to_be_visible(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+
+    called = 0
+
+    def handler() -> None:
+        nonlocal called
+        called += 1
+        page.locator("#close").click()
+
+    page.add_locator_handler(
+        page.get_by_text("This interstitial covers the button"), handler
+    )
+
+    page.evaluate(
+        '() => { window.clicked = 0; window.setupAnnoyingInterstitial("remove", 1); }'
+    )
+    expect(page.locator("#target")).to_be_visible()
+    expect(page.locator("#interstitial")).not_to_be_visible()
+    assert called == 1

From 51bab3928c2ef74cf297307c2382bbf89d69c689 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 23 Feb 2024 09:06:24 +0100
Subject: [PATCH 161/438] test: fix deprecated datetime serialisation
 (follow-up to #2314)

---
 tests/async/test_assertions.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 774d60de5..b8936f4bf 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -13,8 +13,8 @@
 # limitations under the License.
 
 import asyncio
+import datetime
 import re
-from datetime import datetime
 
 import pytest
 
@@ -183,7 +183,11 @@ async def test_assertions_locator_to_have_js_property(
     )
     await expect(page.locator("div")).to_have_js_property(
         "foo",
-        {"a": 1, "b": "string", "c": datetime.utcfromtimestamp(1627503992000 / 1000)},
+        {
+            "a": 1,
+            "b": "string",
+            "c": datetime.datetime.fromtimestamp(1627503992000 / 1000),
+        },
     )
 
 

From 976f04fb4d56d1497fd85e0c5199a9daeed4a138 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 23 Feb 2024 11:12:12 +0100
Subject: [PATCH 162/438] fix: ignore exceptions from updateInterceptorPatterns
 (#2317)

---
 playwright/_impl/_page.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 414ef46aa..9b0798bd5 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -262,9 +262,16 @@ async def _on_route(self, route: Route) -> None:
                 handled = await route_handler.handle(route)
             finally:
                 if len(self._routes) == 0:
+
+                    async def _update_interceptor_patterns_ignore_exceptions() -> None:
+                        try:
+                            await self._update_interception_patterns()
+                        except Error:
+                            pass
+
                     asyncio.create_task(
                         self._connection.wrap_api_call(
-                            lambda: self._update_interception_patterns(), True
+                            _update_interceptor_patterns_ignore_exceptions, True
                         )
                     )
             if handled:

From a4d5fcc456beccec68560cf55ad91050aef44af7 Mon Sep 17 00:00:00 2001
From: Daniel Henderson <77417639+danphenderson@users.noreply.github.com>
Date: Mon, 26 Feb 2024 00:37:14 -0800
Subject: [PATCH 163/438] fix: bug initializing `sync_playwright` when using
 uvloop.EventPolicy. (#2311)

Co-authored-by: danphenderson <danphenderson@gmail.com>
---
 playwright/_impl/_connection.py | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index dd9c709ef..18b8b3423 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -334,20 +334,22 @@ def _send_message_to_server(
                 "line": frames[0]["line"],
                 "column": frames[0]["column"],
             }
-            if len(frames) > 0
+            if frames
             else None
         )
+        metadata = {
+            "wallTime": int(datetime.datetime.now().timestamp() * 1000),
+            "apiName": stack_trace_information["apiName"],
+            "internal": not stack_trace_information["apiName"],
+        }
+        if location:
+            metadata["location"] = location  # type: ignore
         message = {
             "id": id,
             "guid": object._guid,
             "method": method,
             "params": self._replace_channels_with_guids(params),
-            "metadata": {
-                "wallTime": int(datetime.datetime.now().timestamp() * 1000),
-                "apiName": stack_trace_information["apiName"],
-                "location": location,
-                "internal": not stack_trace_information["apiName"],
-            },
+            "metadata": metadata,
         }
         if self._tracing_count > 0 and frames and object._guid != "localUtils":
             self.local_utils.add_stack_to_tracing_no_reply(id, frames)

From 37bce20e31ecb95163877c9f4a1e8857f90a711c Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 26 Feb 2024 19:24:50 +0100
Subject: [PATCH 164/438] fix: report route handler errors to the user after
 they completed (#2321)

Issue: Exceptions which will get thrown in route handlers after route.{fulfill,continue,abort} got called,
won't get surfaced to the user in the sync and async version of Playwright for Python.

Scope: Event handlers which use asyncio.create_task
  - {BrowserContext,Page}.on("route")
  - {Page}.on({"route", "locatorHandlerTriggered"})

There were multiple issues in the implementation:

1. `playwright/_impl/_helper.py` (sync only): we were only waiting until a handler's {continue,fulfill,abort} got called, and did not wait until the actual callback completed. Fix: Wait until the handler completed.
2. `playwright/_impl/_connection.py:423` (sync only): We call event listeners manually, this means that `pyee`'s `"error"` event is not working there. Fix: attach a done callback manually, like pyee is doing inside their library.
3. `playwright/_impl/_connection.py:56` (async): attach an `"error"` event handler for the async error reporting
4. `playwright/_impl/_connection.py:90` if we report an error to the user, we should cancel the underlying future otherwise a warning gets emitted, that there was a future exception never received.

---------

Co-authored-by: Dmitry Gozman <dgozman@gmail.com>
---
 playwright/_impl/_browser_context.py          |  2 +-
 playwright/_impl/_connection.py               | 31 ++++++++++++++-----
 playwright/_impl/_helper.py                   | 12 ++++++-
 playwright/_impl/_page.py                     |  4 +--
 .../test_browsercontext_request_intercept.py  | 13 ++++++++
 .../test_browsercontext_request_intercept.py  | 13 ++++++++
 6 files changed, 64 insertions(+), 11 deletions(-)

diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 6ea934323..c52a134c8 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -123,7 +123,7 @@ def __init__(
         )
         self._channel.on(
             "route",
-            lambda params: asyncio.create_task(
+            lambda params: self._loop.create_task(
                 self._on_route(
                     from_channel(params.get("route")),
                 )
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 18b8b3423..ba6a8ba9f 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -53,6 +53,7 @@ def __init__(self, connection: "Connection", object: "ChannelOwner") -> None:
         self._connection = connection
         self._guid = object._guid
         self._object = object
+        self.on("error", lambda exc: self._connection._on_event_listener_error(exc))
 
     async def send(self, method: str, params: Dict = None) -> Any:
         return await self._connection.wrap_api_call(
@@ -77,13 +78,13 @@ async def inner_send(
     ) -> Any:
         if params is None:
             params = {}
-        callback = self._connection._send_message_to_server(
-            self._object, method, _filter_none(params)
-        )
         if self._connection._error:
             error = self._connection._error
             self._connection._error = None
             raise error
+        callback = self._connection._send_message_to_server(
+            self._object, method, _filter_none(params)
+        )
         done, _ = await asyncio.wait(
             {
                 self._connection._transport.on_error_future,
@@ -416,10 +417,22 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
         try:
             if self._is_sync:
                 for listener in object._channel.listeners(method):
+                    # Event handlers like route/locatorHandlerTriggered require us to perform async work.
+                    # In order to report their potential errors to the user, we need to catch it and store it in the connection
+                    def _done_callback(future: asyncio.Future) -> None:
+                        exc = future.exception()
+                        if exc:
+                            self._on_event_listener_error(exc)
+
+                    def _listener_with_error_handler_attached(params: Any) -> None:
+                        potential_future = listener(params)
+                        if asyncio.isfuture(potential_future):
+                            potential_future.add_done_callback(_done_callback)
+
                     # Each event handler is a potentilly blocking context, create a fiber for each
                     # and switch to them in order, until they block inside and pass control to each
                     # other and then eventually back to dispatcher as listener functions return.
-                    g = EventGreenlet(listener)
+                    g = EventGreenlet(_listener_with_error_handler_attached)
                     if should_replace_guids_with_channels:
                         g.switch(self._replace_guids_with_channels(params))
                     else:
@@ -432,9 +445,13 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
                 else:
                     object._channel.emit(method, params)
         except BaseException as exc:
-            print("Error occurred in event listener", file=sys.stderr)
-            traceback.print_exc()
-            self._error = exc
+            self._on_event_listener_error(exc)
+
+    def _on_event_listener_error(self, exc: BaseException) -> None:
+        print("Error occurred in event listener", file=sys.stderr)
+        traceback.print_exception(type(exc), exc, exc.__traceback__, file=sys.stderr)
+        # Save the error to throw at the next API call. This "replicates" unhandled rejection in Node.js.
+        self._error = exc
 
     def _create_remote_object(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index cd6a1d68c..20ab885f8 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -299,10 +299,20 @@ async def _handle_internal(self, route: "Route") -> bool:
 
         self._handled_count += 1
         if self._is_sync:
+            handler_finished_future = route._loop.create_future()
+
+            def _handler() -> None:
+                try:
+                    self.handler(route, route.request)  # type: ignore
+                    handler_finished_future.set_result(None)
+                except Exception as e:
+                    handler_finished_future.set_exception(e)
+
             # As with event handlers, each route handler is a potentially blocking context
             # so it needs a fiber.
-            g = RouteGreenlet(lambda: self.handler(route, route.request))  # type: ignore
+            g = RouteGreenlet(_handler)
             g.switch()
+            await handler_finished_future
         else:
             coro_or_future = self.handler(route, route.request)  # type: ignore
             if coro_or_future:
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 9b0798bd5..db6cf13b8 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -180,13 +180,13 @@ def __init__(
         )
         self._channel.on(
             "locatorHandlerTriggered",
-            lambda params: asyncio.create_task(
+            lambda params: self._loop.create_task(
                 self._on_locator_handler_triggered(params["uid"])
             ),
         )
         self._channel.on(
             "route",
-            lambda params: asyncio.create_task(
+            lambda params: self._loop.create_task(
                 self._on_route(from_channel(params["route"]))
             ),
         )
diff --git a/tests/async/test_browsercontext_request_intercept.py b/tests/async/test_browsercontext_request_intercept.py
index ffb5103c1..1b4f57322 100644
--- a/tests/async/test_browsercontext_request_intercept.py
+++ b/tests/async/test_browsercontext_request_intercept.py
@@ -15,6 +15,7 @@
 import asyncio
 from pathlib import Path
 
+import pytest
 from twisted.web import http
 
 from playwright.async_api import BrowserContext, Page, Route
@@ -179,3 +180,15 @@ async def test_should_give_access_to_the_intercepted_response_body(
         route.fulfill(response=response),
         eval_task,
     )
+
+
+async def test_should_show_exception_after_fulfill(page: Page, server: Server) -> None:
+    async def _handle(route: Route) -> None:
+        await route.continue_()
+        raise Exception("Exception text!?")
+
+    await page.route("*/**", _handle)
+    await page.goto(server.EMPTY_PAGE)
+    # Any next API call should throw because handler did throw during previous goto()
+    with pytest.raises(Exception, match="Exception text!?"):
+        await page.goto(server.EMPTY_PAGE)
diff --git a/tests/sync/test_browsercontext_request_intercept.py b/tests/sync/test_browsercontext_request_intercept.py
index b136038ec..16cca8cfd 100644
--- a/tests/sync/test_browsercontext_request_intercept.py
+++ b/tests/sync/test_browsercontext_request_intercept.py
@@ -14,6 +14,7 @@
 
 from pathlib import Path
 
+import pytest
 from twisted.web import http
 
 from playwright.sync_api import BrowserContext, Page, Route
@@ -121,3 +122,15 @@ def handle_route(route: Route) -> None:
     assert request.uri.decode() == "/title.html"
     original = (assetdir / "title.html").read_text()
     assert response.text() == original
+
+
+def test_should_show_exception_after_fulfill(page: Page, server: Server) -> None:
+    def _handle(route: Route) -> None:
+        route.continue_()
+        raise Exception("Exception text!?")
+
+    page.route("*/**", _handle)
+    page.goto(server.EMPTY_PAGE)
+    # Any next API call should throw because handler did throw during previous goto()
+    with pytest.raises(Exception, match="Exception text!?"):
+        page.goto(server.EMPTY_PAGE)

From 84a62e47d0195efd4da37e373747bfc6bcc9d889 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 26 Feb 2024 19:29:00 +0100
Subject: [PATCH 165/438] build(deps): bump pyopenssl from 23.2.0 to 24.0.0
 (#2325)

Bumps [pyopenssl](https://github.com/pyca/pyopenssl) from 23.2.0 to 24.0.0.
- [Changelog](https://github.com/pyca/pyopenssl/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/pyopenssl/compare/23.2.0...24.0.0)

---
updated-dependencies:
- dependency-name: pyopenssl
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index a65c17974..5931e3e00 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -8,7 +8,7 @@ objgraph==3.6.0
 Pillow==10.2.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
-pyOpenSSL==23.2.0
+pyOpenSSL==24.0.0
 pytest==8.0.0
 pytest-asyncio==0.21.1
 pytest-cov==4.1.0

From 9517a9a96e74cd2563bfb2157fbfcdf450706c0d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 26 Feb 2024 19:29:06 +0100
Subject: [PATCH 166/438] build(deps): bump objgraph from 3.6.0 to 3.6.1
 (#2327)

Bumps [objgraph](https://github.com/mgedmin/objgraph) from 3.6.0 to 3.6.1.
- [Release notes](https://github.com/mgedmin/objgraph/releases)
- [Changelog](https://github.com/mgedmin/objgraph/blob/master/CHANGES.rst)
- [Commits](https://github.com/mgedmin/objgraph/compare/3.6.0...3.6.1)

---
updated-dependencies:
- dependency-name: objgraph
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 5931e3e00..f966adc10 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -4,7 +4,7 @@ black==24.2.0
 flake8==7.0.0
 flaky==3.7.0
 mypy==1.8.0
-objgraph==3.6.0
+objgraph==3.6.1
 Pillow==10.2.0
 pixelmatch==0.3.0
 pre-commit==3.4.0

From 2dd251c1290cef32ca0dcf6442e739a37c64a37b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 26 Feb 2024 19:29:12 +0100
Subject: [PATCH 167/438] build(deps): bump types-requests from 2.31.0.10 to
 2.31.0.20240218 (#2326)

Bumps [types-requests](https://github.com/python/typeshed) from 2.31.0.10 to 2.31.0.20240218.
- [Commits](https://github.com/python/typeshed/commits)

---
updated-dependencies:
- dependency-name: types-requests
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index f966adc10..740822b7a 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -20,5 +20,5 @@ service_identity==24.1.0
 setuptools==68.2.2
 twisted==23.10.0
 types-pyOpenSSL==24.0.0.20240130
-types-requests==2.31.0.10
+types-requests==2.31.0.20240218
 wheel==0.41.2

From 274ea8f1cbd59dbad930f6e4165ff51dfa8def02 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 5 Mar 2024 13:10:53 +0100
Subject: [PATCH 168/438] build(deps): bump setuptools from 68.2.2 to 69.1.1
 (#2339)

Bumps [setuptools](https://github.com/pypa/setuptools) from 68.2.2 to 69.1.1.
- [Release notes](https://github.com/pypa/setuptools/releases)
- [Changelog](https://github.com/pypa/setuptools/blob/main/NEWS.rst)
- [Commits](https://github.com/pypa/setuptools/compare/v68.2.2...v69.1.1)

---
updated-dependencies:
- dependency-name: setuptools
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 740822b7a..1c40ac36d 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.2.0
 pytest-xdist==3.5.0
 requests==2.31.0
 service_identity==24.1.0
-setuptools==68.2.2
+setuptools==69.1.1
 twisted==23.10.0
 types-pyOpenSSL==24.0.0.20240130
 types-requests==2.31.0.20240218

From 07efec18d35dd8b412a4e78c111b909f55f0e3a3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 5 Mar 2024 13:11:05 +0100
Subject: [PATCH 169/438] build(deps): bump types-pyopenssl from
 24.0.0.20240130 to 24.0.0.20240228 (#2338)

build(deps): bump types-pyopenssl

Bumps [types-pyopenssl](https://github.com/python/typeshed) from 24.0.0.20240130 to 24.0.0.20240228.
- [Commits](https://github.com/python/typeshed/commits)

---
updated-dependencies:
- dependency-name: types-pyopenssl
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 1c40ac36d..3243c809e 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,6 +19,6 @@ requests==2.31.0
 service_identity==24.1.0
 setuptools==69.1.1
 twisted==23.10.0
-types-pyOpenSSL==24.0.0.20240130
+types-pyOpenSSL==24.0.0.20240228
 types-requests==2.31.0.20240218
 wheel==0.41.2

From 0d2899ac6e224021848f4bafaf80b56afd0a229b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 5 Mar 2024 16:23:47 +0100
Subject: [PATCH 170/438] build(deps): bump twisted from 23.10.0 to 24.3.0
 (#2337)

---
 local-requirements.txt                    | 2 +-
 tests/async/test_fetch_browser_context.py | 2 +-
 tests/async/test_har.py                   | 2 +-
 tests/async/test_network.py               | 2 +-
 tests/sync/test_fetch_browser_context.py  | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 3243c809e..f18ac4f91 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -18,7 +18,7 @@ pytest-xdist==3.5.0
 requests==2.31.0
 service_identity==24.1.0
 setuptools==69.1.1
-twisted==23.10.0
+twisted==24.3.0
 types-pyOpenSSL==24.0.0.20240228
 types-requests==2.31.0.20240218
 wheel==0.41.2
diff --git a/tests/async/test_fetch_browser_context.py b/tests/async/test_fetch_browser_context.py
index 2c515697b..695b140b7 100644
--- a/tests/async/test_fetch_browser_context.py
+++ b/tests/async/test_fetch_browser_context.py
@@ -55,7 +55,7 @@ async def test_fetch_should_work(context: BrowserContext, server: Server) -> Non
 async def test_should_throw_on_network_error(
     context: BrowserContext, server: Server
 ) -> None:
-    server.set_route("/test", lambda request: request.transport.loseConnection())
+    server.set_route("/test", lambda request: request.loseConnection())
     with pytest.raises(Error, match="socket hang up"):
         await context.request.fetch(server.PREFIX + "/test")
 
diff --git a/tests/async/test_har.py b/tests/async/test_har.py
index d039273cc..b7875ea35 100644
--- a/tests/async/test_har.py
+++ b/tests/async/test_har.py
@@ -760,7 +760,7 @@ async def test_should_ignore_aborted_requests(
     tmpdir: Path,
 ) -> None:
     path = tmpdir / "test.har"
-    server.set_route("/x", lambda request: request.transport.loseConnection())
+    server.set_route("/x", lambda request: request.loseConnection())
     context1 = await context_factory()
     await context1.route_from_har(har=path, update=True)
     page1 = await context1.new_page()
diff --git a/tests/async/test_network.py b/tests/async/test_network.py
index 486a98914..458a0a118 100644
--- a/tests/async/test_network.py
+++ b/tests/async/test_network.py
@@ -633,7 +633,7 @@ async def test_network_events_request_failed(
 ) -> None:
     def handle_request(request: TestServerRequest) -> None:
         request.setHeader("Content-Type", "text/css")
-        request.transport.loseConnection()
+        request.loseConnection()
 
     server.set_route("/one-style.css", handle_request)
 
diff --git a/tests/sync/test_fetch_browser_context.py b/tests/sync/test_fetch_browser_context.py
index 5a8b38769..dd10d5adf 100644
--- a/tests/sync/test_fetch_browser_context.py
+++ b/tests/sync/test_fetch_browser_context.py
@@ -52,7 +52,7 @@ def test_fetch_should_work(context: BrowserContext, server: Server) -> None:
 
 
 def test_should_throw_on_network_error(context: BrowserContext, server: Server) -> None:
-    server.set_route("/test", lambda request: request.transport.loseConnection())
+    server.set_route("/test", lambda request: request.loseConnection())
     with pytest.raises(Error, match="socket hang up"):
         context.request.fetch(server.PREFIX + "/test")
 

From f6071eee4b0c7d7fa23f402e88038ea77314e2c9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 5 Mar 2024 17:30:11 +0100
Subject: [PATCH 171/438] build(deps): bump wheel from 0.41.2 to 0.42.0 (#2324)

---
 local-requirements.txt | 2 +-
 pyproject.toml         | 2 +-
 setup.py               | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index f18ac4f91..d3dc249e3 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -21,4 +21,4 @@ setuptools==69.1.1
 twisted==24.3.0
 types-pyOpenSSL==24.0.0.20240228
 types-requests==2.31.0.20240218
-wheel==0.41.2
+wheel==0.42.0
diff --git a/pyproject.toml b/pyproject.toml
index e87689aa0..2f6801904 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==68.2.2", "setuptools-scm==8.0.4", "wheel==0.41.2", "auditwheel==5.4.0"]
+requires = ["setuptools==68.2.2", "setuptools-scm==8.0.4", "wheel==0.42.0", "auditwheel==5.4.0"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools_scm]
diff --git a/setup.py b/setup.py
index c190f3794..982dd9c3a 100644
--- a/setup.py
+++ b/setup.py
@@ -222,7 +222,7 @@ def _download_and_extract_local_driver(
         "pyee==11.0.1",
     ],
     # TODO: Can be removed once we migrate to pypa/build or pypa/installer.
-    setup_requires=["setuptools-scm==8.0.4", "wheel==0.41.2"],
+    setup_requires=["setuptools-scm==8.0.4", "wheel==0.42.0"],
     classifiers=[
         "Topic :: Software Development :: Testing",
         "Topic :: Internet :: WWW/HTTP :: Browsers",

From 58551ad95d815755cb33173392c339261838f9fc Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 5 Mar 2024 19:39:29 +0100
Subject: [PATCH 172/438] chore(roll): roll Playwright to v1.42.1 (#2340)

---
 README.md                          |  4 +--
 playwright/async_api/_generated.py | 46 ++++++++++++++++--------------
 playwright/sync_api/_generated.py  | 46 ++++++++++++++++--------------
 setup.py                           |  2 +-
 4 files changed, 51 insertions(+), 47 deletions(-)

diff --git a/README.md b/README.md
index be1ab9fb8..611573b16 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 -->122.0.6261.39<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->123.0.6312.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->122.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->123.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index e484baa09..3e266ccf0 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -11669,35 +11669,37 @@ async def add_locator_handler(
     ) -> None:
         """Page.add_locator_handler
 
-        Sometimes, the web page can show an overlay that obstructs elements behind it and prevents certain actions, like
-        click, from completing. When such an overlay is shown predictably, we recommend dismissing it as a part of your
-        test flow. However, sometimes such an overlay may appear non-deterministically, for example certain cookies consent
-        dialogs behave this way. In this case, `page.add_locator_handler()` allows handling an overlay during an
-        action that it would block.
-
-        This method registers a handler for an overlay that is executed once the locator is visible on the page. The
-        handler should get rid of the overlay so that actions blocked by it can proceed. This is useful for
-        nondeterministic interstitial pages or dialogs, like a cookie consent dialog.
-
-        Note that execution time of the handler counts towards the timeout of the action/assertion that executed the
-        handler.
-
-        You can register multiple handlers. However, only a single handler will be running at a time. Any actions inside a
-        handler must not require another handler to run.
-
-        **NOTE** Running the interceptor will alter your page state mid-test. For example it will change the currently
-        focused element and move the mouse. Make sure that the actions that run after the interceptor are self-contained
-        and do not rely on the focus and mouse state. <br /> <br /> For example, consider a test that calls
+        When testing a web page, sometimes unexpected overlays like a coookie consent dialog appear and block actions you
+        want to automate, e.g. clicking a button. These overlays don't always show up in the same way or at the same time,
+        making them tricky to handle in automated tests.
+
+        This method lets you set up a special function, called a handler, that activates when it detects that overlay is
+        visible. The handler's job is to remove the overlay, allowing your test to continue as if the overlay wasn't there.
+
+        Things to keep in mind:
+        - When an overlay is shown predictably, we recommend explicitly waiting for it in your test and dismissing it as
+          a part of your normal test flow, instead of using `page.add_locator_handler()`.
+        - Playwright checks for the overlay every time before executing or retrying an action that requires an
+          [actionability check](https://playwright.dev/python/docs/actionability), or before performing an auto-waiting assertion check. When overlay
+          is visible, Playwright calls the handler first, and then proceeds with the action/assertion.
+        - The execution time of the handler counts towards the timeout of the action/assertion that executed the handler.
+          If your handler takes too long, it might cause timeouts.
+        - You can register multiple handlers. However, only a single handler will be running at a time. Make sure the
+          actions within a handler don't depend on another handler.
+
+        **NOTE** Running the handler will alter your page state mid-test. For example it will change the currently focused
+        element and move the mouse. Make sure that actions that run after the handler are self-contained and do not rely on
+        the focus and mouse state being unchanged. <br /> <br /> For example, consider a test that calls
         `locator.focus()` followed by `keyboard.press()`. If your handler clicks a button between these two
         actions, the focused element most likely will be wrong, and key press will happen on the unexpected element. Use
         `locator.press()` instead to avoid this problem. <br /> <br /> Another example is a series of mouse
         actions, where `mouse.move()` is followed by `mouse.down()`. Again, when the handler runs between
-        these two actions, the mouse position will be wrong during the mouse down. Prefer methods like
-        `locator.click()` that are self-contained.
+        these two actions, the mouse position will be wrong during the mouse down. Prefer self-contained actions like
+        `locator.click()` that do not rely on the state being unchanged by a handler.
 
         **Usage**
 
-        An example that closes a cookie dialog when it appears:
+        An example that closes a cookie consent dialog when it appears:
 
         ```py
         # Setup the handler.
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index a861367be..d6ecf78ad 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -11752,35 +11752,37 @@ def set_checked(
     def add_locator_handler(self, locator: "Locator", handler: typing.Callable) -> None:
         """Page.add_locator_handler
 
-        Sometimes, the web page can show an overlay that obstructs elements behind it and prevents certain actions, like
-        click, from completing. When such an overlay is shown predictably, we recommend dismissing it as a part of your
-        test flow. However, sometimes such an overlay may appear non-deterministically, for example certain cookies consent
-        dialogs behave this way. In this case, `page.add_locator_handler()` allows handling an overlay during an
-        action that it would block.
-
-        This method registers a handler for an overlay that is executed once the locator is visible on the page. The
-        handler should get rid of the overlay so that actions blocked by it can proceed. This is useful for
-        nondeterministic interstitial pages or dialogs, like a cookie consent dialog.
-
-        Note that execution time of the handler counts towards the timeout of the action/assertion that executed the
-        handler.
-
-        You can register multiple handlers. However, only a single handler will be running at a time. Any actions inside a
-        handler must not require another handler to run.
-
-        **NOTE** Running the interceptor will alter your page state mid-test. For example it will change the currently
-        focused element and move the mouse. Make sure that the actions that run after the interceptor are self-contained
-        and do not rely on the focus and mouse state. <br /> <br /> For example, consider a test that calls
+        When testing a web page, sometimes unexpected overlays like a coookie consent dialog appear and block actions you
+        want to automate, e.g. clicking a button. These overlays don't always show up in the same way or at the same time,
+        making them tricky to handle in automated tests.
+
+        This method lets you set up a special function, called a handler, that activates when it detects that overlay is
+        visible. The handler's job is to remove the overlay, allowing your test to continue as if the overlay wasn't there.
+
+        Things to keep in mind:
+        - When an overlay is shown predictably, we recommend explicitly waiting for it in your test and dismissing it as
+          a part of your normal test flow, instead of using `page.add_locator_handler()`.
+        - Playwright checks for the overlay every time before executing or retrying an action that requires an
+          [actionability check](https://playwright.dev/python/docs/actionability), or before performing an auto-waiting assertion check. When overlay
+          is visible, Playwright calls the handler first, and then proceeds with the action/assertion.
+        - The execution time of the handler counts towards the timeout of the action/assertion that executed the handler.
+          If your handler takes too long, it might cause timeouts.
+        - You can register multiple handlers. However, only a single handler will be running at a time. Make sure the
+          actions within a handler don't depend on another handler.
+
+        **NOTE** Running the handler will alter your page state mid-test. For example it will change the currently focused
+        element and move the mouse. Make sure that actions that run after the handler are self-contained and do not rely on
+        the focus and mouse state being unchanged. <br /> <br /> For example, consider a test that calls
         `locator.focus()` followed by `keyboard.press()`. If your handler clicks a button between these two
         actions, the focused element most likely will be wrong, and key press will happen on the unexpected element. Use
         `locator.press()` instead to avoid this problem. <br /> <br /> Another example is a series of mouse
         actions, where `mouse.move()` is followed by `mouse.down()`. Again, when the handler runs between
-        these two actions, the mouse position will be wrong during the mouse down. Prefer methods like
-        `locator.click()` that are self-contained.
+        these two actions, the mouse position will be wrong during the mouse down. Prefer self-contained actions like
+        `locator.click()` that do not rely on the state being unchanged by a handler.
 
         **Usage**
 
-        An example that closes a cookie dialog when it appears:
+        An example that closes a cookie consent dialog when it appears:
 
         ```py
         # Setup the handler.
diff --git a/setup.py b/setup.py
index 982dd9c3a..3cb4f3dc8 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.42.0-alpha-2024-02-19"
+driver_version = "1.42.1"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 2ab641af55113ad36c318deff459a7a9ac4d88ae Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 5 Mar 2024 20:52:24 +0100
Subject: [PATCH 173/438] Revert "test: fix deprecated datetime serialisation
 (follow-up to #2314)"

This reverts commit 51bab3928c2ef74cf297307c2382bbf89d69c689.
---
 tests/async/test_assertions.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index b8936f4bf..774d60de5 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -13,8 +13,8 @@
 # limitations under the License.
 
 import asyncio
-import datetime
 import re
+from datetime import datetime
 
 import pytest
 
@@ -183,11 +183,7 @@ async def test_assertions_locator_to_have_js_property(
     )
     await expect(page.locator("div")).to_have_js_property(
         "foo",
-        {
-            "a": 1,
-            "b": "string",
-            "c": datetime.datetime.fromtimestamp(1627503992000 / 1000),
-        },
+        {"a": 1, "b": "string", "c": datetime.utcfromtimestamp(1627503992000 / 1000)},
     )
 
 

From 665af8dbe9f188c1dd5d1913d16e4d709a0dd9cc Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 5 Mar 2024 20:52:34 +0100
Subject: [PATCH 174/438] Revert "fix: datetime serialisation (#2314)"

This reverts commit c4ffd453c124fb491bb6a2cdc9899ba448eb909d.
---
 playwright/_impl/_js_handle.py | 2 +-
 tests/sync/test_assertions.py  | 8 ++------
 2 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 01625ec3f..5a930f1e6 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -129,7 +129,7 @@ def serialize_value(
         if math.isnan(value):
             return dict(v="NaN")
     if isinstance(value, datetime):
-        return dict(d=value.isoformat())
+        return dict(d=value.isoformat() + "Z")
     if isinstance(value, bool):
         return {"b": value}
     if isinstance(value, (int, float)):
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index d7180fc94..f2df44ab5 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -12,8 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import datetime
 import re
+from datetime import datetime
 
 import pytest
 
@@ -163,11 +163,7 @@ def test_assertions_locator_to_have_js_property(page: Page, server: Server) -> N
     )
     expect(page.locator("div")).to_have_js_property(
         "foo",
-        {
-            "a": 1,
-            "b": "string",
-            "c": datetime.datetime.fromtimestamp(1627503992000 / 1000),
-        },
+        {"a": 1, "b": "string", "c": datetime.utcfromtimestamp(1627503992000 / 1000)},
     )
 
 

From 8d3a5ebffa9ea4e33d9d1cbf30e0c6d9dee655e9 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 7 Mar 2024 20:18:23 +0100
Subject: [PATCH 175/438] devops: mark Docker images as EOL (#2347)

---
 utils/docker/.gitignore        |  1 +
 utils/docker/publish_docker.sh | 21 +++++++++++++++++++++
 2 files changed, 22 insertions(+)
 create mode 100644 utils/docker/.gitignore

diff --git a/utils/docker/.gitignore b/utils/docker/.gitignore
new file mode 100644
index 000000000..8803f25de
--- /dev/null
+++ b/utils/docker/.gitignore
@@ -0,0 +1 @@
+oras/
diff --git a/utils/docker/publish_docker.sh b/utils/docker/publish_docker.sh
index d47df4c1d..2b4e73a53 100755
--- a/utils/docker/publish_docker.sh
+++ b/utils/docker/publish_docker.sh
@@ -51,6 +51,27 @@ tag_and_push() {
   echo "-- tagging: $target"
   docker tag $source $target
   docker push $target
+  attach_eol_manifest $target
+}
+
+attach_eol_manifest() {
+  local image="$1"
+  local today=$(date -u +'%Y-%m-%d')
+  install_oras_if_needed
+  # oras is re-using Docker credentials, so we don't need to login.
+  # Following the advice in https://portal.microsofticm.com/imp/v3/incidents/incident/476783820/summary
+  ./oras/oras attach --artifact-type application/vnd.microsoft.artifact.lifecycle --annotation "vnd.microsoft.artifact.lifecycle.end-of-life.date=$today" $image
+}
+
+install_oras_if_needed() {
+  if [[ -x oras/oras ]]; then
+    return
+  fi
+  local version="1.1.0"
+  curl -sLO "https://github.com/oras-project/oras/releases/download/v${version}/oras_${version}_linux_amd64.tar.gz"
+  mkdir -p oras
+  tar -zxf oras_${version}_linux_amd64.tar.gz -C oras
+  rm oras_${version}_linux_amd64.tar.gz
 }
 
 publish_docker_images_with_arch_suffix() {

From dd85f0d681ccda9b2d8c6825983729a9f6c8078c Mon Sep 17 00:00:00 2001
From: Liron Haroni <93920881+LironHaroni@users.noreply.github.com>
Date: Fri, 8 Mar 2024 01:01:44 +0200
Subject: [PATCH 176/438] fix: browser_context.route for service worker
 requests (#2345)

---
 playwright/_impl/_network.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index ecce43571..9d1337b01 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -262,7 +262,10 @@ def _target_closed_future(self) -> asyncio.Future:
         return page._closed_or_crashed_future
 
     def _safe_page(self) -> "Optional[Page]":
-        return cast("Frame", from_channel(self._initializer["frame"]))._page
+        frame = from_nullable_channel(self._initializer.get("frame"))
+        if not frame:
+            return None
+        return cast("Frame", frame)._page
 
 
 class Route(ChannelOwner):

From 115e0a167dddb71c5c96453beac67ac4d9338a1b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 11 Mar 2024 21:42:13 +0100
Subject: [PATCH 177/438] build(deps): bump types-pyopenssl from
 24.0.0.20240228 to 24.0.0.20240311 (#2353)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index d3dc249e3..6a19193b0 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,6 +19,6 @@ requests==2.31.0
 service_identity==24.1.0
 setuptools==69.1.1
 twisted==24.3.0
-types-pyOpenSSL==24.0.0.20240228
+types-pyOpenSSL==24.0.0.20240311
 types-requests==2.31.0.20240218
 wheel==0.42.0

From ee06a8cb6e3cc3bc3f409c485f40132909b0e520 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 11 Mar 2024 21:42:28 +0100
Subject: [PATCH 178/438] build(deps): bump pytest-timeout from 2.2.0 to 2.3.1
 (#2351)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 6a19193b0..527797b3a 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -13,7 +13,7 @@ pytest==8.0.0
 pytest-asyncio==0.21.1
 pytest-cov==4.1.0
 pytest-repeat==0.9.3
-pytest-timeout==2.2.0
+pytest-timeout==2.3.1
 pytest-xdist==3.5.0
 requests==2.31.0
 service_identity==24.1.0

From 31ba457485fa86b68be062ff8d8c1d7cc3812312 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 12 Mar 2024 14:28:32 +0100
Subject: [PATCH 179/438] build(deps): bump pyee from 11.0.1 to 11.1.0 (#2349)

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

diff --git a/setup.py b/setup.py
index 3cb4f3dc8..db21211fb 100644
--- a/setup.py
+++ b/setup.py
@@ -219,7 +219,7 @@ def _download_and_extract_local_driver(
     include_package_data=True,
     install_requires=[
         "greenlet==3.0.3",
-        "pyee==11.0.1",
+        "pyee==11.1.0",
     ],
     # TODO: Can be removed once we migrate to pypa/build or pypa/installer.
     setup_requires=["setuptools-scm==8.0.4", "wheel==0.42.0"],

From cdc0ad12765ef3aa4bb6b2fb5c34d1b7ec82501f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 12 Mar 2024 14:28:41 +0100
Subject: [PATCH 180/438] build(deps): bump types-requests from 2.31.0.20240218
 to 2.31.0.20240311 (#2352)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 527797b3a..900594805 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -20,5 +20,5 @@ service_identity==24.1.0
 setuptools==69.1.1
 twisted==24.3.0
 types-pyOpenSSL==24.0.0.20240311
-types-requests==2.31.0.20240218
+types-requests==2.31.0.20240311
 wheel==0.42.0

From 1a685082f9144ddcb82a19f5eabe1e846a63324a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 12 Mar 2024 16:29:48 +0100
Subject: [PATCH 181/438] build(deps): bump pytest from 8.0.0 to 8.1.1 (#2350)

---
 local-requirements.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 900594805..e8196db26 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -2,14 +2,14 @@ auditwheel==6.0.0
 autobahn==23.1.2
 black==24.2.0
 flake8==7.0.0
-flaky==3.7.0
+flaky==3.8.0
 mypy==1.8.0
 objgraph==3.6.1
 Pillow==10.2.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==24.0.0
-pytest==8.0.0
+pytest==8.1.1
 pytest-asyncio==0.21.1
 pytest-cov==4.1.0
 pytest-repeat==0.9.3

From 812f8f9430eb5322727dc80ce5eebed168480e3d Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 12 Mar 2024 17:20:07 +0100
Subject: [PATCH 182/438] fix: datetime parsing with non-UTC timezones (#2322)

---
 playwright/_impl/_js_handle.py | 16 ++++++++++++----
 tests/async/test_assertions.py |  8 ++++++--
 tests/async/test_evaluate.py   | 27 ++++++++++++++++++++++++---
 tests/async/test_jshandle.py   |  6 ++++--
 tests/sync/test_assertions.py  |  8 ++++++--
 5 files changed, 52 insertions(+), 13 deletions(-)

diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 5a930f1e6..4db0e2635 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -13,8 +13,8 @@
 # limitations under the License.
 
 import collections.abc
+import datetime
 import math
-from datetime import datetime
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union
 from urllib.parse import ParseResult, urlparse, urlunparse
@@ -128,8 +128,13 @@ def serialize_value(
             return dict(v="-0")
         if math.isnan(value):
             return dict(v="NaN")
-    if isinstance(value, datetime):
-        return dict(d=value.isoformat() + "Z")
+    if isinstance(value, datetime.datetime):
+        # Node.js Date objects are always in UTC.
+        return {
+            "d": datetime.datetime.strftime(
+                value.astimezone(datetime.timezone.utc), "%Y-%m-%dT%H:%M:%S.%fZ"
+            )
+        }
     if isinstance(value, bool):
         return {"b": value}
     if isinstance(value, (int, float)):
@@ -205,7 +210,10 @@ def parse_value(value: Any, refs: Optional[Dict[int, Any]] = None) -> Any:
             return a
 
         if "d" in value:
-            return datetime.fromisoformat(value["d"][:-1])
+            # Node.js Date objects are always in UTC.
+            return datetime.datetime.strptime(
+                value["d"], "%Y-%m-%dT%H:%M:%S.%fZ"
+            ).replace(tzinfo=datetime.timezone.utc)
 
         if "o" in value:
             o: Dict = {}
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 774d60de5..b8936f4bf 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -13,8 +13,8 @@
 # limitations under the License.
 
 import asyncio
+import datetime
 import re
-from datetime import datetime
 
 import pytest
 
@@ -183,7 +183,11 @@ async def test_assertions_locator_to_have_js_property(
     )
     await expect(page.locator("div")).to_have_js_property(
         "foo",
-        {"a": 1, "b": "string", "c": datetime.utcfromtimestamp(1627503992000 / 1000)},
+        {
+            "a": 1,
+            "b": "string",
+            "c": datetime.datetime.fromtimestamp(1627503992000 / 1000),
+        },
     )
 
 
diff --git a/tests/async/test_evaluate.py b/tests/async/test_evaluate.py
index cafeac61d..0b2143769 100644
--- a/tests/async/test_evaluate.py
+++ b/tests/async/test_evaluate.py
@@ -13,7 +13,7 @@
 # limitations under the License.
 
 import math
-from datetime import datetime
+from datetime import datetime, timedelta, timezone
 from typing import Optional
 from urllib.parse import ParseResult, urlparse
 
@@ -216,17 +216,38 @@ async def test_evaluate_evaluate_date(page: Page) -> None:
     result = await page.evaluate(
         '() => ({ date: new Date("2020-05-27T01:31:38.506Z") })'
     )
-    assert result == {"date": datetime.fromisoformat("2020-05-27T01:31:38.506")}
+    assert result == {
+        "date": datetime.fromisoformat("2020-05-27T01:31:38.506").replace(
+            tzinfo=timezone.utc
+        )
+    }
+
+
+async def test_evaluate_roundtrip_date_without_tzinfo(page: Page) -> None:
+    date = datetime.fromisoformat("2020-05-27T01:31:38.506")
+    result = await page.evaluate("date => date", date)
+    assert result.timestamp() == date.timestamp()
 
 
 async def test_evaluate_roundtrip_date(page: Page) -> None:
+    date = datetime.fromisoformat("2020-05-27T01:31:38.506").replace(
+        tzinfo=timezone.utc
+    )
+    result = await page.evaluate("date => date", date)
+    assert result == date
+
+
+async def test_evaluate_roundtrip_date_with_tzinfo(page: Page) -> None:
     date = datetime.fromisoformat("2020-05-27T01:31:38.506")
+    date = date.astimezone(timezone(timedelta(hours=4)))
     result = await page.evaluate("date => date", date)
     assert result == date
 
 
 async def test_evaluate_jsonvalue_date(page: Page) -> None:
-    date = datetime.fromisoformat("2020-05-27T01:31:38.506")
+    date = datetime.fromisoformat("2020-05-27T01:31:38.506").replace(
+        tzinfo=timezone.utc
+    )
     result = await page.evaluate(
         '() => ({ date: new Date("2020-05-27T01:31:38.506Z") })'
     )
diff --git a/tests/async/test_jshandle.py b/tests/async/test_jshandle.py
index f4136e92c..f18cbd633 100644
--- a/tests/async/test_jshandle.py
+++ b/tests/async/test_jshandle.py
@@ -14,7 +14,7 @@
 
 import json
 import math
-from datetime import datetime
+from datetime import datetime, timezone
 from typing import Any, Dict
 
 from playwright.async_api import Page
@@ -180,7 +180,9 @@ async def test_jshandle_json_value_work(page: Page) -> None:
 async def test_jshandle_json_value_work_with_dates(page: Page) -> None:
     handle = await page.evaluate_handle('() => new Date("2020-05-27T01:31:38.506Z")')
     json = await handle.json_value()
-    assert json == datetime.fromisoformat("2020-05-27T01:31:38.506")
+    assert json == datetime.fromisoformat("2020-05-27T01:31:38.506").replace(
+        tzinfo=timezone.utc
+    )
 
 
 async def test_jshandle_json_value_should_work_for_circular_object(page: Page) -> None:
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index f2df44ab5..d7180fc94 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -12,8 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import datetime
 import re
-from datetime import datetime
 
 import pytest
 
@@ -163,7 +163,11 @@ def test_assertions_locator_to_have_js_property(page: Page, server: Server) -> N
     )
     expect(page.locator("div")).to_have_js_property(
         "foo",
-        {"a": 1, "b": "string", "c": datetime.utcfromtimestamp(1627503992000 / 1000)},
+        {
+            "a": 1,
+            "b": "string",
+            "c": datetime.datetime.fromtimestamp(1627503992000 / 1000),
+        },
     )
 
 

From 31d116b19a88d017230f52f2339871f8ebfe8558 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Mar 2024 22:25:46 +0100
Subject: [PATCH 183/438] build(deps): bump pyopenssl from 24.0.0 to 24.1.0
 (#2358)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index e8196db26..2b82fe97b 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -8,7 +8,7 @@ objgraph==3.6.1
 Pillow==10.2.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
-pyOpenSSL==24.0.0
+pyOpenSSL==24.1.0
 pytest==8.1.1
 pytest-asyncio==0.21.1
 pytest-cov==4.1.0

From 8ddf89c7fc14b888d79de9490d380f661a366a32 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Mar 2024 22:25:53 +0100
Subject: [PATCH 184/438] build(deps): bump black from 24.2.0 to 24.3.0 (#2360)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 2b82fe97b..26b228d7a 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,6 +1,6 @@
 auditwheel==6.0.0
 autobahn==23.1.2
-black==24.2.0
+black==24.3.0
 flake8==7.0.0
 flaky==3.8.0
 mypy==1.8.0

From 88a82b436b384a6f76317330820e888881a58f67 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Mar 2024 22:26:00 +0100
Subject: [PATCH 185/438] build(deps): bump mypy from 1.8.0 to 1.9.0 (#2362)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 26b228d7a..5446be6c3 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ autobahn==23.1.2
 black==24.3.0
 flake8==7.0.0
 flaky==3.8.0
-mypy==1.8.0
+mypy==1.9.0
 objgraph==3.6.1
 Pillow==10.2.0
 pixelmatch==0.3.0

From 09f529a3d12c4d854f38ab16b5c7e44d0456050f Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 20 Mar 2024 18:49:50 +0100
Subject: [PATCH 186/438] fix: get rid of driver wrapper (#2367)

---
 playwright/__main__.py                   |  4 ++--
 playwright/_impl/_driver.py              | 13 +++++++------
 playwright/_impl/_transport.py           | 12 +++++-------
 playwright/async_api/_context_manager.py |  3 +--
 playwright/sync_api/_context_manager.py  |  3 +--
 5 files changed, 16 insertions(+), 19 deletions(-)

diff --git a/playwright/__main__.py b/playwright/__main__.py
index e012cc449..a5dfdad40 100644
--- a/playwright/__main__.py
+++ b/playwright/__main__.py
@@ -19,9 +19,9 @@
 
 
 def main() -> None:
-    driver_executable = compute_driver_executable()
+    driver_executable, driver_cli = compute_driver_executable()
     completed_process = subprocess.run(
-        [str(driver_executable), *sys.argv[1:]], env=get_driver_env()
+        [driver_executable, driver_cli, *sys.argv[1:]], env=get_driver_env()
     )
     sys.exit(completed_process.returncode)
 
diff --git a/playwright/_impl/_driver.py b/playwright/_impl/_driver.py
index d8004d296..9e8cdc1e7 100644
--- a/playwright/_impl/_driver.py
+++ b/playwright/_impl/_driver.py
@@ -16,17 +16,18 @@
 import os
 import sys
 from pathlib import Path
+from typing import Tuple
 
 import playwright
 from playwright._repo_version import version
 
 
-def compute_driver_executable() -> Path:
-    package_path = Path(inspect.getfile(playwright)).parent
-    platform = sys.platform
-    if platform == "win32":
-        return package_path / "driver" / "playwright.cmd"
-    return package_path / "driver" / "playwright.sh"
+def compute_driver_executable() -> Tuple[str, str]:
+    driver_path = Path(inspect.getfile(playwright)).parent / "driver"
+    cli_path = str(driver_path / "package" / "cli.js")
+    if sys.platform == "win32":
+        return (str(driver_path / "node.exe"), cli_path)
+    return (os.getenv("PLAYWRIGHT_NODEJS_PATH", str(driver_path / "node")), cli_path)
 
 
 def get_driver_env() -> dict:
diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index d49b5a2d5..f07d31dcd 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -19,10 +19,9 @@
 import subprocess
 import sys
 from abc import ABC, abstractmethod
-from pathlib import Path
 from typing import Callable, Dict, Optional, Union
 
-from playwright._impl._driver import get_driver_env
+from playwright._impl._driver import compute_driver_executable, get_driver_env
 from playwright._impl._helper import ParsedMessagePayload
 
 
@@ -90,12 +89,9 @@ def deserialize_message(self, data: Union[str, bytes]) -> ParsedMessagePayload:
 
 
 class PipeTransport(Transport):
-    def __init__(
-        self, loop: asyncio.AbstractEventLoop, driver_executable: Path
-    ) -> None:
+    def __init__(self, loop: asyncio.AbstractEventLoop) -> None:
         super().__init__(loop)
         self._stopped = False
-        self._driver_executable = driver_executable
 
     def request_stop(self) -> None:
         assert self._output
@@ -120,8 +116,10 @@ async def connect(self) -> None:
                 startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
                 startupinfo.wShowWindow = subprocess.SW_HIDE
 
+            executable_path, entrypoint_path = compute_driver_executable()
             self._proc = await asyncio.create_subprocess_exec(
-                str(self._driver_executable),
+                executable_path,
+                entrypoint_path,
                 "run-driver",
                 stdin=asyncio.subprocess.PIPE,
                 stdout=asyncio.subprocess.PIPE,
diff --git a/playwright/async_api/_context_manager.py b/playwright/async_api/_context_manager.py
index 2876d85e5..0c93f7043 100644
--- a/playwright/async_api/_context_manager.py
+++ b/playwright/async_api/_context_manager.py
@@ -16,7 +16,6 @@
 from typing import Any
 
 from playwright._impl._connection import Connection
-from playwright._impl._driver import compute_driver_executable
 from playwright._impl._object_factory import create_remote_object
 from playwright._impl._transport import PipeTransport
 from playwright.async_api._generated import Playwright as AsyncPlaywright
@@ -32,7 +31,7 @@ async def __aenter__(self) -> AsyncPlaywright:
         self._connection = Connection(
             None,
             create_remote_object,
-            PipeTransport(loop, compute_driver_executable()),
+            PipeTransport(loop),
             loop,
         )
         loop.create_task(self._connection.run())
diff --git a/playwright/sync_api/_context_manager.py b/playwright/sync_api/_context_manager.py
index c27a25e32..feb648ca0 100644
--- a/playwright/sync_api/_context_manager.py
+++ b/playwright/sync_api/_context_manager.py
@@ -18,7 +18,6 @@
 from greenlet import greenlet
 
 from playwright._impl._connection import ChannelOwner, Connection
-from playwright._impl._driver import compute_driver_executable
 from playwright._impl._errors import Error
 from playwright._impl._greenlets import MainGreenlet
 from playwright._impl._object_factory import create_remote_object
@@ -61,7 +60,7 @@ def greenlet_main() -> None:
         self._connection = Connection(
             dispatcher_fiber,
             create_remote_object,
-            PipeTransport(self._loop, compute_driver_executable()),
+            PipeTransport(self._loop),
             self._loop,
         )
 

From 5a4779e35b6535eb559e60ee3176e6d88a64bc90 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 22 Mar 2024 19:25:00 +0100
Subject: [PATCH 187/438] fix: inherit expect context managers from contextlib
 (#2370)

---
 playwright/_impl/_async_base.py | 11 ++++++-----
 playwright/_impl/_sync_base.py  | 10 ++++++----
 2 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/playwright/_impl/_async_base.py b/playwright/_impl/_async_base.py
index e497232d8..e9544b733 100644
--- a/playwright/_impl/_async_base.py
+++ b/playwright/_impl/_async_base.py
@@ -13,8 +13,9 @@
 # limitations under the License.
 
 import asyncio
+from contextlib import AbstractAsyncContextManager
 from types import TracebackType
-from typing import Any, Callable, Generic, Type, TypeVar
+from typing import Any, Callable, Generic, Optional, Type, TypeVar
 
 from playwright._impl._impl_to_api_mapping import ImplToApiMapping, ImplWrapper
 
@@ -40,7 +41,7 @@ def is_done(self) -> bool:
         return self._future.done()
 
 
-class AsyncEventContextManager(Generic[T]):
+class AsyncEventContextManager(Generic[T], AbstractAsyncContextManager):
     def __init__(self, future: "asyncio.Future[T]") -> None:
         self._event = AsyncEventInfo[T](future)
 
@@ -49,9 +50,9 @@ async def __aenter__(self) -> AsyncEventInfo[T]:
 
     async def __aexit__(
         self,
-        exc_type: Type[BaseException],
-        exc_val: BaseException,
-        exc_tb: TracebackType,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
     ) -> None:
         if exc_val:
             self._event._cancel()
diff --git a/playwright/_impl/_sync_base.py b/playwright/_impl/_sync_base.py
index 50a2c647e..f07b947b2 100644
--- a/playwright/_impl/_sync_base.py
+++ b/playwright/_impl/_sync_base.py
@@ -15,6 +15,7 @@
 import asyncio
 import inspect
 import traceback
+from contextlib import AbstractContextManager
 from types import TracebackType
 from typing import (
     Any,
@@ -22,6 +23,7 @@
     Coroutine,
     Generator,
     Generic,
+    Optional,
     Type,
     TypeVar,
     Union,
@@ -64,7 +66,7 @@ def is_done(self) -> bool:
         return self._future.done()
 
 
-class EventContextManager(Generic[T]):
+class EventContextManager(Generic[T], AbstractContextManager):
     def __init__(self, sync_base: "SyncBase", future: "asyncio.Future[T]") -> None:
         self._event = EventInfo[T](sync_base, future)
 
@@ -73,9 +75,9 @@ def __enter__(self) -> EventInfo[T]:
 
     def __exit__(
         self,
-        exc_type: Type[BaseException],
-        exc_val: BaseException,
-        exc_tb: TracebackType,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        exc_tb: Optional[TracebackType],
     ) -> None:
         if exc_val:
             self._event._cancel()

From 4783148b5c331c81c978c238587e3d376e5d76b5 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 22 Mar 2024 19:42:24 +0100
Subject: [PATCH 188/438] fix: brush up exception messages to include apiName &
 call log (#2371)

---
 playwright/_impl/_connection.py    | 19 +++++++++++++------
 playwright/_impl/_errors.py        |  8 ++++++++
 playwright/_impl/_helper.py        | 12 +++++-------
 tests/async/test_browsercontext.py |  4 ++--
 tests/async/test_frames.py         |  2 +-
 tests/async/test_keyboard.py       |  6 +++---
 tests/async/test_locators.py       | 17 +++++++++++++++++
 tests/async/test_network.py        |  5 ++++-
 tests/async/test_queryselector.py  | 11 ++++++++---
 tests/sync/test_locators.py        | 17 +++++++++++++++++
 tests/sync/test_queryselector.py   | 11 ++++++++---
 11 files changed, 86 insertions(+), 26 deletions(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index ba6a8ba9f..937ab3f8b 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -37,7 +37,7 @@
 from pyee.asyncio import AsyncIOEventEmitter
 
 import playwright
-from playwright._impl._errors import TargetClosedError
+from playwright._impl._errors import TargetClosedError, rewrite_error
 from playwright._impl._greenlets import EventGreenlet
 from playwright._impl._helper import Error, ParsedMessagePayload, parse_error
 from playwright._impl._transport import Transport
@@ -374,11 +374,12 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
                 return
             error = msg.get("error")
             if error and not msg.get("result"):
-                parsed_error = parse_error(error["error"])  # type: ignore
+                parsed_error = parse_error(
+                    error["error"], format_call_log(msg.get("log"))  # type: ignore
+                )
                 parsed_error._stack = "".join(
                     traceback.format_list(callback.stack_trace)[-10:]
                 )
-                parsed_error._message += format_call_log(msg.get("log"))  # type: ignore
                 callback.future.set_exception(parsed_error)
             else:
                 result = self._replace_guids_with_channels(msg.get("result"))
@@ -504,9 +505,12 @@ async def wrap_api_call(
             return await cb()
         task = asyncio.current_task(self._loop)
         st: List[inspect.FrameInfo] = getattr(task, "__pw_stack__", inspect.stack())
-        self._api_zone.set(_extract_stack_trace_information_from_stack(st, is_internal))
+        parsed_st = _extract_stack_trace_information_from_stack(st, is_internal)
+        self._api_zone.set(parsed_st)
         try:
             return await cb()
+        except Exception as error:
+            raise rewrite_error(error, f"{parsed_st['apiName']}: {error}") from None
         finally:
             self._api_zone.set(None)
 
@@ -517,9 +521,12 @@ def wrap_api_call_sync(
             return cb()
         task = asyncio.current_task(self._loop)
         st: List[inspect.FrameInfo] = getattr(task, "__pw_stack__", inspect.stack())
-        self._api_zone.set(_extract_stack_trace_information_from_stack(st, is_internal))
+        parsed_st = _extract_stack_trace_information_from_stack(st, is_internal)
+        self._api_zone.set(parsed_st)
         try:
             return cb()
+        except Exception as error:
+            raise rewrite_error(error, f"{parsed_st['apiName']}: {error}") from None
         finally:
             self._api_zone.set(None)
 
@@ -546,7 +553,7 @@ class ParsedStackTrace(TypedDict):
 
 def _extract_stack_trace_information_from_stack(
     st: List[inspect.FrameInfo], is_internal: bool
-) -> Optional[ParsedStackTrace]:
+) -> ParsedStackTrace:
     playwright_module_path = str(Path(playwright.__file__).parents[0])
     last_internal_api_name = ""
     api_name = ""
diff --git a/playwright/_impl/_errors.py b/playwright/_impl/_errors.py
index 9bd6ab901..c47d918ef 100644
--- a/playwright/_impl/_errors.py
+++ b/playwright/_impl/_errors.py
@@ -50,3 +50,11 @@ class TimeoutError(Error):
 class TargetClosedError(Error):
     def __init__(self, message: str = None) -> None:
         super().__init__(message or "Target page, context or browser has been closed")
+
+
+def rewrite_error(error: Exception, message: str) -> Exception:
+    rewritten_exc = type(error)(message)
+    if isinstance(rewritten_exc, Error) and isinstance(error, Error):
+        rewritten_exc._name = error.name
+        rewritten_exc._stack = error.stack
+    return rewritten_exc
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 20ab885f8..0e6b91cd2 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -210,26 +210,24 @@ def serialize_error(ex: Exception, tb: Optional[TracebackType]) -> ErrorPayload:
     )
 
 
-def parse_error(error: ErrorPayload) -> Error:
+def parse_error(error: ErrorPayload, log: Optional[str] = None) -> Error:
     base_error_class = Error
     if error.get("name") == "TimeoutError":
         base_error_class = TimeoutError
     if error.get("name") == "TargetClosedError":
         base_error_class = TargetClosedError
-    exc = base_error_class(cast(str, patch_error_message(error.get("message"))))
+    if not log:
+        log = ""
+    exc = base_error_class(patch_error_message(error["message"]) + log)
     exc._name = error["name"]
     exc._stack = error["stack"]
     return exc
 
 
-def patch_error_message(message: Optional[str]) -> Optional[str]:
-    if message is None:
-        return None
-
+def patch_error_message(message: str) -> str:
     match = re.match(r"(\w+)(: expected .*)", message)
     if match:
         message = to_snake_case(match.group(1)) + match.group(2)
-    assert message is not None
     message = message.replace(
         "Pass { acceptDownloads: true }", "Pass { accept_downloads: True }"
     )
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index 97c365273..877524b92 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -126,7 +126,7 @@ async def test_page_event_should_not_allow_device_scale_factor_with_null_viewpor
         await browser.new_context(no_viewport=True, device_scale_factor=1)
     assert (
         exc_info.value.message
-        == '"deviceScaleFactor" option is not supported with null "viewport"'
+        == 'Browser.new_context: "deviceScaleFactor" option is not supported with null "viewport"'
     )
 
 
@@ -137,7 +137,7 @@ async def test_page_event_should_not_allow_is_mobile_with_null_viewport(
         await browser.new_context(no_viewport=True, is_mobile=True)
     assert (
         exc_info.value.message
-        == '"isMobile" option is not supported with null "viewport"'
+        == 'Browser.new_context: "isMobile" option is not supported with null "viewport"'
     )
 
 
diff --git a/tests/async/test_frames.py b/tests/async/test_frames.py
index 73c363f23..e1d71a8e7 100644
--- a/tests/async/test_frames.py
+++ b/tests/async/test_frames.py
@@ -71,7 +71,7 @@ async def test_frame_element_throw_when_detached(
     except Error as e:
         error = e
     assert error
-    assert error.message == "Frame has been detached."
+    assert error.message == "Frame.frame_element: Frame has been detached."
 
 
 async def test_evaluate_throw_for_detached_frames(
diff --git a/tests/async/test_keyboard.py b/tests/async/test_keyboard.py
index 9f8db104e..3a449ffe7 100644
--- a/tests/async/test_keyboard.py
+++ b/tests/async/test_keyboard.py
@@ -424,15 +424,15 @@ async def testEnterKey(key: str, expectedKey: str, expectedCode: str) -> None:
 async def test_should_throw_unknown_keys(page: Page, server: Server) -> None:
     with pytest.raises(Error) as exc:
         await page.keyboard.press("NotARealKey")
-    assert exc.value.message == 'Unknown key: "NotARealKey"'
+    assert exc.value.message == 'Keyboard.press: Unknown key: "NotARealKey"'
 
     with pytest.raises(Error) as exc:
         await page.keyboard.press("ё")
-    assert exc.value.message == 'Unknown key: "ё"'
+    assert exc.value.message == 'Keyboard.press: Unknown key: "ё"'
 
     with pytest.raises(Error) as exc:
         await page.keyboard.press("😊")
-    assert exc.value.message == 'Unknown key: "😊"'
+    assert exc.value.message == 'Keyboard.press: Unknown key: "😊"'
 
 
 async def test_should_type_emoji(page: Page, server: Server) -> None:
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 1a423fd2a..e725f13b7 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -14,6 +14,7 @@
 
 import os
 import re
+import traceback
 from typing import Callable
 from urllib.parse import urlparse
 
@@ -1083,3 +1084,19 @@ async def test_locator_all_should_work(page: Page) -> None:
     for p in await page.locator("p").all():
         texts.append(await p.text_content())
     assert texts == ["A", "B", "C"]
+
+
+async def test_locator_click_timeout_error_should_contain_call_log(page: Page) -> None:
+    with pytest.raises(Error) as exc_info:
+        await page.get_by_role("button", name="Hello Python").click(timeout=42)
+    formatted_exception = "".join(
+        traceback.format_exception(type(exc_info.value), value=exc_info.value, tb=None)
+    )
+    assert "Locator.click: Timeout 42ms exceeded." in formatted_exception
+    assert (
+        'waiting for get_by_role("button", name="Hello Python")' in formatted_exception
+    )
+    assert (
+        "During handling of the above exception, another exception occurred"
+        not in formatted_exception
+    )
diff --git a/tests/async/test_network.py b/tests/async/test_network.py
index 458a0a118..b97d38f29 100644
--- a/tests/async/test_network.py
+++ b/tests/async/test_network.py
@@ -830,7 +830,10 @@ async def test_set_extra_http_headers_should_throw_for_non_string_header_values(
     except Error as exc:
         error = exc
     assert error
-    assert error.message == "headers[0].value: expected string, got number"
+    assert (
+        error.message
+        == "Page.set_extra_http_headers: headers[0].value: expected string, got number"
+    )
 
 
 async def test_response_server_addr(page: Page, server: Server) -> None:
diff --git a/tests/async/test_queryselector.py b/tests/async/test_queryselector.py
index 0a09a40c9..28dd720d7 100644
--- a/tests/async/test_queryselector.py
+++ b/tests/async/test_queryselector.py
@@ -182,7 +182,7 @@ async def test_selectors_register_should_handle_errors(
         await selectors.register("$", dummy_selector_engine_script)
     assert (
         exc.value.message
-        == "Selector engine name may only contain [a-zA-Z0-9_] characters"
+        == "Selectors.register: Selector engine name may only contain [a-zA-Z0-9_] characters"
     )
 
     # Selector names are case-sensitive.
@@ -195,11 +195,16 @@ async def test_selectors_register_should_handle_errors(
 
     with pytest.raises(Error) as exc:
         await selectors.register("dummy", dummy_selector_engine_script)
-    assert exc.value.message == '"dummy" selector engine has been already registered'
+    assert (
+        exc.value.message
+        == 'Selectors.register: "dummy" selector engine has been already registered'
+    )
 
     with pytest.raises(Error) as exc:
         await selectors.register("css", dummy_selector_engine_script)
-    assert exc.value.message == '"css" is a predefined selector engine'
+    assert (
+        exc.value.message == 'Selectors.register: "css" is a predefined selector engine'
+    )
 
 
 async def test_should_work_with_layout_selectors(page: Page) -> None:
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 2c0455d57..4c607d15f 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -14,6 +14,7 @@
 
 import os
 import re
+import traceback
 from typing import Callable
 from urllib.parse import urlparse
 
@@ -937,3 +938,19 @@ def test_locator_all_should_work(page: Page) -> None:
     for p in page.locator("p").all():
         texts.append(p.text_content())
     assert texts == ["A", "B", "C"]
+
+
+def test_locator_click_timeout_error_should_contain_call_log(page: Page) -> None:
+    with pytest.raises(Error) as exc_info:
+        page.get_by_role("button", name="Hello Python").click(timeout=42)
+    formatted_exception = "".join(
+        traceback.format_exception(type(exc_info.value), value=exc_info.value, tb=None)
+    )
+    assert "Locator.click: Timeout 42ms exceeded." in formatted_exception
+    assert (
+        'waiting for get_by_role("button", name="Hello Python")' in formatted_exception
+    )
+    assert (
+        "During handling of the above exception, another exception occurred"
+        not in formatted_exception
+    )
diff --git a/tests/sync/test_queryselector.py b/tests/sync/test_queryselector.py
index f773b5109..27b972e95 100644
--- a/tests/sync/test_queryselector.py
+++ b/tests/sync/test_queryselector.py
@@ -156,7 +156,7 @@ def test_selectors_register_should_handle_errors(
         selectors.register("$", dummy_selector_engine_script)
     assert (
         exc.value.message
-        == "Selector engine name may only contain [a-zA-Z0-9_] characters"
+        == "Selectors.register: Selector engine name may only contain [a-zA-Z0-9_] characters"
     )
 
     # Selector names are case-sensitive.
@@ -165,11 +165,16 @@ def test_selectors_register_should_handle_errors(
 
     with pytest.raises(Error) as exc:
         selectors.register("dummy", dummy_selector_engine_script)
-    assert exc.value.message == '"dummy" selector engine has been already registered'
+    assert (
+        exc.value.message
+        == 'Selectors.register: "dummy" selector engine has been already registered'
+    )
 
     with pytest.raises(Error) as exc:
         selectors.register("css", dummy_selector_engine_script)
-    assert exc.value.message == '"css" is a predefined selector engine'
+    assert (
+        exc.value.message == 'Selectors.register: "css" is a predefined selector engine'
+    )
 
 
 def test_should_work_with_layout_selectors(page: Page) -> None:

From 4a2f2e862a55c9385bbd558a5728b304e2091588 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 27 Mar 2024 13:20:17 +0100
Subject: [PATCH 189/438] build(deps): bump pytest-cov from 4.1.0 to 5.0.0
 (#2380)

Bumps [pytest-cov](https://github.com/pytest-dev/pytest-cov) from 4.1.0 to 5.0.0.
- [Changelog](https://github.com/pytest-dev/pytest-cov/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/pytest-dev/pytest-cov/compare/v4.1.0...v5.0.0)

---
updated-dependencies:
- dependency-name: pytest-cov
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 5446be6c3..3f68b2e7f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -11,7 +11,7 @@ pre-commit==3.4.0
 pyOpenSSL==24.1.0
 pytest==8.1.1
 pytest-asyncio==0.21.1
-pytest-cov==4.1.0
+pytest-cov==5.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1
 pytest-xdist==3.5.0

From 963d16d9f7f38748323dbbc6f8d1947adcefd8b5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 27 Mar 2024 13:20:24 +0100
Subject: [PATCH 190/438] build(deps): bump setuptools from 69.1.1 to 69.2.0
 (#2379)

Bumps [setuptools](https://github.com/pypa/setuptools) from 69.1.1 to 69.2.0.
- [Release notes](https://github.com/pypa/setuptools/releases)
- [Changelog](https://github.com/pypa/setuptools/blob/main/NEWS.rst)
- [Commits](https://github.com/pypa/setuptools/compare/v69.1.1...v69.2.0)

---
updated-dependencies:
- dependency-name: setuptools
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 3f68b2e7f..e1d00f1c1 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.5.0
 requests==2.31.0
 service_identity==24.1.0
-setuptools==69.1.1
+setuptools==69.2.0
 twisted==24.3.0
 types-pyOpenSSL==24.0.0.20240311
 types-requests==2.31.0.20240311

From 6a84c65452479f690c82ee88640555c33758bc50 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 27 Mar 2024 13:20:30 +0100
Subject: [PATCH 191/438] build(deps): bump flaky from 3.8.0 to 3.8.1 (#2377)

Bumps [flaky](https://github.com/box/flaky) from 3.8.0 to 3.8.1.
- [Release notes](https://github.com/box/flaky/releases)
- [Changelog](https://github.com/box/flaky/blob/master/HISTORY.rst)
- [Commits](https://github.com/box/flaky/compare/v3.8.0...v3.8.1)

---
updated-dependencies:
- dependency-name: flaky
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index e1d00f1c1..97501a308 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -2,7 +2,7 @@ auditwheel==6.0.0
 autobahn==23.1.2
 black==24.3.0
 flake8==7.0.0
-flaky==3.8.0
+flaky==3.8.1
 mypy==1.9.0
 objgraph==3.6.1
 Pillow==10.2.0

From 7e5f197bf0402f7f292a36e5e30fcb75a038a3c2 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 27 Mar 2024 16:55:54 +0100
Subject: [PATCH 192/438] feat(roll): roll Playwright to
 1.43.0-beta-1711484700000 (#2381)

---
 README.md                                     |   4 +-
 playwright/_impl/_browser_context.py          |  31 +++-
 playwright/_impl/_js_handle.py                |   7 +-
 playwright/_impl/_locator.py                  |   8 +
 playwright/_impl/_network.py                  |   2 +-
 playwright/async_api/_generated.py            | 105 +++++++++++--
 playwright/sync_api/_generated.py             | 107 +++++++++++--
 setup.py                                      |   2 +-
 .../async/test_browsercontext_clearcookies.py | 144 ++++++++++++++++++
 .../test_browsercontext_storage_state.py      |   8 +-
 tests/async/test_element_handle.py            |   8 +
 tests/async/test_locators.py                  |  23 ++-
 tests/async/test_page_network_request.py      |  19 +++
 .../sync/test_browsercontext_storage_state.py |   8 +-
 tests/sync/test_element_handle.py             |   8 +
 tests/sync/test_locators.py                   |  23 ++-
 16 files changed, 470 insertions(+), 37 deletions(-)

diff --git a/README.md b/README.md
index 611573b16..528570e8f 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 -->123.0.6312.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->124.0.6367.8<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->123.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->124.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index c52a134c8..c540ce4c0 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -70,6 +70,7 @@
 )
 from playwright._impl._network import Request, Response, Route, serialize_headers
 from playwright._impl._page import BindingCall, Page, Worker
+from playwright._impl._str_utils import escape_regex_flags
 from playwright._impl._tracing import Tracing
 from playwright._impl._waiter import Waiter
 from playwright._impl._web_error import WebError
@@ -302,8 +303,34 @@ async def cookies(self, urls: Union[str, Sequence[str]] = None) -> List[Cookie]:
     async def add_cookies(self, cookies: Sequence[SetCookieParam]) -> None:
         await self._channel.send("addCookies", dict(cookies=cookies))
 
-    async def clear_cookies(self) -> None:
-        await self._channel.send("clearCookies")
+    async def clear_cookies(
+        self,
+        name: Union[str, Pattern[str]] = None,
+        domain: Union[str, Pattern[str]] = None,
+        path: Union[str, Pattern[str]] = None,
+    ) -> None:
+        await self._channel.send(
+            "clearCookies",
+            {
+                "name": name if isinstance(name, str) else None,
+                "nameRegexSource": name.pattern if isinstance(name, Pattern) else None,
+                "nameRegexFlags": escape_regex_flags(name)
+                if isinstance(name, Pattern)
+                else None,
+                "domain": domain if isinstance(domain, str) else None,
+                "domainRegexSource": domain.pattern
+                if isinstance(domain, Pattern)
+                else None,
+                "domainRegexFlags": escape_regex_flags(domain)
+                if isinstance(domain, Pattern)
+                else None,
+                "path": path if isinstance(path, str) else None,
+                "pathRegexSource": path.pattern if isinstance(path, Pattern) else None,
+                "pathRegexFlags": escape_regex_flags(path)
+                if isinstance(path, Pattern)
+                else None,
+            },
+        )
 
     async def grant_permissions(
         self, permissions: Sequence[str], origin: str = None
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 4db0e2635..415d79a76 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -20,6 +20,7 @@
 from urllib.parse import ParseResult, urlparse, urlunparse
 
 from playwright._impl._connection import Channel, ChannelOwner, from_channel
+from playwright._impl._errors import is_target_closed_error
 from playwright._impl._map import Map
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -102,7 +103,11 @@ def as_element(self) -> Optional["ElementHandle"]:
         return None
 
     async def dispose(self) -> None:
-        await self._channel.send("dispose")
+        try:
+            await self._channel.send("dispose")
+        except Exception as e:
+            if not is_target_closed_error(e):
+                raise e
 
     async def json_value(self) -> Any:
         return parse_result(await self._channel.send("jsonValue"))
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 5d220f13b..c5e92d874 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -325,6 +325,10 @@ def last(self) -> "Locator":
     def nth(self, index: int) -> "Locator":
         return Locator(self._frame, f"{self._selector} >> nth={index}")
 
+    @property
+    def content_frame(self) -> "FrameLocator":
+        return FrameLocator(self._frame, self._selector)
+
     def filter(
         self,
         hasText: Union[str, Pattern[str]] = None,
@@ -817,6 +821,10 @@ def first(self) -> "FrameLocator":
     def last(self) -> "FrameLocator":
         return FrameLocator(self._frame, f"{self._frame_selector} >> nth=-1")
 
+    @property
+    def owner(self) -> "Locator":
+        return Locator(self._frame, self._frame_selector)
+
     def nth(self, index: int) -> "FrameLocator":
         return FrameLocator(self._frame, f"{self._frame_selector} >> nth={index}")
 
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 9d1337b01..1fe436c80 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -169,7 +169,7 @@ def post_data_json(self) -> Optional[Any]:
         if not post_data:
             return None
         content_type = self.headers["content-type"]
-        if content_type == "application/x-www-form-urlencoded":
+        if "application/x-www-form-urlencoded" in content_type:
             return dict(parse.parse_qsl(post_data))
         try:
             return json.loads(post_data)
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 3e266ccf0..244a891e3 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -5862,6 +5862,32 @@ def last(self) -> "FrameLocator":
         """
         return mapping.from_impl(self._impl_obj.last)
 
+    @property
+    def owner(self) -> "Locator":
+        """FrameLocator.owner
+
+        Returns a `Locator` object pointing to the same `iframe` as this frame locator.
+
+        Useful when you have a `FrameLocator` object obtained somewhere, and later on would like to interact with the
+        `iframe` element.
+
+        For a reverse operation, use `locator.content_frame()`.
+
+        **Usage**
+
+        ```py
+        frame_locator = page.frame_locator(\"iframe[name=\\\"embedded\\\"]\")
+        # ...
+        locator = frame_locator.owner
+        await expect(locator).to_be_visible()
+        ```
+
+        Returns
+        -------
+        Locator
+        """
+        return mapping.from_impl(self._impl_obj.owner)
+
     def locator(
         self,
         selector_or_locator: typing.Union["Locator", str],
@@ -11669,9 +11695,11 @@ async def add_locator_handler(
     ) -> None:
         """Page.add_locator_handler
 
-        When testing a web page, sometimes unexpected overlays like a coookie consent dialog appear and block actions you
-        want to automate, e.g. clicking a button. These overlays don't always show up in the same way or at the same time,
-        making them tricky to handle in automated tests.
+        **NOTE** This method is experimental and its behavior may change in the upcoming releases.
+
+        When testing a web page, sometimes unexpected overlays like a \"Sign up\" dialog appear and block actions you want to
+        automate, e.g. clicking a button. These overlays don't always show up in the same way or at the same time, making
+        them tricky to handle in automated tests.
 
         This method lets you set up a special function, called a handler, that activates when it detects that overlay is
         visible. The handler's job is to remove the overlay, allowing your test to continue as if the overlay wasn't there.
@@ -11681,7 +11709,9 @@ async def add_locator_handler(
           a part of your normal test flow, instead of using `page.add_locator_handler()`.
         - Playwright checks for the overlay every time before executing or retrying an action that requires an
           [actionability check](https://playwright.dev/python/docs/actionability), or before performing an auto-waiting assertion check. When overlay
-          is visible, Playwright calls the handler first, and then proceeds with the action/assertion.
+          is visible, Playwright calls the handler first, and then proceeds with the action/assertion. Note that the
+          handler is only called when you perform an action/assertion - if the overlay becomes visible but you don't
+          perform any actions, the handler will not be triggered.
         - The execution time of the handler counts towards the timeout of the action/assertion that executed the handler.
           If your handler takes too long, it might cause timeouts.
         - You can register multiple handlers. However, only a single handler will be running at a time. Make sure the
@@ -11699,13 +11729,13 @@ async def add_locator_handler(
 
         **Usage**
 
-        An example that closes a cookie consent dialog when it appears:
+        An example that closes a \"Sign up to the newsletter\" dialog when it appears:
 
         ```py
         # Setup the handler.
         def handler():
-          page.get_by_role(\"button\", name=\"Reject all cookies\").click()
-        page.add_locator_handler(page.get_by_role(\"button\", name=\"Accept all cookies\"), handler)
+          page.get_by_role(\"button\", name=\"No thanks\").click()
+        page.add_locator_handler(page.get_by_text(\"Sign up to the newsletter\"), handler)
 
         # Write the test as usual.
         page.goto(\"https://example.com\")
@@ -12319,13 +12349,40 @@ async def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
             await self._impl_obj.add_cookies(cookies=mapping.to_impl(cookies))
         )
 
-    async def clear_cookies(self) -> None:
+    async def clear_cookies(
+        self,
+        *,
+        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        domain: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        path: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None
+    ) -> None:
         """BrowserContext.clear_cookies
 
-        Clears context cookies.
+        Removes cookies from context. Accepts optional filter.
+
+        **Usage**
+
+        ```py
+        await context.clear_cookies()
+        await context.clear_cookies(name=\"session-id\")
+        await context.clear_cookies(domain=\"my-origin.com\")
+        await context.clear_cookies(path=\"/api/v1\")
+        await context.clear_cookies(name=\"session-id\", domain=\"my-origin.com\")
+        ```
+
+        Parameters
+        ----------
+        name : Union[Pattern[str], str, None]
+            Only removes cookies with the given name.
+        domain : Union[Pattern[str], str, None]
+            Only removes cookies with the given domain.
+        path : Union[Pattern[str], str, None]
+            Only removes cookies with the given path.
         """
 
-        return mapping.from_maybe_impl(await self._impl_obj.clear_cookies())
+        return mapping.from_maybe_impl(
+            await self._impl_obj.clear_cookies(name=name, domain=domain, path=path)
+        )
 
     async def grant_permissions(
         self, permissions: typing.Sequence[str], *, origin: typing.Optional[str] = None
@@ -13798,6 +13855,7 @@ async def launch(
         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.
         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]
@@ -13955,6 +14013,7 @@ async def launch_persistent_context(
         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.
         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]
@@ -14538,6 +14597,32 @@ def last(self) -> "Locator":
         """
         return mapping.from_impl(self._impl_obj.last)
 
+    @property
+    def content_frame(self) -> "FrameLocator":
+        """Locator.content_frame
+
+        Returns a `FrameLocator` object pointing to the same `iframe` as this locator.
+
+        Useful when you have a `Locator` object obtained somewhere, and later on would like to interact with the content
+        inside the frame.
+
+        For a reverse operation, use `frame_locator.owner()`.
+
+        **Usage**
+
+        ```py
+        locator = page.locator(\"iframe[name=\\\"embedded\\\"]\")
+        # ...
+        frame_locator = locator.content_frame
+        await frame_locator.get_by_role(\"button\").click()
+        ```
+
+        Returns
+        -------
+        FrameLocator
+        """
+        return mapping.from_impl(self._impl_obj.content_frame)
+
     async def bounding_box(
         self, *, timeout: typing.Optional[float] = None
     ) -> typing.Optional[FloatRect]:
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index d6ecf78ad..6c1fe5fbb 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -5976,6 +5976,32 @@ def last(self) -> "FrameLocator":
         """
         return mapping.from_impl(self._impl_obj.last)
 
+    @property
+    def owner(self) -> "Locator":
+        """FrameLocator.owner
+
+        Returns a `Locator` object pointing to the same `iframe` as this frame locator.
+
+        Useful when you have a `FrameLocator` object obtained somewhere, and later on would like to interact with the
+        `iframe` element.
+
+        For a reverse operation, use `locator.content_frame()`.
+
+        **Usage**
+
+        ```py
+        frame_locator = page.frame_locator(\"iframe[name=\\\"embedded\\\"]\")
+        # ...
+        locator = frame_locator.owner
+        expect(locator).to_be_visible()
+        ```
+
+        Returns
+        -------
+        Locator
+        """
+        return mapping.from_impl(self._impl_obj.owner)
+
     def locator(
         self,
         selector_or_locator: typing.Union["Locator", str],
@@ -11752,9 +11778,11 @@ def set_checked(
     def add_locator_handler(self, locator: "Locator", handler: typing.Callable) -> None:
         """Page.add_locator_handler
 
-        When testing a web page, sometimes unexpected overlays like a coookie consent dialog appear and block actions you
-        want to automate, e.g. clicking a button. These overlays don't always show up in the same way or at the same time,
-        making them tricky to handle in automated tests.
+        **NOTE** This method is experimental and its behavior may change in the upcoming releases.
+
+        When testing a web page, sometimes unexpected overlays like a \"Sign up\" dialog appear and block actions you want to
+        automate, e.g. clicking a button. These overlays don't always show up in the same way or at the same time, making
+        them tricky to handle in automated tests.
 
         This method lets you set up a special function, called a handler, that activates when it detects that overlay is
         visible. The handler's job is to remove the overlay, allowing your test to continue as if the overlay wasn't there.
@@ -11764,7 +11792,9 @@ def add_locator_handler(self, locator: "Locator", handler: typing.Callable) -> N
           a part of your normal test flow, instead of using `page.add_locator_handler()`.
         - Playwright checks for the overlay every time before executing or retrying an action that requires an
           [actionability check](https://playwright.dev/python/docs/actionability), or before performing an auto-waiting assertion check. When overlay
-          is visible, Playwright calls the handler first, and then proceeds with the action/assertion.
+          is visible, Playwright calls the handler first, and then proceeds with the action/assertion. Note that the
+          handler is only called when you perform an action/assertion - if the overlay becomes visible but you don't
+          perform any actions, the handler will not be triggered.
         - The execution time of the handler counts towards the timeout of the action/assertion that executed the handler.
           If your handler takes too long, it might cause timeouts.
         - You can register multiple handlers. However, only a single handler will be running at a time. Make sure the
@@ -11782,13 +11812,13 @@ def add_locator_handler(self, locator: "Locator", handler: typing.Callable) -> N
 
         **Usage**
 
-        An example that closes a cookie consent dialog when it appears:
+        An example that closes a \"Sign up to the newsletter\" dialog when it appears:
 
         ```py
         # Setup the handler.
         def handler():
-          await page.get_by_role(\"button\", name=\"Reject all cookies\").click()
-        await page.add_locator_handler(page.get_by_role(\"button\", name=\"Accept all cookies\"), handler)
+          await page.get_by_role(\"button\", name=\"No thanks\").click()
+        await page.add_locator_handler(page.get_by_text(\"Sign up to the newsletter\"), handler)
 
         # Write the test as usual.
         await page.goto(\"https://example.com\")
@@ -12338,13 +12368,42 @@ def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
             self._sync(self._impl_obj.add_cookies(cookies=mapping.to_impl(cookies)))
         )
 
-    def clear_cookies(self) -> None:
+    def clear_cookies(
+        self,
+        *,
+        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        domain: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        path: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None
+    ) -> None:
         """BrowserContext.clear_cookies
 
-        Clears context cookies.
+        Removes cookies from context. Accepts optional filter.
+
+        **Usage**
+
+        ```py
+        context.clear_cookies()
+        context.clear_cookies(name=\"session-id\")
+        context.clear_cookies(domain=\"my-origin.com\")
+        context.clear_cookies(path=\"/api/v1\")
+        context.clear_cookies(name=\"session-id\", domain=\"my-origin.com\")
+        ```
+
+        Parameters
+        ----------
+        name : Union[Pattern[str], str, None]
+            Only removes cookies with the given name.
+        domain : Union[Pattern[str], str, None]
+            Only removes cookies with the given domain.
+        path : Union[Pattern[str], str, None]
+            Only removes cookies with the given path.
         """
 
-        return mapping.from_maybe_impl(self._sync(self._impl_obj.clear_cookies()))
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.clear_cookies(name=name, domain=domain, path=path)
+            )
+        )
 
     def grant_permissions(
         self, permissions: typing.Sequence[str], *, origin: typing.Optional[str] = None
@@ -13828,6 +13887,7 @@ def launch(
         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.
         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]
@@ -13987,6 +14047,7 @@ def launch_persistent_context(
         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.
         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]
@@ -14575,6 +14636,32 @@ def last(self) -> "Locator":
         """
         return mapping.from_impl(self._impl_obj.last)
 
+    @property
+    def content_frame(self) -> "FrameLocator":
+        """Locator.content_frame
+
+        Returns a `FrameLocator` object pointing to the same `iframe` as this locator.
+
+        Useful when you have a `Locator` object obtained somewhere, and later on would like to interact with the content
+        inside the frame.
+
+        For a reverse operation, use `frame_locator.owner()`.
+
+        **Usage**
+
+        ```py
+        locator = page.locator(\"iframe[name=\\\"embedded\\\"]\")
+        # ...
+        frame_locator = locator.content_frame
+        frame_locator.get_by_role(\"button\").click()
+        ```
+
+        Returns
+        -------
+        FrameLocator
+        """
+        return mapping.from_impl(self._impl_obj.content_frame)
+
     def bounding_box(
         self, *, timeout: typing.Optional[float] = None
     ) -> typing.Optional[FloatRect]:
diff --git a/setup.py b/setup.py
index db21211fb..ae859c6ad 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.42.1"
+driver_version = "1.43.0-beta-1711484700000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_browsercontext_clearcookies.py b/tests/async/test_browsercontext_clearcookies.py
index 6b0f03283..336c99718 100644
--- a/tests/async/test_browsercontext_clearcookies.py
+++ b/tests/async/test_browsercontext_clearcookies.py
@@ -12,6 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import re
+from urllib.parse import urlparse
+
 from playwright.async_api import Browser, BrowserContext, Page
 from tests.server import Server
 
@@ -52,3 +55,144 @@ async def test_should_isolate_cookies_when_clearing(
     assert len(await context.cookies()) == 0
     assert len(await another_context.cookies()) == 0
     await another_context.close()
+
+
+async def test_should_remove_cookies_by_name(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    await context.add_cookies(
+        [
+            {
+                "name": "cookie1",
+                "value": "1",
+                "domain": urlparse(server.PREFIX).hostname,
+                "path": "/",
+            },
+            {
+                "name": "cookie2",
+                "value": "2",
+                "domain": urlparse(server.PREFIX).hostname,
+                "path": "/",
+            },
+        ]
+    )
+    await page.goto(server.PREFIX)
+    assert await page.evaluate("document.cookie") == "cookie1=1; cookie2=2"
+    await context.clear_cookies(name="cookie1")
+    assert await page.evaluate("document.cookie") == "cookie2=2"
+
+
+async def test_should_remove_cookies_by_name_regex(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    await context.add_cookies(
+        [
+            {
+                "name": "cookie1",
+                "value": "1",
+                "domain": urlparse(server.PREFIX).hostname,
+                "path": "/",
+            },
+            {
+                "name": "cookie2",
+                "value": "2",
+                "domain": urlparse(server.PREFIX).hostname,
+                "path": "/",
+            },
+        ]
+    )
+    await page.goto(server.PREFIX)
+    assert await page.evaluate("document.cookie") == "cookie1=1; cookie2=2"
+    await context.clear_cookies(name=re.compile("coo.*1"))
+    assert await page.evaluate("document.cookie") == "cookie2=2"
+
+
+async def test_should_remove_cookies_by_domain(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    await context.add_cookies(
+        [
+            {
+                "name": "cookie1",
+                "value": "1",
+                "domain": urlparse(server.PREFIX).hostname,
+                "path": "/",
+            },
+            {
+                "name": "cookie2",
+                "value": "2",
+                "domain": urlparse(server.CROSS_PROCESS_PREFIX).hostname,
+                "path": "/",
+            },
+        ]
+    )
+    await page.goto(server.PREFIX)
+    assert await page.evaluate("document.cookie") == "cookie1=1"
+    await page.goto(server.CROSS_PROCESS_PREFIX)
+    assert await page.evaluate("document.cookie") == "cookie2=2"
+    await context.clear_cookies(domain=urlparse(server.CROSS_PROCESS_PREFIX).hostname)
+    assert await page.evaluate("document.cookie") == ""
+    await page.goto(server.PREFIX)
+    assert await page.evaluate("document.cookie") == "cookie1=1"
+
+
+async def test_should_remove_cookies_by_path(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    await context.add_cookies(
+        [
+            {
+                "name": "cookie1",
+                "value": "1",
+                "domain": urlparse(server.PREFIX).hostname,
+                "path": "/api/v1",
+            },
+            {
+                "name": "cookie2",
+                "value": "2",
+                "domain": urlparse(server.PREFIX).hostname,
+                "path": "/api/v2",
+            },
+            {
+                "name": "cookie3",
+                "value": "3",
+                "domain": urlparse(server.PREFIX).hostname,
+                "path": "/",
+            },
+        ]
+    )
+    await page.goto(server.PREFIX + "/api/v1")
+    assert await page.evaluate("document.cookie") == "cookie1=1; cookie3=3"
+    await context.clear_cookies(path="/api/v1")
+    assert await page.evaluate("document.cookie") == "cookie3=3"
+    await page.goto(server.PREFIX + "/api/v2")
+    assert await page.evaluate("document.cookie") == "cookie2=2; cookie3=3"
+    await page.goto(server.PREFIX + "/")
+    assert await page.evaluate("document.cookie") == "cookie3=3"
+
+
+async def test_should_remove_cookies_by_name_and_domain(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    await context.add_cookies(
+        [
+            {
+                "name": "cookie1",
+                "value": "1",
+                "domain": urlparse(server.PREFIX).hostname,
+                "path": "/",
+            },
+            {
+                "name": "cookie1",
+                "value": "1",
+                "domain": urlparse(server.CROSS_PROCESS_PREFIX).hostname,
+                "path": "/",
+            },
+        ]
+    )
+    await page.goto(server.PREFIX)
+    assert await page.evaluate("document.cookie") == "cookie1=1"
+    await context.clear_cookies(name="cookie1", domain=urlparse(server.PREFIX).hostname)
+    assert await page.evaluate("document.cookie") == ""
+    await page.goto(server.CROSS_PROCESS_PREFIX)
+    assert await page.evaluate("document.cookie") == "cookie1=1"
diff --git a/tests/async/test_browsercontext_storage_state.py b/tests/async/test_browsercontext_storage_state.py
index 9aca1865b..f11aa8281 100644
--- a/tests/async/test_browsercontext_storage_state.py
+++ b/tests/async/test_browsercontext_storage_state.py
@@ -34,13 +34,13 @@ async def test_should_capture_local_storage(context: BrowserContext) -> None:
     origins = state["origins"]
     assert len(origins) == 2
     assert origins[0] == {
-        "origin": "https://www.example.com",
-        "localStorage": [{"name": "name1", "value": "value1"}],
-    }
-    assert origins[1] == {
         "origin": "https://www.domain.com",
         "localStorage": [{"name": "name2", "value": "value2"}],
     }
+    assert origins[1] == {
+        "origin": "https://www.example.com",
+        "localStorage": [{"name": "name1", "value": "value1"}],
+    }
 
 
 async def test_should_set_local_storage(browser: Browser) -> None:
diff --git a/tests/async/test_element_handle.py b/tests/async/test_element_handle.py
index 379e78c18..847b068be 100644
--- a/tests/async/test_element_handle.py
+++ b/tests/async/test_element_handle.py
@@ -784,3 +784,11 @@ async def test_set_checked(page: Page) -> None:
     assert await page.evaluate("checkbox.checked")
     await input.set_checked(False)
     assert await page.evaluate("checkbox.checked") is False
+
+
+async def test_should_allow_disposing_twice(page: Page) -> None:
+    await page.set_content("<section>39</section>")
+    element = await page.query_selector("section")
+    assert element
+    await element.dispose()
+    await element.dispose()
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index e725f13b7..b12a25a56 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -580,7 +580,8 @@ async def route_iframe(page: Page) -> None:
     await page.route(
         "**/empty.html",
         lambda route: route.fulfill(
-            body='<iframe src="iframe.html"></iframe>', content_type="text/html"
+            body='<iframe src="iframe.html" name="frame1">></iframe>',
+            content_type="text/html",
         ),
     )
     await page.route(
@@ -639,6 +640,26 @@ async def test_locators_frame_should_work_with_locator_frame_locator(
     await button.click()
 
 
+async def test_locator_content_frame_should_work(page: Page, server: Server) -> None:
+    await route_iframe(page)
+    await page.goto(server.EMPTY_PAGE)
+    locator = page.locator("iframe")
+    frame_locator = locator.content_frame
+    button = frame_locator.locator("button")
+    assert await button.inner_text() == "Hello iframe"
+    await expect(button).to_have_text("Hello iframe")
+    await button.click()
+
+
+async def test_frame_locator_owner_should_work(page: Page, server: Server) -> None:
+    await route_iframe(page)
+    await page.goto(server.EMPTY_PAGE)
+    frame_locator = page.frame_locator("iframe")
+    locator = frame_locator.owner
+    await expect(locator).to_be_visible()
+    assert await locator.get_attribute("name") == "frame1"
+
+
 async def route_ambiguous(page: Page) -> None:
     await page.route(
         "**/empty.html",
diff --git a/tests/async/test_page_network_request.py b/tests/async/test_page_network_request.py
index 375342ae8..779875eda 100644
--- a/tests/async/test_page_network_request.py
+++ b/tests/async/test_page_network_request.py
@@ -42,3 +42,22 @@ async def test_should_not_allow_to_access_frame_on_popup_main_request(
     await response.finished()
     await popup_promise
     await clicked
+
+
+async def test_should_parse_the_data_if_content_type_is_application_x_www_form_urlencoded_charset_UTF_8(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    async with page.expect_event("request") as request_info:
+        await page.evaluate(
+            """() => fetch('./post', {
+            method: 'POST',
+            headers: {
+            'content-type': 'application/x-www-form-urlencoded; charset=UTF-8',
+            },
+            body: 'foo=bar&baz=123'
+        })"""
+        )
+    request = await request_info.value
+    assert request
+    assert request.post_data_json == {"foo": "bar", "baz": "123"}
diff --git a/tests/sync/test_browsercontext_storage_state.py b/tests/sync/test_browsercontext_storage_state.py
index fc901a5cf..c785b1479 100644
--- a/tests/sync/test_browsercontext_storage_state.py
+++ b/tests/sync/test_browsercontext_storage_state.py
@@ -31,13 +31,13 @@ def test_should_capture_local_storage(context: BrowserContext) -> None:
     assert origins
     assert len(origins) == 2
     assert origins[0] == {
-        "origin": "https://www.example.com",
-        "localStorage": [{"name": "name1", "value": "value1"}],
-    }
-    assert origins[1] == {
         "origin": "https://www.domain.com",
         "localStorage": [{"name": "name2", "value": "value2"}],
     }
+    assert origins[1] == {
+        "origin": "https://www.example.com",
+        "localStorage": [{"name": "name1", "value": "value1"}],
+    }
 
 
 def test_should_set_local_storage(browser: Browser) -> None:
diff --git a/tests/sync/test_element_handle.py b/tests/sync/test_element_handle.py
index 89f6ae2b1..c2faa4a6e 100644
--- a/tests/sync/test_element_handle.py
+++ b/tests/sync/test_element_handle.py
@@ -661,3 +661,11 @@ def test_set_checked(page: Page) -> None:
     assert page.evaluate("checkbox.checked")
     input.set_checked(False)
     assert page.evaluate("checkbox.checked") is False
+
+
+def test_should_allow_disposing_twice(page: Page) -> None:
+    page.set_content("<section>39</section>")
+    element = page.query_selector("section")
+    assert element
+    element.dispose()
+    element.dispose()
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 4c607d15f..07509e10e 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -530,7 +530,8 @@ def route_iframe(page: Page) -> None:
     page.route(
         "**/empty.html",
         lambda route: route.fulfill(
-            body='<iframe src="iframe.html"></iframe>', content_type="text/html"
+            body='<iframe src="iframe.html" name="frame1"></iframe>',
+            content_type="text/html",
         ),
     )
     page.route(
@@ -591,6 +592,26 @@ def test_locators_frame_should_work_with_locator_frame_locator(
     button.click()
 
 
+def test_locator_content_frame_should_work(page: Page, server: Server) -> None:
+    route_iframe(page)
+    page.goto(server.EMPTY_PAGE)
+    locator = page.locator("iframe")
+    frame_locator = locator.content_frame
+    button = frame_locator.locator("button")
+    assert button.inner_text() == "Hello iframe"
+    expect(button).to_have_text("Hello iframe")
+    button.click()
+
+
+def test_frame_locator_owner_should_work(page: Page, server: Server) -> None:
+    route_iframe(page)
+    page.goto(server.EMPTY_PAGE)
+    frame_locator = page.frame_locator("iframe")
+    locator = frame_locator.owner
+    expect(locator).to_be_visible()
+    assert locator.get_attribute("name") == "frame1"
+
+
 def route_ambiguous(page: Page) -> None:
     page.route(
         "**/empty.html",

From 6a10c4252dc7c474e95db3c2e95e0e4474af082d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 2 Apr 2024 08:22:07 +0200
Subject: [PATCH 193/438] build(deps): bump pillow from 10.2.0 to 10.3.0
 (#2387)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 97501a308..03c4a73b5 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -5,7 +5,7 @@ flake8==7.0.0
 flaky==3.8.1
 mypy==1.9.0
 objgraph==3.6.1
-Pillow==10.2.0
+Pillow==10.3.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==24.1.0

From 66ddfee56f5d2c1bdd5db7c40c1e30aaa2a935e6 Mon Sep 17 00:00:00 2001
From: Tobias Fischer <info@tobiasfischer.info>
Date: Wed, 3 Apr 2024 03:44:25 +1000
Subject: [PATCH 194/438] devops: add osx-arm64 and linux-aarch64 conda package
 builds (#2211)

Co-authored-by: Max Schmitt <max@schmitt.mx>
---
 .github/workflows/publish.yml         | 33 +++++++++++++++++++++++----
 conda_build_config_linux_aarch64.yaml |  2 ++
 conda_build_config_osx_arm64.yaml     |  2 ++
 meta.yaml                             |  7 +++++-
 4 files changed, 38 insertions(+), 6 deletions(-)
 create mode 100644 conda_build_config_linux_aarch64.yaml
 create mode 100644 conda_build_config_osx_arm64.yaml

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index cc729ae1e..3a49aa132 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -6,22 +6,45 @@ jobs:
   deploy-conda:
     strategy:
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
+        include:
+          - os: ubuntu-latest
+            target-platform: linux-x86_64
+          - os: ubuntu-latest
+            target-platform: linux-aarch64
+          - os: windows-latest
+            target-platform: win-64
+          - os: macos-latest-large
+            target-platform: osx-intel
+          - os: macos-latest-xlarge
+            target-platform: osx-arm64
     runs-on: ${{ matrix.os }}
+    defaults:
+      run:
+        # Required for conda-incubator/setup-miniconda@v3
+        shell: bash -el {0}
     steps:
       - uses: actions/checkout@v3
         with:
           fetch-depth: 0
       - name: Get conda
-        uses: conda-incubator/setup-miniconda@v2
+        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
+        # Pinned because of https://github.com/conda/conda-build/issues/5267
+        run: conda install anaconda-client conda-build=24.1.2 conda-verify py-lief=0.12.3
       - name: Build and Upload
         env:
           ANACONDA_API_TOKEN: ${{ secrets.ANACONDA_API_TOKEN }}
         run: |
           conda config --set anaconda_upload yes
-          conda build --user microsoft .
+          if [ "${{ matrix.target-platform }}" == "osx-arm64" ]; then
+            conda build --user microsoft . -m conda_build_config.yaml -m conda_build_config_osx_arm64.yaml
+          elif [ "${{ matrix.target-platform }}" == "linux-aarch64" ]; then
+            conda install cross-python_linux-aarch64
+            conda build --user microsoft . -m conda_build_config.yaml -m conda_build_config_linux_aarch64.yaml
+          else
+            conda build --user microsoft . -m conda_build_config.yaml
+          fi
diff --git a/conda_build_config_linux_aarch64.yaml b/conda_build_config_linux_aarch64.yaml
new file mode 100644
index 000000000..68dceb2e3
--- /dev/null
+++ b/conda_build_config_linux_aarch64.yaml
@@ -0,0 +1,2 @@
+target_platform:
+- linux-aarch64
diff --git a/conda_build_config_osx_arm64.yaml b/conda_build_config_osx_arm64.yaml
new file mode 100644
index 000000000..d535f7252
--- /dev/null
+++ b/conda_build_config_osx_arm64.yaml
@@ -0,0 +1,2 @@
+target_platform:
+- osx-arm64
diff --git a/meta.yaml b/meta.yaml
index 85deaf23b..2b113e15d 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -15,6 +15,10 @@ build:
     - playwright = playwright.__main__:main
 
 requirements:
+  build:
+    - python                              # [build_platform != target_platform]
+    - pip                                 # [build_platform != target_platform]
+    - cross-python_{{ target_platform }}  # [build_platform != target_platform]
   host:
     - python
     - wheel
@@ -25,7 +29,8 @@ requirements:
     - python
     - greenlet ==3.0.3
     - pyee ==11.0.1
-test:
+
+test: # [build_platform == target_platform]
   requires:
     - pip
   imports:

From ac6e957bb0c77a1723ded5fa7635c36129e53ac7 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 3 Apr 2024 17:41:41 +0200
Subject: [PATCH 195/438] fix(cli): don't show a stack trace when command + c
 of the CLI (#2390)

---
 playwright/__main__.py | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/playwright/__main__.py b/playwright/__main__.py
index a5dfdad40..b38ae8a95 100644
--- a/playwright/__main__.py
+++ b/playwright/__main__.py
@@ -19,11 +19,14 @@
 
 
 def main() -> None:
-    driver_executable, driver_cli = compute_driver_executable()
-    completed_process = subprocess.run(
-        [driver_executable, driver_cli, *sys.argv[1:]], env=get_driver_env()
-    )
-    sys.exit(completed_process.returncode)
+    try:
+        driver_executable, driver_cli = compute_driver_executable()
+        completed_process = subprocess.run(
+            [driver_executable, driver_cli, *sys.argv[1:]], env=get_driver_env()
+        )
+        sys.exit(completed_process.returncode)
+    except KeyboardInterrupt:
+        sys.exit(130)
 
 
 if __name__ == "__main__":

From d796ac7ad18b5fe1ff2b0b254bcd41dcb00c7a5a Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 3 Apr 2024 17:53:40 +0200
Subject: [PATCH 196/438] devops(conda): publish a single version per OS
 instead of each supported Python version (#2391)

---
 .github/workflows/publish.yml | 6 +++---
 conda_build_config.yaml       | 6 ------
 meta.yaml                     | 7 +++----
 3 files changed, 6 insertions(+), 13 deletions(-)
 delete mode 100644 conda_build_config.yaml

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 3a49aa132..cae28da1a 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -41,10 +41,10 @@ jobs:
         run: |
           conda config --set anaconda_upload yes
           if [ "${{ matrix.target-platform }}" == "osx-arm64" ]; then
-            conda build --user microsoft . -m conda_build_config.yaml -m conda_build_config_osx_arm64.yaml
+            conda build --user microsoft . -m conda_build_config_osx_arm64.yaml
           elif [ "${{ matrix.target-platform }}" == "linux-aarch64" ]; then
             conda install cross-python_linux-aarch64
-            conda build --user microsoft . -m conda_build_config.yaml -m conda_build_config_linux_aarch64.yaml
+            conda build --user microsoft . -m conda_build_config_linux_aarch64.yaml
           else
-            conda build --user microsoft . -m conda_build_config.yaml
+            conda build --user microsoft .
           fi
diff --git a/conda_build_config.yaml b/conda_build_config.yaml
deleted file mode 100644
index 92ada529f..000000000
--- a/conda_build_config.yaml
+++ /dev/null
@@ -1,6 +0,0 @@
-python:
-  - 3.8
-  - 3.9
-  - "3.10"
-  - "3.11"
-  - "3.12"
diff --git a/meta.yaml b/meta.yaml
index 2b113e15d..98b774490 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -8,7 +8,6 @@ source:
 build:
   number: 0
   script: "{{ PYTHON }} -m pip install . --no-deps -vv"
-  skip: true # [py<37]
   binary_relocation: False
   missing_dso_whitelist: "*"
   entry_points:
@@ -16,17 +15,17 @@ build:
 
 requirements:
   build:
-    - python                              # [build_platform != target_platform]
+    - python >=3.8                        # [build_platform != target_platform]
     - pip                                 # [build_platform != target_platform]
     - cross-python_{{ target_platform }}  # [build_platform != target_platform]
   host:
-    - python
+    - python >=3.8
     - wheel
     - pip
     - curl
     - setuptools_scm
   run:
-    - python
+    - python >=3.8
     - greenlet ==3.0.3
     - pyee ==11.0.1
 

From b26b1f5d2a13d4ea3cc88c7d88880cac097dfe3d Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 4 Apr 2024 18:20:00 +0200
Subject: [PATCH 197/438] test: port test_launcher to sync test-suite (#2392)

---
 tests/sync/test_launcher.py | 126 ++++++++++++++++++++++++++++++++++++
 1 file changed, 126 insertions(+)
 create mode 100644 tests/sync/test_launcher.py

diff --git a/tests/sync/test_launcher.py b/tests/sync/test_launcher.py
new file mode 100644
index 000000000..8577fd200
--- /dev/null
+++ b/tests/sync/test_launcher.py
@@ -0,0 +1,126 @@
+# 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
+from pathlib import Path
+from typing import Dict, Optional
+
+import pytest
+
+from playwright.sync_api import BrowserType, Error
+
+
+@pytest.mark.skip_browser("firefox")
+def test_browser_type_launch_should_throw_if_page_argument_is_passed(
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
+    with pytest.raises(Error) as exc:
+        browser_type.launch(**launch_arguments, args=["http://example.com"])
+    assert "can not specify page" in exc.value.message
+
+
+def test_browser_type_launch_should_reject_if_launched_browser_fails_immediately(
+    browser_type: BrowserType, launch_arguments: Dict, assetdir: Path
+) -> None:
+    with pytest.raises(Error):
+        browser_type.launch(
+            **launch_arguments,
+            executable_path=assetdir / "dummy_bad_browser_executable.js",
+        )
+
+
+def test_browser_type_launch_should_reject_if_executable_path_is_invalid(
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
+    with pytest.raises(Error) as exc:
+        browser_type.launch(**launch_arguments, executable_path="random-invalid-path")
+    assert "executable doesn't exist" in exc.value.message
+
+
+def test_browser_type_executable_path_should_work(
+    browser_type: BrowserType, browser_channel: str
+) -> None:
+    if browser_channel:
+        return
+    executable_path = browser_type.executable_path
+    assert os.path.exists(executable_path)
+    assert os.path.realpath(executable_path) == os.path.realpath(executable_path)
+
+
+def test_browser_type_name_should_work(
+    browser_type: BrowserType, is_webkit: bool, is_firefox: bool, is_chromium: bool
+) -> None:
+    if is_webkit:
+        assert browser_type.name == "webkit"
+    elif is_firefox:
+        assert browser_type.name == "firefox"
+    elif is_chromium:
+        assert browser_type.name == "chromium"
+    else:
+        raise ValueError("Unknown browser")
+
+
+def test_browser_close_should_fire_close_event_for_all_contexts(
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
+    browser = browser_type.launch(**launch_arguments)
+    context = browser.new_context()
+    closed = []
+    context.on("close", lambda _: closed.append(True))
+    browser.close()
+    assert closed == [True]
+
+
+def test_browser_close_should_be_callable_twice(
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
+    browser = browser_type.launch(**launch_arguments)
+    browser.close()
+    browser.close()
+
+
+@pytest.mark.only_browser("chromium")
+def test_browser_launch_should_return_background_pages(
+    browser_type: BrowserType,
+    tmpdir: Path,
+    browser_channel: Optional[str],
+    assetdir: Path,
+    launch_arguments: Dict,
+) -> None:
+    if browser_channel:
+        pytest.skip()
+
+    extension_path = str(assetdir / "simple-extension")
+    context = browser_type.launch_persistent_context(
+        str(tmpdir),
+        **{
+            **launch_arguments,
+            "headless": False,
+            "args": [
+                f"--disable-extensions-except={extension_path}",
+                f"--load-extension={extension_path}",
+            ],
+        },
+    )
+    background_page = None
+    if len(context.background_pages):
+        background_page = context.background_pages[0]
+    else:
+        background_page = context.wait_for_event("backgroundpage")
+    assert background_page
+    assert background_page in context.background_pages
+    assert background_page not in context.pages
+    context.close()
+    assert len(context.background_pages) == 0
+    assert len(context.pages) == 0

From d1e3f3c31e859f22aade0dd9ecb17730bbc4939d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 8 Apr 2024 21:40:35 +0200
Subject: [PATCH 198/438] build(deps): bump types-requests from 2.31.0.20240311
 to 2.31.0.20240406 (#2396)

Bumps [types-requests](https://github.com/python/typeshed) from 2.31.0.20240311 to 2.31.0.20240406.
- [Commits](https://github.com/python/typeshed/commits)

---
updated-dependencies:
- dependency-name: types-requests
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 03c4a73b5..51250c00b 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -20,5 +20,5 @@ service_identity==24.1.0
 setuptools==69.2.0
 twisted==24.3.0
 types-pyOpenSSL==24.0.0.20240311
-types-requests==2.31.0.20240311
+types-requests==2.31.0.20240406
 wheel==0.42.0

From d12ce3bce59b01b6db5f722c936edb9f7d56fff1 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 9 Apr 2024 09:02:00 +0200
Subject: [PATCH 199/438] feat(roll): roll Playwright to v1.43 (#2395)

---
 README.md | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 528570e8f..bdf616079 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->124.0.6367.8<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->124.0.6367.29<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->124.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/setup.py b/setup.py
index ae859c6ad..29cc21951 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.43.0-beta-1711484700000"
+driver_version = "1.43.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 3808e7436999cc077ce756baa0d52b7647965037 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Sat, 13 Apr 2024 15:55:55 +0200
Subject: [PATCH 200/438] fix(conda): update pyee version (#2402)

---
 meta.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/meta.yaml b/meta.yaml
index 98b774490..f9d1618d5 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -27,7 +27,7 @@ requirements:
   run:
     - python >=3.8
     - greenlet ==3.0.3
-    - pyee ==11.0.1
+    - pyee ==11.1.0
 
 test: # [build_platform == target_platform]
   requires:

From c47d51ce1587df8df95d301c9e29ea15df174b4b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 15 Apr 2024 20:03:28 +0200
Subject: [PATCH 201/438] build(deps): bump setuptools from 69.2.0 to 69.5.1
 (#2407)

Bumps [setuptools](https://github.com/pypa/setuptools) from 69.2.0 to 69.5.1.
- [Release notes](https://github.com/pypa/setuptools/releases)
- [Changelog](https://github.com/pypa/setuptools/blob/main/NEWS.rst)
- [Commits](https://github.com/pypa/setuptools/compare/v69.2.0...v69.5.1)

---
updated-dependencies:
- dependency-name: setuptools
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 51250c00b..eb1318739 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.5.0
 requests==2.31.0
 service_identity==24.1.0
-setuptools==69.2.0
+setuptools==69.5.1
 twisted==24.3.0
 types-pyOpenSSL==24.0.0.20240311
 types-requests==2.31.0.20240406

From 47f88e50163ad81049376889cce60d03d87afa09 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 15 Apr 2024 20:31:54 +0200
Subject: [PATCH 202/438] build(deps): bump black from 24.3.0 to 24.4.0 (#2406)

Bumps [black](https://github.com/psf/black) from 24.3.0 to 24.4.0.
- [Release notes](https://github.com/psf/black/releases)
- [Changelog](https://github.com/psf/black/blob/main/CHANGES.md)
- [Commits](https://github.com/psf/black/compare/24.3.0...24.4.0)

---
updated-dependencies:
- dependency-name: black
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index eb1318739..2c7851a64 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,6 +1,6 @@
 auditwheel==6.0.0
 autobahn==23.1.2
-black==24.3.0
+black==24.4.0
 flake8==7.0.0
 flaky==3.8.1
 mypy==1.9.0

From 57b41b255a279429577b2f2137bddf4332f408ea Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 16 Apr 2024 21:57:36 +0200
Subject: [PATCH 203/438] fix(download): support download.failure() is None
 (#2409)

fix(download): support download.failure() == Node
---
 playwright/_impl/_artifact.py | 5 ++++-
 playwright/_impl/_helper.py   | 2 +-
 tests/async/test_download.py  | 7 ++++++-
 3 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/playwright/_impl/_artifact.py b/playwright/_impl/_artifact.py
index 63833fe04..d619c35e2 100644
--- a/playwright/_impl/_artifact.py
+++ b/playwright/_impl/_artifact.py
@@ -42,7 +42,10 @@ async def save_as(self, path: Union[str, Path]) -> None:
         await stream.save_as(path)
 
     async def failure(self) -> Optional[str]:
-        return patch_error_message(await self._channel.send("failure"))
+        reason = await self._channel.send("failure")
+        if reason is None:
+            return None
+        return patch_error_message(reason)
 
     async def delete(self) -> None:
         await self._channel.send("delete")
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 0e6b91cd2..a79d9fe6a 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -229,7 +229,7 @@ def patch_error_message(message: str) -> str:
     if match:
         message = to_snake_case(match.group(1)) + match.group(2)
     message = message.replace(
-        "Pass { acceptDownloads: true }", "Pass { accept_downloads: True }"
+        "Pass { acceptDownloads: true }", "Pass 'accept_downloads=True'"
     )
     return message
 
diff --git a/tests/async/test_download.py b/tests/async/test_download.py
index 96d06820e..082fcac26 100644
--- a/tests/async/test_download.py
+++ b/tests/async/test_download.py
@@ -65,6 +65,7 @@ async def test_should_report_downloads_with_accept_downloads_false(
         == f"<Download url={download.url!r} suggested_filename={download.suggested_filename!r}>"
     )
     assert await download.path()
+    assert await download.failure() is None
 
 
 async def test_should_report_downloads_with_accept_downloads_true(
@@ -180,9 +181,13 @@ async def test_should_error_when_saving_with_downloads_disabled(
     with pytest.raises(Error) as exc:
         await download.save_as(user_path)
     assert (
-        "Pass { accept_downloads: True } when you are creating your browser context"
+        "Pass 'accept_downloads=True' when you are creating your browser context"
         in exc.value.message
     )
+    assert (
+        "Pass 'accept_downloads=True' when you are creating your browser context."
+        == await download.failure()
+    )
     await page.close()
 
 

From ad9087a8f7ba9c0efac418fdfd2517d674a3c338 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 16 Apr 2024 23:37:40 +0200
Subject: [PATCH 204/438] fix: page.video should be None if not recording
 (#2410)

---
 playwright/_impl/_page.py | 16 ++++++++++++----
 tests/async/test_video.py |  8 ++++++++
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index db6cf13b8..8efbaf164 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -311,7 +311,7 @@ def _on_download(self, params: Any) -> None:
 
     def _on_video(self, params: Any) -> None:
         artifact = from_channel(params["artifact"])
-        cast(Video, self.video)._artifact_ready(artifact)
+        self._force_video()._artifact_ready(artifact)
 
     @property
     def context(self) -> "BrowserContext":
@@ -1064,13 +1064,21 @@ 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)
+        return self._video
+
     @property
     def video(
         self,
     ) -> Optional[Video]:
-        if not self._video:
-            self._video = Video(self)
-        return self._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._options.get("recordVideo"):
+            return None
+        return self._force_video()
 
     def _close_error_with_reason(self) -> TargetClosedError:
         return TargetClosedError(
diff --git a/tests/async/test_video.py b/tests/async/test_video.py
index 8575aabad..b0ab4c529 100644
--- a/tests/async/test_video.py
+++ b/tests/async/test_video.py
@@ -76,3 +76,11 @@ async def test_should_not_error_if_page_not_closed_before_save_as(
     await saved
     await page.context.close()
     assert os.path.exists(out_path)
+
+
+async def test_should_be_None_if_not_recording(
+    browser: Browser, tmpdir: Path, server: Server
+) -> None:
+    page = await browser.new_page()
+    assert page.video is None
+    await page.close()

From 2e4e81baa695bbcb181346899531018245501c84 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 17 Apr 2024 18:26:44 +0200
Subject: [PATCH 205/438] fix(cdpSession): allow optional params in events
 (#2411)

---
 playwright/_impl/_cdp_session.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/playwright/_impl/_cdp_session.py b/playwright/_impl/_cdp_session.py
index a6af32b90..b6e383ff2 100644
--- a/playwright/_impl/_cdp_session.py
+++ b/playwright/_impl/_cdp_session.py
@@ -26,7 +26,7 @@ def __init__(
         self._channel.on("event", lambda params: self._on_event(params))
 
     def _on_event(self, params: Any) -> None:
-        self.emit(params["method"], params["params"])
+        self.emit(params["method"], params.get("params"))
 
     async def send(self, method: str, params: Dict = None) -> Dict:
         return await self._channel.send("send", locals_to_params(locals()))

From d4bf8d27c6d136de537fda6ea12af01ba2970626 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 19 Apr 2024 00:13:40 +0200
Subject: [PATCH 206/438] devops: migrate to OIDC for Docker publishing (#2412)

---
 .github/workflows/publish_docker.yml | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/publish_docker.yml b/.github/workflows/publish_docker.yml
index d69645bee..87db48384 100644
--- a/.github/workflows/publish_docker.yml
+++ b/.github/workflows/publish_docker.yml
@@ -16,17 +16,24 @@ jobs:
     name: "publish to DockerHub"
     runs-on: ubuntu-22.04
     if: github.repository == 'microsoft/playwright-python'
+    permissions:
+      id-token: write   # This is required for OIDC login (azure/login) to succeed
+      contents: read    # This is required for actions/checkout to succeed
+    environment: Docker
     steps:
     - uses: actions/checkout@v3
+    - name: Azure login
+      uses: azure/login@v2
+      with:
+        client-id: ${{ secrets.AZURE_DOCKER_CLIENT_ID }}
+        tenant-id: ${{ secrets.AZURE_DOCKER_TENANT_ID }}
+        subscription-id: ${{ secrets.AZURE_DOCKER_SUBSCRIPTION_ID }}
+    - name: Login to ACR via OIDC
+      run: az acr login --name playwright
     - name: Set up Python
       uses: actions/setup-python@v4
       with:
         python-version: "3.10"
-    - uses: azure/docker-login@v1
-      with:
-        login-server: playwright.azurecr.io
-        username: playwright
-        password: ${{ secrets.DOCKER_PASSWORD }}
     - name: Set up Docker QEMU for arm64 docker builds
       uses: docker/setup-qemu-action@v2
       with:

From 5b6461884286172202f7f8ed875330f83c97abcf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 22 Apr 2024 19:30:27 +0200
Subject: [PATCH 207/438] build(deps): bump types-pyopenssl from
 24.0.0.20240311 to 24.0.0.20240417 (#2414)

build(deps): bump types-pyopenssl

Bumps [types-pyopenssl](https://github.com/python/typeshed) from 24.0.0.20240311 to 24.0.0.20240417.
- [Commits](https://github.com/python/typeshed/commits)

---
updated-dependencies:
- dependency-name: types-pyopenssl
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 2c7851a64..b793df85c 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,6 +19,6 @@ requests==2.31.0
 service_identity==24.1.0
 setuptools==69.5.1
 twisted==24.3.0
-types-pyOpenSSL==24.0.0.20240311
+types-pyOpenSSL==24.0.0.20240417
 types-requests==2.31.0.20240406
 wheel==0.42.0

From cb94c25302a7ef72abc3d2c29816a57b8494d987 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 2 May 2024 16:03:28 +0000
Subject: [PATCH 208/438] fix(connect): Future exception was never retrieved on
 close() (#2427)

---
 playwright/_impl/_connection.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 937ab3f8b..b1cb245d8 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -293,6 +293,9 @@ def cleanup(self, cause: Exception = None) -> None:
         for ws_connection in self._child_ws_connections:
             ws_connection._transport.dispose()
         for callback in self._callbacks.values():
+            # To prevent 'Future exception was never retrieved' we ignore all callbacks that are no_reply.
+            if callback.no_reply:
+                continue
             callback.future.set_exception(self._closed_error)
         self._callbacks.clear()
         self.emit("close")

From 27079a1ebf22ec46b0e448a68ebca7c8f0e16445 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 3 May 2024 18:05:27 +0000
Subject: [PATCH 209/438] devops: upgrade EsrpRelease task to v7 (#2429)

---
 .azure-pipelines/publish.yml | 30 ++++++++++++++++++------------
 1 file changed, 18 insertions(+), 12 deletions(-)

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index 10d6ead8b..52af52ceb 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -41,17 +41,23 @@ extends:
             pip install -e .
             python setup.py bdist_wheel --all
           displayName: 'Install & Build'
-        - task: EsrpRelease@4
+        - task: EsrpRelease@7
           inputs:
-            ConnectedServiceName: 'Playwright-ESRP'
-            Intent: 'PackageDistribution'
-            ContentType: 'PyPi'
-            ContentSource: 'Folder'
-            FolderLocation: './dist/'
-            WaitForReleaseCompletion: true
-            Owners: 'maxschmitt@microsoft.com'
-            Approvers: 'maxschmitt@microsoft.com'
-            ServiceEndpointUrl: 'https://api.esrp.microsoft.com'
-            MainPublisher: 'Playwright'
-            DomainTenantId: '72f988bf-86f1-41af-91ab-2d7cd011db47'
+            connectedservicename: 'Playwright-ESRP-Azure'
+            keyvaultname: 'pw-publishing-secrets'
+            authcertname: 'ESRP-Release-Auth'
+            signcertname: 'ESRP-Release-Sign'
+            clientid: '13434a40-7de4-4c23-81a3-d843dc81c2c5'
+            intent: 'PackageDistribution'
+            contenttype: 'PyPi'
+            # Keeping it commented out as a workaround for:
+            # https://portal.microsofticm.com/imp/v3/incidents/incident/499972482/summary
+            # contentsource: 'folder'
+            folderlocation: './dist/'
+            waitforreleasecompletion: true
+            owners: 'maxschmitt@microsoft.com'
+            approvers: 'maxschmitt@microsoft.com'
+            serviceendpointurl: 'https://api.esrp.microsoft.com'
+            mainpublisher: 'Playwright'
+            domaintenantid: '72f988bf-86f1-41af-91ab-2d7cd011db47'
           displayName: 'ESRP Release to PIP'

From 4ac3b49adf3e53a3d7a23c17f86a338721c7e2c6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 6 May 2024 11:44:30 +0000
Subject: [PATCH 210/438] build(deps): bump black from 24.4.0 to 24.4.2 (#2419)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index b793df85c..647f5e6ca 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,6 +1,6 @@
 auditwheel==6.0.0
 autobahn==23.1.2
-black==24.4.0
+black==24.4.2
 flake8==7.0.0
 flaky==3.8.1
 mypy==1.9.0

From 5cf07fa6a308b73422b2a3eea35abcb86986d86e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 6 May 2024 11:44:41 +0000
Subject: [PATCH 211/438] build(deps): bump types-pyopenssl from
 24.0.0.20240417 to 24.1.0.20240425 (#2420)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 647f5e6ca..6fdc580d7 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,6 +19,6 @@ requests==2.31.0
 service_identity==24.1.0
 setuptools==69.5.1
 twisted==24.3.0
-types-pyOpenSSL==24.0.0.20240417
+types-pyOpenSSL==24.1.0.20240425
 types-requests==2.31.0.20240406
 wheel==0.42.0

From 789a47e489be5bf483352b13ed5f4847ee0eddb8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 6 May 2024 11:44:48 +0000
Subject: [PATCH 212/438] build(deps): bump pytest-xdist from 3.5.0 to 3.6.1
 (#2421)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 6fdc580d7..5f7953170 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -14,7 +14,7 @@ pytest-asyncio==0.21.1
 pytest-cov==5.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1
-pytest-xdist==3.5.0
+pytest-xdist==3.6.1
 requests==2.31.0
 service_identity==24.1.0
 setuptools==69.5.1

From 7bd2c7f00f723afb43688179788a15325c55fe34 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 6 May 2024 11:47:22 +0000
Subject: [PATCH 213/438] build(deps): bump mypy from 1.9.0 to 1.10.0 (#2423)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 5f7953170..8f9aaff85 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ autobahn==23.1.2
 black==24.4.2
 flake8==7.0.0
 flaky==3.8.1
-mypy==1.9.0
+mypy==1.10.0
 objgraph==3.6.1
 Pillow==10.3.0
 pixelmatch==0.3.0

From a0538188ee8e6b986eb7dffc7480d87cf2abc3b9 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 6 May 2024 12:13:23 +0000
Subject: [PATCH 214/438] test: unflake Firefox tests (#2431)

---
 tests/async/test_click.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/tests/async/test_click.py b/tests/async/test_click.py
index 038d6239d..fd783546d 100644
--- a/tests/async/test_click.py
+++ b/tests/async/test_click.py
@@ -547,6 +547,10 @@ async def test_wait_for_stable_position(page: Page, server: Server) -> None:
             document.body.style.margin = '0';
         }""",
     )
+    # rafraf for Firefox to kick in the animation.
+    await page.evaluate(
+        "() => new Promise(f => requestAnimationFrame(() => requestAnimationFrame(f)))"
+    )
 
     await page.click("button")
     assert await page.evaluate("window.result") == "Clicked"
@@ -564,6 +568,10 @@ async def test_timeout_waiting_for_stable_position(page: Page, server: Server) -
             button.style.marginLeft = '200px'
         }"""
     )
+    # rafraf for Firefox to kick in the animation.
+    await page.evaluate(
+        "() => new Promise(f => requestAnimationFrame(() => requestAnimationFrame(f)))"
+    )
 
     with pytest.raises(Error) as exc_info:
         await button.click(timeout=3000)

From 8dc39788ebf7ab2ab0ecff0437ccf0f0513b17bf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 6 May 2024 12:33:25 +0000
Subject: [PATCH 215/438] build(deps): bump pytest from 8.1.1 to 8.2.0 (#2422)

---
 local-requirements.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 8f9aaff85..ad29988d1 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,8 +9,8 @@ Pillow==10.3.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==24.1.0
-pytest==8.1.1
-pytest-asyncio==0.21.1
+pytest==8.2.0
+pytest-asyncio==0.21.2
 pytest-cov==5.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1

From e756233a49a7be14994c3c5d2e297e3483fdb589 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 8 May 2024 19:40:20 +0100
Subject: [PATCH 216/438] feat(roll): roll Playwright to v1.44.0 (#2433)

---
 README.md                                    |   4 +-
 ROLLING.md                                   |   7 +
 playwright/_impl/_assertions.py              |  86 ++-
 playwright/_impl/_browser_context.py         |   1 +
 playwright/_impl/_browser_type.py            |  24 +-
 playwright/_impl/_connection.py              |   8 +-
 playwright/_impl/_fetch.py                   |   1 +
 playwright/_impl/_helper.py                  |   2 +-
 playwright/_impl/_json_pipe.py               |  11 +-
 playwright/_impl/_locator.py                 |   3 +
 playwright/_impl/_page.py                    |  87 ++-
 playwright/_impl/_tracing.py                 |  11 +-
 playwright/async_api/_generated.py           | 621 +++++++++++++++---
 playwright/sync_api/_generated.py            | 636 ++++++++++++++++---
 scripts/expected_api_mismatch.txt            |   3 +
 setup.py                                     |   2 +-
 tests/assets/input/handle-locator.html       |  17 +-
 tests/async/test_assertions.py               |  40 ++
 tests/async/test_browsercontext.py           |   4 +-
 tests/async/test_browsertype_connect.py      |  16 +-
 tests/async/test_browsertype_connect_cdp.py  |  19 +-
 tests/async/test_keyboard.py                 |  18 +-
 tests/async/test_page_add_locator_handler.py | 203 +++++-
 tests/async/test_websocket.py                |  72 ++-
 tests/conftest.py                            |   7 +-
 tests/server.py                              |  55 +-
 tests/sync/test_page_add_locator_handler.py  | 204 +++++-
 27 files changed, 1816 insertions(+), 346 deletions(-)

diff --git a/README.md b/README.md
index bdf616079..901da2298 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 -->124.0.6367.29<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->125.0.6422.26<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->124.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->125.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/ROLLING.md b/ROLLING.md
index 5cd3240fa..2d35ee1e7 100644
--- a/ROLLING.md
+++ b/ROLLING.md
@@ -14,3 +14,10 @@
 * generate API: `./scripts/update_api.sh`
 * commit changes & send PR
 * wait for bots to pass & merge the PR
+
+
+## Fix typing issues with Playwright ToT
+
+1. `cd playwright`
+1. `API_JSON_MODE=1 node utils/doclint/generateApiJson.js > ../playwright-python/playwright/driver/package/api.json`
+1. `./scripts/update_api.sh`
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 2c895e527..5841eca5a 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -16,7 +16,11 @@
 from typing import Any, List, Optional, Pattern, Sequence, Union
 from urllib.parse import urljoin
 
-from playwright._impl._api_structures import ExpectedTextValue, FrameExpectOptions
+from playwright._impl._api_structures import (
+    AriaRole,
+    ExpectedTextValue,
+    FrameExpectOptions,
+)
 from playwright._impl._connection import format_call_log
 from playwright._impl._errors import Error
 from playwright._impl._fetch import APIResponse
@@ -92,10 +96,10 @@ def _not(self) -> "PageAssertions":
     async def to_have_title(
         self, titleOrRegExp: Union[Pattern[str], str], timeout: float = None
     ) -> None:
+        __tracebackhide__ = True
         expected_values = to_expected_text_values(
             [titleOrRegExp], normalize_white_space=True
         )
-        __tracebackhide__ = True
         await self._expect_impl(
             "to.have.title",
             FrameExpectOptions(expectedText=expected_values, timeout=timeout),
@@ -110,13 +114,16 @@ async def not_to_have_title(
         await self._not.to_have_title(titleOrRegExp, timeout)
 
     async def to_have_url(
-        self, urlOrRegExp: Union[str, Pattern[str]], timeout: float = None
+        self,
+        urlOrRegExp: Union[str, Pattern[str]],
+        timeout: float = None,
+        ignoreCase: bool = None,
     ) -> None:
         __tracebackhide__ = True
         base_url = self._actual_page.context._options.get("baseURL")
         if isinstance(urlOrRegExp, str) and base_url:
             urlOrRegExp = urljoin(base_url, urlOrRegExp)
-        expected_text = to_expected_text_values([urlOrRegExp])
+        expected_text = to_expected_text_values([urlOrRegExp], ignoreCase=ignoreCase)
         await self._expect_impl(
             "to.have.url",
             FrameExpectOptions(expectedText=expected_text, timeout=timeout),
@@ -125,10 +132,13 @@ async def to_have_url(
         )
 
     async def not_to_have_url(
-        self, urlOrRegExp: Union[Pattern[str], str], timeout: float = None
+        self,
+        urlOrRegExp: Union[Pattern[str], str],
+        timeout: float = None,
+        ignoreCase: bool = None,
     ) -> None:
         __tracebackhide__ = True
-        await self._not.to_have_url(urlOrRegExp, timeout)
+        await self._not.to_have_url(urlOrRegExp, timeout, ignoreCase)
 
 
 class LocatorAssertions(AssertionsBase):
@@ -704,6 +714,70 @@ async def not_to_be_in_viewport(
         __tracebackhide__ = True
         await self._not.to_be_in_viewport(ratio=ratio, timeout=timeout)
 
+    async def to_have_accessible_description(
+        self,
+        description: Union[str, Pattern[str]],
+        ignoreCase: bool = None,
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        expected_values = to_expected_text_values([description], ignoreCase=ignoreCase)
+        await self._expect_impl(
+            "to.have.accessible.description",
+            FrameExpectOptions(expectedText=expected_values, timeout=timeout),
+            None,
+            "Locator expected to have accessible description",
+        )
+
+    async def not_to_have_accessible_description(
+        self,
+        name: Union[str, Pattern[str]],
+        ignoreCase: bool = None,
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        await self._not.to_have_accessible_description(name, ignoreCase, timeout)
+
+    async def to_have_accessible_name(
+        self,
+        name: Union[str, Pattern[str]],
+        ignoreCase: bool = None,
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        expected_values = to_expected_text_values([name], ignoreCase=ignoreCase)
+        await self._expect_impl(
+            "to.have.accessible.name",
+            FrameExpectOptions(expectedText=expected_values, timeout=timeout),
+            None,
+            "Locator expected to have accessible name",
+        )
+
+    async def not_to_have_accessible_name(
+        self,
+        name: Union[str, Pattern[str]],
+        ignoreCase: bool = None,
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        await self._not.to_have_accessible_name(name, ignoreCase, timeout)
+
+    async def to_have_role(self, role: AriaRole, timeout: float = None) -> None:
+        __tracebackhide__ = True
+        if isinstance(role, Pattern):
+            raise Error('"role" argument in to_have_role must be a string')
+        expected_values = to_expected_text_values([role])
+        await self._expect_impl(
+            "to.have.role",
+            FrameExpectOptions(expectedText=expected_values, timeout=timeout),
+            None,
+            "Locator expected to have accessible role",
+        )
+
+    async def not_to_have_role(self, role: AriaRole, timeout: float = None) -> None:
+        __tracebackhide__ = True
+        await self._not.to_have_role(role, timeout)
+
 
 class APIResponseAssertions:
     def __init__(
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index c540ce4c0..edb298c9c 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -510,6 +510,7 @@ def _on_close(self) -> None:
             self._browser._contexts.remove(self)
 
         self._dispose_har_routers()
+        self._tracing._reset_stack_counter()
         self.emit(BrowserContext.Events.Close, self)
 
     async def close(self, reason: str = None) -> None:
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 8393d69ee..00e146061 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -218,6 +218,20 @@ async def connect(
             local_utils=self._connection.local_utils,
         )
         connection.mark_as_remote()
+
+        browser = None
+
+        def handle_transport_close(reason: Optional[str]) -> None:
+            if browser:
+                for context in browser.contexts:
+                    for page in context.pages:
+                        page._on_close()
+                    context._on_close()
+                browser._on_close()
+            connection.cleanup(reason)
+
+        transport.once("close", handle_transport_close)
+
         connection._is_sync = self._connection._is_sync
         connection._loop.create_task(connection.run())
         playwright_future = connection.playwright_future
@@ -240,16 +254,6 @@ async def connect(
         self._did_launch_browser(browser)
         browser._should_close_connection_on_close = True
 
-        def handle_transport_close() -> None:
-            for context in browser.contexts:
-                for page in context.pages:
-                    page._on_close()
-                context._on_close()
-            browser._on_close()
-            connection.cleanup()
-
-        transport.once("close", handle_transport_close)
-
         return browser
 
     def _did_create_context(
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index b1cb245d8..eb4d182d3 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -284,10 +284,8 @@ async def stop_async(self) -> None:
         await self._transport.wait_until_stopped()
         self.cleanup()
 
-    def cleanup(self, cause: Exception = None) -> None:
-        self._closed_error = (
-            TargetClosedError(str(cause)) if cause else TargetClosedError()
-        )
+    def cleanup(self, cause: str = None) -> None:
+        self._closed_error = TargetClosedError(cause) if cause else TargetClosedError()
         if self._init_task and not self._init_task.done():
             self._init_task.cancel()
         for ws_connection in self._child_ws_connections:
@@ -305,7 +303,7 @@ def call_on_object_with_known_name(
     ) -> None:
         self._waiting_for_object[guid] = callback
 
-    def set_in_tracing(self, is_tracing: bool) -> None:
+    def set_is_tracing(self, is_tracing: bool) -> None:
         if is_tracing:
             self._tracing_count += 1
         else:
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index 53c457ba7..9947534aa 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -96,6 +96,7 @@ def __init__(
 
     async def dispose(self) -> None:
         await self._channel.send("dispose")
+        self._tracing._reset_stack_counter()
 
     async def delete(
         self,
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index a79d9fe6a..fca945643 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -57,7 +57,7 @@
 ForcedColors = Literal["active", "none", "null"]
 ReducedMotion = Literal["no-preference", "null", "reduce"]
 DocumentLoadState = Literal["commit", "domcontentloaded", "load", "networkidle"]
-KeyboardModifier = Literal["Alt", "Control", "Meta", "Shift"]
+KeyboardModifier = Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]
 MouseButton = Literal["left", "middle", "right"]
 ServiceWorkersPolicy = Literal["allow", "block"]
 HarMode = Literal["full", "minimal"]
diff --git a/playwright/_impl/_json_pipe.py b/playwright/_impl/_json_pipe.py
index 12d3a886f..f76bc7175 100644
--- a/playwright/_impl/_json_pipe.py
+++ b/playwright/_impl/_json_pipe.py
@@ -13,11 +13,12 @@
 # limitations under the License.
 
 import asyncio
-from typing import Dict, cast
+from typing import Dict, Optional, cast
 
 from pyee.asyncio import AsyncIOEventEmitter
 
 from playwright._impl._connection import Channel
+from playwright._impl._errors import TargetClosedError
 from playwright._impl._helper import Error, ParsedMessagePayload
 from playwright._impl._transport import Transport
 
@@ -53,8 +54,10 @@ def handle_message(message: Dict) -> None:
                 return
             self.on_message(cast(ParsedMessagePayload, message))
 
-        def handle_closed() -> None:
-            self.emit("close")
+        def handle_closed(reason: Optional[str]) -> None:
+            self.emit("close", reason)
+            if reason:
+                self.on_error_future.set_exception(TargetClosedError(reason))
             self._stopped_future.set_result(None)
 
         self._pipe_channel.on(
@@ -63,7 +66,7 @@ def handle_closed() -> None:
         )
         self._pipe_channel.on(
             "closed",
-            lambda _: handle_closed(),
+            lambda params: handle_closed(params.get("reason")),
         )
 
     async def run(self) -> None:
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index c5e92d874..0213ff9ea 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -116,6 +116,9 @@ async def _with_element(
         finally:
             await handle.dispose()
 
+    def _equals(self, locator: "Locator") -> bool:
+        return self._frame == locator._frame and self._selector == locator._selector
+
     @property
     def page(self) -> "Page":
         return self._frame.page
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 8efbaf164..43a9e06db 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -98,6 +98,25 @@
     from playwright._impl._network import WebSocket
 
 
+class LocatorHandler:
+    locator: "Locator"
+    handler: Union[Callable[["Locator"], Any], Callable[..., Any]]
+    times: Union[int, None]
+
+    def __init__(
+        self, locator: "Locator", handler: Callable[..., Any], times: Union[int, None]
+    ) -> None:
+        self.locator = locator
+        self._handler = handler
+        self.times = times
+
+    def __call__(self) -> Any:
+        arg_count = len(inspect.signature(self._handler).parameters)
+        if arg_count == 0:
+            return self._handler()
+        return self._handler(self.locator)
+
+
 class Page(ChannelOwner):
     Events = SimpleNamespace(
         Close="close",
@@ -152,7 +171,7 @@ def __init__(
         self._close_reason: Optional[str] = None
         self._close_was_called = False
         self._har_routers: List[HarRouter] = []
-        self._locator_handlers: Dict[str, Callable] = {}
+        self._locator_handlers: Dict[str, LocatorHandler] = {}
 
         self._channel.on(
             "bindingCall",
@@ -1270,48 +1289,72 @@ async def set_checked(
                 trial=trial,
             )
 
-    async def add_locator_handler(self, locator: "Locator", handler: Callable) -> None:
+    async def add_locator_handler(
+        self,
+        locator: "Locator",
+        handler: Union[Callable[["Locator"], Any], Callable[[], Any]],
+        noWaitAfter: bool = None,
+        times: int = None,
+    ) -> None:
         if locator._frame != self._main_frame:
             raise Error("Locator must belong to the main frame of this page")
+        if times == 0:
+            return
         uid = await self._channel.send(
             "registerLocatorHandler",
             {
                 "selector": locator._selector,
+                "noWaitAfter": noWaitAfter,
             },
         )
-        self._locator_handlers[uid] = handler
+        self._locator_handlers[uid] = LocatorHandler(
+            handler=handler, times=times, locator=locator
+        )
 
     async def _on_locator_handler_triggered(self, uid: str) -> None:
+        remove = False
         try:
-            if self._dispatcher_fiber:
-                handler_finished_future = self._loop.create_future()
-
-                def _handler() -> None:
-                    try:
-                        self._locator_handlers[uid]()
-                        handler_finished_future.set_result(None)
-                    except Exception as e:
-                        handler_finished_future.set_exception(e)
-
-                g = LocatorHandlerGreenlet(_handler)
-                g.switch()
-                await handler_finished_future
-            else:
-                coro_or_future = self._locator_handlers[uid]()
-                if coro_or_future:
-                    await coro_or_future
-
+            handler = self._locator_handlers.get(uid)
+            if handler and handler.times != 0:
+                if handler.times is not None:
+                    handler.times -= 1
+                if self._dispatcher_fiber:
+                    handler_finished_future = self._loop.create_future()
+
+                    def _handler() -> None:
+                        try:
+                            handler()
+                            handler_finished_future.set_result(None)
+                        except Exception as e:
+                            handler_finished_future.set_exception(e)
+
+                    g = LocatorHandlerGreenlet(_handler)
+                    g.switch()
+                    await handler_finished_future
+                else:
+                    coro_or_future = handler()
+                    if coro_or_future:
+                        await coro_or_future
+                remove = handler.times == 0
         finally:
+            if remove:
+                del self._locator_handlers[uid]
             try:
                 await self._connection.wrap_api_call(
                     lambda: self._channel.send(
-                        "resolveLocatorHandlerNoReply", {"uid": uid}
+                        "resolveLocatorHandlerNoReply", {"uid": uid, "remove": remove}
                     ),
                     is_internal=True,
                 )
             except Error:
                 pass
 
+    async def remove_locator_handler(self, locator: "Locator") -> None:
+        for uid, data in self._locator_handlers.copy().items():
+            if data.locator._equals(locator):
+                del self._locator_handlers[uid]
+                self._channel.send_no_reply("unregisterLocatorHandler", {"uid": uid})
+
 
 class Worker(ChannelOwner):
     Events = SimpleNamespace(Close="close")
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index 7f7972372..b2d4b5df9 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -58,7 +58,7 @@ async def start_chunk(self, title: str = None, name: str = None) -> None:
     async def _start_collecting_stacks(self, trace_name: str) -> None:
         if not self._is_tracing:
             self._is_tracing = True
-            self._connection.set_in_tracing(True)
+            self._connection.set_is_tracing(True)
         self._stacks_id = await self._connection.local_utils.tracing_started(
             self._traces_dir, trace_name
         )
@@ -74,9 +74,7 @@ async def _inner() -> None:
         await self._connection.wrap_api_call(_inner, True)
 
     async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> None:
-        if self._is_tracing:
-            self._is_tracing = False
-            self._connection.set_in_tracing(False)
+        self._reset_stack_counter()
 
         if not file_path:
             # Not interested in any artifacts
@@ -133,3 +131,8 @@ async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> No
                 "includeSources": self._include_sources,
             }
         )
+
+    def _reset_stack_counter(self) -> None:
+        if self._is_tracing:
+            self._is_tracing = False
+            self._connection.set_is_tracing(False)
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 244a891e3..696637c83 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -1140,7 +1140,8 @@ async def down(self, key: str) -> None:
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -1246,7 +1247,8 @@ async def press(self, key: str, *, delay: typing.Optional[float] = None) -> None
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -1846,7 +1848,7 @@ async def hover(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -1869,9 +1871,10 @@ async def hover(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -1904,7 +1907,7 @@ async def click(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -1930,9 +1933,10 @@ async def click(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -1974,7 +1978,7 @@ async def dblclick(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -2002,9 +2006,10 @@ async def dblclick(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -2120,7 +2125,7 @@ async def tap(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -2145,9 +2150,10 @@ async def tap(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -2377,7 +2383,8 @@ async def press(
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -3321,6 +3328,9 @@ async def wait_for_load_state(
         committed when this method is called. If current document has already reached the required state, resolves
         immediately.
 
+        **NOTE** Most of the time, this method is not needed because Playwright
+        [auto-waits before every action](https://playwright.dev/python/docs/actionability).
+
         **Usage**
 
         ```py
@@ -4119,7 +4129,7 @@ async def click(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -4149,9 +4159,10 @@ async def click(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -4199,7 +4210,7 @@ async def dblclick(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -4231,9 +4242,10 @@ async def dblclick(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -4278,7 +4290,7 @@ async def tap(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -4307,9 +4319,10 @@ async def tap(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -5122,7 +5135,7 @@ async def hover(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -5149,9 +5162,10 @@ async def hover(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -5494,7 +5508,8 @@ async def press(
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -7114,7 +7129,9 @@ def on(
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
         popup with `window.open('http://example.com')`, this event will fire when the network request to
-        \"http://example.com\" is done and its response has started loading in the popup.
+        \"http://example.com\" is done and its response has started loading in the popup. If you would like to route/listen
+        to this network request, use `browser_context.route()` and `browser_context.on('request')` respectively
+        instead of similar methods on the `Page`.
 
         ```py
         async with page.expect_event(\"popup\") as page_info:
@@ -7382,7 +7399,9 @@ def once(
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
         popup with `window.open('http://example.com')`, this event will fire when the network request to
-        \"http://example.com\" is done and its response has started loading in the popup.
+        \"http://example.com\" is done and its response has started loading in the popup. If you would like to route/listen
+        to this network request, use `browser_context.route()` and `browser_context.on('request')` respectively
+        instead of similar methods on the `Page`.
 
         ```py
         async with page.expect_event(\"popup\") as page_info:
@@ -8695,6 +8714,9 @@ async def wait_for_load_state(
         committed when this method is called. If current document has already reached the required state, resolves
         immediately.
 
+        **NOTE** Most of the time, this method is not needed because Playwright
+        [auto-waits before every action](https://playwright.dev/python/docs/actionability).
+
         **Usage**
 
         ```py
@@ -9065,6 +9087,9 @@ async def route(
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
         using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
 
+        **NOTE** `page.route()` will not intercept the first request of a popup page. Use
+        `browser_context.route()` instead.
+
         **Usage**
 
         An example of a naive handler that aborts all image requests:
@@ -9381,7 +9406,7 @@ async def click(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -9411,9 +9436,10 @@ async def click(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -9461,7 +9487,7 @@ async def dblclick(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -9493,9 +9519,10 @@ async def dblclick(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -9540,7 +9567,7 @@ async def tap(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -9569,9 +9596,10 @@ async def tap(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -10382,7 +10410,7 @@ async def hover(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -10409,9 +10437,10 @@ async def hover(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -10773,7 +10802,8 @@ async def press(
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -11691,12 +11721,17 @@ async def set_checked(
         )
 
     async def add_locator_handler(
-        self, locator: "Locator", handler: typing.Callable
+        self,
+        locator: "Locator",
+        handler: typing.Union[
+            typing.Callable[["Locator"], typing.Any], typing.Callable[[], typing.Any]
+        ],
+        *,
+        no_wait_after: typing.Optional[bool] = None,
+        times: typing.Optional[int] = None
     ) -> None:
         """Page.add_locator_handler
 
-        **NOTE** This method is experimental and its behavior may change in the upcoming releases.
-
         When testing a web page, sometimes unexpected overlays like a \"Sign up\" dialog appear and block actions you want to
         automate, e.g. clicking a button. These overlays don't always show up in the same way or at the same time, making
         them tricky to handle in automated tests.
@@ -11712,6 +11747,8 @@ async def add_locator_handler(
           is visible, Playwright calls the handler first, and then proceeds with the action/assertion. Note that the
           handler is only called when you perform an action/assertion - if the overlay becomes visible but you don't
           perform any actions, the handler will not be triggered.
+        - After executing the handler, Playwright will ensure that overlay that triggered the handler is not visible
+          anymore. You can opt-out of this behavior with `noWaitAfter`.
         - The execution time of the handler counts towards the timeout of the action/assertion that executed the handler.
           If your handler takes too long, it might cause timeouts.
         - You can register multiple handlers. However, only a single handler will be running at a time. Make sure the
@@ -11756,34 +11793,68 @@ def handler():
         ```
 
         An example with a custom callback on every actionability check. It uses a `<body>` locator that is always visible,
-        so the handler is called before every actionability check:
+        so the handler is called before every actionability check. It is important to specify `noWaitAfter`, because the
+        handler does not hide the `<body>` element.
 
         ```py
         # Setup the handler.
         def handler():
           page.evaluate(\"window.removeObstructionsForTestIfNeeded()\")
-        page.add_locator_handler(page.locator(\"body\"), handler)
+        page.add_locator_handler(page.locator(\"body\"), handler, no_wait_after=True)
 
         # Write the test as usual.
         page.goto(\"https://example.com\")
         page.get_by_role(\"button\", name=\"Start here\").click()
         ```
 
+        Handler takes the original locator as an argument. You can also automatically remove the handler after a number of
+        invocations by setting `times`:
+
+        ```py
+        def handler(locator):
+          locator.click()
+        page.add_locator_handler(page.get_by_label(\"Close\"), handler, times=1)
+        ```
+
         Parameters
         ----------
         locator : Locator
             Locator that triggers the handler.
-        handler : Callable
+        handler : Union[Callable[[Locator], Any], Callable[[], Any]]
             Function that should be run once `locator` appears. This function should get rid of the element that blocks actions
             like click.
+        no_wait_after : Union[bool, None]
+            By default, after calling the handler Playwright will wait until the overlay becomes hidden, and only then
+            Playwright will continue with the action/assertion that triggered the handler. This option allows to opt-out of
+            this behavior, so that overlay can stay visible after the handler has run.
+        times : Union[int, None]
+            Specifies the maximum number of times this handler should be called. Unlimited by default.
         """
 
         return mapping.from_maybe_impl(
             await self._impl_obj.add_locator_handler(
-                locator=locator._impl_obj, handler=self._wrap_handler(handler)
+                locator=locator._impl_obj,
+                handler=self._wrap_handler(handler),
+                noWaitAfter=no_wait_after,
+                times=times,
             )
         )
 
+    async def remove_locator_handler(self, locator: "Locator") -> None:
+        """Page.remove_locator_handler
+
+        Removes all locator handlers added by `page.add_locator_handler()` for a specific locator.
+
+        Parameters
+        ----------
+        locator : Locator
+            Locator passed to `page.add_locator_handler()`.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.remove_locator_handler(locator=locator._impl_obj)
+        )
+
 
 mapping.register(PageImpl, Page)
 
@@ -11907,7 +11978,9 @@ def on(
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
         popup with `window.open('http://example.com')`, this event will fire when the network request to
-        \"http://example.com\" is done and its response has started loading in the popup.
+        \"http://example.com\" is done and its response has started loading in the popup. If you would like to route/listen
+        to this network request, use `browser_context.route()` and `browser_context.on('request')` respectively
+        instead of similar methods on the `Page`.
 
         ```py
         async with context.expect_page() as page_info:
@@ -12085,7 +12158,9 @@ def once(
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
         popup with `window.open('http://example.com')`, this event will fire when the network request to
-        \"http://example.com\" is done and its response has started loading in the popup.
+        \"http://example.com\" is done and its response has started loading in the popup. If you would like to route/listen
+        to this network request, use `browser_context.route()` and `browser_context.on('request')` respectively
+        instead of similar methods on the `Page`.
 
         ```py
         async with context.expect_page() as page_info:
@@ -14734,7 +14809,7 @@ async def click(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -14780,9 +14855,10 @@ async def click(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -14824,7 +14900,7 @@ async def dblclick(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -14856,9 +14932,10 @@ async def dblclick(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -16085,7 +16162,7 @@ async def hover(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -16118,9 +16195,10 @@ async def hover(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -16419,7 +16497,8 @@ async def press(
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -16762,7 +16841,7 @@ async def tap(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -16791,9 +16870,10 @@ async def tap(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -17345,9 +17425,7 @@ async def delete(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17423,9 +17501,7 @@ async def head(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17513,9 +17589,7 @@ async def get(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17591,9 +17665,7 @@ async def patch(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17669,9 +17741,7 @@ async def put(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17744,11 +17814,11 @@ async def post(
         files):
 
         The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
-        encoding. You can achieve that with Playwright API like this:
+        encoding. Use `FormData` to construct request body and pass it to the request as `multipart` parameter:
 
         ```python
         api_request_context.post(
-          \"https://example.com/api/uploadScrip'\",
+          \"https://example.com/api/uploadScript'\",
           multipart={
             \"fileField\": {
               \"name\": \"f.js\",
@@ -17778,9 +17848,7 @@ async def post(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17834,11 +17902,12 @@ async def fetch(
         """APIRequestContext.fetch
 
         Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and
-        update context cookies from the response. The method will automatically follow redirects. JSON objects can be
-        passed directly to the request.
+        update context cookies from the response. The method will automatically follow redirects.
 
         **Usage**
 
+        JSON objects can be passed directly to the request:
+
         ```python
         data = {
             \"title\": \"Book Title\",
@@ -17847,8 +17916,8 @@ async def fetch(
         api_request_context.fetch(\"https://example.com/api/createBook\", method=\"post\", data=data)
         ```
 
-        The common way to send file(s) in the body of a request is to encode it as form fields with `multipart/form-data`
-        encoding. You can achieve that with Playwright API like this:
+        The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
+        encoding. Use `FormData` to construct request body and pass it to the request as `multipart` parameter:
 
         Parameters
         ----------
@@ -17873,9 +17942,7 @@ async def fetch(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -18070,7 +18137,8 @@ async def to_have_url(
         self,
         url_or_reg_exp: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
+        ignore_case: typing.Optional[bool] = None
     ) -> None:
         """PageAssertions.to_have_url
 
@@ -18092,12 +18160,15 @@ async def to_have_url(
             Expected URL string or RegExp.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
         """
         __tracebackhide__ = True
 
         return mapping.from_maybe_impl(
             await self._impl_obj.to_have_url(
-                urlOrRegExp=url_or_reg_exp, timeout=timeout
+                urlOrRegExp=url_or_reg_exp, timeout=timeout, ignoreCase=ignore_case
             )
         )
 
@@ -18105,7 +18176,8 @@ async def not_to_have_url(
         self,
         url_or_reg_exp: typing.Union[typing.Pattern[str], str],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
+        ignore_case: typing.Optional[bool] = None
     ) -> None:
         """PageAssertions.not_to_have_url
 
@@ -18117,12 +18189,15 @@ async def not_to_have_url(
             Expected URL string or RegExp.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
         """
         __tracebackhide__ = True
 
         return mapping.from_maybe_impl(
             await self._impl_obj.not_to_have_url(
-                urlOrRegExp=url_or_reg_exp, timeout=timeout
+                urlOrRegExp=url_or_reg_exp, timeout=timeout, ignoreCase=ignore_case
             )
         )
 
@@ -19420,6 +19495,360 @@ async def not_to_be_in_viewport(
             await self._impl_obj.not_to_be_in_viewport(ratio=ratio, timeout=timeout)
         )
 
+    async def to_have_accessible_description(
+        self,
+        description: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_have_accessible_description
+
+        Ensures the `Locator` points to an element with a given
+        [accessible description](https://w3c.github.io/accname/#dfn-accessible-description).
+
+        **Usage**
+
+        ```py
+        locator = page.get_by_test_id(\"save-button\")
+        await expect(locator).to_have_accessible_description(\"Save results to disk\")
+        ```
+
+        Parameters
+        ----------
+        description : Union[Pattern[str], str]
+            Expected accessible description.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.to_have_accessible_description(
+                description=description, ignoreCase=ignore_case, timeout=timeout
+            )
+        )
+
+    async def not_to_have_accessible_description(
+        self,
+        name: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_have_accessible_description
+
+        The opposite of `locator_assertions.to_have_accessible_description()`.
+
+        Parameters
+        ----------
+        name : Union[Pattern[str], str]
+            Expected accessible description.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.not_to_have_accessible_description(
+                name=name, ignoreCase=ignore_case, timeout=timeout
+            )
+        )
+
+    async def to_have_accessible_name(
+        self,
+        name: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_have_accessible_name
+
+        Ensures the `Locator` points to an element with a given
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+        **Usage**
+
+        ```py
+        locator = page.get_by_test_id(\"save-button\")
+        await expect(locator).to_have_accessible_name(\"Save to disk\")
+        ```
+
+        Parameters
+        ----------
+        name : Union[Pattern[str], str]
+            Expected accessible name.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.to_have_accessible_name(
+                name=name, ignoreCase=ignore_case, timeout=timeout
+            )
+        )
+
+    async def not_to_have_accessible_name(
+        self,
+        name: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_have_accessible_name
+
+        The opposite of `locator_assertions.to_have_accessible_name()`.
+
+        Parameters
+        ----------
+        name : Union[Pattern[str], str]
+            Expected accessible name.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.not_to_have_accessible_name(
+                name=name, ignoreCase=ignore_case, timeout=timeout
+            )
+        )
+
+    async def to_have_role(
+        self,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeitem",
+        ],
+        *,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_have_role
+
+        Ensures the `Locator` points to an element with a given [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles).
+
+        Note that role is matched as a string, disregarding the ARIA role hierarchy. For example, asserting  a superclass
+        role `\"checkbox\"` on an element with a subclass role `\"switch\"` will fail.
+
+        **Usage**
+
+        ```py
+        locator = page.get_by_test_id(\"save-button\")
+        await expect(locator).to_have_role(\"button\")
+        ```
+
+        Parameters
+        ----------
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
+            Required aria role.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.to_have_role(role=role, timeout=timeout)
+        )
+
+    async def not_to_have_role(
+        self,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeitem",
+        ],
+        *,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_have_role
+
+        The opposite of `locator_assertions.to_have_role()`.
+
+        Parameters
+        ----------
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
+            Required aria role.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.not_to_have_role(role=role, timeout=timeout)
+        )
+
 
 mapping.register(LocatorAssertionsImpl, LocatorAssertions)
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 6c1fe5fbb..b5076c9be 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -1136,7 +1136,8 @@ def down(self, key: str) -> None:
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -1244,7 +1245,8 @@ def press(self, key: str, *, delay: typing.Optional[float] = None) -> None:
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -1854,7 +1856,7 @@ def hover(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -1877,9 +1879,10 @@ def hover(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -1914,7 +1917,7 @@ def click(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -1940,9 +1943,10 @@ def click(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -1986,7 +1990,7 @@ def dblclick(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -2014,9 +2018,10 @@ def dblclick(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -2136,7 +2141,7 @@ def tap(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -2161,9 +2166,10 @@ def tap(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -2403,7 +2409,8 @@ def press(
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -3375,6 +3382,9 @@ def wait_for_load_state(
         committed when this method is called. If current document has already reached the required state, resolves
         immediately.
 
+        **NOTE** Most of the time, this method is not needed because Playwright
+        [auto-waits before every action](https://playwright.dev/python/docs/actionability).
+
         **Usage**
 
         ```py
@@ -4198,7 +4208,7 @@ def click(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -4228,9 +4238,10 @@ def click(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -4280,7 +4291,7 @@ def dblclick(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -4312,9 +4323,10 @@ def dblclick(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -4361,7 +4373,7 @@ def tap(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -4390,9 +4402,10 @@ def tap(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -5217,7 +5230,7 @@ def hover(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -5244,9 +5257,10 @@ def hover(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -5601,7 +5615,8 @@ def press(
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -7184,7 +7199,9 @@ def on(self, event: Literal["popup"], f: typing.Callable[["Page"], "None"]) -> N
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
         popup with `window.open('http://example.com')`, this event will fire when the network request to
-        \"http://example.com\" is done and its response has started loading in the popup.
+        \"http://example.com\" is done and its response has started loading in the popup. If you would like to route/listen
+        to this network request, use `browser_context.route()` and `browser_context.on('request')` respectively
+        instead of similar methods on the `Page`.
 
         ```py
         with page.expect_event(\"popup\") as page_info:
@@ -7404,7 +7421,9 @@ def once(
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
         popup with `window.open('http://example.com')`, this event will fire when the network request to
-        \"http://example.com\" is done and its response has started loading in the popup.
+        \"http://example.com\" is done and its response has started loading in the popup. If you would like to route/listen
+        to this network request, use `browser_context.route()` and `browser_context.on('request')` respectively
+        instead of similar methods on the `Page`.
 
         ```py
         with page.expect_event(\"popup\") as page_info:
@@ -8726,6 +8745,9 @@ def wait_for_load_state(
         committed when this method is called. If current document has already reached the required state, resolves
         immediately.
 
+        **NOTE** Most of the time, this method is not needed because Playwright
+        [auto-waits before every action](https://playwright.dev/python/docs/actionability).
+
         **Usage**
 
         ```py
@@ -9103,6 +9125,9 @@ def route(
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
         using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
 
+        **NOTE** `page.route()` will not intercept the first request of a popup page. Use
+        `browser_context.route()` instead.
+
         **Usage**
 
         An example of a naive handler that aborts all image requests:
@@ -9429,7 +9454,7 @@ def click(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -9459,9 +9484,10 @@ def click(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -9511,7 +9537,7 @@ def dblclick(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -9543,9 +9569,10 @@ def dblclick(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -9592,7 +9619,7 @@ def tap(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -9621,9 +9648,10 @@ def tap(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -10446,7 +10474,7 @@ def hover(
         selector: str,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -10473,9 +10501,10 @@ def hover(
         selector : str
             A selector to search for an element. If there are multiple elements satisfying the selector, the first will be
             used.
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -10849,7 +10878,8 @@ def press(
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -11775,11 +11805,18 @@ def set_checked(
             )
         )
 
-    def add_locator_handler(self, locator: "Locator", handler: typing.Callable) -> None:
+    def add_locator_handler(
+        self,
+        locator: "Locator",
+        handler: typing.Union[
+            typing.Callable[["Locator"], typing.Any], typing.Callable[[], typing.Any]
+        ],
+        *,
+        no_wait_after: typing.Optional[bool] = None,
+        times: typing.Optional[int] = None
+    ) -> None:
         """Page.add_locator_handler
 
-        **NOTE** This method is experimental and its behavior may change in the upcoming releases.
-
         When testing a web page, sometimes unexpected overlays like a \"Sign up\" dialog appear and block actions you want to
         automate, e.g. clicking a button. These overlays don't always show up in the same way or at the same time, making
         them tricky to handle in automated tests.
@@ -11795,6 +11832,8 @@ def add_locator_handler(self, locator: "Locator", handler: typing.Callable) -> N
           is visible, Playwright calls the handler first, and then proceeds with the action/assertion. Note that the
           handler is only called when you perform an action/assertion - if the overlay becomes visible but you don't
           perform any actions, the handler will not be triggered.
+        - After executing the handler, Playwright will ensure that overlay that triggered the handler is not visible
+          anymore. You can opt-out of this behavior with `noWaitAfter`.
         - The execution time of the handler counts towards the timeout of the action/assertion that executed the handler.
           If your handler takes too long, it might cause timeouts.
         - You can register multiple handlers. However, only a single handler will be running at a time. Make sure the
@@ -11839,36 +11878,70 @@ def handler():
         ```
 
         An example with a custom callback on every actionability check. It uses a `<body>` locator that is always visible,
-        so the handler is called before every actionability check:
+        so the handler is called before every actionability check. It is important to specify `noWaitAfter`, because the
+        handler does not hide the `<body>` element.
 
         ```py
         # Setup the handler.
         def handler():
           await page.evaluate(\"window.removeObstructionsForTestIfNeeded()\")
-        await page.add_locator_handler(page.locator(\"body\"), handler)
+        await page.add_locator_handler(page.locator(\"body\"), handler, no_wait_after=True)
 
         # Write the test as usual.
         await page.goto(\"https://example.com\")
         await page.get_by_role(\"button\", name=\"Start here\").click()
         ```
 
+        Handler takes the original locator as an argument. You can also automatically remove the handler after a number of
+        invocations by setting `times`:
+
+        ```py
+        def handler(locator):
+          await locator.click()
+        await page.add_locator_handler(page.get_by_label(\"Close\"), handler, times=1)
+        ```
+
         Parameters
         ----------
         locator : Locator
             Locator that triggers the handler.
-        handler : Callable
+        handler : Union[Callable[[Locator], Any], Callable[[], Any]]
             Function that should be run once `locator` appears. This function should get rid of the element that blocks actions
             like click.
+        no_wait_after : Union[bool, None]
+            By default, after calling the handler Playwright will wait until the overlay becomes hidden, and only then
+            Playwright will continue with the action/assertion that triggered the handler. This option allows to opt-out of
+            this behavior, so that overlay can stay visible after the handler has run.
+        times : Union[int, None]
+            Specifies the maximum number of times this handler should be called. Unlimited by default.
         """
 
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.add_locator_handler(
-                    locator=locator._impl_obj, handler=self._wrap_handler(handler)
+                    locator=locator._impl_obj,
+                    handler=self._wrap_handler(handler),
+                    noWaitAfter=no_wait_after,
+                    times=times,
                 )
             )
         )
 
+    def remove_locator_handler(self, locator: "Locator") -> None:
+        """Page.remove_locator_handler
+
+        Removes all locator handlers added by `page.add_locator_handler()` for a specific locator.
+
+        Parameters
+        ----------
+        locator : Locator
+            Locator passed to `page.add_locator_handler()`.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.remove_locator_handler(locator=locator._impl_obj))
+        )
+
 
 mapping.register(PageImpl, Page)
 
@@ -11974,7 +12047,9 @@ def on(self, event: Literal["page"], f: typing.Callable[["Page"], "None"]) -> No
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
         popup with `window.open('http://example.com')`, this event will fire when the network request to
-        \"http://example.com\" is done and its response has started loading in the popup.
+        \"http://example.com\" is done and its response has started loading in the popup. If you would like to route/listen
+        to this network request, use `browser_context.route()` and `browser_context.on('request')` respectively
+        instead of similar methods on the `Page`.
 
         ```py
         with context.expect_page() as page_info:
@@ -12120,7 +12195,9 @@ def once(
 
         The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
         popup with `window.open('http://example.com')`, this event will fire when the network request to
-        \"http://example.com\" is done and its response has started loading in the popup.
+        \"http://example.com\" is done and its response has started loading in the popup. If you would like to route/listen
+        to this network request, use `browser_context.route()` and `browser_context.on('request')` respectively
+        instead of similar methods on the `Page`.
 
         ```py
         with context.expect_page() as page_info:
@@ -14775,7 +14852,7 @@ def click(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -14821,9 +14898,10 @@ def click(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -14867,7 +14945,7 @@ def dblclick(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         delay: typing.Optional[float] = None,
@@ -14899,9 +14977,10 @@ def dblclick(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -16147,7 +16226,7 @@ def hover(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -16180,9 +16259,10 @@ def hover(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -16495,7 +16575,8 @@ def press(
         `Delete`, `Escape`, `ArrowDown`, `End`, `Enter`, `Home`, `Insert`, `PageDown`, `PageUp`, `ArrowRight`, `ArrowUp`,
         etc.
 
-        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`.
+        Following modification shortcuts are also supported: `Shift`, `Control`, `Alt`, `Meta`, `ShiftLeft`,
+        `ControlOrMeta`. `ControlOrMeta` resolves to `Control` on Windows and Linux and to `Meta` on macOS.
 
         Holding down `Shift` will type the text that corresponds to the `key` in the upper case.
 
@@ -16848,7 +16929,7 @@ def tap(
         self,
         *,
         modifiers: typing.Optional[
-            typing.Sequence[Literal["Alt", "Control", "Meta", "Shift"]]
+            typing.Sequence[Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]]
         ] = None,
         position: typing.Optional[Position] = None,
         timeout: typing.Optional[float] = None,
@@ -16877,9 +16958,10 @@ def tap(
 
         Parameters
         ----------
-        modifiers : Union[Sequence[Union["Alt", "Control", "Meta", "Shift"]], None]
+        modifiers : Union[Sequence[Union["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]], None]
             Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores
-            current modifiers back. If not specified, currently pressed modifiers are used.
+            current modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to
+            "Control" on Windows and Linux and to "Meta" on macOS.
         position : Union[{x: float, y: float}, None]
             A point to use relative to the top-left corner of element padding box. If not specified, uses some visible point of
             the element.
@@ -17441,9 +17523,7 @@ def delete(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17521,9 +17601,7 @@ def head(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17613,9 +17691,7 @@ def get(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17693,9 +17769,7 @@ def patch(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17773,9 +17847,7 @@ def put(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17850,11 +17922,11 @@ def post(
         ```
 
         The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
-        encoding. You can achieve that with Playwright API like this:
+        encoding. Use `FormData` to construct request body and pass it to the request as `multipart` parameter:
 
         ```python
         api_request_context.post(
-          \"https://example.com/api/uploadScrip'\",
+          \"https://example.com/api/uploadScript'\",
           multipart={
             \"fileField\": {
               \"name\": \"f.js\",
@@ -17884,9 +17956,7 @@ def post(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -17942,18 +18012,18 @@ def fetch(
         """APIRequestContext.fetch
 
         Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and
-        update context cookies from the response. The method will automatically follow redirects. JSON objects can be
-        passed directly to the request.
+        update context cookies from the response. The method will automatically follow redirects.
 
         **Usage**
 
-        The common way to send file(s) in the body of a request is to encode it as form fields with `multipart/form-data`
-        encoding. You can achieve that with Playwright API like this:
+        JSON objects can be passed directly to the request:
+
+        The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
+        encoding. Use `FormData` to construct request body and pass it to the request as `multipart` parameter:
 
         ```python
         api_request_context.fetch(
-          \"https://example.com/api/uploadScrip'\",
-          method=\"post\",
+          \"https://example.com/api/uploadScript\",  method=\"post\",
           multipart={
             \"fileField\": {
               \"name\": \"f.js\",
@@ -17986,9 +18056,7 @@ def fetch(
         multipart : Union[Dict[str, Union[bool, bytes, float, str, {name: str, mimeType: str, buffer: bytes}]], None]
             Provides an object that will be serialized as html form using `multipart/form-data` encoding and sent as this
             request body. If this parameter is specified `content-type` header will be set to `multipart/form-data` unless
-            explicitly provided. File values can be passed either as
-            [`fs.ReadStream`](https://nodejs.org/api/fs.html#fs_class_fs_readstream) or as file-like object containing file
-            name, mime-type and its content.
+            explicitly provided. File values can be passed as file-like object containing file name, mime-type and its content.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
         fail_on_status_code : Union[bool, None]
@@ -18191,7 +18259,8 @@ def to_have_url(
         self,
         url_or_reg_exp: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
+        ignore_case: typing.Optional[bool] = None
     ) -> None:
         """PageAssertions.to_have_url
 
@@ -18213,12 +18282,17 @@ def to_have_url(
             Expected URL string or RegExp.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
         """
         __tracebackhide__ = True
 
         return mapping.from_maybe_impl(
             self._sync(
-                self._impl_obj.to_have_url(urlOrRegExp=url_or_reg_exp, timeout=timeout)
+                self._impl_obj.to_have_url(
+                    urlOrRegExp=url_or_reg_exp, timeout=timeout, ignoreCase=ignore_case
+                )
             )
         )
 
@@ -18226,7 +18300,8 @@ def not_to_have_url(
         self,
         url_or_reg_exp: typing.Union[typing.Pattern[str], str],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
+        ignore_case: typing.Optional[bool] = None
     ) -> None:
         """PageAssertions.not_to_have_url
 
@@ -18238,13 +18313,16 @@ def not_to_have_url(
             Expected URL string or RegExp.
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
         """
         __tracebackhide__ = True
 
         return mapping.from_maybe_impl(
             self._sync(
                 self._impl_obj.not_to_have_url(
-                    urlOrRegExp=url_or_reg_exp, timeout=timeout
+                    urlOrRegExp=url_or_reg_exp, timeout=timeout, ignoreCase=ignore_case
                 )
             )
         )
@@ -19577,6 +19655,368 @@ def not_to_be_in_viewport(
             )
         )
 
+    def to_have_accessible_description(
+        self,
+        description: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_have_accessible_description
+
+        Ensures the `Locator` points to an element with a given
+        [accessible description](https://w3c.github.io/accname/#dfn-accessible-description).
+
+        **Usage**
+
+        ```py
+        locator = page.get_by_test_id(\"save-button\")
+        expect(locator).to_have_accessible_description(\"Save results to disk\")
+        ```
+
+        Parameters
+        ----------
+        description : Union[Pattern[str], str]
+            Expected accessible description.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.to_have_accessible_description(
+                    description=description, ignoreCase=ignore_case, timeout=timeout
+                )
+            )
+        )
+
+    def not_to_have_accessible_description(
+        self,
+        name: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_have_accessible_description
+
+        The opposite of `locator_assertions.to_have_accessible_description()`.
+
+        Parameters
+        ----------
+        name : Union[Pattern[str], str]
+            Expected accessible description.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.not_to_have_accessible_description(
+                    name=name, ignoreCase=ignore_case, timeout=timeout
+                )
+            )
+        )
+
+    def to_have_accessible_name(
+        self,
+        name: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_have_accessible_name
+
+        Ensures the `Locator` points to an element with a given
+        [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
+
+        **Usage**
+
+        ```py
+        locator = page.get_by_test_id(\"save-button\")
+        expect(locator).to_have_accessible_name(\"Save to disk\")
+        ```
+
+        Parameters
+        ----------
+        name : Union[Pattern[str], str]
+            Expected accessible name.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.to_have_accessible_name(
+                    name=name, ignoreCase=ignore_case, timeout=timeout
+                )
+            )
+        )
+
+    def not_to_have_accessible_name(
+        self,
+        name: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_have_accessible_name
+
+        The opposite of `locator_assertions.to_have_accessible_name()`.
+
+        Parameters
+        ----------
+        name : Union[Pattern[str], str]
+            Expected accessible name.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.not_to_have_accessible_name(
+                    name=name, ignoreCase=ignore_case, timeout=timeout
+                )
+            )
+        )
+
+    def to_have_role(
+        self,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeitem",
+        ],
+        *,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_have_role
+
+        Ensures the `Locator` points to an element with a given [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles).
+
+        Note that role is matched as a string, disregarding the ARIA role hierarchy. For example, asserting  a superclass
+        role `\"checkbox\"` on an element with a subclass role `\"switch\"` will fail.
+
+        **Usage**
+
+        ```py
+        locator = page.get_by_test_id(\"save-button\")
+        expect(locator).to_have_role(\"button\")
+        ```
+
+        Parameters
+        ----------
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
+            Required aria role.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.to_have_role(role=role, timeout=timeout))
+        )
+
+    def not_to_have_role(
+        self,
+        role: Literal[
+            "alert",
+            "alertdialog",
+            "application",
+            "article",
+            "banner",
+            "blockquote",
+            "button",
+            "caption",
+            "cell",
+            "checkbox",
+            "code",
+            "columnheader",
+            "combobox",
+            "complementary",
+            "contentinfo",
+            "definition",
+            "deletion",
+            "dialog",
+            "directory",
+            "document",
+            "emphasis",
+            "feed",
+            "figure",
+            "form",
+            "generic",
+            "grid",
+            "gridcell",
+            "group",
+            "heading",
+            "img",
+            "insertion",
+            "link",
+            "list",
+            "listbox",
+            "listitem",
+            "log",
+            "main",
+            "marquee",
+            "math",
+            "menu",
+            "menubar",
+            "menuitem",
+            "menuitemcheckbox",
+            "menuitemradio",
+            "meter",
+            "navigation",
+            "none",
+            "note",
+            "option",
+            "paragraph",
+            "presentation",
+            "progressbar",
+            "radio",
+            "radiogroup",
+            "region",
+            "row",
+            "rowgroup",
+            "rowheader",
+            "scrollbar",
+            "search",
+            "searchbox",
+            "separator",
+            "slider",
+            "spinbutton",
+            "status",
+            "strong",
+            "subscript",
+            "superscript",
+            "switch",
+            "tab",
+            "table",
+            "tablist",
+            "tabpanel",
+            "term",
+            "textbox",
+            "time",
+            "timer",
+            "toolbar",
+            "tooltip",
+            "tree",
+            "treegrid",
+            "treeitem",
+        ],
+        *,
+        timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_have_role
+
+        The opposite of `locator_assertions.to_have_role()`.
+
+        Parameters
+        ----------
+        role : Union["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "directory", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"]
+            Required aria role.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.not_to_have_role(role=role, timeout=timeout))
+        )
+
 
 mapping.register(LocatorAssertionsImpl, LocatorAssertions)
 
diff --git a/scripts/expected_api_mismatch.txt b/scripts/expected_api_mismatch.txt
index 47c084c61..c101bba16 100644
--- a/scripts/expected_api_mismatch.txt
+++ b/scripts/expected_api_mismatch.txt
@@ -12,3 +12,6 @@ Parameter type mismatch in BrowserContext.route(handler=): documented as Callabl
 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]
 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]]
 Parameter type mismatch in Page.unroute(handler=): documented as Union[Callable[[Route, Request], Union[Any, Any]], None], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
+
+# One vs two arguments in the callback, Python explicitly unions.
+Parameter type mismatch in Page.add_locator_handler(handler=): documented as Callable[[Locator], Any], code has Union[Callable[[Locator], Any], Callable[[], Any]]
diff --git a/setup.py b/setup.py
index 29cc21951..d65dc81a1 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.43.0"
+driver_version = "1.44.0-beta-1715189091000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/assets/input/handle-locator.html b/tests/assets/input/handle-locator.html
index 865fb5364..f8f2111c9 100644
--- a/tests/assets/input/handle-locator.html
+++ b/tests/assets/input/handle-locator.html
@@ -50,9 +50,16 @@
       }, false);
 
       close.addEventListener('click', () => {
-        interstitial.classList.remove('visible');
-        target.classList.remove('hidden');
-        target.classList.remove('removed');
+        const closeInterstitial = () => {
+          interstitial.classList.remove('visible');
+          target.classList.remove('hidden');
+          target.classList.remove('removed');
+        };
+
+        if (interstitial.classList.contains('timeout'))
+          setTimeout(closeInterstitial, 3000);
+        else
+          closeInterstitial();
       });
 
       let timesToShow = 0;
@@ -65,9 +72,11 @@
           if (!timesToShow && event !== 'none')
             target.removeEventListener(event, listener, capture === 'capture');
         };
-        if (event === 'hide') {
+        if (event === 'hide' || event === 'timeout') {
           target.classList.add('hidden');
           listener();
+          if (event === 'timeout')
+            interstitial.classList.add('timeout');
         } else if (event === 'remove') {
           target.classList.add('removed');
           listener();
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index b8936f4bf..d61e625c7 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -84,6 +84,11 @@ async def test_assertions_page_to_have_url_with_base_url(
     await page.close()
 
 
+async def test_assertions_page_to_have_url_support_ignore_case(page: Page) -> None:
+    await page.goto("data:text/html,<div>A</div>")
+    await expect(page).to_have_url("DATA:teXT/HTml,<div>a</div>", ignore_case=True)
+
+
 async def test_assertions_locator_to_contain_text(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content("<div id=foobar>kek</div>")
@@ -828,3 +833,38 @@ async def test_should_be_able_to_set_custom_global_timeout(page: Page) -> None:
         )
     finally:
         expect.set_options(timeout=None)
+
+
+async def test_to_have_accessible_name(page: Page) -> None:
+    await page.set_content('<div role="button" aria-label="Hello"></div>')
+    locator = page.locator("div")
+    await expect(locator).to_have_accessible_name("Hello")
+    await expect(locator).not_to_have_accessible_name("hello")
+    await expect(locator).to_have_accessible_name("hello", ignore_case=True)
+    await expect(locator).to_have_accessible_name(re.compile(r"ell\w"))
+    await expect(locator).not_to_have_accessible_name(re.compile(r"hello"))
+    await expect(locator).to_have_accessible_name(
+        re.compile(r"hello"), ignore_case=True
+    )
+
+
+async def test_to_have_accessible_description(page: Page) -> None:
+    await page.set_content('<div role="button" aria-description="Hello"></div>')
+    locator = page.locator("div")
+    await expect(locator).to_have_accessible_description("Hello")
+    await expect(locator).not_to_have_accessible_description("hello")
+    await expect(locator).to_have_accessible_description("hello", ignore_case=True)
+    await expect(locator).to_have_accessible_description(re.compile(r"ell\w"))
+    await expect(locator).not_to_have_accessible_description(re.compile(r"hello"))
+    await expect(locator).to_have_accessible_description(
+        re.compile(r"hello"), ignore_case=True
+    )
+
+
+async def test_to_have_role(page: Page) -> None:
+    await page.set_content('<div role="button">Button!</div>')
+    await expect(page.locator("div")).to_have_role("button")
+    await expect(page.locator("div")).not_to_have_role("checkbox")
+    with pytest.raises(Error) as excinfo:
+        await expect(page.locator("div")).to_have_role(re.compile(r"button|checkbox"))  # type: ignore
+    assert '"role" argument in to_have_role must be a string' in str(excinfo.value)
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index 877524b92..af4516f87 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -774,7 +774,7 @@ async def test_page_event_should_work_with_shift_clicking(
 
 @pytest.mark.only_browser("chromium")
 async def test_page_event_should_work_with_ctrl_clicking(
-    context: BrowserContext, server: Server, is_mac: bool
+    context: BrowserContext, server: Server
 ) -> None:
     # Firefox: reports an opener in this case.
     # WebKit: Ctrl+Click does not open a new tab.
@@ -782,7 +782,7 @@ async def test_page_event_should_work_with_ctrl_clicking(
     await page.goto(server.EMPTY_PAGE)
     await page.set_content('<a href="/one-style.html">yo</a>')
     async with context.expect_page() as popup_info:
-        await page.click("a", modifiers=["Meta" if is_mac else "Control"])
+        await page.click("a", modifiers=["ControlOrMeta"])
     popup = await popup_info.value
     assert await popup.opener() is None
 
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index 34bf42245..7233c084f 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -23,10 +23,24 @@
 
 from playwright.async_api import BrowserType, Error, Playwright, Route
 from tests.conftest import RemoteServer
-from tests.server import Server, TestServerRequest
+from tests.server import Server, TestServerRequest, WebSocketProtocol
 from tests.utils import parse_trace
 
 
+async def test_should_print_custom_ws_close_error(
+    server: Server, browser_type: BrowserType
+) -> None:
+    def _handle_ws(ws: WebSocketProtocol) -> None:
+        def _onMessage(payload: bytes, isBinary: bool) -> None:
+            ws.sendClose(code=4123, reason="Oh my!")
+
+        setattr(ws, "onMessage", _onMessage)
+
+    server.once_web_socket_connection(_handle_ws)
+    with pytest.raises(Error, match="Oh my!"):
+        await browser_type.connect(f"ws://localhost:{server.PORT}/ws")
+
+
 async def test_browser_type_connect_should_be_able_to_reconnect_to_a_browser(
     server: Server, browser_type: BrowserType, launch_server: Callable[[], RemoteServer]
 ) -> None:
diff --git a/tests/async/test_browsertype_connect_cdp.py b/tests/async/test_browsertype_connect_cdp.py
index de3d96e77..251781546 100644
--- a/tests/async/test_browsertype_connect_cdp.py
+++ b/tests/async/test_browsertype_connect_cdp.py
@@ -19,7 +19,7 @@
 import requests
 
 from playwright.async_api import BrowserType, Error
-from tests.server import Server, find_free_port
+from tests.server import Server, WebSocketProtocol, find_free_port
 
 pytestmark = pytest.mark.only_browser("chromium")
 
@@ -92,9 +92,26 @@ async def test_conect_over_a_ws_endpoint(
 async def test_connect_over_cdp_passing_header_works(
     browser_type: BrowserType, server: Server
 ) -> None:
+    server.send_on_web_socket_connection(b"incoming")
     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"}
         )
     assert (await request).getHeader("foo") == "bar"
+
+
+async def test_should_print_custom_ws_close_error(
+    browser_type: BrowserType, server: Server
+) -> None:
+    def _handle_ws(ws: WebSocketProtocol) -> None:
+        def _onMessage(payload: bytes, isBinary: bool) -> None:
+            ws.sendClose(code=4123, reason="Oh my!")
+
+        setattr(ws, "onMessage", _onMessage)
+
+    server.once_web_socket_connection(_handle_ws)
+    with pytest.raises(Error, match="Browser logs:\n\nOh my!\n"):
+        await browser_type.connect_over_cdp(
+            f"ws://127.0.0.1:{server.PORT}/ws", headers={"foo": "bar"}
+        )
diff --git a/tests/async/test_keyboard.py b/tests/async/test_keyboard.py
index 3a449ffe7..d94f036e7 100644
--- a/tests/async/test_keyboard.py
+++ b/tests/async/test_keyboard.py
@@ -459,24 +459,19 @@ async def test_should_type_emoji_into_an_iframe(
     )
 
 
-async def test_should_handle_select_all(
-    page: Page, server: Server, is_mac: bool
-) -> None:
+async def test_should_handle_select_all(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
     assert textarea
     await textarea.type("some text")
-    modifier = "Meta" if is_mac else "Control"
-    await page.keyboard.down(modifier)
+    await page.keyboard.down("ControlOrMeta")
     await page.keyboard.press("a")
-    await page.keyboard.up(modifier)
+    await page.keyboard.up("ControlOrMeta")
     await page.keyboard.press("Backspace")
     assert await page.eval_on_selector("textarea", "textarea => textarea.value") == ""
 
 
-async def test_should_be_able_to_prevent_select_all(
-    page: Page, server: Server, is_mac: bool
-) -> None:
+async def test_should_be_able_to_prevent_select_all(page: Page, server: Server) -> None:
     await page.goto(server.PREFIX + "/input/textarea.html")
     textarea = await page.query_selector("textarea")
     assert textarea
@@ -491,10 +486,9 @@ async def test_should_be_able_to_prevent_select_all(
   }""",
     )
 
-    modifier = "Meta" if is_mac else "Control"
-    await page.keyboard.down(modifier)
+    await page.keyboard.down("ControlOrMeta")
     await page.keyboard.press("a")
-    await page.keyboard.up(modifier)
+    await page.keyboard.up("ControlOrMeta")
     await page.keyboard.press("Backspace")
     assert (
         await page.eval_on_selector("textarea", "textarea => textarea.value")
diff --git a/tests/async/test_page_add_locator_handler.py b/tests/async/test_page_add_locator_handler.py
index 8eb08c59d..4492037a7 100644
--- a/tests/async/test_page_add_locator_handler.py
+++ b/tests/async/test_page_add_locator_handler.py
@@ -16,7 +16,7 @@
 
 import pytest
 
-from playwright.async_api import Error, Page, expect
+from playwright.async_api import Error, Locator, Page, expect
 from tests.server import Server
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
@@ -27,16 +27,18 @@ async def test_should_work(page: Page, server: Server) -> None:
     before_count = 0
     after_count = 0
 
-    async def handler() -> None:
+    original_locator = page.get_by_text("This interstitial covers the button")
+
+    async def handler(locator: Locator) -> None:
+        nonlocal original_locator
+        assert locator == original_locator
         nonlocal before_count
         nonlocal after_count
         before_count += 1
         await page.locator("#close").click()
         after_count += 1
 
-    await page.add_locator_handler(
-        page.locator("text=This interstitial covers the button"), handler
-    )
+    await page.add_locator_handler(original_locator, handler)
 
     for args in [
         ["mouseover", 1],
@@ -72,7 +74,7 @@ async def handler() -> None:
         if await page.get_by_text("This interstitial covers the button").is_visible():
             await page.locator("#close").click()
 
-    await page.add_locator_handler(page.locator("body"), handler)
+    await page.add_locator_handler(page.locator("body"), handler, no_wait_after=True)
 
     for args in [
         ["mouseover", 2],
@@ -196,3 +198,192 @@ async def handler() -> None:
     await expect(page.locator("#target")).to_be_visible()
     await expect(page.locator("#interstitial")).not_to_be_visible()
     assert called == 1
+
+
+async def test_should_work_when_owner_frame_detaches(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.evaluate(
+        """
+    () => {
+        const iframe = document.createElement('iframe');
+        iframe.src = 'data:text/html,<body>hello from iframe</body>';
+        document.body.append(iframe);
+
+        const target = document.createElement('button');
+        target.textContent = 'Click me';
+        target.id = 'target';
+        target.addEventListener('click', () => window._clicked = true);
+        document.body.appendChild(target);
+
+        const closeButton = document.createElement('button');
+        closeButton.textContent = 'close';
+        closeButton.id = 'close';
+        closeButton.addEventListener('click', () => iframe.remove());
+        document.body.appendChild(closeButton);
+    }
+    """
+    )
+    await page.add_locator_handler(
+        page.frame_locator("iframe").locator("body"),
+        lambda: page.locator("#close").click(),
+    )
+    await page.locator("#target").click()
+    assert await page.query_selector("iframe") is None
+    assert await page.evaluate("window._clicked") is True
+
+
+async def test_should_work_with_times_option(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+    called = 0
+
+    def _handler() -> None:
+        nonlocal called
+        called += 1
+
+    await page.add_locator_handler(
+        page.locator("body"), _handler, no_wait_after=True, times=2
+    )
+    await page.locator("#aside").hover()
+    await page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('mouseover', 4);
+    }
+    """
+    )
+    with pytest.raises(Error) as exc_info:
+        await page.locator("#target").click(timeout=3000)
+    assert called == 2
+    assert await page.evaluate("window.clicked") == 0
+    await expect(page.locator("#interstitial")).to_be_visible()
+    assert "Timeout 3000ms exceeded" in exc_info.value.message
+    assert (
+        '<div>This interstitial covers the button</div> from <div class="visible" id="interstitial">…</div> subtree intercepts pointer events'
+        in exc_info.value.message
+    )
+
+
+async def test_should_wait_for_hidden_by_default(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+    called = 0
+
+    async def _handler(button: Locator) -> None:
+        nonlocal called
+        called += 1
+        await button.click()
+
+    await page.add_locator_handler(page.get_by_role("button", name="close"), _handler)
+    await page.locator("#aside").hover()
+    await page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('timeout', 1);
+    }
+    """
+    )
+    await page.locator("#target").click()
+    assert await page.evaluate("window.clicked") == 1
+    await expect(page.locator("#interstitial")).not_to_be_visible()
+    assert called == 1
+
+
+async def test_should_wait_for_hidden_by_default_2(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+    called = 0
+
+    def _handler() -> None:
+        nonlocal called
+        called += 1
+
+    await page.add_locator_handler(page.get_by_role("button", name="close"), _handler)
+    await page.locator("#aside").hover()
+    await page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('hide', 1);
+    }
+    """
+    )
+    with pytest.raises(Error) as exc_info:
+        await page.locator("#target").click(timeout=3000)
+    assert await page.evaluate("window.clicked") == 0
+    await expect(page.locator("#interstitial")).to_be_visible()
+    assert called == 1
+    assert (
+        'locator handler has finished, waiting for get_by_role("button", name="close") to be hidden'
+        in exc_info.value.message
+    )
+
+
+async def test_should_work_with_noWaitAfter(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+    called = 0
+
+    async def _handler(button: Locator) -> None:
+        nonlocal called
+        called += 1
+        if called == 1:
+            await button.click()
+        else:
+            await page.locator("#interstitial").wait_for(state="hidden")
+
+    await page.add_locator_handler(
+        page.get_by_role("button", name="close"), _handler, no_wait_after=True
+    )
+    await page.locator("#aside").hover()
+    await page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('timeout', 1);
+    }
+    """
+    )
+    await page.locator("#target").click()
+    assert await page.evaluate("window.clicked") == 1
+    await expect(page.locator("#interstitial")).not_to_be_visible()
+    assert called == 2
+
+
+async def test_should_removeLocatorHandler(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/input/handle-locator.html")
+    called = 0
+
+    async def _handler(locator: Locator) -> None:
+        nonlocal called
+        called += 1
+        await locator.click()
+
+    await page.add_locator_handler(page.get_by_role("button", name="close"), _handler)
+    await page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('hide', 1);
+    }
+    """
+    )
+    await page.locator("#target").click()
+    assert called == 1
+    assert await page.evaluate("window.clicked") == 1
+    await expect(page.locator("#interstitial")).not_to_be_visible()
+    await page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('hide', 1);
+    }
+    """
+    )
+    await page.remove_locator_handler(page.get_by_role("button", name="close"))
+    with pytest.raises(Error) as error:
+        await page.locator("#target").click(timeout=3000)
+    assert called == 1
+    assert await page.evaluate("window.clicked") == 0
+    await expect(page.locator("#interstitial")).to_be_visible()
+    assert "Timeout 3000ms exceeded" in error.value.message
diff --git a/tests/async/test_websocket.py b/tests/async/test_websocket.py
index eb90f95d3..9b006f15d 100644
--- a/tests/async/test_websocket.py
+++ b/tests/async/test_websocket.py
@@ -19,11 +19,11 @@
 from flaky import flaky
 
 from playwright.async_api import Error, Page, WebSocket
-from tests.conftest import WebSocketServerServer
-from tests.server import Server
+from tests.server import Server, WebSocketProtocol
 
 
-async def test_should_work(page: Page, ws_server: WebSocketServerServer) -> None:
+async def test_should_work(page: Page, server: Server) -> None:
+    server.send_on_web_socket_connection(b"incoming")
     value = await page.evaluate(
         """port => {
         let cb;
@@ -32,39 +32,42 @@ async def test_should_work(page: Page, ws_server: WebSocketServerServer) -> None
         ws.addEventListener('message', data => { ws.close(); cb(data.data); });
         return result;
     }""",
-        ws_server.PORT,
+        server.PORT,
     )
     assert value == "incoming"
     pass
 
 
-async def test_should_emit_close_events(
-    page: Page, ws_server: WebSocketServerServer
-) -> None:
+async def test_should_emit_close_events(page: Page, server: Server) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    close_future: asyncio.Future[None] = asyncio.Future()
     async with page.expect_websocket() as ws_info:
         await page.evaluate(
             """port => {
-            let cb;
-            const result = new Promise(f => cb = f);
             const ws = new WebSocket('ws://localhost:' + port + '/ws');
-            ws.addEventListener('message', data => { ws.close(); cb(data.data); });
-            return result;
+            ws.addEventListener('open', data => ws.close());
         }""",
-            ws_server.PORT,
+            server.PORT,
         )
     ws = await ws_info.value
-    assert ws.url == f"ws://localhost:{ws_server.PORT}/ws"
+    ws.on("close", lambda ws: close_future.set_result(None))
+    assert ws.url == f"ws://localhost:{server.PORT}/ws"
     assert repr(ws) == f"<WebSocket url={ws.url!r}>"
-    if not ws.is_closed():
-        await ws.wait_for_event("close")
+    await close_future
     assert ws.is_closed()
 
 
-async def test_should_emit_frame_events(
-    page: Page, ws_server: WebSocketServerServer
-) -> None:
+async def test_should_emit_frame_events(page: Page, server: Server) -> None:
+    def _handle_ws_connection(ws: WebSocketProtocol) -> None:
+        def _onMessage(payload: bytes, isBinary: bool) -> None:
+            ws.sendMessage(b"incoming", False)
+            ws.sendClose()
+
+        setattr(ws, "onMessage", _onMessage)
+
+    server.once_web_socket_connection(_handle_ws_connection)
     log = []
-    socke_close_future: "asyncio.Future[None]" = asyncio.Future()
+    socket_close_future: "asyncio.Future[None]" = asyncio.Future()
 
     def on_web_socket(ws: WebSocket) -> None:
         log.append("open")
@@ -83,7 +86,7 @@ def _on_framereceived(payload: Union[bytes, str]) -> None:
 
         def _handle_close(ws: WebSocket) -> None:
             log.append("close")
-            socke_close_future.set_result(None)
+            socket_close_future.set_result(None)
 
         ws.on("close", _handle_close)
 
@@ -95,18 +98,30 @@ def _handle_close(ws: WebSocket) -> None:
             ws.addEventListener('open', () => ws.send('outgoing'));
             ws.addEventListener('message', () => ws.close())
         }""",
-            ws_server.PORT,
+            server.PORT,
         )
-    await socke_close_future
+    await socket_close_future
     assert log[0] == "open"
     assert log[3] == "close"
     log.sort()
     assert log == ["close", "open", "received<incoming>", "sent<outgoing>"]
 
 
-async def test_should_emit_binary_frame_events(
-    page: Page, ws_server: WebSocketServerServer
-) -> None:
+async def test_should_emit_binary_frame_events(page: Page, server: Server) -> None:
+    def _handle_ws_connection(ws: WebSocketProtocol) -> None:
+        ws.sendMessage(b"incoming")
+
+        def _onMessage(payload: bytes, isBinary: bool) -> None:
+            if payload == b"echo-bin":
+                ws.sendMessage(b"\x04\x02", True)
+                ws.sendClose()
+            if payload == b"echo-text":
+                ws.sendMessage(b"text", False)
+                ws.sendClose()
+
+        setattr(ws, "onMessage", _onMessage)
+
+    server.once_web_socket_connection(_handle_ws_connection)
     done_task: "asyncio.Future[None]" = asyncio.Future()
     sent = []
     received = []
@@ -129,7 +144,7 @@ def on_web_socket(ws: WebSocket) -> None:
                 ws.send('echo-bin');
             });
         }""",
-            ws_server.PORT,
+            server.PORT,
         )
     await done_task
     assert sent == [b"\x00\x01\x02\x03\x04", "echo-bin"]
@@ -138,14 +153,15 @@ def on_web_socket(ws: WebSocket) -> None:
 
 @flaky
 async def test_should_reject_wait_for_event_on_close_and_error(
-    page: Page, ws_server: WebSocketServerServer
+    page: Page, server: Server
 ) -> None:
+    server.send_on_web_socket_connection(b"incoming")
     async with page.expect_event("websocket") as ws_info:
         await page.evaluate(
             """port => {
             window.ws = new WebSocket('ws://localhost:' + port + '/ws');
         }""",
-            ws_server.PORT,
+            server.PORT,
         )
     ws = await ws_info.value
     await ws.wait_for_event("framereceived")
diff --git a/tests/conftest.py b/tests/conftest.py
index d5e9226f1..770bd9c30 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -30,7 +30,7 @@
 import playwright
 from playwright._impl._path_utils import get_file_dirname
 
-from .server import Server, WebSocketServerServer, test_server
+from .server import Server, test_server
 
 _dirname = get_file_dirname()
 
@@ -76,11 +76,6 @@ def https_server() -> Generator[Server, None, None]:
     yield test_server.https_server
 
 
-@pytest.fixture
-def ws_server() -> Generator[WebSocketServerServer, None, None]:
-    yield test_server.ws_server
-
-
 @pytest.fixture(autouse=True, scope="session")
 async def start_server() -> AsyncGenerator[None, None]:
     test_server.start()
diff --git a/tests/server.py b/tests/server.py
index 06e344653..23d7ff374 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -27,6 +27,7 @@
     Dict,
     Generator,
     Generic,
+    List,
     Optional,
     Set,
     Tuple,
@@ -35,6 +36,7 @@
 )
 from urllib.parse import urlparse
 
+from autobahn.twisted.resource import WebSocketResource
 from autobahn.twisted.websocket import WebSocketServerFactory, WebSocketServerProtocol
 from OpenSSL import crypto
 from twisted.internet import reactor as _twisted_reactor
@@ -91,6 +93,10 @@ def process(self) -> None:
             )
             server.request_subscribers.pop(path)
 
+        if path == "/ws":
+            server._ws_resource.render(self)
+            return
+
         if server.auth.get(path):
             authorization_header = self.requestHeaders.getRawHeaders("authorization")
             creds_correct = False
@@ -171,10 +177,17 @@ def start(self) -> None:
         self.auth = auth
         self.csp = csp
         self.routes = routes
+        self._ws_handlers: List[Callable[["WebSocketProtocol"], None]] = []
         self.gzip_routes = gzip_routes
         self.static_path = _dirname / "assets"
         factory = TestServerFactory()
         factory.server_instance = self
+
+        ws_factory = WebSocketServerFactory()
+        ws_factory.protocol = WebSocketProtocol
+        ws_factory.server_instance = self
+        self._ws_resource = WebSocketResource(ws_factory)
+
         self.listen(factory)
 
     async def wait_for_request(self, path: str) -> TestServerRequest:
@@ -210,6 +223,7 @@ def reset(self) -> None:
         self.csp.clear()
         self.gzip_routes.clear()
         self.routes.clear()
+        self._ws_handlers.clear()
 
     def set_route(
         self, path: str, callback: Callable[[TestServerRequest], Any]
@@ -227,6 +241,14 @@ def handle_redirect(request: http.Request) -> None:
 
         self.set_route(from_, handle_redirect)
 
+    def send_on_web_socket_connection(self, data: bytes) -> None:
+        self.once_web_socket_connection(lambda ws: ws.sendMessage(data))
+
+    def once_web_socket_connection(
+        self, handler: Callable[["WebSocketProtocol"], None]
+    ) -> None:
+        self._ws_handlers.append(handler)
+
 
 class HTTPServer(Server):
     def listen(self, factory: http.HTTPFactory) -> None:
@@ -257,48 +279,21 @@ def listen(self, factory: http.HTTPFactory) -> None:
             pass
 
 
-class WebSocketServerServer(WebSocketServerProtocol):
-    def __init__(self) -> None:
-        super().__init__()
-        self.PORT = find_free_port()
-
-    def start(self) -> None:
-        ws = WebSocketServerFactory("ws://127.0.0.1:" + str(self.PORT))
-        ws.protocol = WebSocketProtocol
-        reactor.listenTCP(self.PORT, ws)
-
-
 class WebSocketProtocol(WebSocketServerProtocol):
-    def onConnect(self, request: Any) -> None:
-        pass
-
     def onOpen(self) -> None:
-        self.sendMessage(b"incoming")
-
-    def onMessage(self, payload: bytes, isBinary: bool) -> None:
-        if payload == b"echo-bin":
-            self.sendMessage(b"\x04\x02", True)
-            self.sendClose()
-        if payload == b"echo-text":
-            self.sendMessage(b"text", False)
-            self.sendClose()
-        if payload == b"close":
-            self.sendClose()
-
-    def onClose(self, wasClean: Any, code: Any, reason: Any) -> None:
-        pass
+        for handler in self.factory.server_instance._ws_handlers.copy():
+            self.factory.server_instance._ws_handlers.remove(handler)
+            handler(self)
 
 
 class TestServer:
     def __init__(self) -> None:
         self.server = HTTPServer()
         self.https_server = HTTPSServer()
-        self.ws_server = WebSocketServerServer()
 
     def start(self) -> None:
         self.server.start()
         self.https_server.start()
-        self.ws_server.start()
         self.thread = threading.Thread(
             target=lambda: reactor.run(installSignalHandlers=False)
         )
diff --git a/tests/sync/test_page_add_locator_handler.py b/tests/sync/test_page_add_locator_handler.py
index e4ba14462..b069520ec 100644
--- a/tests/sync/test_page_add_locator_handler.py
+++ b/tests/sync/test_page_add_locator_handler.py
@@ -12,9 +12,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+
 import pytest
 
-from playwright.sync_api import Error, Page, expect
+from playwright.sync_api import Error, Locator, Page, expect
 from tests.server import Server
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
@@ -25,16 +26,18 @@ def test_should_work(page: Page, server: Server) -> None:
     before_count = 0
     after_count = 0
 
-    def handler() -> None:
+    original_locator = page.get_by_text("This interstitial covers the button")
+
+    def handler(locator: Locator) -> None:
+        nonlocal original_locator
+        assert locator == original_locator
         nonlocal before_count
         nonlocal after_count
         before_count += 1
         page.locator("#close").click()
         after_count += 1
 
-    page.add_locator_handler(
-        page.locator("text=This interstitial covers the button"), handler
-    )
+    page.add_locator_handler(original_locator, handler)
 
     for args in [
         ["mouseover", 1],
@@ -70,7 +73,7 @@ def handler() -> None:
         if page.get_by_text("This interstitial covers the button").is_visible():
             page.locator("#close").click()
 
-    page.add_locator_handler(page.locator("body"), handler)
+    page.add_locator_handler(page.locator("body"), handler, no_wait_after=True)
 
     for args in [
         ["mouseover", 2],
@@ -152,7 +155,7 @@ def handler() -> None:
         # Deliberately timeout.
         try:
             page.wait_for_timeout(9999999)
-        except Error:
+        except Exception:
             pass
 
     page.add_locator_handler(
@@ -195,3 +198,190 @@ def handler() -> None:
     expect(page.locator("#target")).to_be_visible()
     expect(page.locator("#interstitial")).not_to_be_visible()
     assert called == 1
+
+
+def test_should_work_when_owner_frame_detaches(page: Page, server: Server) -> None:
+    page.goto(server.EMPTY_PAGE)
+    page.evaluate(
+        """
+    () => {
+        const iframe = document.createElement('iframe');
+        iframe.src = 'data:text/html,<body>hello from iframe</body>';
+        document.body.append(iframe);
+
+        const target = document.createElement('button');
+        target.textContent = 'Click me';
+        target.id = 'target';
+        target.addEventListener('click', () => window._clicked = true);
+        document.body.appendChild(target);
+
+        const closeButton = document.createElement('button');
+        closeButton.textContent = 'close';
+        closeButton.id = 'close';
+        closeButton.addEventListener('click', () => iframe.remove());
+        document.body.appendChild(closeButton);
+    }
+    """
+    )
+    page.add_locator_handler(
+        page.frame_locator("iframe").locator("body"),
+        lambda: page.locator("#close").click(),
+    )
+    page.locator("#target").click()
+    assert page.query_selector("iframe") is None
+    assert page.evaluate("window._clicked") is True
+
+
+def test_should_work_with_times_option(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+    called = 0
+
+    def _handler() -> None:
+        nonlocal called
+        called += 1
+
+    page.add_locator_handler(
+        page.locator("body"), _handler, no_wait_after=True, times=2
+    )
+    page.locator("#aside").hover()
+    page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('mouseover', 4);
+    }
+    """
+    )
+    with pytest.raises(Error) as exc_info:
+        page.locator("#target").click(timeout=3000)
+    assert called == 2
+    assert page.evaluate("window.clicked") == 0
+    expect(page.locator("#interstitial")).to_be_visible()
+    assert "Timeout 3000ms exceeded" in exc_info.value.message
+    assert (
+        '<div>This interstitial covers the button</div> from <div class="visible" id="interstitial">…</div> subtree intercepts pointer events'
+        in exc_info.value.message
+    )
+
+
+def test_should_wait_for_hidden_by_default(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+    called = 0
+
+    def _handler(button: Locator) -> None:
+        nonlocal called
+        called += 1
+        button.click()
+
+    page.add_locator_handler(page.get_by_role("button", name="close"), _handler)
+    page.locator("#aside").hover()
+    page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('timeout', 1);
+    }
+    """
+    )
+    page.locator("#target").click()
+    assert page.evaluate("window.clicked") == 1
+    expect(page.locator("#interstitial")).not_to_be_visible()
+    assert called == 1
+
+
+def test_should_wait_for_hidden_by_default_2(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+    called = 0
+
+    def _handler() -> None:
+        nonlocal called
+        called += 1
+
+    page.add_locator_handler(page.get_by_role("button", name="close"), _handler)
+    page.locator("#aside").hover()
+    page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('hide', 1);
+    }
+    """
+    )
+    with pytest.raises(Error) as exc_info:
+        page.locator("#target").click(timeout=3000)
+    assert page.evaluate("window.clicked") == 0
+    expect(page.locator("#interstitial")).to_be_visible()
+    assert called == 1
+    assert (
+        'locator handler has finished, waiting for get_by_role("button", name="close") to be hidden'
+        in exc_info.value.message
+    )
+
+
+def test_should_work_with_noWaitAfter(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+    called = 0
+
+    def _handler(button: Locator) -> None:
+        nonlocal called
+        called += 1
+        if called == 1:
+            button.click()
+        else:
+            page.locator("#interstitial").wait_for(state="hidden")
+
+    page.add_locator_handler(
+        page.get_by_role("button", name="close"), _handler, no_wait_after=True
+    )
+    page.locator("#aside").hover()
+    page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('timeout', 1);
+    }
+    """
+    )
+    page.locator("#target").click()
+    assert page.evaluate("window.clicked") == 1
+    expect(page.locator("#interstitial")).not_to_be_visible()
+    assert called == 2
+
+
+def test_should_removeLocatorHandler(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/handle-locator.html")
+    called = 0
+
+    def _handler(locator: Locator) -> None:
+        nonlocal called
+        called += 1
+        locator.click()
+
+    page.add_locator_handler(page.get_by_role("button", name="close"), _handler)
+    page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('hide', 1);
+    }
+    """
+    )
+    page.locator("#target").click()
+    assert called == 1
+    assert page.evaluate("window.clicked") == 1
+    expect(page.locator("#interstitial")).not_to_be_visible()
+    page.evaluate(
+        """
+    () => {
+        window.clicked = 0;
+        window.setupAnnoyingInterstitial('hide', 1);
+    }
+    """
+    )
+    page.remove_locator_handler(page.get_by_role("button", name="close"))
+    with pytest.raises(Error) as error:
+        page.locator("#target").click(timeout=3000)
+    assert called == 1
+    assert page.evaluate("window.clicked") == 0
+    expect(page.locator("#interstitial")).to_be_visible()
+    assert "Timeout 3000ms exceeded" in error.value.message

From 7cc2bc950fa69a2c58382886c9c6c05f2c225f3e Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 17 May 2024 10:38:48 +0200
Subject: [PATCH 217/438] chore(roll): roll Playwright to
 1.44.0-beta-1715802478000 (#2438)

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

diff --git a/setup.py b/setup.py
index d65dc81a1..8709e52a2 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.44.0-beta-1715189091000"
+driver_version = "1.44.0-beta-1715802478000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From e27ef4ce7fe06e8904cc2df9273a7aa6da55d346 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 22 May 2024 13:34:04 +0200
Subject: [PATCH 218/438] build(deps): bump requests from 2.31.0 to 2.32.0
 (#2443)

---
 local-requirements.txt | 2 +-
 pyproject.toml         | 2 +-
 setup.py               | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index ad29988d1..fc591fa0c 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -15,7 +15,7 @@ pytest-cov==5.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1
 pytest-xdist==3.6.1
-requests==2.31.0
+requests==2.32.0
 service_identity==24.1.0
 setuptools==69.5.1
 twisted==24.3.0
diff --git a/pyproject.toml b/pyproject.toml
index 2f6801904..34504380f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==68.2.2", "setuptools-scm==8.0.4", "wheel==0.42.0", "auditwheel==5.4.0"]
+requires = ["setuptools==68.2.2", "setuptools-scm==8.1.0", "wheel==0.42.0", "auditwheel==5.4.0"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools_scm]
diff --git a/setup.py b/setup.py
index 8709e52a2..714bb20fe 100644
--- a/setup.py
+++ b/setup.py
@@ -222,7 +222,7 @@ def _download_and_extract_local_driver(
         "pyee==11.1.0",
     ],
     # TODO: Can be removed once we migrate to pypa/build or pypa/installer.
-    setup_requires=["setuptools-scm==8.0.4", "wheel==0.42.0"],
+    setup_requires=["setuptools-scm==8.1.0", "wheel==0.42.0"],
     classifiers=[
         "Topic :: Software Development :: Testing",
         "Topic :: Internet :: WWW/HTTP :: Browsers",

From a7a7dcb9b30cc74c296d2586cc57916bcab24cb1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 22 May 2024 14:20:36 +0200
Subject: [PATCH 219/438] build(deps): bump pytest from 8.2.0 to 8.2.1 (#2441)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index fc591fa0c..4434b29a3 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,7 +9,7 @@ Pillow==10.3.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==24.1.0
-pytest==8.2.0
+pytest==8.2.1
 pytest-asyncio==0.21.2
 pytest-cov==5.0.0
 pytest-repeat==0.9.3

From 2402e1283de6049cb66ea8ec6f303ba681890d2a Mon Sep 17 00:00:00 2001
From: KRRT7 <106575910+KRRT7@users.noreply.github.com>
Date: Fri, 24 May 2024 10:48:03 -0400
Subject: [PATCH 220/438] chore: support for Nuitka (#2435)

---
 playwright/_impl/_transport.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index f07d31dcd..f2f455c50 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -105,9 +105,9 @@ async def connect(self) -> None:
         self._stopped_future: asyncio.Future = asyncio.Future()
 
         try:
-            # For pyinstaller
+            # For pyinstaller and Nuitka
             env = get_driver_env()
-            if getattr(sys, "frozen", False):
+            if getattr(sys, "frozen", False) or globals().get("_compiled__"):
                 env.setdefault("PLAYWRIGHT_BROWSERS_PATH", "0")
 
             startupinfo = None

From 47c1bc15122796da70a160b07f1e08a71f9032e2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 10 Jun 2024 19:45:36 +0200
Subject: [PATCH 221/438] build(deps): bump pytest from 8.2.1 to 8.2.2 (#2461)

Bumps [pytest](https://github.com/pytest-dev/pytest) from 8.2.1 to 8.2.2.
- [Release notes](https://github.com/pytest-dev/pytest/releases)
- [Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pytest-dev/pytest/compare/8.2.1...8.2.2)

---
updated-dependencies:
- dependency-name: pytest
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 4434b29a3..4467d2876 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,7 +9,7 @@ Pillow==10.3.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==24.1.0
-pytest==8.2.1
+pytest==8.2.2
 pytest-asyncio==0.21.2
 pytest-cov==5.0.0
 pytest-repeat==0.9.3

From a00d636ea421eed10e47de8409e1b9c80786c91c Mon Sep 17 00:00:00 2001
From: Mikhail Seliakov <123661527+MikhailSeliakov@users.noreply.github.com>
Date: Wed, 12 Jun 2024 18:13:46 +0500
Subject: [PATCH 222/438] fix(driver): consider PLAYWRIGHT_NODEJS_PATH from
 host env win32 (#2462)

---
 playwright/_impl/_driver.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_driver.py b/playwright/_impl/_driver.py
index 9e8cdc1e7..22b53b8e7 100644
--- a/playwright/_impl/_driver.py
+++ b/playwright/_impl/_driver.py
@@ -26,7 +26,10 @@ def compute_driver_executable() -> Tuple[str, str]:
     driver_path = Path(inspect.getfile(playwright)).parent / "driver"
     cli_path = str(driver_path / "package" / "cli.js")
     if sys.platform == "win32":
-        return (str(driver_path / "node.exe"), cli_path)
+        return (
+            os.getenv("PLAYWRIGHT_NODEJS_PATH", str(driver_path / "node.exe")),
+            cli_path,
+        )
     return (os.getenv("PLAYWRIGHT_NODEJS_PATH", str(driver_path / "node")), cli_path)
 
 

From 52135113fc56f4ad7aa4ac6cfdcc5ca506f75e15 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 13 Jun 2024 10:15:41 +0200
Subject: [PATCH 223/438] build(deps): bump requests from 2.32.0 to 2.32.3
 (#2458)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 4467d2876..fc11c7619 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -15,7 +15,7 @@ pytest-cov==5.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1
 pytest-xdist==3.6.1
-requests==2.32.0
+requests==2.32.3
 service_identity==24.1.0
 setuptools==69.5.1
 twisted==24.3.0

From d46b729dbee10b1af98ec5f7dfad84090f10e20c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 13 Jun 2024 10:15:50 +0200
Subject: [PATCH 224/438] build(deps): bump types-requests from 2.31.0.20240406
 to 2.32.0.20240602 (#2459)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index fc11c7619..72adfa778 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -20,5 +20,5 @@ service_identity==24.1.0
 setuptools==69.5.1
 twisted==24.3.0
 types-pyOpenSSL==24.1.0.20240425
-types-requests==2.31.0.20240406
+types-requests==2.32.0.20240602
 wheel==0.42.0

From f8c8882cce12ef079ccfedf805a10d48bb6ed39c Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 13 Jun 2024 10:16:26 +0200
Subject: [PATCH 225/438] devops: run conda test builds on macos-13

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index c37bf348e..9f1468c5f 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -157,7 +157,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-20.04, macos-12, windows-2019]
+        os: [ubuntu-20.04, macos-13, windows-2019]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v3

From 3c46eecd9caf4bd4ae763462d1b23184a8943e29 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 17 Jun 2024 20:29:47 +0200
Subject: [PATCH 226/438] build(deps): bump flake8 from 7.0.0 to 7.1.0 (#2466)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 72adfa778..dc1cba114 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,7 +1,7 @@
 auditwheel==6.0.0
 autobahn==23.1.2
 black==24.4.2
-flake8==7.0.0
+flake8==7.1.0
 flaky==3.8.1
 mypy==1.10.0
 objgraph==3.6.1

From b331b8ea4b78cdaf270b8b0e36f35f289c1a004e Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 19 Jun 2024 14:27:49 +0200
Subject: [PATCH 227/438] devops: update conda-incubator/setup-miniconda to v3
 (#2467)

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 9f1468c5f..55f66440c 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -164,7 +164,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Get conda
-        uses: conda-incubator/setup-miniconda@v2
+        uses: conda-incubator/setup-miniconda@v3
         with:
           python-version: 3.9
           channels: conda-forge

From c6cc4c97cc9e1bccd66c7f2a54bc44b627903f24 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 21 Jun 2024 12:51:24 +0200
Subject: [PATCH 228/438] chore(roll): roll Playwright to
 1.45.0-alpha-2024-06-14 (#2464)

---
 README.md                                     |   4 +-
 playwright/_impl/_api_structures.py           |   1 +
 playwright/_impl/_browser_context.py          |  10 +
 playwright/_impl/_clock.py                    |  84 +++
 playwright/_impl/_fetch.py                    |  14 +-
 playwright/_impl/_helper.py                   |  16 +-
 playwright/_impl/_network.py                  |  20 +-
 playwright/_impl/_page.py                     |   5 +
 playwright/_impl/_set_input_files_helpers.py  | 102 +++-
 playwright/async_api/_generated.py            | 247 ++++++++-
 playwright/sync_api/_generated.py             | 251 ++++++++-
 scripts/documentation_provider.py             |   4 +
 scripts/generate_api.py                       |   4 +
 setup.py                                      |   2 +-
 tests/assets/input/folderupload.html          |  12 +
 tests/async/conftest.py                       |  11 +-
 .../async/test_browsercontext_add_cookies.py  |  20 +-
 tests/async/test_browsercontext_cookies.py    |  29 +-
 tests/async/test_browsertype_connect.py       |  58 ++-
 tests/async/test_defaultbrowsercontext.py     |  28 +-
 tests/async/test_fetch_browser_context.py     |  73 ++-
 tests/async/test_fetch_global.py              |  39 ++
 tests/async/test_input.py                     | 102 +++-
 tests/async/test_network.py                   |  26 +-
 tests/async/test_page_clock.py                | 487 ++++++++++++++++++
 tests/async/test_request_continue.py          |  51 +-
 tests/sync/test_locators.py                   |   2 +-
 tests/sync/test_page_clock.py                 | 464 +++++++++++++++++
 tests/utils.py                                |  11 +
 29 files changed, 2055 insertions(+), 122 deletions(-)
 create mode 100644 playwright/_impl/_clock.py
 create mode 100644 tests/assets/input/folderupload.html
 create mode 100644 tests/async/test_page_clock.py
 create mode 100644 tests/sync/test_page_clock.py

diff --git a/README.md b/README.md
index 901da2298..aca6755bc 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 -->125.0.6422.26<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->127.0.6533.5<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->125.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->127.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index f06a6247e..ba46c2a71 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -63,6 +63,7 @@ class HttpCredentials(TypedDict, total=False):
     username: str
     password: str
     origin: Optional[str]
+    send: Optional[Literal["always", "unauthorized"]]
 
 
 class LocalStorageEntry(TypedDict):
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index edb298c9c..455bf3410 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -39,6 +39,7 @@
 )
 from playwright._impl._artifact import Artifact
 from playwright._impl._cdp_session import CDPSession
+from playwright._impl._clock import Clock
 from playwright._impl._connection import (
     ChannelOwner,
     from_channel,
@@ -114,6 +115,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._clock = Clock(self)
         self._channel.on(
             "bindingCall",
             lambda params: self._on_binding(from_channel(params["binding"])),
@@ -519,6 +521,10 @@ async def close(self, reason: str = None) -> None:
         self._close_reason = reason
         self._close_was_called = True
 
+        await self._channel._connection.wrap_api_call(
+            lambda: self.request.dispose(reason=reason), True
+        )
+
         async def _inner_close() -> None:
             for har_id, params in self._har_recorders.items():
                 har = cast(
@@ -679,3 +685,7 @@ def tracing(self) -> Tracing:
     @property
     def request(self) -> "APIRequestContext":
         return self._request
+
+    @property
+    def clock(self) -> Clock:
+        return self._clock
diff --git a/playwright/_impl/_clock.py b/playwright/_impl/_clock.py
new file mode 100644
index 000000000..11c230b92
--- /dev/null
+++ b/playwright/_impl/_clock.py
@@ -0,0 +1,84 @@
+# 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 datetime
+from typing import TYPE_CHECKING, Dict, Union
+
+if TYPE_CHECKING:
+    from playwright._impl._browser_context import BrowserContext
+
+
+class Clock:
+    def __init__(self, browser_context: "BrowserContext") -> None:
+        self._browser_context = browser_context
+        self._loop = browser_context._loop
+        self._dispatcher_fiber = browser_context._dispatcher_fiber
+
+    async def install(self, time: Union[int, str, datetime.datetime] = None) -> None:
+        await self._browser_context._channel.send(
+            "clockInstall", parse_time(time) if time is not None else {}
+        )
+
+    async def fast_forward(
+        self,
+        ticks: Union[int, str],
+    ) -> None:
+        await self._browser_context._channel.send(
+            "clockFastForward", parse_ticks(ticks)
+        )
+
+    async def pause_at(
+        self,
+        time: Union[int, str, datetime.datetime],
+    ) -> None:
+        await self._browser_context._channel.send("clockPauseAt", parse_time(time))
+
+    async def resume(
+        self,
+    ) -> None:
+        await self._browser_context._channel.send("clockResume")
+
+    async def run_for(
+        self,
+        ticks: Union[int, str],
+    ) -> None:
+        await self._browser_context._channel.send("clockRunFor", parse_ticks(ticks))
+
+    async def set_fixed_time(
+        self,
+        time: Union[int, str, datetime.datetime],
+    ) -> None:
+        await self._browser_context._channel.send("clockSetFixedTime", parse_time(time))
+
+    async def set_system_time(
+        self,
+        time: Union[int, str, datetime.datetime],
+    ) -> None:
+        await self._browser_context._channel.send(
+            "clockSetSystemTime", parse_time(time)
+        )
+
+
+def parse_time(time: Union[int, str, datetime.datetime]) -> Dict[str, Union[int, str]]:
+    if isinstance(time, int):
+        return {"timeNumber": time}
+    if isinstance(time, str):
+        return {"timeString": time}
+    return {"timeNumber": int(time.timestamp())}
+
+
+def parse_ticks(ticks: Union[int, str]) -> Dict[str, Union[int, str]]:
+    if isinstance(ticks, int):
+        return {"ticksNumber": ticks}
+    return {"ticksString": ticks}
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index 9947534aa..3a71a5ff5 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -34,6 +34,7 @@
 from playwright._impl._helper import (
     Error,
     NameValue,
+    TargetClosedError,
     async_readfile,
     async_writefile,
     is_file_payload,
@@ -93,9 +94,16 @@ def __init__(
     ) -> None:
         super().__init__(parent, type, guid, initializer)
         self._tracing: Tracing = from_channel(initializer["tracing"])
+        self._close_reason: Optional[str] = None
 
-    async def dispose(self) -> None:
-        await self._channel.send("dispose")
+    async def dispose(self, reason: str = None) -> None:
+        self._close_reason = reason
+        try:
+            await self._channel.send("dispose", {"reason": reason})
+        except Error as e:
+            if is_target_closed_error(e):
+                return
+            raise e
         self._tracing._reset_stack_counter()
 
     async def delete(
@@ -313,6 +321,8 @@ async def _inner_fetch(
         ignoreHTTPSErrors: bool = None,
         maxRedirects: int = None,
     ) -> "APIResponse":
+        if self._close_reason:
+            raise TargetClosedError(self._close_reason)
         assert (
             (1 if data else 0) + (1 if form else 0) + (1 if multipart else 0)
         ) <= 1, "Only one of 'data', 'form' or 'multipart' can be specified"
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index fca945643..ec633c6e8 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -37,7 +37,13 @@
 from urllib.parse import urljoin
 
 from playwright._impl._api_structures import NameValue
-from playwright._impl._errors import Error, TargetClosedError, TimeoutError
+from playwright._impl._errors import (
+    Error,
+    TargetClosedError,
+    TimeoutError,
+    is_target_closed_error,
+    rewrite_error,
+)
 from playwright._impl._glob import glob_to_regex
 from playwright._impl._greenlets import RouteGreenlet
 from playwright._impl._str_utils import escape_regex_flags
@@ -287,6 +293,14 @@ async def handle(self, route: "Route") -> bool:
             # If the handler was stopped (without waiting for completion), we ignore all exceptions.
             if self._ignore_exception:
                 return False
+            if is_target_closed_error(e):
+                # We are failing in the handler because the target has closed.
+                # Give user a hint!
+                optional_async_prefix = "await " if not self._is_sync else ""
+                raise rewrite_error(
+                    e,
+                    f"\"{str(e)}\" while running route callback.\nConsider awaiting `{optional_async_prefix}page.unroute_all(behavior='ignoreErrors')`\nbefore the end of the test to ignore remaining routes in flight.",
+                )
             raise e
         finally:
             handler_invocation.complete.set_result(None)
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 1fe436c80..3656a01cc 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -111,11 +111,6 @@ def __init__(
         self._fallback_overrides: SerializedFallbackOverrides = (
             SerializedFallbackOverrides()
         )
-        base64_post_data = initializer.get("postData")
-        if base64_post_data is not None:
-            self._fallback_overrides.post_data_buffer = base64.b64decode(
-                base64_post_data
-            )
 
     def __repr__(self) -> str:
         return f"<Request url={self.url!r} method={self.method!r}>"
@@ -159,9 +154,12 @@ async def sizes(self) -> RequestSizes:
     @property
     def post_data(self) -> Optional[str]:
         data = self._fallback_overrides.post_data_buffer
-        if not data:
-            return None
-        return data.decode()
+        if data:
+            return data.decode()
+        base64_post_data = self._initializer.get("postData")
+        if base64_post_data is not None:
+            return base64.b64decode(base64_post_data).decode()
+        return None
 
     @property
     def post_data_json(self) -> Optional[Any]:
@@ -178,7 +176,11 @@ def post_data_json(self) -> Optional[Any]:
 
     @property
     def post_data_buffer(self) -> Optional[bytes]:
-        return self._fallback_overrides.post_data_buffer
+        if self._fallback_overrides.post_data_buffer:
+            return self._fallback_overrides.post_data_buffer
+        if self._initializer.get("postData"):
+            return base64.b64decode(self._initializer["postData"])
+        return None
 
     async def response(self) -> Optional["Response"]:
         return from_nullable_channel(await self._channel.send("response"))
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 43a9e06db..97af978f3 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -43,6 +43,7 @@
     ViewportSize,
 )
 from playwright._impl._artifact import Artifact
+from playwright._impl._clock import Clock
 from playwright._impl._connection import (
     ChannelOwner,
     from_channel,
@@ -336,6 +337,10 @@ def _on_video(self, params: Any) -> None:
     def context(self) -> "BrowserContext":
         return self._browser_context
 
+    @property
+    def clock(self) -> Clock:
+        return self._browser_context.clock
+
     async def opener(self) -> Optional["Page"]:
         if self._opener and self._opener.is_closed():
             return None
diff --git a/playwright/_impl/_set_input_files_helpers.py b/playwright/_impl/_set_input_files_helpers.py
index e47946be7..ababf5fab 100644
--- a/playwright/_impl/_set_input_files_helpers.py
+++ b/playwright/_impl/_set_input_files_helpers.py
@@ -15,7 +15,17 @@
 import collections.abc
 import os
 from pathlib import Path
-from typing import TYPE_CHECKING, Dict, List, Optional, Sequence, TypedDict, Union, cast
+from typing import (
+    TYPE_CHECKING,
+    Dict,
+    List,
+    Optional,
+    Sequence,
+    Tuple,
+    TypedDict,
+    Union,
+    cast,
+)
 
 from playwright._impl._connection import Channel, from_channel
 from playwright._impl._helper import Error
@@ -31,10 +41,20 @@
 
 class InputFilesList(TypedDict, total=False):
     streams: Optional[List[Channel]]
+    directoryStream: Optional[Channel]
+    localDirectory: Optional[str]
     localPaths: Optional[List[str]]
     payloads: Optional[List[Dict[str, Union[str, bytes]]]]
 
 
+def _list_files(directory: str) -> List[str]:
+    files = []
+    for root, _, filenames in os.walk(directory):
+        for filename in filenames:
+            files.append(os.path.join(root, filename))
+    return files
+
+
 async def convert_input_files(
     files: Union[
         str, Path, FilePayload, Sequence[Union[str, Path]], Sequence[FilePayload]
@@ -50,31 +70,51 @@ async def convert_input_files(
     if any([isinstance(item, (str, Path)) for item in items]):
         if not all([isinstance(item, (str, Path)) for item in items]):
             raise Error("File paths cannot be mixed with buffers")
+
+        (local_paths, local_directory) = resolve_paths_and_directory_for_input_files(
+            cast(Sequence[Union[str, Path]], items)
+        )
+
         if context._channel._connection.is_remote:
+            files_to_stream = cast(
+                List[str],
+                (_list_files(local_directory) if local_directory else local_paths),
+            )
             streams = []
-            for item in items:
-                assert isinstance(item, (str, Path))
-                last_modified_ms = int(os.path.getmtime(item) * 1000)
-                stream: WritableStream = from_channel(
-                    await context._connection.wrap_api_call(
-                        lambda: context._channel.send(
-                            "createTempFile",
-                            {
-                                "name": os.path.basename(cast(str, item)),
-                                "lastModifiedMs": last_modified_ms,
-                            },
-                        )
-                    )
+            result = await context._connection.wrap_api_call(
+                lambda: context._channel.send_return_as_dict(
+                    "createTempFiles",
+                    {
+                        "rootDirName": (
+                            os.path.basename(local_directory)
+                            if local_directory
+                            else None
+                        ),
+                        "items": list(
+                            map(
+                                lambda file: dict(
+                                    name=(
+                                        os.path.relpath(file, local_directory)
+                                        if local_directory
+                                        else os.path.basename(file)
+                                    ),
+                                    lastModifiedMs=int(os.path.getmtime(file) * 1000),
+                                ),
+                                files_to_stream,
+                            )
+                        ),
+                    },
                 )
-                await stream.copy(item)
+            )
+            for i, file in enumerate(result["writableStreams"]):
+                stream: WritableStream = from_channel(file)
+                await stream.copy(files_to_stream[i])
                 streams.append(stream._channel)
-            return InputFilesList(streams=streams)
-        return InputFilesList(
-            localPaths=[
-                str(Path(cast(Union[str, Path], item)).absolute().resolve())
-                for item in items
-            ]
-        )
+            return InputFilesList(
+                streams=None if local_directory else streams,
+                directoryStream=result.get("rootDir"),
+            )
+        return InputFilesList(localPaths=local_paths, localDirectory=local_directory)
 
     file_payload_exceeds_size_limit = (
         sum([len(f.get("buffer", "")) for f in items if not isinstance(f, (str, Path))])
@@ -95,3 +135,21 @@ async def convert_input_files(
             for item in cast(List[FilePayload], items)
         ]
     )
+
+
+def resolve_paths_and_directory_for_input_files(
+    items: Sequence[Union[str, Path]]
+) -> Tuple[Optional[List[str]], Optional[str]]:
+    local_paths: Optional[List[str]] = None
+    local_directory: Optional[str] = None
+    for item in items:
+        if os.path.isdir(item):
+            if local_directory:
+                raise Error("Multiple directories are not supported")
+            local_directory = str(Path(item).resolve())
+        else:
+            local_paths = local_paths or []
+            local_paths.append(str(Path(item).resolve()))
+    if local_paths and local_directory:
+        raise Error("File paths must be all files or a single directory")
+    return (local_paths, local_directory)
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 696637c83..5afc93a7b 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 
+import datetime
 import pathlib
 import typing
 from typing import Literal
@@ -52,6 +53,7 @@
 from playwright._impl._browser_context import BrowserContext as BrowserContextImpl
 from playwright._impl._browser_type import BrowserType as BrowserTypeImpl
 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._dialog import Dialog as DialogImpl
 from playwright._impl._download import Download as DownloadImpl
@@ -1411,7 +1413,8 @@ async def dblclick(
     async def wheel(self, delta_x: float, delta_y: float) -> None:
         """Mouse.wheel
 
-        Dispatches a `wheel` event.
+        Dispatches a `wheel` event. This method is usually used to manually scroll the page. See
+        [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll.
 
         **NOTE** Wheel events may cause scrolling if they are not handled, and this method does not wait for the scrolling
         to finish before returning.
@@ -1833,6 +1836,8 @@ async def scroll_into_view_if_needed(
         Throws when `elementHandle` does not point to an element
         [connected](https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected) to a Document or a ShadowRoot.
 
+        See [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll.
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -2291,7 +2296,8 @@ async def set_input_files(
         """ElementHandle.set_input_files
 
         Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
-        they are resolved relative to the current working directory. For empty array, clears the selected files.
+        they are resolved relative to the current working directory. For empty array, clears the selected files. For inputs
+        with a `[webkitdirectory]` attribute, only a single directory path is supported.
 
         This method expects `ElementHandle` to point to an
         [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
@@ -6656,6 +6662,160 @@ def set_test_id_attribute(self, attribute_name: str) -> None:
 mapping.register(SelectorsImpl, Selectors)
 
 
+class Clock(AsyncBase):
+    async def install(
+        self, *, time: typing.Optional[typing.Union[int, str, datetime.datetime]] = None
+    ) -> None:
+        """Clock.install
+
+        Install fake implementations for the following time-related functions:
+        - `Date`
+        - `setTimeout`
+        - `clearTimeout`
+        - `setInterval`
+        - `clearInterval`
+        - `requestAnimationFrame`
+        - `cancelAnimationFrame`
+        - `requestIdleCallback`
+        - `cancelIdleCallback`
+        - `performance`
+
+        Fake timers are used to manually control the flow of time in tests. They allow you to advance time, fire timers,
+        and control the behavior of time-dependent functions. See `clock.run_for()` and
+        `clock.fast_forward()` for more information.
+
+        Parameters
+        ----------
+        time : Union[datetime.datetime, int, str, None]
+            Time to initialize with, current system time by default.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.install(time=time))
+
+    async def fast_forward(self, ticks: typing.Union[int, str]) -> None:
+        """Clock.fast_forward
+
+        Advance the clock by jumping forward in time. Only fires due timers at most once. This is equivalent to user
+        closing the laptop lid for a while and reopening it later, after given time.
+
+        **Usage**
+
+        ```py
+        await page.clock.fast_forward(1000)
+        await page.clock.fast_forward(\"30:00\")
+        ```
+
+        Parameters
+        ----------
+        ticks : Union[int, str]
+            Time may be the number of milliseconds to advance the clock by or a human-readable string. Valid string formats are
+            "08" for eight seconds, "01:00" for one minute and "02:34:10" for two hours, 34 minutes and ten seconds.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.fast_forward(ticks=ticks))
+
+    async def pause_at(self, time: typing.Union[int, str, datetime.datetime]) -> None:
+        """Clock.pause_at
+
+        Advance the clock by jumping forward in time and pause the time. Once this method is called, no timers are fired
+        unless `clock.run_for()`, `clock.fast_forward()`, `clock.pause_at()` or
+        `clock.resume()` is called.
+
+        Only fires due timers at most once. This is equivalent to user closing the laptop lid for a while and reopening it
+        at the specified time and pausing.
+
+        **Usage**
+
+        ```py
+        await page.clock.pause_at(datetime.datetime(2020, 2, 2))
+        await page.clock.pause_at(\"2020-02-02\")
+        ```
+
+        Parameters
+        ----------
+        time : Union[datetime.datetime, int, str]
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.pause_at(time=time))
+
+    async def resume(self) -> None:
+        """Clock.resume
+
+        Resumes timers. Once this method is called, time resumes flowing, timers are fired as usual.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.resume())
+
+    async def run_for(self, ticks: typing.Union[int, str]) -> None:
+        """Clock.run_for
+
+        Advance the clock, firing all the time-related callbacks.
+
+        **Usage**
+
+        ```py
+        await page.clock.run_for(1000);
+        await page.clock.run_for(\"30:00\")
+        ```
+
+        Parameters
+        ----------
+        ticks : Union[int, str]
+            Time may be the number of milliseconds to advance the clock by or a human-readable string. Valid string formats are
+            "08" for eight seconds, "01:00" for one minute and "02:34:10" for two hours, 34 minutes and ten seconds.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.run_for(ticks=ticks))
+
+    async def set_fixed_time(
+        self, time: typing.Union[int, str, datetime.datetime]
+    ) -> None:
+        """Clock.set_fixed_time
+
+        Makes `Date.now` and `new Date()` return fixed fake time at all times, keeps all the timers running.
+
+        **Usage**
+
+        ```py
+        await page.clock.set_fixed_time(datetime.datetime.now())
+        await page.clock.set_fixed_time(datetime.datetime(2020, 2, 2))
+        await page.clock.set_fixed_time(\"2020-02-02\")
+        ```
+
+        Parameters
+        ----------
+        time : Union[datetime.datetime, int, str]
+            Time to be set.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.set_fixed_time(time=time))
+
+    async def set_system_time(
+        self, time: typing.Union[int, str, datetime.datetime]
+    ) -> None:
+        """Clock.set_system_time
+
+        Sets current system time but does not trigger any timers.
+
+        **Usage**
+
+        ```py
+        await page.clock.set_system_time(datetime.datetime.now())
+        await page.clock.set_system_time(datetime.datetime(2020, 2, 2))
+        await page.clock.set_system_time(\"2020-02-02\")
+        ```
+
+        Parameters
+        ----------
+        time : Union[datetime.datetime, int, str]
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.set_system_time(time=time))
+
+
+mapping.register(ClockImpl, Clock)
+
+
 class ConsoleMessage(AsyncBase):
     @property
     def type(self) -> str:
@@ -7539,6 +7699,18 @@ def context(self) -> "BrowserContext":
         """
         return mapping.from_impl(self._impl_obj.context)
 
+    @property
+    def clock(self) -> "Clock":
+        """Page.clock
+
+        Playwright has ability to mock clock and passage of time.
+
+        Returns
+        -------
+        Clock
+        """
+        return mapping.from_impl(self._impl_obj.clock)
+
     @property
     def main_frame(self) -> "Frame":
         """Page.main_frame
@@ -9190,7 +9362,7 @@ async def unroute_all(
         Parameters
         ----------
         behavior : Union["default", "ignoreErrors", "wait", None]
-            Specifies wether to wait for already running handlers and what to do if they throw errors:
+            Specifies whether to wait for already running handlers and what to do if they throw errors:
             - `'default'` - do not wait for current handler calls (if any) to finish, if unrouted handler throws, it may
               result in unhandled error
             - `'wait'` - wait for current handler calls (if any) to finish
@@ -10693,7 +10865,8 @@ async def set_input_files(
         """Page.set_input_files
 
         Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
-        they are resolved relative to the current working directory. For empty array, clears the selected files.
+        they are resolved relative to the current working directory. For empty array, clears the selected files. For inputs
+        with a `[webkitdirectory]` attribute, only a single directory path is supported.
 
         This method expects `selector` to point to an
         [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
@@ -11563,7 +11736,7 @@ def expect_response(
         return response.ok
 
         # or with a lambda
-        async with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200) as response_info:
+        async with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200 and response.request.method == \"get\") as response_info:
             await page.get_by_text(\"trigger response\").click()
         response = await response_info.value
         return response.ok
@@ -12323,6 +12496,18 @@ def request(self) -> "APIRequestContext":
         """
         return mapping.from_impl(self._impl_obj.request)
 
+    @property
+    def clock(self) -> "Clock":
+        """BrowserContext.clock
+
+        Playwright has ability to mock clock and passage of time.
+
+        Returns
+        -------
+        Clock
+        """
+        return mapping.from_impl(self._impl_obj.clock)
+
     def set_default_navigation_timeout(self, timeout: float) -> None:
         """BrowserContext.set_default_navigation_timeout
 
@@ -12471,21 +12656,22 @@ async def grant_permissions(
         ----------
         permissions : Sequence[str]
             A permission or an array of permissions to grant. Permissions can be one of the following values:
-            - `'geolocation'`
-            - `'midi'`
-            - `'midi-sysex'` (system-exclusive midi)
-            - `'notifications'`
-            - `'camera'`
-            - `'microphone'`
-            - `'background-sync'`
-            - `'ambient-light-sensor'`
             - `'accelerometer'`
-            - `'gyroscope'`
-            - `'magnetometer'`
             - `'accessibility-events'`
+            - `'ambient-light-sensor'`
+            - `'background-sync'`
+            - `'camera'`
             - `'clipboard-read'`
             - `'clipboard-write'`
+            - `'geolocation'`
+            - `'gyroscope'`
+            - `'magnetometer'`
+            - `'microphone'`
+            - `'midi-sysex'` (system-exclusive midi)
+            - `'midi'`
+            - `'notifications'`
             - `'payment-handler'`
+            - `'storage-access'`
         origin : Union[str, None]
             The [origin] to grant permissions to, e.g. "https://example.com".
         """
@@ -12880,7 +13066,7 @@ async def unroute_all(
         Parameters
         ----------
         behavior : Union["default", "ignoreErrors", "wait", None]
-            Specifies wether to wait for already running handlers and what to do if they throw errors:
+            Specifies whether to wait for already running handlers and what to do if they throw errors:
             - `'default'` - do not wait for current handler calls (if any) to finish, if unrouted handler throws, it may
               result in unhandled error
             - `'wait'` - wait for current handler calls (if any) to finish
@@ -13218,9 +13404,9 @@ def contexts(self) -> typing.List["BrowserContext"]:
 
         ```py
         browser = await pw.webkit.launch()
-        print(len(browser.contexts())) # prints `0`
+        print(len(browser.contexts)) # prints `0`
         context = await browser.new_context()
-        print(len(browser.contexts())) # prints `1`
+        print(len(browser.contexts)) # prints `1`
         ```
 
         Returns
@@ -13371,7 +13557,7 @@ async def new_context(
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
-        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None], send: Union["always", "unauthorized", None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
@@ -13585,7 +13771,7 @@ async def new_page(
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
-        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None], send: Union["always", "unauthorized", None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
@@ -14132,7 +14318,7 @@ async def launch_persistent_context(
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
-        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None], send: Union["always", "unauthorized", None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
@@ -16644,6 +16830,8 @@ async def scroll_into_view_if_needed(
         it is completely visible as defined by
         [IntersectionObserver](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)'s `ratio`.
 
+        See [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll.
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16787,7 +16975,8 @@ async def set_input_files(
     ) -> None:
         """Locator.set_input_files
 
-        Upload file or multiple files into `<input type=file>`.
+        Upload file or multiple files into `<input type=file>`. For inputs with a `[webkitdirectory]` attribute, only a
+        single directory path is supported.
 
         **Usage**
 
@@ -16798,6 +16987,9 @@ async def set_input_files(
         # Select multiple files
         await page.get_by_label(\"Upload files\").set_input_files(['file1.txt', 'file2.txt'])
 
+        # Select a directory
+        await page.get_by_label(\"Upload directory\").set_input_files('mydir')
+
         # Remove all the selected files
         await page.get_by_label(\"Upload file\").set_input_files([])
 
@@ -17371,15 +17563,20 @@ async def dispose(self) -> None:
 
 
 class APIRequestContext(AsyncBase):
-    async def dispose(self) -> None:
+    async def dispose(self, *, reason: typing.Optional[str] = None) -> None:
         """APIRequestContext.dispose
 
         All responses returned by `a_pi_request_context.get()` and similar methods are stored in the memory, so that
         you can later call `a_pi_response.body()`.This method discards all its resources, calling any method on
         disposed `APIRequestContext` will throw an exception.
+
+        Parameters
+        ----------
+        reason : Union[str, None]
+            The reason to be reported to the operations interrupted by the context disposal.
         """
 
-        return mapping.from_maybe_impl(await self._impl_obj.dispose())
+        return mapping.from_maybe_impl(await self._impl_obj.dispose(reason=reason))
 
     async def delete(
         self,
@@ -18032,7 +18229,7 @@ async def new_context(
               `http://localhost:3000/bar.html`
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request. Defaults to none.
-        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None], send: Union["always", "unauthorized", None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         ignore_https_errors : Union[bool, None]
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index b5076c9be..6dfe26ee8 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 
+import datetime
 import pathlib
 import typing
 from typing import Literal
@@ -46,6 +47,7 @@
 from playwright._impl._browser_context import BrowserContext as BrowserContextImpl
 from playwright._impl._browser_type import BrowserType as BrowserTypeImpl
 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._dialog import Dialog as DialogImpl
 from playwright._impl._download import Download as DownloadImpl
@@ -1413,7 +1415,8 @@ def dblclick(
     def wheel(self, delta_x: float, delta_y: float) -> None:
         """Mouse.wheel
 
-        Dispatches a `wheel` event.
+        Dispatches a `wheel` event. This method is usually used to manually scroll the page. See
+        [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll.
 
         **NOTE** Wheel events may cause scrolling if they are not handled, and this method does not wait for the scrolling
         to finish before returning.
@@ -1841,6 +1844,8 @@ def scroll_into_view_if_needed(
         Throws when `elementHandle` does not point to an element
         [connected](https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected) to a Document or a ShadowRoot.
 
+        See [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll.
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -2311,7 +2316,8 @@ def set_input_files(
         """ElementHandle.set_input_files
 
         Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
-        they are resolved relative to the current working directory. For empty array, clears the selected files.
+        they are resolved relative to the current working directory. For empty array, clears the selected files. For inputs
+        with a `[webkitdirectory]` attribute, only a single directory path is supported.
 
         This method expects `ElementHandle` to point to an
         [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
@@ -6766,6 +6772,162 @@ def set_test_id_attribute(self, attribute_name: str) -> None:
 mapping.register(SelectorsImpl, Selectors)
 
 
+class Clock(SyncBase):
+    def install(
+        self, *, time: typing.Optional[typing.Union[int, str, datetime.datetime]] = None
+    ) -> None:
+        """Clock.install
+
+        Install fake implementations for the following time-related functions:
+        - `Date`
+        - `setTimeout`
+        - `clearTimeout`
+        - `setInterval`
+        - `clearInterval`
+        - `requestAnimationFrame`
+        - `cancelAnimationFrame`
+        - `requestIdleCallback`
+        - `cancelIdleCallback`
+        - `performance`
+
+        Fake timers are used to manually control the flow of time in tests. They allow you to advance time, fire timers,
+        and control the behavior of time-dependent functions. See `clock.run_for()` and
+        `clock.fast_forward()` for more information.
+
+        Parameters
+        ----------
+        time : Union[datetime.datetime, int, str, None]
+            Time to initialize with, current system time by default.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.install(time=time)))
+
+    def fast_forward(self, ticks: typing.Union[int, str]) -> None:
+        """Clock.fast_forward
+
+        Advance the clock by jumping forward in time. Only fires due timers at most once. This is equivalent to user
+        closing the laptop lid for a while and reopening it later, after given time.
+
+        **Usage**
+
+        ```py
+        page.clock.fast_forward(1000)
+        page.clock.fast_forward(\"30:00\")
+        ```
+
+        Parameters
+        ----------
+        ticks : Union[int, str]
+            Time may be the number of milliseconds to advance the clock by or a human-readable string. Valid string formats are
+            "08" for eight seconds, "01:00" for one minute and "02:34:10" for two hours, 34 minutes and ten seconds.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.fast_forward(ticks=ticks))
+        )
+
+    def pause_at(self, time: typing.Union[int, str, datetime.datetime]) -> None:
+        """Clock.pause_at
+
+        Advance the clock by jumping forward in time and pause the time. Once this method is called, no timers are fired
+        unless `clock.run_for()`, `clock.fast_forward()`, `clock.pause_at()` or
+        `clock.resume()` is called.
+
+        Only fires due timers at most once. This is equivalent to user closing the laptop lid for a while and reopening it
+        at the specified time and pausing.
+
+        **Usage**
+
+        ```py
+        page.clock.pause_at(datetime.datetime(2020, 2, 2))
+        page.clock.pause_at(\"2020-02-02\")
+        ```
+
+        Parameters
+        ----------
+        time : Union[datetime.datetime, int, str]
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.pause_at(time=time)))
+
+    def resume(self) -> None:
+        """Clock.resume
+
+        Resumes timers. Once this method is called, time resumes flowing, timers are fired as usual.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.resume()))
+
+    def run_for(self, ticks: typing.Union[int, str]) -> None:
+        """Clock.run_for
+
+        Advance the clock, firing all the time-related callbacks.
+
+        **Usage**
+
+        ```py
+        page.clock.run_for(1000);
+        page.clock.run_for(\"30:00\")
+        ```
+
+        Parameters
+        ----------
+        ticks : Union[int, str]
+            Time may be the number of milliseconds to advance the clock by or a human-readable string. Valid string formats are
+            "08" for eight seconds, "01:00" for one minute and "02:34:10" for two hours, 34 minutes and ten seconds.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.run_for(ticks=ticks)))
+
+    def set_fixed_time(self, time: typing.Union[int, str, datetime.datetime]) -> None:
+        """Clock.set_fixed_time
+
+        Makes `Date.now` and `new Date()` return fixed fake time at all times, keeps all the timers running.
+
+        **Usage**
+
+        ```py
+        page.clock.set_fixed_time(datetime.datetime.now())
+        page.clock.set_fixed_time(datetime.datetime(2020, 2, 2))
+        page.clock.set_fixed_time(\"2020-02-02\")
+        ```
+
+        Parameters
+        ----------
+        time : Union[datetime.datetime, int, str]
+            Time to be set.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.set_fixed_time(time=time))
+        )
+
+    def set_system_time(self, time: typing.Union[int, str, datetime.datetime]) -> None:
+        """Clock.set_system_time
+
+        Sets current system time but does not trigger any timers.
+
+        **Usage**
+
+        ```py
+        page.clock.set_system_time(datetime.datetime.now())
+        page.clock.set_system_time(datetime.datetime(2020, 2, 2))
+        page.clock.set_system_time(\"2020-02-02\")
+        ```
+
+        Parameters
+        ----------
+        time : Union[datetime.datetime, int, str]
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.set_system_time(time=time))
+        )
+
+
+mapping.register(ClockImpl, Clock)
+
+
 class ConsoleMessage(SyncBase):
     @property
     def type(self) -> str:
@@ -7545,6 +7707,18 @@ def context(self) -> "BrowserContext":
         """
         return mapping.from_impl(self._impl_obj.context)
 
+    @property
+    def clock(self) -> "Clock":
+        """Page.clock
+
+        Playwright has ability to mock clock and passage of time.
+
+        Returns
+        -------
+        Clock
+        """
+        return mapping.from_impl(self._impl_obj.clock)
+
     @property
     def main_frame(self) -> "Frame":
         """Page.main_frame
@@ -9232,7 +9406,7 @@ def unroute_all(
         Parameters
         ----------
         behavior : Union["default", "ignoreErrors", "wait", None]
-            Specifies wether to wait for already running handlers and what to do if they throw errors:
+            Specifies whether to wait for already running handlers and what to do if they throw errors:
             - `'default'` - do not wait for current handler calls (if any) to finish, if unrouted handler throws, it may
               result in unhandled error
             - `'wait'` - wait for current handler calls (if any) to finish
@@ -10765,7 +10939,8 @@ def set_input_files(
         """Page.set_input_files
 
         Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then
-        they are resolved relative to the current working directory. For empty array, clears the selected files.
+        they are resolved relative to the current working directory. For empty array, clears the selected files. For inputs
+        with a `[webkitdirectory]` attribute, only a single directory path is supported.
 
         This method expects `selector` to point to an
         [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside
@@ -11646,7 +11821,7 @@ def expect_response(
         return response.ok
 
         # or with a lambda
-        with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200) as response_info:
+        with page.expect_response(lambda response: response.url == \"https://example.com\" and response.status == 200 and response.request.method == \"get\") as response_info:
             page.get_by_text(\"trigger response\").click()
         response = response_info.value
         return response.ok
@@ -12344,6 +12519,18 @@ def request(self) -> "APIRequestContext":
         """
         return mapping.from_impl(self._impl_obj.request)
 
+    @property
+    def clock(self) -> "Clock":
+        """BrowserContext.clock
+
+        Playwright has ability to mock clock and passage of time.
+
+        Returns
+        -------
+        Clock
+        """
+        return mapping.from_impl(self._impl_obj.clock)
+
     def set_default_navigation_timeout(self, timeout: float) -> None:
         """BrowserContext.set_default_navigation_timeout
 
@@ -12494,21 +12681,22 @@ def grant_permissions(
         ----------
         permissions : Sequence[str]
             A permission or an array of permissions to grant. Permissions can be one of the following values:
-            - `'geolocation'`
-            - `'midi'`
-            - `'midi-sysex'` (system-exclusive midi)
-            - `'notifications'`
-            - `'camera'`
-            - `'microphone'`
-            - `'background-sync'`
-            - `'ambient-light-sensor'`
             - `'accelerometer'`
-            - `'gyroscope'`
-            - `'magnetometer'`
             - `'accessibility-events'`
+            - `'ambient-light-sensor'`
+            - `'background-sync'`
+            - `'camera'`
             - `'clipboard-read'`
             - `'clipboard-write'`
+            - `'geolocation'`
+            - `'gyroscope'`
+            - `'magnetometer'`
+            - `'microphone'`
+            - `'midi-sysex'` (system-exclusive midi)
+            - `'midi'`
+            - `'notifications'`
             - `'payment-handler'`
+            - `'storage-access'`
         origin : Union[str, None]
             The [origin] to grant permissions to, e.g. "https://example.com".
         """
@@ -12906,7 +13094,7 @@ def unroute_all(
         Parameters
         ----------
         behavior : Union["default", "ignoreErrors", "wait", None]
-            Specifies wether to wait for already running handlers and what to do if they throw errors:
+            Specifies whether to wait for already running handlers and what to do if they throw errors:
             - `'default'` - do not wait for current handler calls (if any) to finish, if unrouted handler throws, it may
               result in unhandled error
             - `'wait'` - wait for current handler calls (if any) to finish
@@ -13246,9 +13434,9 @@ def contexts(self) -> typing.List["BrowserContext"]:
 
         ```py
         browser = pw.webkit.launch()
-        print(len(browser.contexts())) # prints `0`
+        print(len(browser.contexts)) # prints `0`
         context = browser.new_context()
-        print(len(browser.contexts())) # prints `1`
+        print(len(browser.contexts)) # prints `1`
         ```
 
         Returns
@@ -13399,7 +13587,7 @@ def new_context(
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
-        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None], send: Union["always", "unauthorized", None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
@@ -13615,7 +13803,7 @@ def new_page(
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
-        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None], send: Union["always", "unauthorized", None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
@@ -14168,7 +14356,7 @@ def launch_persistent_context(
         offline : Union[bool, None]
             Whether to emulate network being offline. Defaults to `false`. Learn more about
             [network emulation](../emulation.md#offline).
-        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None], send: Union["always", "unauthorized", None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         device_scale_factor : Union[float, None]
@@ -16726,6 +16914,8 @@ def scroll_into_view_if_needed(
         it is completely visible as defined by
         [IntersectionObserver](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)'s `ratio`.
 
+        See [scrolling](https://playwright.dev/python/docs/input#scrolling) for alternative ways to scroll.
+
         Parameters
         ----------
         timeout : Union[float, None]
@@ -16871,7 +17061,8 @@ def set_input_files(
     ) -> None:
         """Locator.set_input_files
 
-        Upload file or multiple files into `<input type=file>`.
+        Upload file or multiple files into `<input type=file>`. For inputs with a `[webkitdirectory]` attribute, only a
+        single directory path is supported.
 
         **Usage**
 
@@ -16882,6 +17073,9 @@ def set_input_files(
         # Select multiple files
         page.get_by_label(\"Upload files\").set_input_files(['file1.txt', 'file2.txt'])
 
+        # Select a directory
+        page.get_by_label(\"Upload directory\").set_input_files('mydir')
+
         # Remove all the selected files
         page.get_by_label(\"Upload file\").set_input_files([])
 
@@ -17469,15 +17663,22 @@ def dispose(self) -> None:
 
 
 class APIRequestContext(SyncBase):
-    def dispose(self) -> None:
+    def dispose(self, *, reason: typing.Optional[str] = None) -> None:
         """APIRequestContext.dispose
 
         All responses returned by `a_pi_request_context.get()` and similar methods are stored in the memory, so that
         you can later call `a_pi_response.body()`.This method discards all its resources, calling any method on
         disposed `APIRequestContext` will throw an exception.
+
+        Parameters
+        ----------
+        reason : Union[str, None]
+            The reason to be reported to the operations interrupted by the context disposal.
         """
 
-        return mapping.from_maybe_impl(self._sync(self._impl_obj.dispose()))
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.dispose(reason=reason))
+        )
 
     def delete(
         self,
@@ -18148,7 +18349,7 @@ def new_context(
               `http://localhost:3000/bar.html`
         extra_http_headers : Union[Dict[str, str], None]
             An object containing additional HTTP headers to be sent with every request. Defaults to none.
-        http_credentials : Union[{username: str, password: str, origin: Union[str, None]}, None]
+        http_credentials : Union[{username: str, password: str, origin: Union[str, None], send: Union["always", "unauthorized", None]}, None]
             Credentials for [HTTP authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication). If no
             origin is specified, the username and password are sent to any servers upon unauthorized responses.
         ignore_https_errors : Union[bool, None]
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 457212913..f76509443 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -350,6 +350,8 @@ def serialize_python_type(self, value: Any, direction: str) -> str:
             return "Error"
         if str_value == "<class 'NoneType'>":
             return "None"
+        if str_value == "<class 'datetime.datetime'>":
+            return "datetime.datetime"
         match = re.match(r"^<class '((?:pathlib\.)?\w+)'>$", str_value)
         if match:
             return match.group(1)
@@ -489,6 +491,8 @@ def inner_serialize_doc_type(self, type: Any, direction: str) -> str:
             return "Callable"
         if type_name == "Buffer" or type_name == "ReadStream":
             return "bytes"
+        if type_name == "Date":
+            return "datetime.datetime"
         if type_name == "URL":
             return "str"
         if type_name == "RegExp":
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index b35c91cff..3c6f26fbf 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -28,6 +28,7 @@
 from playwright._impl._browser_context import BrowserContext
 from playwright._impl._browser_type import BrowserType
 from playwright._impl._cdp_session import CDPSession
+from playwright._impl._clock import Clock
 from playwright._impl._console_message import ConsoleMessage
 from playwright._impl._dialog import Dialog
 from playwright._impl._download import Download
@@ -212,6 +213,7 @@ def return_value(value: Any) -> List[str]:
 
 import typing
 import pathlib
+import datetime
 
 from typing import Literal
 
@@ -221,6 +223,7 @@ def return_value(value: Any) -> List[str]:
 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._dialog import Dialog as DialogImpl
@@ -260,6 +263,7 @@ def return_value(value: Any) -> List[str]:
     FrameLocator,
     Worker,
     Selectors,
+    Clock,
     ConsoleMessage,
     Dialog,
     Download,
diff --git a/setup.py b/setup.py
index 714bb20fe..46d323f17 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.44.0-beta-1715802478000"
+driver_version = "1.45.0-alpha-2024-06-14"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/assets/input/folderupload.html b/tests/assets/input/folderupload.html
new file mode 100644
index 000000000..b6a2693b7
--- /dev/null
+++ b/tests/assets/input/folderupload.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Folder upload test</title>
+  </head>
+  <body>
+    <form action="/upload" method="post" enctype="multipart/form-data">
+      <input type="file" name="file1" webkitdirectory>
+      <input type="submit">
+    </form>
+  </body>
+</html>
diff --git a/tests/async/conftest.py b/tests/async/conftest.py
index 442d059f4..268c8a433 100644
--- a/tests/async/conftest.py
+++ b/tests/async/conftest.py
@@ -84,6 +84,11 @@ async def browser(
     await browser.close()
 
 
+@pytest.fixture(scope="session")
+async def browser_version(browser: Browser) -> str:
+    return browser.version
+
+
 @pytest.fixture
 async def context_factory(
     browser: Browser,
@@ -101,12 +106,14 @@ async def launch(**kwargs: Any) -> BrowserContext:
 
 
 @pytest.fixture(scope="session")
-async def default_same_site_cookie_value(browser_name: str) -> str:
+async def default_same_site_cookie_value(browser_name: str, is_linux: bool) -> str:
     if browser_name == "chromium":
         return "Lax"
     if browser_name == "firefox":
         return "None"
-    if browser_name == "webkit":
+    if browser_name == "webkit" and is_linux:
+        return "Lax"
+    if browser_name == "webkit" and not is_linux:
         return "None"
     raise Exception(f"Invalid browser_name: {browser_name}")
 
diff --git a/tests/async/test_browsercontext_add_cookies.py b/tests/async/test_browsercontext_add_cookies.py
index 9423ccd63..185a758b0 100644
--- a/tests/async/test_browsercontext_add_cookies.py
+++ b/tests/async/test_browsercontext_add_cookies.py
@@ -233,7 +233,9 @@ async def test_should_have_expires_set_to_neg_1_for_session_cookies(
 
 
 async def test_should_set_cookie_with_reasonable_defaults(
-    context: BrowserContext, server: Server, is_chromium: bool
+    context: BrowserContext,
+    server: Server,
+    default_same_site_cookie_value: str,
 ) -> None:
     await context.add_cookies(
         [{"url": server.EMPTY_PAGE, "name": "defaults", "value": "123456"}]
@@ -249,13 +251,16 @@ async def test_should_set_cookie_with_reasonable_defaults(
             "expires": -1,
             "httpOnly": False,
             "secure": False,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         }
     ]
 
 
 async def test_should_set_a_cookie_with_a_path(
-    context: BrowserContext, page: Page, server: Server, is_chromium: bool
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    default_same_site_cookie_value: str,
 ) -> None:
     await page.goto(server.PREFIX + "/grid.html")
     await context.add_cookies(
@@ -277,7 +282,7 @@ async def test_should_set_a_cookie_with_a_path(
             "expires": -1,
             "httpOnly": False,
             "secure": False,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         }
     ]
     assert await page.evaluate("document.cookie") == "gridcookie=GRID"
@@ -342,7 +347,10 @@ async def test_should_be_able_to_set_unsecure_cookie_for_http_website(
 
 
 async def test_should_set_a_cookie_on_a_different_domain(
-    context: BrowserContext, page: Page, server: Server, is_chromium: bool
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    default_same_site_cookie_value: str,
 ) -> None:
     await page.goto(server.EMPTY_PAGE)
     await context.add_cookies(
@@ -358,7 +366,7 @@ async def test_should_set_a_cookie_on_a_different_domain(
             "expires": -1,
             "httpOnly": False,
             "secure": True,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         }
     ]
 
diff --git a/tests/async/test_browsercontext_cookies.py b/tests/async/test_browsercontext_cookies.py
index e99439507..087d00613 100644
--- a/tests/async/test_browsercontext_cookies.py
+++ b/tests/async/test_browsercontext_cookies.py
@@ -27,7 +27,10 @@ async def test_should_return_no_cookies_in_pristine_browser_context(
 
 
 async def test_should_get_a_cookie(
-    context: BrowserContext, page: Page, server: Server, is_chromium: bool
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    default_same_site_cookie_value: str,
 ) -> None:
     await page.goto(server.EMPTY_PAGE)
     document_cookie = await page.evaluate(
@@ -46,13 +49,16 @@ async def test_should_get_a_cookie(
             "expires": -1,
             "httpOnly": False,
             "secure": False,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         }
     ]
 
 
 async def test_should_get_a_non_session_cookie(
-    context: BrowserContext, page: Page, server: Server, is_chromium: bool
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    default_same_site_cookie_value: str,
 ) -> None:
     await page.goto(server.EMPTY_PAGE)
     # @see https://en.wikipedia.org/wiki/Year_2038_problem
@@ -85,7 +91,7 @@ async def test_should_get_a_non_session_cookie(
             "path": "/",
             "httpOnly": False,
             "secure": False,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         }
     ]
 
@@ -146,7 +152,10 @@ async def test_should_properly_report_lax_sameSite_cookie(
 
 
 async def test_should_get_multiple_cookies(
-    context: BrowserContext, page: Page, server: Server, is_chromium: bool
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    default_same_site_cookie_value: str,
 ) -> None:
     await page.goto(server.EMPTY_PAGE)
     document_cookie = await page.evaluate(
@@ -168,7 +177,7 @@ async def test_should_get_multiple_cookies(
             "expires": -1,
             "httpOnly": False,
             "secure": False,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         },
         {
             "name": "username",
@@ -178,13 +187,13 @@ async def test_should_get_multiple_cookies(
             "expires": -1,
             "httpOnly": False,
             "secure": False,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         },
     ]
 
 
 async def test_should_get_cookies_from_multiple_urls(
-    context: BrowserContext, is_chromium: bool
+    context: BrowserContext, default_same_site_cookie_value: str
 ) -> None:
     await context.add_cookies(
         [
@@ -205,7 +214,7 @@ async def test_should_get_cookies_from_multiple_urls(
             "expires": -1,
             "httpOnly": False,
             "secure": True,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         },
         {
             "name": "doggo",
@@ -215,6 +224,6 @@ async def test_should_get_cookies_from_multiple_urls(
             "expires": -1,
             "httpOnly": False,
             "secure": True,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         },
     ]
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index 7233c084f..f58fd2981 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -24,7 +24,7 @@
 from playwright.async_api import BrowserType, Error, Playwright, Route
 from tests.conftest import RemoteServer
 from tests.server import Server, TestServerRequest, WebSocketProtocol
-from tests.utils import parse_trace
+from tests.utils import chromium_version_less_than, parse_trace
 
 
 async def test_should_print_custom_ws_close_error(
@@ -405,3 +405,59 @@ async def test_set_input_files_should_preserve_last_modified_timestamp(
     # rounds it to seconds in WebKit: 1696272058110 -> 1696272058000.
     for i in range(len(timestamps)):
         assert abs(timestamps[i] - expected_timestamps[i]) < 1000
+
+
+async def test_should_upload_a_folder(
+    browser_type: BrowserType,
+    launch_server: Callable[[], RemoteServer],
+    server: Server,
+    tmp_path: Path,
+    browser_name: str,
+    browser_version: str,
+    headless: bool,
+) -> None:
+    remote = launch_server()
+
+    browser = await browser_type.connect(remote.ws_endpoint)
+    context = await browser.new_context()
+    page = await context.new_page()
+    await page.goto(server.PREFIX + "/input/folderupload.html")
+    input = await page.query_selector("input")
+    assert input
+    dir = tmp_path / "file-upload-test"
+    dir.mkdir()
+    (dir / "file1.txt").write_text("file1 content")
+    (dir / "file2").write_text("file2 content")
+    (dir / "sub-dir").mkdir()
+    (dir / "sub-dir" / "really.txt").write_text("sub-dir file content")
+    await input.set_input_files(dir)
+    assert set(
+        await input.evaluate("e => [...e.files].map(f => f.webkitRelativePath)")
+    ) == set(
+        [
+            "file-upload-test/file1.txt",
+            "file-upload-test/file2",
+            # https://issues.chromium.org/issues/345393164
+            *(
+                []
+                if browser_name == "chromium"
+                and headless
+                and chromium_version_less_than(browser_version, "127.0.6533.0")
+                else ["file-upload-test/sub-dir/really.txt"]
+            ),
+        ]
+    )
+    webkit_relative_paths = await input.evaluate(
+        "e => [...e.files].map(f => f.webkitRelativePath)"
+    )
+    for i, webkit_relative_path in enumerate(webkit_relative_paths):
+        content = await input.evaluate(
+            """(e, i) => {
+            const reader = new FileReader();
+            const promise = new Promise(fulfill => reader.onload = fulfill);
+            reader.readAsText(e.files[i]);
+            return promise.then(() => reader.result);
+        }""",
+            i,
+        )
+        assert content == (dir / ".." / webkit_relative_path).read_text()
diff --git a/tests/async/test_defaultbrowsercontext.py b/tests/async/test_defaultbrowsercontext.py
index e5d06ff96..ff3b32489 100644
--- a/tests/async/test_defaultbrowsercontext.py
+++ b/tests/async/test_defaultbrowsercontext.py
@@ -15,7 +15,16 @@
 import asyncio
 import os
 from pathlib import Path
-from typing import Any, AsyncGenerator, Awaitable, Callable, Dict, Optional, Tuple
+from typing import (
+    Any,
+    AsyncGenerator,
+    Awaitable,
+    Callable,
+    Dict,
+    Literal,
+    Optional,
+    Tuple,
+)
 
 import pytest
 
@@ -49,7 +58,7 @@ async def _launch(**options: Any) -> Tuple[Page, BrowserContext]:
 async def test_context_cookies_should_work(
     server: Server,
     launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
-    is_chromium: bool,
+    default_same_site_cookie_value: str,
 ) -> None:
     (page, context) = await launch_persistent()
     await page.goto(server.EMPTY_PAGE)
@@ -70,7 +79,7 @@ async def test_context_cookies_should_work(
             "expires": -1,
             "httpOnly": False,
             "secure": False,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         }
     ]
 
@@ -78,12 +87,19 @@ async def test_context_cookies_should_work(
 async def test_context_add_cookies_should_work(
     server: Server,
     launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
-    is_chromium: bool,
+    default_same_site_cookie_value: Literal["Lax", "None", "Strict"],
 ) -> None:
     (page, context) = await launch_persistent()
     await page.goto(server.EMPTY_PAGE)
     await page.context.add_cookies(
-        [{"url": server.EMPTY_PAGE, "name": "username", "value": "John Doe"}]
+        [
+            {
+                "url": server.EMPTY_PAGE,
+                "name": "username",
+                "value": "John Doe",
+                "sameSite": default_same_site_cookie_value,
+            }
+        ]
     )
     assert await page.evaluate("() => document.cookie") == "username=John Doe"
     assert await page.context.cookies() == [
@@ -95,7 +111,7 @@ async def test_context_add_cookies_should_work(
             "expires": -1,
             "httpOnly": False,
             "secure": False,
-            "sameSite": "Lax" if is_chromium else "None",
+            "sameSite": default_same_site_cookie_value,
         }
     ]
 
diff --git a/tests/async/test_fetch_browser_context.py b/tests/async/test_fetch_browser_context.py
index 695b140b7..72f957cc1 100644
--- a/tests/async/test_fetch_browser_context.py
+++ b/tests/async/test_fetch_browser_context.py
@@ -13,13 +13,14 @@
 # limitations under the License.
 
 import asyncio
+import base64
 import json
-from typing import Any, cast
+from typing import Any, Callable, cast
 from urllib.parse import parse_qs
 
 import pytest
 
-from playwright.async_api import BrowserContext, Error, FilePayload, Page
+from playwright.async_api import Browser, BrowserContext, Error, FilePayload, Page
 from tests.server import Server
 from tests.utils import must
 
@@ -150,6 +151,66 @@ async def test_should_not_add_context_cookie_if_cookie_header_passed_as_paramete
     assert server_req.getHeader("Cookie") == "foo=bar"
 
 
+async def test_should_support_http_credentials_send_immediately_for_browser_context(
+    context_factory: "Callable[..., asyncio.Future[BrowserContext]]", server: Server
+) -> None:
+    context = await context_factory(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX.upper(),
+            "send": "always",
+        }
+    )
+    # First request
+    server_request, response = await asyncio.gather(
+        server.wait_for_request("/empty.html"), context.request.get(server.EMPTY_PAGE)
+    )
+    expected_auth = "Basic " + base64.b64encode(b"user:pass").decode()
+    assert server_request.getHeader("authorization") == expected_auth
+    assert response.status == 200
+
+    # Second request
+    server_request, response = await asyncio.gather(
+        server.wait_for_request("/empty.html"),
+        context.request.get(server.CROSS_PROCESS_PREFIX + "/empty.html"),
+    )
+    # Not sent to another origin.
+    assert server_request.getHeader("authorization") is None
+    assert response.status == 200
+
+
+async def test_support_http_credentials_send_immediately_for_browser_new_page(
+    server: Server, browser: Browser
+) -> None:
+    page = await browser.new_page(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX.upper(),
+            "send": "always",
+        }
+    )
+    server_request, response = await asyncio.gather(
+        server.wait_for_request("/empty.html"), page.request.get(server.EMPTY_PAGE)
+    )
+    assert (
+        server_request.getHeader("authorization")
+        == "Basic " + base64.b64encode(b"user:pass").decode()
+    )
+    assert response.status == 200
+
+    server_request, response = await asyncio.gather(
+        server.wait_for_request("/empty.html"),
+        page.request.get(server.CROSS_PROCESS_PREFIX + "/empty.html"),
+    )
+    # Not sent to another origin.
+    assert server_request.getHeader("authorization") is None
+    assert response.status == 200
+
+    await page.close()
+
+
 @pytest.mark.parametrize("method", ["delete", "patch", "post", "put"])
 async def test_should_support_post_data(
     context: BrowserContext, method: str, server: Server
@@ -243,3 +304,11 @@ async def test_should_add_default_headers(
     assert request.getHeader("User-Agent") == await page.evaluate(
         "() => navigator.userAgent"
     )
+
+
+async def test_should_work_after_context_dispose(
+    context: BrowserContext, server: Server
+) -> None:
+    await context.close(reason="Test ended.")
+    with pytest.raises(Error, match="Test ended."):
+        await context.request.get(server.EMPTY_PAGE)
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index 5e26f4550..eda3145ee 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import asyncio
+import base64
 import json
 import sys
 from pathlib import Path
@@ -56,6 +57,15 @@ async def test_should_dispose_global_request(
         await response.body()
 
 
+async def test_should_dispose_with_custom_error_message(
+    playwright: Playwright, server: Server
+) -> None:
+    request = await playwright.request.new_context()
+    await request.dispose(reason="My reason")
+    with pytest.raises(Error, match="My reason"):
+        await request.get(server.EMPTY_PAGE)
+
+
 async def test_should_support_global_user_agent_option(
     playwright: Playwright, server: Server
 ) -> None:
@@ -204,6 +214,35 @@ async def test_should_return_error_with_correct_credentials_and_mismatching_port
     await response.dispose()
 
 
+async def test_support_http_credentials_send_immediately(
+    playwright: Playwright, server: Server
+) -> None:
+    request = await playwright.request.new_context(
+        http_credentials={
+            "username": "user",
+            "password": "pass",
+            "origin": server.PREFIX.upper(),
+            "send": "always",
+        }
+    )
+    server_request, response = await asyncio.gather(
+        server.wait_for_request("/empty.html"), request.get(server.EMPTY_PAGE)
+    )
+    assert (
+        server_request.getHeader("authorization")
+        == "Basic " + base64.b64encode(b"user:pass").decode()
+    )
+    assert response.status == 200
+
+    server_request, response = await asyncio.gather(
+        server.wait_for_request("/empty.html"),
+        request.get(server.CROSS_PROCESS_PREFIX + "/empty.html"),
+    )
+    # Not sent to another origin.
+    assert server_request.getHeader("authorization") is None
+    assert response.status == 200
+
+
 async def test_should_support_global_ignore_https_errors_option(
     playwright: Playwright, https_server: Server
 ) -> None:
diff --git a/tests/async/test_input.py b/tests/async/test_input.py
index 5898d1a6f..f9c487867 100644
--- a/tests/async/test_input.py
+++ b/tests/async/test_input.py
@@ -24,9 +24,9 @@
 from flaky import flaky
 
 from playwright._impl._path_utils import get_file_dirname
-from playwright.async_api import FilePayload, Page
+from playwright.async_api import Error, FilePayload, Page
 from tests.server import Server
-from tests.utils import must
+from tests.utils import chromium_version_less_than, must
 
 _dirname = get_file_dirname()
 FILE_TO_UPLOAD = _dirname / ".." / "assets/file-to-upload.txt"
@@ -412,3 +412,101 @@ async def test_should_upload_multiple_large_file(
     assert files_len == files_count
     for path in upload_files:
         path.unlink()
+
+
+async def test_should_upload_a_folder(
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    browser_name: str,
+    browser_version: str,
+    headless: bool,
+) -> None:
+    await page.goto(server.PREFIX + "/input/folderupload.html")
+    input = await page.query_selector("input")
+    assert input
+    dir = tmp_path / "file-upload-test"
+    dir.mkdir()
+    (dir / "file1.txt").write_text("file1 content")
+    (dir / "file2").write_text("file2 content")
+    (dir / "sub-dir").mkdir()
+    (dir / "sub-dir" / "really.txt").write_text("sub-dir file content")
+    await input.set_input_files(dir)
+    assert set(
+        await input.evaluate("e => [...e.files].map(f => f.webkitRelativePath)")
+    ) == set(
+        [
+            "file-upload-test/file1.txt",
+            "file-upload-test/file2",
+            # https://issues.chromium.org/issues/345393164
+            *(
+                []
+                if browser_name == "chromium"
+                and headless
+                and chromium_version_less_than(browser_version, "127.0.6533.0")
+                else ["file-upload-test/sub-dir/really.txt"]
+            ),
+        ]
+    )
+    webkit_relative_paths = await input.evaluate(
+        "e => [...e.files].map(f => f.webkitRelativePath)"
+    )
+    for i, webkit_relative_path in enumerate(webkit_relative_paths):
+        content = await input.evaluate(
+            """(e, i) => {
+            const reader = new FileReader();
+            const promise = new Promise(fulfill => reader.onload = fulfill);
+            reader.readAsText(e.files[i]);
+            return promise.then(() => reader.result);
+        }""",
+            i,
+        )
+        assert content == (dir / ".." / webkit_relative_path).read_text()
+
+
+async def test_should_upload_a_folder_and_throw_for_multiple_directories(
+    page: Page, server: Server, tmp_path: Path
+) -> None:
+    await page.goto(server.PREFIX + "/input/folderupload.html")
+    input = page.locator("input")
+    dir = tmp_path / "file-upload-test"
+    dir.mkdir()
+    (dir / "folder1").mkdir()
+    (dir / "folder1" / "file1.txt").write_text("file1 content")
+    (dir / "folder2").mkdir()
+    (dir / "folder2" / "file2.txt").write_text("file2 content")
+    with pytest.raises(Error) as exc_info:
+        await input.set_input_files([dir / "folder1", dir / "folder2"])
+    assert "Multiple directories are not supported" in exc_info.value.message
+
+
+async def test_should_throw_if_a_directory_and_files_are_passed(
+    page: Page, server: Server, tmp_path: Path
+) -> None:
+    await page.goto(server.PREFIX + "/input/folderupload.html")
+    input = page.locator("input")
+    dir = tmp_path / "file-upload-test"
+    dir.mkdir()
+    (dir / "file1.txt").write_text("file1 content")
+    with pytest.raises(Error) as exc_info:
+        await input.set_input_files([dir, dir / "file1.txt"])
+    assert (
+        "File paths must be all files or a single directory" in exc_info.value.message
+    )
+
+
+async def test_should_throw_when_upload_a_folder_in_a_normal_file_upload_input(
+    page: Page, server: Server, tmp_path: Path
+) -> None:
+    await page.goto(server.PREFIX + "/input/fileupload.html")
+    input = await page.query_selector("input")
+    assert input
+    dir = tmp_path / "file-upload-test"
+    dir.mkdir()
+    (dir / "file1.txt").write_text("file1 content")
+    with pytest.raises(Error) as exc_info:
+        await input.set_input_files(dir)
+    assert (
+        "File input does not support directories, pass individual files instead"
+        in exc_info.value.message
+    )
diff --git a/tests/async/test_network.py b/tests/async/test_network.py
index b97d38f29..0725516bd 100644
--- a/tests/async/test_network.py
+++ b/tests/async/test_network.py
@@ -28,6 +28,14 @@
 from .utils import Utils
 
 
+def adjust_server_headers(headers: Dict[str, str], browser_name: str) -> Dict[str, str]:
+    if browser_name != "firefox":
+        return headers
+    headers = headers.copy()
+    headers.pop("priority", None)
+    return headers
+
+
 async def test_request_fulfill(page: Page, server: Server) -> None:
     async def handle_request(route: Route, request: Request) -> None:
         headers = await route.request.all_headers()
@@ -193,7 +201,11 @@ async def test_request_headers_should_work(
 
 
 async def test_request_headers_should_get_the_same_headers_as_the_server(
-    page: Page, server: Server, is_webkit: bool, is_win: bool
+    page: Page,
+    server: Server,
+    is_webkit: bool,
+    is_win: bool,
+    browser_name: str,
 ) -> None:
     if is_webkit and is_win:
         pytest.xfail("Curl does not show accept-encoding and accept-language")
@@ -211,12 +223,14 @@ def handle(request: http.Request) -> None:
     server.set_route("/empty.html", handle)
     response = await page.goto(server.EMPTY_PAGE)
     assert response
-    server_headers = await server_request_headers_future
+    server_headers = adjust_server_headers(
+        await server_request_headers_future, browser_name
+    )
     assert await response.request.all_headers() == server_headers
 
 
 async def test_request_headers_should_get_the_same_headers_as_the_server_cors(
-    page: Page, server: Server, is_webkit: bool, is_win: bool
+    page: Page, server: Server, is_webkit: bool, is_win: bool, browser_name: str
 ) -> None:
     if is_webkit and is_win:
         pytest.xfail("Curl does not show accept-encoding and accept-language")
@@ -246,7 +260,9 @@ def handle_something(request: http.Request) -> None:
         )
     request = await request_info.value
     assert text == "done"
-    server_headers = await server_request_headers_future
+    server_headers = adjust_server_headers(
+        await server_request_headers_future, browser_name
+    )
     assert await request.all_headers() == server_headers
 
 
@@ -260,6 +276,8 @@ async def test_should_report_request_headers_array(
     def handle(request: http.Request) -> None:
         for name, values in request.requestHeaders.getAllRawHeaders():
             for value in values:
+                if browser_name == "firefox" and name.decode().lower() == "priority":
+                    continue
                 expected_headers.append(
                     {"name": name.decode().lower(), "value": value.decode()}
                 )
diff --git a/tests/async/test_page_clock.py b/tests/async/test_page_clock.py
new file mode 100644
index 000000000..1339efaae
--- /dev/null
+++ b/tests/async/test_page_clock.py
@@ -0,0 +1,487 @@
+# 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 datetime
+from typing import Any, AsyncGenerator, List
+
+import pytest
+
+from playwright.async_api import Error, Page
+from tests.server import Server
+
+
+@pytest.fixture(autouse=True)
+async def calls(page: Page) -> List[Any]:
+    calls: List[Any] = []
+    await page.expose_function("stub", lambda *args: calls.append(list(args)))
+    return calls
+
+
+class TestRunFor:
+    @pytest.fixture(autouse=True)
+    async def before_each(self, page: Page) -> AsyncGenerator[None, None]:
+        await page.clock.install(time=0)
+        await page.clock.pause_at(1000)
+        yield
+
+    async def test_run_for_triggers_immediately_without_specified_delay(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate("setTimeout(window.stub)")
+        await page.clock.run_for(0)
+        assert len(calls) == 1
+
+    async def test_run_for_does_not_trigger_without_sufficient_delay(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate("setTimeout(window.stub, 100)")
+        await page.clock.run_for(10)
+        assert len(calls) == 0
+
+    async def test_run_for_triggers_after_sufficient_delay(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate("setTimeout(window.stub, 100)")
+        await page.clock.run_for(100)
+        assert len(calls) == 1
+
+    async def test_run_for_triggers_simultaneous_timers(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate(
+            "setTimeout(window.stub, 100); setTimeout(window.stub, 100)"
+        )
+        await page.clock.run_for(100)
+        assert len(calls) == 2
+
+    async def test_run_for_triggers_multiple_simultaneous_timers(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate(
+            "setTimeout(window.stub, 100); setTimeout(window.stub, 100); setTimeout(window.stub, 99); setTimeout(window.stub, 100)"
+        )
+        await page.clock.run_for(100)
+        assert len(calls) == 4
+
+    async def test_run_for_waits_after_setTimeout_was_called(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate("setTimeout(window.stub, 150)")
+        await page.clock.run_for(50)
+        assert len(calls) == 0
+        await page.clock.run_for(100)
+        assert len(calls) == 1
+
+    async def test_run_for_triggers_event_when_some_throw(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate(
+            "setTimeout(() => { throw new Error(); }, 100); setTimeout(window.stub, 120)"
+        )
+        with pytest.raises(Error):
+            await page.clock.run_for(120)
+        assert len(calls) == 1
+
+    async def test_run_for_creates_updated_Date_while_ticking(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.clock.set_system_time(0)
+        await page.evaluate(
+            "setInterval(() => { window.stub(new Date().getTime()); }, 10)"
+        )
+        await page.clock.run_for(100)
+        assert calls == [
+            [10],
+            [20],
+            [30],
+            [40],
+            [50],
+            [60],
+            [70],
+            [80],
+            [90],
+            [100],
+        ]
+
+    async def test_run_for_passes_8_seconds(self, page: Page, calls: List[Any]) -> None:
+        await page.evaluate("setInterval(window.stub, 4000)")
+        await page.clock.run_for("08")
+        assert len(calls) == 2
+
+    async def test_run_for_passes_1_minute(self, page: Page, calls: List[Any]) -> None:
+        await page.evaluate("setInterval(window.stub, 6000)")
+        await page.clock.run_for("01:00")
+        assert len(calls) == 10
+
+    async def test_run_for_passes_2_hours_34_minutes_and_10_seconds(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate("setInterval(window.stub, 10000)")
+        await page.clock.run_for("02:34:10")
+        assert len(calls) == 925
+
+    async def test_run_for_throws_for_invalid_format(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate("setInterval(window.stub, 10000)")
+        with pytest.raises(Error):
+            await page.clock.run_for("12:02:34:10")
+        assert len(calls) == 0
+
+    async def test_run_for_returns_the_current_now_value(self, page: Page) -> None:
+        await page.clock.set_system_time(0)
+        value = 200
+        await page.clock.run_for(value)
+        assert await page.evaluate("Date.now()") == value
+
+
+class TestFastForward:
+    @pytest.fixture(autouse=True)
+    async def before_each(self, page: Page) -> AsyncGenerator[None, None]:
+        await page.clock.install(time=0)
+        await page.clock.pause_at(1000)
+        yield
+
+    async def test_ignores_timers_which_wouldnt_be_run(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate(
+            "setTimeout(() => { window.stub('should not be logged'); }, 1000)"
+        )
+        await page.clock.fast_forward(500)
+        assert len(calls) == 0
+
+    async def test_pushes_back_execution_time_for_skipped_timers(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate("setTimeout(() => { window.stub(Date.now()); }, 1000)")
+        await page.clock.fast_forward(2000)
+        assert calls == [[1000 + 2000]]
+
+    async def test_supports_string_time_arguments(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate(
+            "setTimeout(() => { window.stub(Date.now()); }, 100000)"
+        )  # 100000 = 1:40
+        await page.clock.fast_forward("01:50")
+        assert calls == [[1000 + 110000]]
+
+
+class TestStubTimers:
+    @pytest.fixture(autouse=True)
+    async def before_each(self, page: Page) -> AsyncGenerator[None, None]:
+        await page.clock.install(time=0)
+        await page.clock.pause_at(1000)
+        yield
+
+    async def test_sets_initial_timestamp(self, page: Page) -> None:
+        await page.clock.set_system_time(1400)
+        assert await page.evaluate("Date.now()") == 1400
+
+    async def test_replaces_global_setTimeout(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate("setTimeout(window.stub, 1000)")
+        await page.clock.run_for(1000)
+        assert len(calls) == 1
+
+    async def test_global_fake_setTimeout_should_return_id(self, page: Page) -> None:
+        to = await page.evaluate("setTimeout(window.stub, 1000)")
+        assert isinstance(to, int)
+
+    async def test_replaces_global_clearTimeout(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate(
+            """
+            const to = setTimeout(window.stub, 1000);
+            clearTimeout(to);
+        """
+        )
+        await page.clock.run_for(1000)
+        assert len(calls) == 0
+
+    async def test_replaces_global_setInterval(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate("setInterval(window.stub, 500)")
+        await page.clock.run_for(1000)
+        assert len(calls) == 2
+
+    async def test_replaces_global_clearInterval(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.evaluate(
+            """
+            const to = setInterval(window.stub, 500);
+            clearInterval(to);
+        """
+        )
+        await page.clock.run_for(1000)
+        assert len(calls) == 0
+
+    async def test_replaces_global_performance_now(self, page: Page) -> None:
+        promise = asyncio.create_task(
+            page.evaluate(
+                """async () => {
+            const prev = performance.now();
+            await new Promise(f => setTimeout(f, 1000));
+            const next = performance.now();
+            return { prev, next };
+        }"""
+            )
+        )
+        await asyncio.sleep(0)  # Make sure the promise is scheduled.
+        await page.clock.run_for(1000)
+        assert await promise == {"prev": 1000, "next": 2000}
+
+    async def test_fakes_Date_constructor(self, page: Page) -> None:
+        now = await page.evaluate("new Date().getTime()")
+        assert now == 1000
+
+
+class TestStubTimersPerformance:
+    async def test_replaces_global_performance_time_origin(self, page: Page) -> None:
+        await page.clock.install(time=1000)
+        await page.clock.pause_at(2000)
+        promise = asyncio.create_task(
+            page.evaluate(
+                """async () => {
+            const prev = performance.now();
+            await new Promise(f => setTimeout(f, 1000));
+            const next = performance.now();
+            return { prev, next };
+        }"""
+            )
+        )
+        await asyncio.sleep(0)  # Make sure the promise is scheduled.
+        await page.clock.run_for(1000)
+        assert await page.evaluate("performance.timeOrigin") == 1000
+        assert await promise == {"prev": 1000, "next": 2000}
+
+
+class TestPopup:
+    async def test_should_tick_after_popup(self, page: Page) -> None:
+        await page.clock.install(time=0)
+        now = datetime.datetime.fromisoformat("2015-09-25")
+        await page.clock.pause_at(now)
+        popup, _ = await asyncio.gather(
+            page.wait_for_event("popup"), page.evaluate("window.open('about:blank')")
+        )
+        popup_time = await popup.evaluate("Date.now()")
+        assert popup_time == now.timestamp()
+        await page.clock.run_for(1000)
+        popup_time_after = await popup.evaluate("Date.now()")
+        assert popup_time_after == now.timestamp() + 1000
+
+    async def test_should_tick_before_popup(self, page: Page) -> None:
+        await page.clock.install(time=0)
+        now = datetime.datetime.fromisoformat("2015-09-25")
+        await page.clock.pause_at(now)
+        await page.clock.run_for(1000)
+        popup, _ = await asyncio.gather(
+            page.wait_for_event("popup"), page.evaluate("window.open('about:blank')")
+        )
+        popup_time = await popup.evaluate("Date.now()")
+        assert popup_time == int(now.timestamp() + 1000)
+
+    async def test_should_run_time_before_popup(
+        self, page: Page, server: Server
+    ) -> None:
+        server.set_route(
+            "/popup.html",
+            lambda res: (
+                res.setHeader("Content-Type", "text/html"),
+                res.write(b"<script>window.time = Date.now()</script>"),
+                res.finish(),
+            ),
+        )
+        await page.goto(server.EMPTY_PAGE)
+        # Wait for 2 second in real life to check that it is past in popup.
+        await page.wait_for_timeout(2000)
+        popup, _ = await asyncio.gather(
+            page.wait_for_event("popup"),
+            page.evaluate("window.open('{}')".format(server.PREFIX + "/popup.html")),
+        )
+        popup_time = await popup.evaluate("window.time")
+        assert popup_time >= 2000
+
+    async def test_should_not_run_time_before_popup_on_pause(
+        self, page: Page, server: Server
+    ) -> None:
+        server.set_route(
+            "/popup.html",
+            lambda res: (
+                res.setHeader("Content-Type", "text/html"),
+                res.write(b"<script>window.time = Date.now()</script>"),
+                res.finish(),
+            ),
+        )
+        await page.clock.install(time=0)
+        await page.clock.pause_at(1000)
+        await page.goto(server.EMPTY_PAGE)
+        # Wait for 2 second in real life to check that it is past in popup.
+        await page.wait_for_timeout(2000)
+        popup, _ = await asyncio.gather(
+            page.wait_for_event("popup"),
+            page.evaluate("window.open('{}')".format(server.PREFIX + "/popup.html")),
+        )
+        popup_time = await popup.evaluate("window.time")
+        assert popup_time == 1000
+
+
+class TestSetFixedTime:
+    async def test_does_not_fake_methods(self, page: Page) -> None:
+        await page.clock.set_fixed_time(0)
+        # Should not stall.
+        await page.evaluate("new Promise(f => setTimeout(f, 1))")
+
+    async def test_allows_setting_time_multiple_times(self, page: Page) -> None:
+        await page.clock.set_fixed_time(100)
+        assert await page.evaluate("Date.now()") == 100
+        await page.clock.set_fixed_time(200)
+        assert await page.evaluate("Date.now()") == 200
+
+    async def test_fixed_time_is_not_affected_by_clock_manipulation(
+        self, page: Page
+    ) -> None:
+        await page.clock.set_fixed_time(100)
+        assert await page.evaluate("Date.now()") == 100
+        await page.clock.fast_forward(20)
+        assert await page.evaluate("Date.now()") == 100
+
+    async def test_allows_installing_fake_timers_after_setting_time(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.clock.set_fixed_time(100)
+        assert await page.evaluate("Date.now()") == 100
+        await page.clock.set_fixed_time(200)
+        await page.evaluate("setTimeout(() => window.stub(Date.now()))")
+        await page.clock.run_for(0)
+        assert calls == [[200]]
+
+
+class TestWhileRunning:
+    async def test_should_progress_time(self, page: Page) -> None:
+        await page.clock.install(time=0)
+        await page.goto("data:text/html,")
+        await page.wait_for_timeout(1000)
+        now = await page.evaluate("Date.now()")
+        assert 1000 <= now <= 2000
+
+    async def test_should_run_for(self, page: Page) -> None:
+        await page.clock.install(time=0)
+        await page.goto("data:text/html,")
+        await page.clock.run_for(10000)
+        now = await page.evaluate("Date.now()")
+        assert 10000 <= now <= 11000
+
+    async def test_should_fast_forward(self, page: Page) -> None:
+        await page.clock.install(time=0)
+        await page.goto("data:text/html,")
+        await page.clock.fast_forward(10000)
+        now = await page.evaluate("Date.now()")
+        assert 10000 <= now <= 11000
+
+    async def test_should_fast_forward_to(self, page: Page) -> None:
+        await page.clock.install(time=0)
+        await page.goto("data:text/html,")
+        await page.clock.fast_forward(10000)
+        now = await page.evaluate("Date.now()")
+        assert 10000 <= now <= 11000
+
+    async def test_should_pause(self, page: Page) -> None:
+        await page.clock.install(time=0)
+        await page.goto("data:text/html,")
+        await page.clock.pause_at(1000)
+        await page.wait_for_timeout(1000)
+        await page.clock.resume()
+        now = await page.evaluate("Date.now()")
+        assert 0 <= now <= 1000
+
+    async def test_should_pause_and_fast_forward(self, page: Page) -> None:
+        await page.clock.install(time=0)
+        await page.goto("data:text/html,")
+        await page.clock.pause_at(1000)
+        await page.clock.fast_forward(1000)
+        now = await page.evaluate("Date.now()")
+        assert now == 2000
+
+    async def test_should_set_system_time_on_pause(self, page: Page) -> None:
+        await page.clock.install(time=0)
+        await page.goto("data:text/html,")
+        await page.clock.pause_at(1000)
+        now = await page.evaluate("Date.now()")
+        assert now == 1000
+
+
+class TestWhileOnPause:
+    async def test_fast_forward_should_not_run_nested_immediate(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.clock.install(time=0)
+        await page.goto("data:text/html,")
+        await page.clock.pause_at(1000)
+        await page.evaluate(
+            """
+            setTimeout(() => {
+                window.stub('outer');
+                setTimeout(() => window.stub('inner'), 0);
+            }, 1000);
+        """
+        )
+        await page.clock.fast_forward(1000)
+        assert calls == [["outer"]]
+        await page.clock.fast_forward(1)
+        assert calls == [["outer"], ["inner"]]
+
+    async def test_run_for_should_not_run_nested_immediate(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.clock.install(time=0)
+        await page.goto("data:text/html,")
+        await page.clock.pause_at(1000)
+        await page.evaluate(
+            """
+            setTimeout(() => {
+                window.stub('outer');
+                setTimeout(() => window.stub('inner'), 0);
+            }, 1000);
+        """
+        )
+        await page.clock.run_for(1000)
+        assert calls == [["outer"]]
+        await page.clock.run_for(1)
+        assert calls == [["outer"], ["inner"]]
+
+    async def test_run_for_should_not_run_nested_immediate_from_microtask(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        await page.clock.install(time=0)
+        await page.goto("data:text/html,")
+        await page.clock.pause_at(1000)
+        await page.evaluate(
+            """
+            setTimeout(() => {
+                window.stub('outer');
+                void Promise.resolve().then(() => setTimeout(() => window.stub('inner'), 0));
+            }, 1000);
+        """
+        )
+        await page.clock.run_for(1000)
+        assert calls == [["outer"]]
+        await page.clock.run_for(1)
+        assert calls == [["outer"], ["inner"]]
diff --git a/tests/async/test_request_continue.py b/tests/async/test_request_continue.py
index eb7dfbfda..b322d01fb 100644
--- a/tests/async/test_request_continue.py
+++ b/tests/async/test_request_continue.py
@@ -16,7 +16,7 @@
 from typing import Optional
 
 from playwright.async_api import Page, Route
-from tests.server import Server
+from tests.server import Server, TestServerRequest
 
 
 async def test_request_continue_should_work(page: Page, server: Server) -> None:
@@ -145,3 +145,52 @@ async def test_should_amend_binary_post_data(page: Page, server: Server) -> None
     )
     assert server_request.method == b"POST"
     assert server_request.post_body == b"\x00\x01\x02\x03\x04"
+
+
+async def test_continue_should_not_change_multipart_form_data_body(
+    page: Page, server: Server, browser_name: str
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    server.set_route(
+        "/upload",
+        lambda context: (
+            context.write(b"done"),
+            context.setHeader("Content-Type", "text/plain"),
+            context.finish(),
+        ),
+    )
+
+    async def send_form_data() -> TestServerRequest:
+        req_task = asyncio.create_task(server.wait_for_request("/upload"))
+        status = await page.evaluate(
+            """async () => {
+            const newFile = new File(['file content'], 'file.txt');
+            const formData = new FormData();
+            formData.append('file', newFile);
+            const response = await fetch('/upload', {
+                method: 'POST',
+                credentials: 'include',
+                body: formData,
+            });
+            return response.status;
+        }"""
+        )
+        req = await req_task
+        assert status == 200
+        return req
+
+    req_before = await send_form_data()
+    await page.route("**/*", lambda route: route.continue_())
+    req_after = await send_form_data()
+
+    file_content = (
+        'Content-Disposition: form-data; name="file"; filename="file.txt"\r\n'
+        "Content-Type: application/octet-stream\r\n"
+        "\r\n"
+        "file content\r\n"
+        "------"
+    )
+    assert req_before.post_body
+    assert req_after.post_body
+    assert file_content in req_before.post_body.decode()
+    assert file_content in req_after.post_body.decode()
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 07509e10e..4ed1b578a 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -356,7 +356,7 @@ def test_locators_should_select_textarea(
     textarea = page.locator("textarea")
     textarea.evaluate("textarea => textarea.value = 'some value'")
     textarea.select_text()
-    textarea.select_text(timeout=1_000)
+    textarea.select_text(timeout=25_000)
     if browser_name == "firefox" or browser_name == "webkit":
         assert textarea.evaluate("el => el.selectionStart") == 0
         assert textarea.evaluate("el => el.selectionEnd") == 10
diff --git a/tests/sync/test_page_clock.py b/tests/sync/test_page_clock.py
new file mode 100644
index 000000000..8759ec49d
--- /dev/null
+++ b/tests/sync/test_page_clock.py
@@ -0,0 +1,464 @@
+# 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 datetime
+from typing import Any, Generator, List
+
+import pytest
+
+from playwright.sync_api import Error, Page
+from tests.server import Server
+
+
+@pytest.fixture(autouse=True)
+def calls(page: Page) -> List[Any]:
+    calls: List[Any] = []
+    page.expose_function("stub", lambda *args: calls.append(list(args)))
+    return calls
+
+
+class TestRunFor:
+    @pytest.fixture(autouse=True)
+    def before_each(self, page: Page) -> Generator[None, None, None]:
+        page.clock.install(time=0)
+        page.clock.pause_at(1000)
+        yield
+
+    def test_run_for_triggers_immediately_without_specified_delay(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate("setTimeout(window.stub)")
+        page.clock.run_for(0)
+        assert len(calls) == 1
+
+    def test_run_for_does_not_trigger_without_sufficient_delay(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate("setTimeout(window.stub, 100)")
+        page.clock.run_for(10)
+        assert len(calls) == 0
+
+    def test_run_for_triggers_after_sufficient_delay(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate("setTimeout(window.stub, 100)")
+        page.clock.run_for(100)
+        assert len(calls) == 1
+
+    def test_run_for_triggers_simultaneous_timers(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate("setTimeout(window.stub, 100); setTimeout(window.stub, 100)")
+        page.clock.run_for(100)
+        assert len(calls) == 2
+
+    def test_run_for_triggers_multiple_simultaneous_timers(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate(
+            "setTimeout(window.stub, 100); setTimeout(window.stub, 100); setTimeout(window.stub, 99); setTimeout(window.stub, 100)"
+        )
+        page.clock.run_for(100)
+        assert len(calls) == 4
+
+    def test_run_for_waits_after_setTimeout_was_called(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate("setTimeout(window.stub, 150)")
+        page.clock.run_for(50)
+        assert len(calls) == 0
+        page.clock.run_for(100)
+        assert len(calls) == 1
+
+    def test_run_for_triggers_event_when_some_throw(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate(
+            "setTimeout(() => { throw new Error(); }, 100); setTimeout(window.stub, 120)"
+        )
+        with pytest.raises(Error):
+            page.clock.run_for(120)
+        assert len(calls) == 1
+
+    def test_run_for_creates_updated_Date_while_ticking(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.clock.set_system_time(0)
+        page.evaluate("setInterval(() => { window.stub(new Date().getTime()); }, 10)")
+        page.clock.run_for(100)
+        assert calls == [
+            [10],
+            [20],
+            [30],
+            [40],
+            [50],
+            [60],
+            [70],
+            [80],
+            [90],
+            [100],
+        ]
+
+    def test_run_for_passes_8_seconds(self, page: Page, calls: List[Any]) -> None:
+        page.evaluate("setInterval(window.stub, 4000)")
+        page.clock.run_for("08")
+        assert len(calls) == 2
+
+    def test_run_for_passes_1_minute(self, page: Page, calls: List[Any]) -> None:
+        page.evaluate("setInterval(window.stub, 6000)")
+        page.clock.run_for("01:00")
+        assert len(calls) == 10
+
+    def test_run_for_passes_2_hours_34_minutes_and_10_seconds(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate("setInterval(window.stub, 10000)")
+        page.clock.run_for("02:34:10")
+        assert len(calls) == 925
+
+    def test_run_for_throws_for_invalid_format(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate("setInterval(window.stub, 10000)")
+        with pytest.raises(Error):
+            page.clock.run_for("12:02:34:10")
+        assert len(calls) == 0
+
+    def test_run_for_returns_the_current_now_value(self, page: Page) -> None:
+        page.clock.set_system_time(0)
+        value = 200
+        page.clock.run_for(value)
+        assert page.evaluate("Date.now()") == value
+
+
+class TestFastForward:
+    @pytest.fixture(autouse=True)
+    def before_each(self, page: Page) -> Generator[None, None, None]:
+        page.clock.install(time=0)
+        page.clock.pause_at(1000)
+        yield
+
+    def test_ignores_timers_which_wouldnt_be_run(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate(
+            "setTimeout(() => { window.stub('should not be logged'); }, 1000)"
+        )
+        page.clock.fast_forward(500)
+        assert len(calls) == 0
+
+    def test_pushes_back_execution_time_for_skipped_timers(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.evaluate("setTimeout(() => { window.stub(Date.now()); }, 1000)")
+        page.clock.fast_forward(2000)
+        assert calls == [[1000 + 2000]]
+
+    def test_supports_string_time_arguments(self, page: Page, calls: List[Any]) -> None:
+        page.evaluate(
+            "setTimeout(() => { window.stub(Date.now()); }, 100000)"
+        )  # 100000 = 1:40
+        page.clock.fast_forward("01:50")
+        assert calls == [[1000 + 110000]]
+
+
+class TestStubTimers:
+    @pytest.fixture(autouse=True)
+    def before_each(self, page: Page) -> Generator[None, None, None]:
+        page.clock.install(time=0)
+        page.clock.pause_at(1000)
+        yield
+
+    def test_sets_initial_timestamp(self, page: Page) -> None:
+        page.clock.set_system_time(1400)
+        assert page.evaluate("Date.now()") == 1400
+
+    def test_replaces_global_setTimeout(self, page: Page, calls: List[Any]) -> None:
+        page.evaluate("setTimeout(window.stub, 1000)")
+        page.clock.run_for(1000)
+        assert len(calls) == 1
+
+    def test_global_fake_setTimeout_should_return_id(self, page: Page) -> None:
+        to = page.evaluate("setTimeout(window.stub, 1000)")
+        assert isinstance(to, int)
+
+    def test_replaces_global_clearTimeout(self, page: Page, calls: List[Any]) -> None:
+        page.evaluate(
+            """
+            const to = setTimeout(window.stub, 1000);
+            clearTimeout(to);
+        """
+        )
+        page.clock.run_for(1000)
+        assert len(calls) == 0
+
+    def test_replaces_global_setInterval(self, page: Page, calls: List[Any]) -> None:
+        page.evaluate("setInterval(window.stub, 500)")
+        page.clock.run_for(1000)
+        assert len(calls) == 2
+
+    def test_replaces_global_clearInterval(self, page: Page, calls: List[Any]) -> None:
+        page.evaluate(
+            """
+            const to = setInterval(window.stub, 500);
+            clearInterval(to);
+        """
+        )
+        page.clock.run_for(1000)
+        assert len(calls) == 0
+
+    def test_replaces_global_performance_now(self, page: Page) -> None:
+        page.evaluate(
+            """() => {
+            window.waitForPromise = new Promise(async resolve => {
+                const prev = performance.now();
+                await new Promise(f => setTimeout(f, 1000));
+                const next = performance.now();
+                resolve({ prev, next });
+            });
+        }"""
+        )
+        page.clock.run_for(1000)
+        assert page.evaluate("window.waitForPromise") == {"prev": 1000, "next": 2000}
+
+    def test_fakes_Date_constructor(self, page: Page) -> None:
+        now = page.evaluate("new Date().getTime()")
+        assert now == 1000
+
+
+class TestStubTimersPerformance:
+    def test_replaces_global_performance_time_origin(self, page: Page) -> None:
+        page.clock.install(time=1000)
+        page.clock.pause_at(2000)
+        page.evaluate(
+            """() => {
+            window.waitForPromise = new Promise(async resolve => {
+                const prev = performance.now();
+                await new Promise(f => setTimeout(f, 1000));
+                const next = performance.now();
+                resolve({ prev, next });
+            });
+        }"""
+        )
+        page.clock.run_for(1000)
+        assert page.evaluate("performance.timeOrigin") == 1000
+        assert page.evaluate("window.waitForPromise") == {"prev": 1000, "next": 2000}
+
+
+class TestPopup:
+    def test_should_tick_after_popup(self, page: Page) -> None:
+        page.clock.install(time=0)
+        now = datetime.datetime.fromisoformat("2015-09-25")
+        page.clock.pause_at(now)
+        with page.expect_popup() as popup_info:
+            page.evaluate("window.open('about:blank')")
+        popup = popup_info.value
+        popup_time = popup.evaluate("Date.now()")
+        assert popup_time == now.timestamp()
+        page.clock.run_for(1000)
+        popup_time_after = popup.evaluate("Date.now()")
+        assert popup_time_after == now.timestamp() + 1000
+
+    def test_should_tick_before_popup(self, page: Page) -> None:
+        page.clock.install(time=0)
+        now = datetime.datetime.fromisoformat("2015-09-25")
+        page.clock.pause_at(now)
+        page.clock.run_for(1000)
+        with page.expect_popup() as popup_info:
+            page.evaluate("window.open('about:blank')")
+        popup = popup_info.value
+        popup_time = popup.evaluate("Date.now()")
+        assert popup_time == int(now.timestamp() + 1000)
+
+    def test_should_run_time_before_popup(self, page: Page, server: Server) -> None:
+        server.set_route(
+            "/popup.html",
+            lambda res: (
+                res.setHeader("Content-Type", "text/html"),
+                res.write(b"<script>window.time = Date.now()</script>"),
+                res.finish(),
+            ),
+        )
+        page.goto(server.EMPTY_PAGE)
+        # Wait for 2 second in real life to check that it is past in popup.
+        page.wait_for_timeout(2000)
+        with page.expect_popup() as popup_info:
+            page.evaluate("window.open('{}')".format(server.PREFIX + "/popup.html"))
+        popup = popup_info.value
+        popup_time = popup.evaluate("window.time")
+        assert popup_time >= 2000
+
+    def test_should_not_run_time_before_popup_on_pause(
+        self, page: Page, server: Server
+    ) -> None:
+        server.set_route(
+            "/popup.html",
+            lambda res: (
+                res.setHeader("Content-Type", "text/html"),
+                res.write(b"<script>window.time = Date.now()</script>"),
+                res.finish(),
+            ),
+        )
+        page.clock.install(time=0)
+        page.clock.pause_at(1000)
+        page.goto(server.EMPTY_PAGE)
+        # Wait for 2 second in real life to check that it is past in popup.
+        page.wait_for_timeout(2000)
+        with page.expect_popup() as popup_info:
+            page.evaluate("window.open('{}')".format(server.PREFIX + "/popup.html"))
+        popup = popup_info.value
+        popup_time = popup.evaluate("window.time")
+        assert popup_time == 1000
+
+
+class TestSetFixedTime:
+    def test_does_not_fake_methods(self, page: Page) -> None:
+        page.clock.set_fixed_time(0)
+        # Should not stall.
+        page.evaluate("new Promise(f => setTimeout(f, 1))")
+
+    def test_allows_setting_time_multiple_times(self, page: Page) -> None:
+        page.clock.set_fixed_time(100)
+        assert page.evaluate("Date.now()") == 100
+        page.clock.set_fixed_time(200)
+        assert page.evaluate("Date.now()") == 200
+
+    def test_fixed_time_is_not_affected_by_clock_manipulation(self, page: Page) -> None:
+        page.clock.set_fixed_time(100)
+        assert page.evaluate("Date.now()") == 100
+        page.clock.fast_forward(20)
+        assert page.evaluate("Date.now()") == 100
+
+    def test_allows_installing_fake_timers_after_setting_time(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.clock.set_fixed_time(100)
+        assert page.evaluate("Date.now()") == 100
+        page.clock.set_fixed_time(200)
+        page.evaluate("setTimeout(() => window.stub(Date.now()))")
+        page.clock.run_for(0)
+        assert calls == [[200]]
+
+
+class TestWhileRunning:
+    def test_should_progress_time(self, page: Page) -> None:
+        page.clock.install(time=0)
+        page.goto("data:text/html,")
+        page.wait_for_timeout(1000)
+        now = page.evaluate("Date.now()")
+        assert 1000 <= now <= 2000
+
+    def test_should_run_for(self, page: Page) -> None:
+        page.clock.install(time=0)
+        page.goto("data:text/html,")
+        page.clock.run_for(10000)
+        now = page.evaluate("Date.now()")
+        assert 10000 <= now <= 11000
+
+    def test_should_fast_forward(self, page: Page) -> None:
+        page.clock.install(time=0)
+        page.goto("data:text/html,")
+        page.clock.fast_forward(10000)
+        now = page.evaluate("Date.now()")
+        assert 10000 <= now <= 11000
+
+    def test_should_fast_forward_to(self, page: Page) -> None:
+        page.clock.install(time=0)
+        page.goto("data:text/html,")
+        page.clock.fast_forward(10000)
+        now = page.evaluate("Date.now()")
+        assert 10000 <= now <= 11000
+
+    def test_should_pause(self, page: Page) -> None:
+        page.clock.install(time=0)
+        page.goto("data:text/html,")
+        page.clock.pause_at(1000)
+        page.wait_for_timeout(1000)
+        page.clock.resume()
+        now = page.evaluate("Date.now()")
+        assert 0 <= now <= 1000
+
+    def test_should_pause_and_fast_forward(self, page: Page) -> None:
+        page.clock.install(time=0)
+        page.goto("data:text/html,")
+        page.clock.pause_at(1000)
+        page.clock.fast_forward(1000)
+        now = page.evaluate("Date.now()")
+        assert now == 2000
+
+    def test_should_set_system_time_on_pause(self, page: Page) -> None:
+        page.clock.install(time=0)
+        page.goto("data:text/html,")
+        page.clock.pause_at(1000)
+        now = page.evaluate("Date.now()")
+        assert now == 1000
+
+
+class TestWhileOnPause:
+    def test_fast_forward_should_not_run_nested_immediate(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.clock.install(time=0)
+        page.goto("data:text/html,")
+        page.clock.pause_at(1000)
+        page.evaluate(
+            """
+            setTimeout(() => {
+                window.stub('outer');
+                setTimeout(() => window.stub('inner'), 0);
+            }, 1000);
+        """
+        )
+        page.clock.fast_forward(1000)
+        assert calls == [["outer"]]
+        page.clock.fast_forward(1)
+        assert calls == [["outer"], ["inner"]]
+
+    def test_run_for_should_not_run_nested_immediate(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.clock.install(time=0)
+        page.goto("data:text/html,")
+        page.clock.pause_at(1000)
+        page.evaluate(
+            """
+            setTimeout(() => {
+                window.stub('outer');
+                setTimeout(() => window.stub('inner'), 0);
+            }, 1000);
+        """
+        )
+        page.clock.run_for(1000)
+        assert calls == [["outer"]]
+        page.clock.run_for(1)
+        assert calls == [["outer"], ["inner"]]
+
+    def test_run_for_should_not_run_nested_immediate_from_microtask(
+        self, page: Page, calls: List[Any]
+    ) -> None:
+        page.clock.install(time=0)
+        page.goto("data:text/html,")
+        page.clock.pause_at(1000)
+        page.evaluate(
+            """
+            setTimeout(() => {
+                window.stub('outer');
+                void Promise.resolve().then(() => setTimeout(() => window.stub('inner'), 0));
+            }, 1000);
+        """
+        )
+        page.clock.run_for(1000)
+        assert calls == [["outer"]]
+        page.clock.run_for(1)
+        assert calls == [["outer"], ["inner"]]
diff --git a/tests/utils.py b/tests/utils.py
index 4a9faf9a1..c6c10a810 100644
--- a/tests/utils.py
+++ b/tests/utils.py
@@ -65,3 +65,14 @@ def get_trace_actions(events: List[Any]) -> List[str]:
 def must(value: Optional[MustType]) -> MustType:
     assert value
     return value
+
+
+def chromium_version_less_than(a: str, b: str) -> bool:
+    left = list(map(int, a.split(".")))
+    right = list(map(int, b.split(".")))
+    for i in range(4):
+        if left[i] > right[i]:
+            return False
+        if left[i] < right[i]:
+            return True
+    return False

From d83dc6e96a4ce9ffa8b0e95667866320702142fb Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 1 Jul 2024 18:32:16 +0200
Subject: [PATCH 229/438] fix(fetch): serialise empty array in 'data' as JSON
 (#2476)

---
 playwright/_impl/_fetch.py       |  2 +-
 tests/async/test_fetch_global.py | 14 ++++++++++----
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index 3a71a5ff5..da17c169c 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -338,7 +338,7 @@ async def _inner_fetch(
         form_data: Optional[List[NameValue]] = None
         multipart_data: Optional[List[FormField]] = None
         post_data_buffer: Optional[bytes] = None
-        if data:
+        if data is not None:
             if isinstance(data, str):
                 if is_json_content_type(serialized_headers):
                     json_data = data if is_json_parsable(data) else json.dumps(data)
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index eda3145ee..82ecf38ec 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -448,12 +448,18 @@ async def test_should_throw_an_error_when_max_redirects_is_less_than_0(
         assert "'max_redirects' must be greater than or equal to '0'" in str(exc_info)
 
 
-async def test_should_serialize_null_values_in_json(
+async def test_should_serialize_request_data(
     playwright: Playwright, server: Server
 ) -> None:
     request = await playwright.request.new_context()
     server.set_route("/echo", lambda req: (req.write(req.post_body), req.finish()))
-    response = await request.post(server.PREFIX + "/echo", data={"foo": None})
-    assert response.status == 200
-    assert await response.text() == '{"foo": null}'
+    for data, expected in [
+        ({"foo": None}, '{"foo": null}'),
+        ([], "[]"),
+        ({}, "{}"),
+        ("", ""),
+    ]:
+        response = await request.post(server.PREFIX + "/echo", data=data)
+        assert response.status == 200
+        assert await response.text() == expected
     await request.dispose()

From 8f9bcd1dd50938e8d37600ddfbd22c3e8fc51cf0 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 3 Jul 2024 11:02:45 +0200
Subject: [PATCH 230/438] chore(roll): roll to Playwright
 1.45.1-beta-1719996498000 (#2474)

---
 README.md                          |  2 +-
 playwright/_impl/_clock.py         | 18 +++++-----
 playwright/async_api/_generated.py | 54 ++++++++--------------------
 playwright/sync_api/_generated.py  | 56 +++++++++---------------------
 scripts/documentation_provider.py  |  2 ++
 setup.py                           |  2 +-
 tests/async/test_page_clock.py     | 35 ++++++++++---------
 tests/sync/test_page_clock.py      | 41 +++++++++++++---------
 8 files changed, 86 insertions(+), 124 deletions(-)

diff --git a/README.md b/README.md
index aca6755bc..92cd726ab 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->127.0.6533.5<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->127.0.6533.17<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->127.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/playwright/_impl/_clock.py b/playwright/_impl/_clock.py
index 11c230b92..d8bb58718 100644
--- a/playwright/_impl/_clock.py
+++ b/playwright/_impl/_clock.py
@@ -25,7 +25,7 @@ def __init__(self, browser_context: "BrowserContext") -> None:
         self._loop = browser_context._loop
         self._dispatcher_fiber = browser_context._dispatcher_fiber
 
-    async def install(self, time: Union[int, str, datetime.datetime] = None) -> None:
+    async def install(self, time: Union[float, str, datetime.datetime] = None) -> None:
         await self._browser_context._channel.send(
             "clockInstall", parse_time(time) if time is not None else {}
         )
@@ -40,7 +40,7 @@ async def fast_forward(
 
     async def pause_at(
         self,
-        time: Union[int, str, datetime.datetime],
+        time: Union[float, str, datetime.datetime],
     ) -> None:
         await self._browser_context._channel.send("clockPauseAt", parse_time(time))
 
@@ -57,25 +57,27 @@ async def run_for(
 
     async def set_fixed_time(
         self,
-        time: Union[int, str, datetime.datetime],
+        time: Union[float, str, datetime.datetime],
     ) -> None:
         await self._browser_context._channel.send("clockSetFixedTime", parse_time(time))
 
     async def set_system_time(
         self,
-        time: Union[int, str, datetime.datetime],
+        time: Union[float, str, datetime.datetime],
     ) -> None:
         await self._browser_context._channel.send(
             "clockSetSystemTime", parse_time(time)
         )
 
 
-def parse_time(time: Union[int, str, datetime.datetime]) -> Dict[str, Union[int, str]]:
-    if isinstance(time, int):
-        return {"timeNumber": time}
+def parse_time(
+    time: Union[float, str, datetime.datetime]
+) -> Dict[str, Union[int, str]]:
+    if isinstance(time, (float, int)):
+        return {"timeNumber": int(time * 1_000)}
     if isinstance(time, str):
         return {"timeString": time}
-    return {"timeNumber": int(time.timestamp())}
+    return {"timeNumber": int(time.timestamp() * 1_000)}
 
 
 def parse_ticks(ticks: Union[int, str]) -> Dict[str, Union[int, str]]:
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 5afc93a7b..0a866ef75 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -6664,7 +6664,9 @@ def set_test_id_attribute(self, attribute_name: str) -> None:
 
 class Clock(AsyncBase):
     async def install(
-        self, *, time: typing.Optional[typing.Union[int, str, datetime.datetime]] = None
+        self,
+        *,
+        time: typing.Optional[typing.Union[float, str, datetime.datetime]] = None
     ) -> None:
         """Clock.install
 
@@ -6686,7 +6688,7 @@ async def install(
 
         Parameters
         ----------
-        time : Union[datetime.datetime, int, str, None]
+        time : Union[datetime.datetime, float, str, None]
             Time to initialize with, current system time by default.
         """
 
@@ -6714,7 +6716,7 @@ async def fast_forward(self, ticks: typing.Union[int, str]) -> None:
 
         return mapping.from_maybe_impl(await self._impl_obj.fast_forward(ticks=ticks))
 
-    async def pause_at(self, time: typing.Union[int, str, datetime.datetime]) -> None:
+    async def pause_at(self, time: typing.Union[float, str, datetime.datetime]) -> None:
         """Clock.pause_at
 
         Advance the clock by jumping forward in time and pause the time. Once this method is called, no timers are fired
@@ -6733,7 +6735,8 @@ async def pause_at(self, time: typing.Union[int, str, datetime.datetime]) -> Non
 
         Parameters
         ----------
-        time : Union[datetime.datetime, int, str]
+        time : Union[datetime.datetime, float, str]
+            Time to pause at.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.pause_at(time=time))
@@ -6768,7 +6771,7 @@ async def run_for(self, ticks: typing.Union[int, str]) -> None:
         return mapping.from_maybe_impl(await self._impl_obj.run_for(ticks=ticks))
 
     async def set_fixed_time(
-        self, time: typing.Union[int, str, datetime.datetime]
+        self, time: typing.Union[float, str, datetime.datetime]
     ) -> None:
         """Clock.set_fixed_time
 
@@ -6784,14 +6787,14 @@ async def set_fixed_time(
 
         Parameters
         ----------
-        time : Union[datetime.datetime, int, str]
+        time : Union[datetime.datetime, float, str]
             Time to be set.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.set_fixed_time(time=time))
 
     async def set_system_time(
-        self, time: typing.Union[int, str, datetime.datetime]
+        self, time: typing.Union[float, str, datetime.datetime]
     ) -> None:
         """Clock.set_system_time
 
@@ -6807,7 +6810,8 @@ async def set_system_time(
 
         Parameters
         ----------
-        time : Union[datetime.datetime, int, str]
+        time : Union[datetime.datetime, float, str]
+            Time to be set.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.set_system_time(time=time))
@@ -8662,22 +8666,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        An example of passing an element handle:
-
-        ```py
-        async def print(source, element):
-            print(await element.text_content())
-
-        await page.expose_binding(\"clicked\", print, handle=true)
-        await page.set_content(\"\"\"
-          <script>
-            document.addEventListener('click', event => window.clicked(event.target));
-          </script>
-          <div>Click me</div>
-          <div>Or click me</div>
-        \"\"\")
-        ```
-
         Parameters
         ----------
         name : str
@@ -8687,6 +8675,7 @@ async def print(source, element):
         handle : Union[bool, None]
             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.
         """
 
         return mapping.from_maybe_impl(
@@ -12849,22 +12838,6 @@ async def main():
         asyncio.run(main())
         ```
 
-        An example of passing an element handle:
-
-        ```py
-        async def print(source, element):
-            print(await element.text_content())
-
-        await context.expose_binding(\"clicked\", print, handle=true)
-        await page.set_content(\"\"\"
-          <script>
-            document.addEventListener('click', event => window.clicked(event.target));
-          </script>
-          <div>Click me</div>
-          <div>Or click me</div>
-        \"\"\")
-        ```
-
         Parameters
         ----------
         name : str
@@ -12874,6 +12847,7 @@ async def print(source, element):
         handle : Union[bool, None]
             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.
         """
 
         return mapping.from_maybe_impl(
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 6dfe26ee8..2f28abbb9 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -6774,7 +6774,9 @@ def set_test_id_attribute(self, attribute_name: str) -> None:
 
 class Clock(SyncBase):
     def install(
-        self, *, time: typing.Optional[typing.Union[int, str, datetime.datetime]] = None
+        self,
+        *,
+        time: typing.Optional[typing.Union[float, str, datetime.datetime]] = None
     ) -> None:
         """Clock.install
 
@@ -6796,7 +6798,7 @@ def install(
 
         Parameters
         ----------
-        time : Union[datetime.datetime, int, str, None]
+        time : Union[datetime.datetime, float, str, None]
             Time to initialize with, current system time by default.
         """
 
@@ -6826,7 +6828,7 @@ def fast_forward(self, ticks: typing.Union[int, str]) -> None:
             self._sync(self._impl_obj.fast_forward(ticks=ticks))
         )
 
-    def pause_at(self, time: typing.Union[int, str, datetime.datetime]) -> None:
+    def pause_at(self, time: typing.Union[float, str, datetime.datetime]) -> None:
         """Clock.pause_at
 
         Advance the clock by jumping forward in time and pause the time. Once this method is called, no timers are fired
@@ -6845,7 +6847,8 @@ def pause_at(self, time: typing.Union[int, str, datetime.datetime]) -> None:
 
         Parameters
         ----------
-        time : Union[datetime.datetime, int, str]
+        time : Union[datetime.datetime, float, str]
+            Time to pause at.
         """
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.pause_at(time=time)))
@@ -6879,7 +6882,7 @@ def run_for(self, ticks: typing.Union[int, str]) -> None:
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.run_for(ticks=ticks)))
 
-    def set_fixed_time(self, time: typing.Union[int, str, datetime.datetime]) -> None:
+    def set_fixed_time(self, time: typing.Union[float, str, datetime.datetime]) -> None:
         """Clock.set_fixed_time
 
         Makes `Date.now` and `new Date()` return fixed fake time at all times, keeps all the timers running.
@@ -6894,7 +6897,7 @@ def set_fixed_time(self, time: typing.Union[int, str, datetime.datetime]) -> Non
 
         Parameters
         ----------
-        time : Union[datetime.datetime, int, str]
+        time : Union[datetime.datetime, float, str]
             Time to be set.
         """
 
@@ -6902,7 +6905,9 @@ def set_fixed_time(self, time: typing.Union[int, str, datetime.datetime]) -> Non
             self._sync(self._impl_obj.set_fixed_time(time=time))
         )
 
-    def set_system_time(self, time: typing.Union[int, str, datetime.datetime]) -> None:
+    def set_system_time(
+        self, time: typing.Union[float, str, datetime.datetime]
+    ) -> None:
         """Clock.set_system_time
 
         Sets current system time but does not trigger any timers.
@@ -6917,7 +6922,8 @@ def set_system_time(self, time: typing.Union[int, str, datetime.datetime]) -> No
 
         Parameters
         ----------
-        time : Union[datetime.datetime, int, str]
+        time : Union[datetime.datetime, float, str]
+            Time to be set.
         """
 
         return mapping.from_maybe_impl(
@@ -8689,22 +8695,6 @@ def run(playwright: Playwright):
             run(playwright)
         ```
 
-        An example of passing an element handle:
-
-        ```py
-        def print(source, element):
-            print(element.text_content())
-
-        page.expose_binding(\"clicked\", print, handle=true)
-        page.set_content(\"\"\"
-          <script>
-            document.addEventListener('click', event => window.clicked(event.target));
-          </script>
-          <div>Click me</div>
-          <div>Or click me</div>
-        \"\"\")
-        ```
-
         Parameters
         ----------
         name : str
@@ -8714,6 +8704,7 @@ def print(source, element):
         handle : Union[bool, None]
             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.
         """
 
         return mapping.from_maybe_impl(
@@ -12871,22 +12862,6 @@ def run(playwright: Playwright):
             run(playwright)
         ```
 
-        An example of passing an element handle:
-
-        ```py
-        def print(source, element):
-            print(element.text_content())
-
-        context.expose_binding(\"clicked\", print, handle=true)
-        page.set_content(\"\"\"
-          <script>
-            document.addEventListener('click', event => window.clicked(event.target));
-          </script>
-          <div>Click me</div>
-          <div>Or click me</div>
-        \"\"\")
-        ```
-
         Parameters
         ----------
         name : str
@@ -12896,6 +12871,7 @@ def print(source, element):
         handle : Union[bool, None]
             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.
         """
 
         return mapping.from_maybe_impl(
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index f76509443..82e3f4bb6 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -481,6 +481,8 @@ def inner_serialize_doc_type(self, type: Any, direction: str) -> str:
             return f"{{{', '.join(items)}}}"
         if type_name == "boolean":
             return "bool"
+        if type_name == "long":
+            return "int"
         if type_name.lower() == "string":
             return "str"
         if type_name == "any" or type_name == "Serializable":
diff --git a/setup.py b/setup.py
index 46d323f17..2a0454820 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.45.0-alpha-2024-06-14"
+driver_version = "1.45.1-beta-1719996498000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_page_clock.py b/tests/async/test_page_clock.py
index 1339efaae..0676ee581 100644
--- a/tests/async/test_page_clock.py
+++ b/tests/async/test_page_clock.py
@@ -151,7 +151,7 @@ class TestFastForward:
     @pytest.fixture(autouse=True)
     async def before_each(self, page: Page) -> AsyncGenerator[None, None]:
         await page.clock.install(time=0)
-        await page.clock.pause_at(1000)
+        await page.clock.pause_at(1)
         yield
 
     async def test_ignores_timers_which_wouldnt_be_run(
@@ -184,11 +184,11 @@ class TestStubTimers:
     @pytest.fixture(autouse=True)
     async def before_each(self, page: Page) -> AsyncGenerator[None, None]:
         await page.clock.install(time=0)
-        await page.clock.pause_at(1000)
+        await page.clock.pause_at(1)
         yield
 
     async def test_sets_initial_timestamp(self, page: Page) -> None:
-        await page.clock.set_system_time(1400)
+        await page.clock.set_system_time(1.4)
         assert await page.evaluate("Date.now()") == 1400
 
     async def test_replaces_global_setTimeout(
@@ -255,8 +255,8 @@ async def test_fakes_Date_constructor(self, page: Page) -> None:
 
 class TestStubTimersPerformance:
     async def test_replaces_global_performance_time_origin(self, page: Page) -> None:
-        await page.clock.install(time=1000)
-        await page.clock.pause_at(2000)
+        await page.clock.install(time=1)
+        await page.clock.pause_at(2)
         promise = asyncio.create_task(
             page.evaluate(
                 """async () => {
@@ -282,10 +282,10 @@ async def test_should_tick_after_popup(self, page: Page) -> None:
             page.wait_for_event("popup"), page.evaluate("window.open('about:blank')")
         )
         popup_time = await popup.evaluate("Date.now()")
-        assert popup_time == now.timestamp()
+        assert popup_time == now.timestamp() * 1000
         await page.clock.run_for(1000)
         popup_time_after = await popup.evaluate("Date.now()")
-        assert popup_time_after == now.timestamp() + 1000
+        assert popup_time_after == now.timestamp() * 1000 + 1000
 
     async def test_should_tick_before_popup(self, page: Page) -> None:
         await page.clock.install(time=0)
@@ -296,7 +296,8 @@ async def test_should_tick_before_popup(self, page: Page) -> None:
             page.wait_for_event("popup"), page.evaluate("window.open('about:blank')")
         )
         popup_time = await popup.evaluate("Date.now()")
-        assert popup_time == int(now.timestamp() + 1000)
+        assert popup_time == int(now.timestamp() * 1000 + 1000)
+        assert datetime.datetime.fromtimestamp(popup_time / 1_000).year == 2015
 
     async def test_should_run_time_before_popup(
         self, page: Page, server: Server
@@ -331,7 +332,7 @@ async def test_should_not_run_time_before_popup_on_pause(
             ),
         )
         await page.clock.install(time=0)
-        await page.clock.pause_at(1000)
+        await page.clock.pause_at(1)
         await page.goto(server.EMPTY_PAGE)
         # Wait for 2 second in real life to check that it is past in popup.
         await page.wait_for_timeout(2000)
@@ -350,15 +351,15 @@ async def test_does_not_fake_methods(self, page: Page) -> None:
         await page.evaluate("new Promise(f => setTimeout(f, 1))")
 
     async def test_allows_setting_time_multiple_times(self, page: Page) -> None:
-        await page.clock.set_fixed_time(100)
+        await page.clock.set_fixed_time(0.1)
         assert await page.evaluate("Date.now()") == 100
-        await page.clock.set_fixed_time(200)
+        await page.clock.set_fixed_time(0.2)
         assert await page.evaluate("Date.now()") == 200
 
     async def test_fixed_time_is_not_affected_by_clock_manipulation(
         self, page: Page
     ) -> None:
-        await page.clock.set_fixed_time(100)
+        await page.clock.set_fixed_time(0.1)
         assert await page.evaluate("Date.now()") == 100
         await page.clock.fast_forward(20)
         assert await page.evaluate("Date.now()") == 100
@@ -366,9 +367,9 @@ async def test_fixed_time_is_not_affected_by_clock_manipulation(
     async def test_allows_installing_fake_timers_after_setting_time(
         self, page: Page, calls: List[Any]
     ) -> None:
-        await page.clock.set_fixed_time(100)
+        await page.clock.set_fixed_time(0.1)
         assert await page.evaluate("Date.now()") == 100
-        await page.clock.set_fixed_time(200)
+        await page.clock.set_fixed_time(0.2)
         await page.evaluate("setTimeout(() => window.stub(Date.now()))")
         await page.clock.run_for(0)
         assert calls == [[200]]
@@ -406,7 +407,7 @@ async def test_should_fast_forward_to(self, page: Page) -> None:
     async def test_should_pause(self, page: Page) -> None:
         await page.clock.install(time=0)
         await page.goto("data:text/html,")
-        await page.clock.pause_at(1000)
+        await page.clock.pause_at(1)
         await page.wait_for_timeout(1000)
         await page.clock.resume()
         now = await page.evaluate("Date.now()")
@@ -415,7 +416,7 @@ async def test_should_pause(self, page: Page) -> None:
     async def test_should_pause_and_fast_forward(self, page: Page) -> None:
         await page.clock.install(time=0)
         await page.goto("data:text/html,")
-        await page.clock.pause_at(1000)
+        await page.clock.pause_at(1)
         await page.clock.fast_forward(1000)
         now = await page.evaluate("Date.now()")
         assert now == 2000
@@ -423,7 +424,7 @@ async def test_should_pause_and_fast_forward(self, page: Page) -> None:
     async def test_should_set_system_time_on_pause(self, page: Page) -> None:
         await page.clock.install(time=0)
         await page.goto("data:text/html,")
-        await page.clock.pause_at(1000)
+        await page.clock.pause_at(1)
         now = await page.evaluate("Date.now()")
         assert now == 1000
 
diff --git a/tests/sync/test_page_clock.py b/tests/sync/test_page_clock.py
index 8759ec49d..025133b57 100644
--- a/tests/sync/test_page_clock.py
+++ b/tests/sync/test_page_clock.py
@@ -146,7 +146,7 @@ class TestFastForward:
     @pytest.fixture(autouse=True)
     def before_each(self, page: Page) -> Generator[None, None, None]:
         page.clock.install(time=0)
-        page.clock.pause_at(1000)
+        page.clock.pause_at(1)
         yield
 
     def test_ignores_timers_which_wouldnt_be_run(
@@ -177,11 +177,11 @@ class TestStubTimers:
     @pytest.fixture(autouse=True)
     def before_each(self, page: Page) -> Generator[None, None, None]:
         page.clock.install(time=0)
-        page.clock.pause_at(1000)
+        page.clock.pause_at(1)
         yield
 
     def test_sets_initial_timestamp(self, page: Page) -> None:
-        page.clock.set_system_time(1400)
+        page.clock.set_system_time(1.4)
         assert page.evaluate("Date.now()") == 1400
 
     def test_replaces_global_setTimeout(self, page: Page, calls: List[Any]) -> None:
@@ -239,8 +239,8 @@ def test_fakes_Date_constructor(self, page: Page) -> None:
 
 class TestStubTimersPerformance:
     def test_replaces_global_performance_time_origin(self, page: Page) -> None:
-        page.clock.install(time=1000)
-        page.clock.pause_at(2000)
+        page.clock.install(time=1)
+        page.clock.pause_at(2)
         page.evaluate(
             """() => {
             window.waitForPromise = new Promise(async resolve => {
@@ -265,10 +265,10 @@ def test_should_tick_after_popup(self, page: Page) -> None:
             page.evaluate("window.open('about:blank')")
         popup = popup_info.value
         popup_time = popup.evaluate("Date.now()")
-        assert popup_time == now.timestamp()
+        assert popup_time == now.timestamp() * 1000
         page.clock.run_for(1000)
         popup_time_after = popup.evaluate("Date.now()")
-        assert popup_time_after == now.timestamp() + 1000
+        assert popup_time_after == now.timestamp() * 1000 + 1000
 
     def test_should_tick_before_popup(self, page: Page) -> None:
         page.clock.install(time=0)
@@ -279,7 +279,8 @@ def test_should_tick_before_popup(self, page: Page) -> None:
             page.evaluate("window.open('about:blank')")
         popup = popup_info.value
         popup_time = popup.evaluate("Date.now()")
-        assert popup_time == int(now.timestamp() + 1000)
+        assert popup_time == int(now.timestamp() * 1_000 + 1000)
+        assert datetime.datetime.fromtimestamp(popup_time / 1_000).year == 2015
 
     def test_should_run_time_before_popup(self, page: Page, server: Server) -> None:
         server.set_route(
@@ -311,7 +312,7 @@ def test_should_not_run_time_before_popup_on_pause(
             ),
         )
         page.clock.install(time=0)
-        page.clock.pause_at(1000)
+        page.clock.pause_at(1)
         page.goto(server.EMPTY_PAGE)
         # Wait for 2 second in real life to check that it is past in popup.
         page.wait_for_timeout(2000)
@@ -323,19 +324,25 @@ def test_should_not_run_time_before_popup_on_pause(
 
 
 class TestSetFixedTime:
+    def test_allows_passing_as_int(self, page: Page) -> None:
+        page.clock.set_fixed_time(1)
+        assert page.evaluate("Date.now()") == 1000
+        page.clock.set_fixed_time(int(2))
+        assert page.evaluate("Date.now()") == 2000
+
     def test_does_not_fake_methods(self, page: Page) -> None:
         page.clock.set_fixed_time(0)
         # Should not stall.
         page.evaluate("new Promise(f => setTimeout(f, 1))")
 
     def test_allows_setting_time_multiple_times(self, page: Page) -> None:
-        page.clock.set_fixed_time(100)
+        page.clock.set_fixed_time(0.1)
         assert page.evaluate("Date.now()") == 100
-        page.clock.set_fixed_time(200)
+        page.clock.set_fixed_time(0.2)
         assert page.evaluate("Date.now()") == 200
 
     def test_fixed_time_is_not_affected_by_clock_manipulation(self, page: Page) -> None:
-        page.clock.set_fixed_time(100)
+        page.clock.set_fixed_time(0.1)
         assert page.evaluate("Date.now()") == 100
         page.clock.fast_forward(20)
         assert page.evaluate("Date.now()") == 100
@@ -343,9 +350,9 @@ def test_fixed_time_is_not_affected_by_clock_manipulation(self, page: Page) -> N
     def test_allows_installing_fake_timers_after_setting_time(
         self, page: Page, calls: List[Any]
     ) -> None:
-        page.clock.set_fixed_time(100)
+        page.clock.set_fixed_time(0.1)
         assert page.evaluate("Date.now()") == 100
-        page.clock.set_fixed_time(200)
+        page.clock.set_fixed_time(0.2)
         page.evaluate("setTimeout(() => window.stub(Date.now()))")
         page.clock.run_for(0)
         assert calls == [[200]]
@@ -383,7 +390,7 @@ def test_should_fast_forward_to(self, page: Page) -> None:
     def test_should_pause(self, page: Page) -> None:
         page.clock.install(time=0)
         page.goto("data:text/html,")
-        page.clock.pause_at(1000)
+        page.clock.pause_at(1)
         page.wait_for_timeout(1000)
         page.clock.resume()
         now = page.evaluate("Date.now()")
@@ -392,7 +399,7 @@ def test_should_pause(self, page: Page) -> None:
     def test_should_pause_and_fast_forward(self, page: Page) -> None:
         page.clock.install(time=0)
         page.goto("data:text/html,")
-        page.clock.pause_at(1000)
+        page.clock.pause_at(1)
         page.clock.fast_forward(1000)
         now = page.evaluate("Date.now()")
         assert now == 2000
@@ -400,7 +407,7 @@ def test_should_pause_and_fast_forward(self, page: Page) -> None:
     def test_should_set_system_time_on_pause(self, page: Page) -> None:
         page.clock.install(time=0)
         page.goto("data:text/html,")
-        page.clock.pause_at(1000)
+        page.clock.pause_at(1)
         now = page.evaluate("Date.now()")
         assert now == 1000
 

From ecb34e3bf5f1d50b0c0ae4cda9b0380ca2ab1817 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 3 Jul 2024 11:10:55 +0200
Subject: [PATCH 231/438] build(deps): bump types-requests from 2.32.0.20240602
 to 2.32.0.20240622 (#2470)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index dc1cba114..875f219db 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -20,5 +20,5 @@ service_identity==24.1.0
 setuptools==69.5.1
 twisted==24.3.0
 types-pyOpenSSL==24.1.0.20240425
-types-requests==2.32.0.20240602
+types-requests==2.32.0.20240622
 wheel==0.42.0

From 90bf2e688a35cd1b0b1e665cf87cb779fc97ed8d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 3 Jul 2024 11:11:07 +0200
Subject: [PATCH 232/438] build(deps): bump mypy from 1.10.0 to 1.10.1 (#2479)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 875f219db..f938dc64a 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ autobahn==23.1.2
 black==24.4.2
 flake8==7.1.0
 flaky==3.8.1
-mypy==1.10.0
+mypy==1.10.1
 objgraph==3.6.1
 Pillow==10.3.0
 pixelmatch==0.3.0

From 4e6f9de064d086140628afd3c9423f528d40cd9d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 12 Jul 2024 14:18:54 +0200
Subject: [PATCH 233/438] build(deps): bump pillow from 10.3.0 to 10.4.0
 (#2477)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index f938dc64a..34fd7a72d 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -5,7 +5,7 @@ flake8==7.1.0
 flaky==3.8.1
 mypy==1.10.1
 objgraph==3.6.1
-Pillow==10.3.0
+Pillow==10.4.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==24.1.0

From c03604df36aef253cbbf38af53f05873ec65d7e3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 12 Jul 2024 14:19:03 +0200
Subject: [PATCH 234/438] build(deps): bump setuptools from 69.5.1 to 70.2.0
 (#2478)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 34fd7a72d..cb73a5085 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.1.0
-setuptools==69.5.1
+setuptools==70.2.0
 twisted==24.3.0
 types-pyOpenSSL==24.1.0.20240425
 types-requests==2.32.0.20240622

From d7af2d1e29b467fb1f257f033b6de88f48fb3997 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 12 Jul 2024 20:26:16 +0200
Subject: [PATCH 235/438] build(deps): bump setuptools from 70.2.0 to 70.3.0
 (#2484)

Bumps [setuptools](https://github.com/pypa/setuptools) from 70.2.0 to 70.3.0.
- [Release notes](https://github.com/pypa/setuptools/releases)
- [Changelog](https://github.com/pypa/setuptools/blob/main/NEWS.rst)
- [Commits](https://github.com/pypa/setuptools/compare/v70.2.0...v70.3.0)

---
updated-dependencies:
- dependency-name: setuptools
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index cb73a5085..a76ab8824 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.1.0
-setuptools==70.2.0
+setuptools==70.3.0
 twisted==24.3.0
 types-pyOpenSSL==24.1.0.20240425
 types-requests==2.32.0.20240622

From 054a89cd47e2b1902ac3b673ed7b878844053913 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 15 Jul 2024 22:28:51 +0200
Subject: [PATCH 236/438] build(deps): bump types-requests from 2.32.0.20240622
 to 2.32.0.20240712 (#2487)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index a76ab8824..cbe5301c3 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -20,5 +20,5 @@ service_identity==24.1.0
 setuptools==70.3.0
 twisted==24.3.0
 types-pyOpenSSL==24.1.0.20240425
-types-requests==2.32.0.20240622
+types-requests==2.32.0.20240712
 wheel==0.42.0

From adb95fb7491b67b70afc848ab05ce5f0fecfa4cb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 29 Jul 2024 22:56:57 +0200
Subject: [PATCH 237/438] build(deps): bump pytest from 8.2.2 to 8.3.2 (#2500)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index cbe5301c3..e93b1d48a 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,7 +9,7 @@ Pillow==10.4.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==24.1.0
-pytest==8.2.2
+pytest==8.3.2
 pytest-asyncio==0.21.2
 pytest-cov==5.0.0
 pytest-repeat==0.9.3

From ead662a3f26ab84f27609f4fb0cf14e00eceb813 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 29 Jul 2024 22:57:06 +0200
Subject: [PATCH 238/438] build(deps): bump types-pyopenssl from
 24.1.0.20240425 to 24.1.0.20240722 (#2494)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index e93b1d48a..8ce0084f2 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,6 +19,6 @@ requests==2.32.3
 service_identity==24.1.0
 setuptools==70.3.0
 twisted==24.3.0
-types-pyOpenSSL==24.1.0.20240425
+types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20240712
 wheel==0.42.0

From 0c305706594ffb3fc5167e0bcedb8fc72d7a21c9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 29 Jul 2024 22:57:20 +0200
Subject: [PATCH 239/438] build(deps): bump mypy from 1.10.1 to 1.11.0 (#2490)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 8ce0084f2..b96c3dd73 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ autobahn==23.1.2
 black==24.4.2
 flake8==7.1.0
 flaky==3.8.1
-mypy==1.10.1
+mypy==1.11.0
 objgraph==3.6.1
 Pillow==10.4.0
 pixelmatch==0.3.0

From 2ba0188455ddbcd8bda625361c1dbd737027997c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 29 Jul 2024 22:57:36 +0200
Subject: [PATCH 240/438] build(deps): bump setuptools from 70.3.0 to 72.1.0
 (#2501)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index b96c3dd73..239edaef8 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.1.0
-setuptools==70.3.0
+setuptools==72.1.0
 twisted==24.3.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20240712

From c13cd03cecb508937fb664e82d1282f6aa52848a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 30 Jul 2024 09:35:56 +0200
Subject: [PATCH 241/438] build(deps): bump pyopenssl from 24.1.0 to 24.2.1
 (#2493)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 239edaef8..a47b06315 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -8,7 +8,7 @@ objgraph==3.6.1
 Pillow==10.4.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
-pyOpenSSL==24.1.0
+pyOpenSSL==24.2.1
 pytest==8.3.2
 pytest-asyncio==0.21.2
 pytest-cov==5.0.0

From 65658108c693c267638d7cc87c4b95f9257a122b Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 31 Jul 2024 09:39:03 +0200
Subject: [PATCH 242/438] chore(roll): roll Playwright to v1.46 (#2499)

---
 README.md                                     |   6 +-
 playwright/_impl/_api_structures.py           |   9 +
 playwright/_impl/_browser.py                  |  10 +-
 playwright/_impl/_browser_type.py             |   4 +-
 playwright/_impl/_fetch.py                    |  26 +-
 playwright/_impl/_js_handle.py                |  23 +-
 playwright/_impl/_network.py                  |  33 +-
 playwright/async_api/_generated.py            | 403 ++++++++++--------
 playwright/sync_api/_generated.py             | 403 ++++++++++--------
 scripts/generate_api.py                       |   2 +-
 setup.py                                      |   2 +-
 tests/assets/client-certificates/README.md    |  60 +++
 .../client/trusted/cert.pem                   |  29 ++
 .../client/trusted/csr.pem                    |  26 ++
 .../client/trusted/key.pem                    |  52 +++
 .../server/server_cert.pem                    |  32 ++
 .../client-certificates/server/server_key.pem |  52 +++
 ...test_browsercontext_client_certificates.py | 135 ++++++
 tests/async/test_fetch_browser_context.py     |  23 +-
 tests/async/test_fetch_global.py              |  25 +-
 ...test_evaluate.py => test_page_evaluate.py} |  48 ++-
 ...test_browsercontext_client_certificates.py | 135 ++++++
 22 files changed, 1174 insertions(+), 364 deletions(-)
 create mode 100644 tests/assets/client-certificates/README.md
 create mode 100644 tests/assets/client-certificates/client/trusted/cert.pem
 create mode 100644 tests/assets/client-certificates/client/trusted/csr.pem
 create mode 100644 tests/assets/client-certificates/client/trusted/key.pem
 create mode 100644 tests/assets/client-certificates/server/server_cert.pem
 create mode 100644 tests/assets/client-certificates/server/server_key.pem
 create mode 100644 tests/async/test_browsercontext_client_certificates.py
 rename tests/async/{test_evaluate.py => test_page_evaluate.py} (86%)
 create mode 100644 tests/sync/test_browsercontext_client_certificates.py

diff --git a/README.md b/README.md
index 92cd726ab..fdd043e95 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 -->127.0.6533.17<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->127.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->128.0.6613.7<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| WebKit <!-- GEN:webkit-version -->18.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->128.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index ba46c2a71..34cfc8a48 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from pathlib import Path
 from typing import Any, Dict, List, Literal, Optional, Sequence, TypedDict, Union
 
 # These are the structures that we like keeping in a JSON form for their potential
@@ -100,6 +101,14 @@ class StorageState(TypedDict, total=False):
     origins: List[OriginState]
 
 
+class ClientCertificate(TypedDict, total=False):
+    origin: str
+    certPath: Optional[Union[str, Path]]
+    keyPath: Optional[Union[str, Path]]
+    pfxPath: Optional[Union[str, Path]]
+    passphrase: Optional[str]
+
+
 class ResourceTiming(TypedDict):
     startTime: float
     domainLookupStart: float
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index 8a248f703..c5a9022a3 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -18,6 +18,7 @@
 from typing import TYPE_CHECKING, Dict, List, Optional, Pattern, Sequence, Union, cast
 
 from playwright._impl._api_structures import (
+    ClientCertificate,
     Geolocation,
     HttpCredentials,
     ProxySettings,
@@ -41,7 +42,7 @@
     make_dirs_for_file,
     prepare_record_har_options,
 )
-from playwright._impl._network import serialize_headers
+from playwright._impl._network import serialize_headers, to_client_certificates_protocol
 from playwright._impl._page import Page
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -120,6 +121,7 @@ async def new_context(
         recordHarUrlFilter: Union[Pattern[str], str] = None,
         recordHarMode: HarMode = None,
         recordHarContent: HarContentPolicy = None,
+        clientCertificates: List[ClientCertificate] = None,
     ) -> BrowserContext:
         params = locals_to_params(locals())
         await prepare_browser_context_params(params)
@@ -165,6 +167,7 @@ async def new_page(
         recordHarUrlFilter: Union[Pattern[str], str] = None,
         recordHarMode: HarMode = None,
         recordHarContent: HarContentPolicy = None,
+        clientCertificates: List[ClientCertificate] = None,
     ) -> Page:
         params = locals_to_params(locals())
 
@@ -253,3 +256,8 @@ async def prepare_browser_context_params(params: Dict) -> None:
         params["forcedColors"] = "no-override"
     if "acceptDownloads" in params:
         params["acceptDownloads"] = "accept" if params["acceptDownloads"] else "deny"
+
+    if "clientCertificates" in params:
+        params["clientCertificates"] = await to_client_certificates_protocol(
+            params["clientCertificates"]
+        )
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 00e146061..70525949c 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -15,9 +15,10 @@
 import asyncio
 import pathlib
 from pathlib import Path
-from typing import TYPE_CHECKING, Dict, Optional, Pattern, Sequence, Union, cast
+from typing import TYPE_CHECKING, Dict, List, Optional, Pattern, Sequence, Union, cast
 
 from playwright._impl._api_structures import (
+    ClientCertificate,
     Geolocation,
     HttpCredentials,
     ProxySettings,
@@ -147,6 +148,7 @@ async def launch_persistent_context(
         recordHarUrlFilter: Union[Pattern[str], str] = None,
         recordHarMode: HarMode = None,
         recordHarContent: HarContentPolicy = None,
+        clientCertificates: List[ClientCertificate] = None,
     ) -> BrowserContext:
         userDataDir = str(Path(userDataDir)) if userDataDir else ""
         params = locals_to_params(locals())
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index da17c169c..8dde5a541 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -21,6 +21,7 @@
 
 import playwright._impl._network as network
 from playwright._impl._api_structures import (
+    ClientCertificate,
     FilePayload,
     FormField,
     Headers,
@@ -42,7 +43,7 @@
     object_to_array,
     to_impl,
 )
-from playwright._impl._network import serialize_headers
+from playwright._impl._network import serialize_headers, to_client_certificates_protocol
 from playwright._impl._tracing import Tracing
 
 if typing.TYPE_CHECKING:
@@ -71,6 +72,7 @@ async def new_context(
         userAgent: str = None,
         timeout: float = None,
         storageState: Union[StorageState, str, Path] = None,
+        clientCertificates: List[ClientCertificate] = None,
     ) -> "APIRequestContext":
         params = locals_to_params(locals())
         if "storageState" in params:
@@ -81,6 +83,9 @@ async def new_context(
                 )
         if "extraHTTPHeaders" in params:
             params["extraHTTPHeaders"] = serialize_headers(params["extraHTTPHeaders"])
+        params["clientCertificates"] = await to_client_certificates_protocol(
+            params.get("clientCertificates")
+        )
         context = cast(
             APIRequestContext,
             from_channel(await self.playwright._channel.send("newRequest", params)),
@@ -118,6 +123,7 @@ async def delete(
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
         maxRedirects: int = None,
+        maxRetries: int = None,
     ) -> "APIResponse":
         return await self.fetch(
             url,
@@ -131,6 +137,7 @@ async def delete(
             failOnStatusCode=failOnStatusCode,
             ignoreHTTPSErrors=ignoreHTTPSErrors,
             maxRedirects=maxRedirects,
+            maxRetries=maxRetries,
         )
 
     async def head(
@@ -145,6 +152,7 @@ async def head(
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
         maxRedirects: int = None,
+        maxRetries: int = None,
     ) -> "APIResponse":
         return await self.fetch(
             url,
@@ -158,6 +166,7 @@ async def head(
             failOnStatusCode=failOnStatusCode,
             ignoreHTTPSErrors=ignoreHTTPSErrors,
             maxRedirects=maxRedirects,
+            maxRetries=maxRetries,
         )
 
     async def get(
@@ -172,6 +181,7 @@ async def get(
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
         maxRedirects: int = None,
+        maxRetries: int = None,
     ) -> "APIResponse":
         return await self.fetch(
             url,
@@ -185,6 +195,7 @@ async def get(
             failOnStatusCode=failOnStatusCode,
             ignoreHTTPSErrors=ignoreHTTPSErrors,
             maxRedirects=maxRedirects,
+            maxRetries=maxRetries,
         )
 
     async def patch(
@@ -199,6 +210,7 @@ async def patch(
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
         maxRedirects: int = None,
+        maxRetries: int = None,
     ) -> "APIResponse":
         return await self.fetch(
             url,
@@ -212,6 +224,7 @@ async def patch(
             failOnStatusCode=failOnStatusCode,
             ignoreHTTPSErrors=ignoreHTTPSErrors,
             maxRedirects=maxRedirects,
+            maxRetries=maxRetries,
         )
 
     async def put(
@@ -226,6 +239,7 @@ async def put(
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
         maxRedirects: int = None,
+        maxRetries: int = None,
     ) -> "APIResponse":
         return await self.fetch(
             url,
@@ -239,6 +253,7 @@ async def put(
             failOnStatusCode=failOnStatusCode,
             ignoreHTTPSErrors=ignoreHTTPSErrors,
             maxRedirects=maxRedirects,
+            maxRetries=maxRetries,
         )
 
     async def post(
@@ -253,6 +268,7 @@ async def post(
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
         maxRedirects: int = None,
+        maxRetries: int = None,
     ) -> "APIResponse":
         return await self.fetch(
             url,
@@ -266,6 +282,7 @@ async def post(
             failOnStatusCode=failOnStatusCode,
             ignoreHTTPSErrors=ignoreHTTPSErrors,
             maxRedirects=maxRedirects,
+            maxRetries=maxRetries,
         )
 
     async def fetch(
@@ -281,6 +298,7 @@ async def fetch(
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
         maxRedirects: int = None,
+        maxRetries: int = None,
     ) -> "APIResponse":
         url = urlOrRequest if isinstance(urlOrRequest, str) else None
         request = (
@@ -304,6 +322,7 @@ async def fetch(
             failOnStatusCode,
             ignoreHTTPSErrors,
             maxRedirects,
+            maxRetries,
         )
 
     async def _inner_fetch(
@@ -320,6 +339,7 @@ async def _inner_fetch(
         failOnStatusCode: bool = None,
         ignoreHTTPSErrors: bool = None,
         maxRedirects: int = None,
+        maxRetries: int = None,
     ) -> "APIResponse":
         if self._close_reason:
             raise TargetClosedError(self._close_reason)
@@ -329,6 +349,9 @@ async def _inner_fetch(
         assert (
             maxRedirects is None or maxRedirects >= 0
         ), "'max_redirects' must be greater than or equal to '0'"
+        assert (
+            maxRetries is None or maxRetries >= 0
+        ), "'max_retries' must be greater than or equal to '0'"
         url = url or (request.url if request else url)
         method = method or (request.method if request else "GET")
         # Cannot call allHeaders() here as the request may be paused inside route handler.
@@ -392,6 +415,7 @@ async def _inner_fetch(
                 "failOnStatusCode": failOnStatusCode,
                 "ignoreHTTPSErrors": ignoreHTTPSErrors,
                 "maxRedirects": maxRedirects,
+                "maxRetries": maxRetries,
             },
         )
         return APIResponse(self, response)
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 415d79a76..a8be0ee18 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -15,12 +15,13 @@
 import collections.abc
 import datetime
 import math
+import traceback
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union
 from urllib.parse import ParseResult, urlparse, urlunparse
 
 from playwright._impl._connection import Channel, ChannelOwner, from_channel
-from playwright._impl._errors import is_target_closed_error
+from playwright._impl._errors import Error, is_target_closed_error
 from playwright._impl._map import Map
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -140,6 +141,20 @@ def serialize_value(
                 value.astimezone(datetime.timezone.utc), "%Y-%m-%dT%H:%M:%S.%fZ"
             )
         }
+    if isinstance(value, Exception):
+        return {
+            "e": {
+                "m": str(value),
+                "n": (value.name or "")
+                if isinstance(value, Error)
+                else value.__class__.__name__,
+                "s": (value.stack or "")
+                if isinstance(value, Error)
+                else "".join(
+                    traceback.format_exception(type(value), value=value, tb=None)
+                ),
+            }
+        }
     if isinstance(value, bool):
         return {"b": value}
     if isinstance(value, (int, float)):
@@ -207,6 +222,12 @@ def parse_value(value: Any, refs: Optional[Dict[int, Any]] = None) -> Any:
         if "bi" in value:
             return int(value["bi"])
 
+        if "e" in value:
+            error = Error(value["e"]["m"])
+            error._name = value["e"]["n"]
+            error._stack = value["e"]["s"]
+            return error
+
         if "a" in value:
             a: List = []
             refs[value["id"]] = a
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 3656a01cc..d6df048bc 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -36,6 +36,7 @@
 from urllib import parse
 
 from playwright._impl._api_structures import (
+    ClientCertificate,
     Headers,
     HeadersArray,
     RemoteAddr,
@@ -50,7 +51,7 @@
 )
 from playwright._impl._errors import Error
 from playwright._impl._event_context_manager import EventContextManagerImpl
-from playwright._impl._helper import locals_to_params
+from playwright._impl._helper import async_readfile, locals_to_params
 from playwright._impl._waiter import Waiter
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -83,6 +84,34 @@ def serialize_headers(headers: Dict[str, str]) -> HeadersArray:
     ]
 
 
+async def to_client_certificates_protocol(
+    clientCertificates: Optional[List[ClientCertificate]],
+) -> Optional[List[Dict[str, str]]]:
+    if not clientCertificates:
+        return None
+    out = []
+    for clientCertificate in clientCertificates:
+        out_record = {
+            "origin": clientCertificate["origin"],
+        }
+        if passphrase := clientCertificate.get("passphrase"):
+            out_record["passphrase"] = passphrase
+        if pfx_path := clientCertificate.get("pfxPath"):
+            out_record["pfx"] = base64.b64encode(
+                await async_readfile(pfx_path)
+            ).decode()
+        if cert_path := clientCertificate.get("certPath"):
+            out_record["cert"] = base64.b64encode(
+                await async_readfile(cert_path)
+            ).decode()
+        if key_path := clientCertificate.get("keyPath"):
+            out_record["key"] = base64.b64encode(
+                await async_readfile(key_path)
+            ).decode()
+        out.append(out_record)
+    return out
+
+
 class Request(ChannelOwner):
     def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
@@ -410,6 +439,7 @@ async def fetch(
         headers: Dict[str, str] = None,
         postData: Union[Any, str, bytes] = None,
         maxRedirects: int = None,
+        maxRetries: int = None,
         timeout: float = None,
     ) -> "APIResponse":
         return await self._connection.wrap_api_call(
@@ -420,6 +450,7 @@ async def fetch(
                 headers,
                 postData,
                 maxRedirects=maxRedirects,
+                maxRetries=maxRetries,
                 timeout=timeout,
             )
         )
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 0a866ef75..dbd9a36b7 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -20,6 +20,7 @@
 
 from playwright._impl._accessibility import Accessibility as AccessibilityImpl
 from playwright._impl._api_structures import (
+    ClientCertificate,
     Cookie,
     FilePayload,
     FloatRect,
@@ -365,7 +366,7 @@ async def headers_array(self) -> typing.List[NameValue]:
     async def header_value(self, name: str) -> typing.Optional[str]:
         """Request.header_value
 
-        Returns the value of the header matching the name. The name is case insensitive.
+        Returns the value of the header matching the name. The name is case-insensitive.
 
         Parameters
         ----------
@@ -512,7 +513,7 @@ async def headers_array(self) -> typing.List[NameValue]:
     async def header_value(self, name: str) -> typing.Optional[str]:
         """Response.header_value
 
-        Returns the value of the header matching the name. The name is case insensitive. If multiple headers have the same
+        Returns the value of the header matching the name. The name is case-insensitive. If multiple headers have the same
         name (except `set-cookie`), they are returned as a list separated by `, `. For `set-cookie`, the `\\n` separator is
         used. If no headers are found, `null` is returned.
 
@@ -531,7 +532,7 @@ async def header_value(self, name: str) -> typing.Optional[str]:
     async def header_values(self, name: str) -> typing.List[str]:
         """Response.header_values
 
-        Returns all values of the headers matching the name, for example `set-cookie`. The name is case insensitive.
+        Returns all values of the headers matching the name, for example `set-cookie`. The name is case-insensitive.
 
         Parameters
         ----------
@@ -733,6 +734,7 @@ async def fetch(
         headers: typing.Optional[typing.Dict[str, str]] = None,
         post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
         max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None,
         timeout: typing.Optional[float] = None
     ) -> "APIResponse":
         """Route.fetch
@@ -773,6 +775,9 @@ async def handle(route):
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
 
@@ -788,6 +793,7 @@ async def handle(route):
                 headers=mapping.to_impl(headers),
                 postData=mapping.to_impl(post_data),
                 maxRedirects=max_redirects,
+                maxRetries=max_retries,
                 timeout=timeout,
             )
         )
@@ -1301,7 +1307,9 @@ async def move(
         Parameters
         ----------
         x : float
+            X coordinate relative to the main frame's viewport in CSS pixels.
         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.
         """
@@ -1368,7 +1376,9 @@ async def click(
         Parameters
         ----------
         x : float
+            X coordinate relative to the main frame's viewport in CSS pixels.
         y : float
+            Y coordinate relative to the main frame's viewport in CSS pixels.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -1399,7 +1409,9 @@ async def dblclick(
         Parameters
         ----------
         x : float
+            X coordinate relative to the main frame's viewport in CSS pixels.
         y : float
+            Y coordinate relative to the main frame's viewport in CSS pixels.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -1446,7 +1458,9 @@ async def tap(self, x: float, y: float) -> None:
         Parameters
         ----------
         x : float
+            X coordinate relative to the main frame's viewport in CSS pixels.
         y : float
+            Y coordinate relative to the main frame's viewport in CSS pixels.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.tap(x=x, y=y))
@@ -1867,7 +1881,6 @@ async def hover(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -1887,9 +1900,8 @@ async def hover(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         trial : Union[bool, None]
@@ -1960,6 +1972,7 @@ async def click(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         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.
@@ -1999,8 +2012,6 @@ async def dblclick(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
-           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -2028,9 +2039,8 @@ async def dblclick(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -2108,6 +2118,7 @@ async def select_option(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
 
         Returns
         -------
@@ -2144,7 +2155,6 @@ async def tap(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -2168,9 +2178,8 @@ async def tap(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -2215,9 +2224,8 @@ async def fill(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -2311,9 +2319,8 @@ async def set_input_files(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -2357,9 +2364,8 @@ async def type(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -2413,6 +2419,7 @@ async def press(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         """
 
         return mapping.from_maybe_impl(
@@ -2440,7 +2447,6 @@ async def set_checked(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -2459,9 +2465,8 @@ async def set_checked(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -2495,7 +2500,6 @@ async def check(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
@@ -2514,9 +2518,8 @@ async def check(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -2549,7 +2552,6 @@ async def uncheck(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
@@ -2568,9 +2570,8 @@ async def uncheck(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -3066,9 +3067,8 @@ async def set_files(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -4083,7 +4083,7 @@ async def add_script_tag(
         content : Union[str, None]
             Raw JavaScript content to be injected into frame.
         type : Union[str, None]
-            Script type. Use 'module' in order to load a Javascript ES6 module. See
+            Script type. Use 'module' in order to load a JavaScript ES6 module. See
             [script](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script) for more details.
 
         Returns
@@ -4187,6 +4187,7 @@ async def click(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4234,8 +4235,7 @@ async def dblclick(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
-        1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
+        1. Use `page.mouse` to double click in the center of the element, or the specified `position`. if
            the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -4265,9 +4265,8 @@ async def dblclick(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4313,7 +4312,6 @@ async def tap(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
@@ -4338,9 +4336,8 @@ async def tap(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4396,9 +4393,8 @@ async def fill(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5158,7 +5154,6 @@ async def hover(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
@@ -5179,9 +5174,8 @@ async def hover(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -5237,9 +5231,8 @@ async def drag_and_drop(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5326,6 +5319,7 @@ async def select_option(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5427,9 +5421,8 @@ async def set_input_files(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -5477,9 +5470,8 @@ async def type(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -5544,6 +5536,7 @@ async def press(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         """
 
         return mapping.from_maybe_impl(
@@ -5578,7 +5571,6 @@ async def check(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -5598,9 +5590,8 @@ async def check(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5642,7 +5633,6 @@ async def uncheck(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -5662,9 +5652,8 @@ async def uncheck(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5808,7 +5797,6 @@ async def set_checked(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -5830,9 +5818,8 @@ async def set_checked(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8508,7 +8495,7 @@ async def add_script_tag(
         content : Union[str, None]
             Raw JavaScript content to be injected into frame.
         type : Union[str, None]
-            Script type. Use 'module' in order to load a Javascript ES6 module. See
+            Script type. Use 'module' in order to load a JavaScript ES6 module. See
             [script](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script) for more details.
 
         Returns
@@ -9008,7 +8995,7 @@ async def go_back(
         """Page.go_back
 
         Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
-        the last redirect. If can not go back, returns `null`.
+        the last redirect. If cannot go back, returns `null`.
 
         Navigate to the previous page in history.
 
@@ -9048,7 +9035,7 @@ async def go_forward(
         """Page.go_forward
 
         Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
-        the last redirect. If can not go forward, returns `null`.
+        the last redirect. If cannot go forward, returns `null`.
 
         Navigate to the next page in history.
 
@@ -9619,6 +9606,7 @@ async def click(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         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.
@@ -9667,8 +9655,6 @@ async def dblclick(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
-           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
@@ -9697,9 +9683,8 @@ async def dblclick(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9745,7 +9730,6 @@ async def tap(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
@@ -9770,9 +9754,8 @@ async def tap(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9828,9 +9811,8 @@ async def fill(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10588,7 +10570,6 @@ async def hover(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
@@ -10609,9 +10590,8 @@ async def hover(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -10683,9 +10663,8 @@ async def drag_and_drop(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -10773,6 +10752,7 @@ async def select_option(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -10875,9 +10855,8 @@ async def set_input_files(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -10922,9 +10901,8 @@ async def type(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11005,6 +10983,7 @@ async def press(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11042,7 +11021,6 @@ async def check(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -11062,9 +11040,8 @@ async def check(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11106,7 +11083,6 @@ async def uncheck(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -11126,9 +11102,8 @@ async def uncheck(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11836,7 +11811,6 @@ async def set_checked(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -11858,9 +11832,8 @@ async def set_checked(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -12589,9 +12562,6 @@ async def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
         Parameters
         ----------
         cookies : Sequence[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
-            Adds cookies to the browser context.
-
-            For the cookie to apply to all subdomains as well, prefix domain with a dot, like this: ".example.com".
         """
 
         return mapping.from_maybe_impl(
@@ -13469,7 +13439,8 @@ async def new_context(
             typing.Union[str, typing.Pattern[str]]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
-        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None
+        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
     ) -> "BrowserContext":
         """Browser.new_context
 
@@ -13610,6 +13581,20 @@ async def new_context(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+            TLS Client Authentication allows the server to request a client certificate and verify it.
+
+            **Details**
+
+            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
+            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
+            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
+            the certificate is valid for.
+
+            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
+
+            **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
+            work by replacing `localhost` with `local.playwright`.
 
         Returns
         -------
@@ -13652,6 +13637,7 @@ async def new_context(
                 recordHarUrlFilter=record_har_url_filter,
                 recordHarMode=record_har_mode,
                 recordHarContent=record_har_content,
+                clientCertificates=client_certificates,
             )
         )
 
@@ -13699,7 +13685,8 @@ async def new_page(
             typing.Union[str, typing.Pattern[str]]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
-        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None
+        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
     ) -> "Page":
         """Browser.new_page
 
@@ -13824,6 +13811,20 @@ async def new_page(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+            TLS Client Authentication allows the server to request a client certificate and verify it.
+
+            **Details**
+
+            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
+            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
+            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
+            the certificate is valid for.
+
+            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
+
+            **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
+            work by replacing `localhost` with `local.playwright`.
 
         Returns
         -------
@@ -13866,6 +13867,7 @@ async def new_page(
                 recordHarUrlFilter=record_har_url_filter,
                 recordHarMode=record_har_mode,
                 recordHarContent=record_har_content,
+                clientCertificates=client_certificates,
             )
         )
 
@@ -14196,7 +14198,8 @@ async def launch_persistent_context(
             typing.Union[str, typing.Pattern[str]]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
-        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None
+        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
     ) -> "BrowserContext":
         """BrowserType.launch_persistent_context
 
@@ -14367,6 +14370,20 @@ async def launch_persistent_context(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+            TLS Client Authentication allows the server to request a client certificate and verify it.
+
+            **Details**
+
+            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
+            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
+            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
+            the certificate is valid for.
+
+            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
+
+            **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
+            work by replacing `localhost` with `local.playwright`.
 
         Returns
         -------
@@ -14424,6 +14441,7 @@ async def launch_persistent_context(
                 recordHarUrlFilter=record_har_url_filter,
                 recordHarMode=record_har_mode,
                 recordHarContent=record_har_content,
+                clientCertificates=client_certificates,
             )
         )
 
@@ -14922,7 +14940,6 @@ async def check(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
@@ -14947,9 +14964,8 @@ async def check(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -15037,6 +15053,7 @@ async def click(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         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.
@@ -15080,8 +15097,6 @@ async def dblclick(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
-           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -15109,9 +15124,8 @@ async def dblclick(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -15370,9 +15384,8 @@ async def fill(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -15416,9 +15429,8 @@ async def clear(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -16262,9 +16274,8 @@ async def drag_to(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -16346,7 +16357,6 @@ async def hover(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -16366,9 +16376,8 @@ async def hover(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         trial : Union[bool, None]
@@ -16681,6 +16690,7 @@ async def press(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         """
 
         return mapping.from_maybe_impl(
@@ -16886,6 +16896,7 @@ async def select_option(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
 
@@ -16992,9 +17003,8 @@ async def set_input_files(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -17025,7 +17035,6 @@ async def tap(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -17049,9 +17058,8 @@ async def tap(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -17120,9 +17128,8 @@ async def type(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -17174,9 +17181,8 @@ async def press_sequentially(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -17212,7 +17218,6 @@ async def uncheck(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
@@ -17231,9 +17236,8 @@ async def uncheck(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -17361,7 +17365,6 @@ async def set_checked(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -17380,9 +17383,8 @@ async def set_checked(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -17568,7 +17570,8 @@ async def delete(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.delete
 
@@ -17607,6 +17610,9 @@ async def delete(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -17625,6 +17631,7 @@ async def delete(
                 failOnStatusCode=fail_on_status_code,
                 ignoreHTTPSErrors=ignore_https_errors,
                 maxRedirects=max_redirects,
+                maxRetries=max_retries,
             )
         )
 
@@ -17644,7 +17651,8 @@ async def head(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.head
 
@@ -17683,6 +17691,9 @@ async def head(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -17701,6 +17712,7 @@ async def head(
                 failOnStatusCode=fail_on_status_code,
                 ignoreHTTPSErrors=ignore_https_errors,
                 maxRedirects=max_redirects,
+                maxRetries=max_retries,
             )
         )
 
@@ -17720,7 +17732,8 @@ async def get(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.get
 
@@ -17771,6 +17784,9 @@ async def get(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -17789,6 +17805,7 @@ async def get(
                 failOnStatusCode=fail_on_status_code,
                 ignoreHTTPSErrors=ignore_https_errors,
                 maxRedirects=max_redirects,
+                maxRetries=max_retries,
             )
         )
 
@@ -17808,7 +17825,8 @@ async def patch(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.patch
 
@@ -17847,6 +17865,9 @@ async def patch(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -17865,6 +17886,7 @@ async def patch(
                 failOnStatusCode=fail_on_status_code,
                 ignoreHTTPSErrors=ignore_https_errors,
                 maxRedirects=max_redirects,
+                maxRetries=max_retries,
             )
         )
 
@@ -17884,7 +17906,8 @@ async def put(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.put
 
@@ -17923,6 +17946,9 @@ async def put(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -17941,6 +17967,7 @@ async def put(
                 failOnStatusCode=fail_on_status_code,
                 ignoreHTTPSErrors=ignore_https_errors,
                 maxRedirects=max_redirects,
+                maxRetries=max_retries,
             )
         )
 
@@ -17960,7 +17987,8 @@ async def post(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.post
 
@@ -18030,6 +18058,9 @@ async def post(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -18048,6 +18079,7 @@ async def post(
                 failOnStatusCode=fail_on_status_code,
                 ignoreHTTPSErrors=ignore_https_errors,
                 maxRedirects=max_redirects,
+                maxRetries=max_retries,
             )
         )
 
@@ -18068,7 +18100,8 @@ async def fetch(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.fetch
 
@@ -18124,6 +18157,9 @@ async def fetch(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -18143,6 +18179,7 @@ async def fetch(
                 failOnStatusCode=fail_on_status_code,
                 ignoreHTTPSErrors=ignore_https_errors,
                 maxRedirects=max_redirects,
+                maxRetries=max_retries,
             )
         )
 
@@ -18184,7 +18221,8 @@ async def new_context(
         timeout: typing.Optional[float] = None,
         storage_state: typing.Optional[
             typing.Union[StorageState, str, pathlib.Path]
-        ] = None
+        ] = None,
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
     ) -> "APIRequestContext":
         """APIRequest.new_context
 
@@ -18220,6 +18258,20 @@ async def new_context(
             information obtained via `browser_context.storage_state()` or `a_pi_request_context.storage_state()`.
             Either a path to the file with saved storage, or the value returned by one of
             `browser_context.storage_state()` or `a_pi_request_context.storage_state()` methods.
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+            TLS Client Authentication allows the server to request a client certificate and verify it.
+
+            **Details**
+
+            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
+            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
+            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
+            the certificate is valid for.
+
+            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
+
+            **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
+            work by replacing `localhost` with `local.playwright`.
 
         Returns
         -------
@@ -18236,6 +18288,7 @@ async def new_context(
                 userAgent=user_agent,
                 timeout=timeout,
                 storageState=storage_state,
+                clientCertificates=client_certificates,
             )
         )
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 2f28abbb9..aa4e60166 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -20,6 +20,7 @@
 
 from playwright._impl._accessibility import Accessibility as AccessibilityImpl
 from playwright._impl._api_structures import (
+    ClientCertificate,
     Cookie,
     FilePayload,
     FloatRect,
@@ -365,7 +366,7 @@ def headers_array(self) -> typing.List[NameValue]:
     def header_value(self, name: str) -> typing.Optional[str]:
         """Request.header_value
 
-        Returns the value of the header matching the name. The name is case insensitive.
+        Returns the value of the header matching the name. The name is case-insensitive.
 
         Parameters
         ----------
@@ -514,7 +515,7 @@ def headers_array(self) -> typing.List[NameValue]:
     def header_value(self, name: str) -> typing.Optional[str]:
         """Response.header_value
 
-        Returns the value of the header matching the name. The name is case insensitive. If multiple headers have the same
+        Returns the value of the header matching the name. The name is case-insensitive. If multiple headers have the same
         name (except `set-cookie`), they are returned as a list separated by `, `. For `set-cookie`, the `\\n` separator is
         used. If no headers are found, `null` is returned.
 
@@ -535,7 +536,7 @@ def header_value(self, name: str) -> typing.Optional[str]:
     def header_values(self, name: str) -> typing.List[str]:
         """Response.header_values
 
-        Returns all values of the headers matching the name, for example `set-cookie`. The name is case insensitive.
+        Returns all values of the headers matching the name, for example `set-cookie`. The name is case-insensitive.
 
         Parameters
         ----------
@@ -743,6 +744,7 @@ def fetch(
         headers: typing.Optional[typing.Dict[str, str]] = None,
         post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
         max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None,
         timeout: typing.Optional[float] = None
     ) -> "APIResponse":
         """Route.fetch
@@ -783,6 +785,9 @@ def handle(route):
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
         timeout : Union[float, None]
             Request timeout in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
 
@@ -799,6 +804,7 @@ def handle(route):
                     headers=mapping.to_impl(headers),
                     postData=mapping.to_impl(post_data),
                     maxRedirects=max_redirects,
+                    maxRetries=max_retries,
                     timeout=timeout,
                 )
             )
@@ -1299,7 +1305,9 @@ def move(self, x: float, y: float, *, steps: typing.Optional[int] = None) -> Non
         Parameters
         ----------
         x : float
+            X coordinate relative to the main frame's viewport in CSS pixels.
         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.
         """
@@ -1368,7 +1376,9 @@ def click(
         Parameters
         ----------
         x : float
+            X coordinate relative to the main frame's viewport in CSS pixels.
         y : float
+            Y coordinate relative to the main frame's viewport in CSS pixels.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -1401,7 +1411,9 @@ def dblclick(
         Parameters
         ----------
         x : float
+            X coordinate relative to the main frame's viewport in CSS pixels.
         y : float
+            Y coordinate relative to the main frame's viewport in CSS pixels.
         delay : Union[float, None]
             Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
         button : Union["left", "middle", "right", None]
@@ -1448,7 +1460,9 @@ def tap(self, x: float, y: float) -> None:
         Parameters
         ----------
         x : float
+            X coordinate relative to the main frame's viewport in CSS pixels.
         y : float
+            Y coordinate relative to the main frame's viewport in CSS pixels.
         """
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.tap(x=x, y=y)))
@@ -1875,7 +1889,6 @@ def hover(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -1895,9 +1908,8 @@ def hover(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         trial : Union[bool, None]
@@ -1970,6 +1982,7 @@ def click(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         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.
@@ -2011,8 +2024,6 @@ def dblclick(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
-           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -2040,9 +2051,8 @@ def dblclick(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -2122,6 +2132,7 @@ def select_option(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
 
         Returns
         -------
@@ -2160,7 +2171,6 @@ def tap(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -2184,9 +2194,8 @@ def tap(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -2233,9 +2242,8 @@ def fill(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -2331,9 +2339,8 @@ def set_input_files(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -2381,9 +2388,8 @@ def type(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -2439,6 +2445,7 @@ def press(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         """
 
         return mapping.from_maybe_impl(
@@ -2468,7 +2475,6 @@ def set_checked(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -2487,9 +2493,8 @@ def set_checked(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -2525,7 +2530,6 @@ def check(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
@@ -2544,9 +2548,8 @@ def check(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -2581,7 +2584,6 @@ def uncheck(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
@@ -2600,9 +2602,8 @@ def uncheck(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -3112,9 +3113,8 @@ def set_files(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -4158,7 +4158,7 @@ def add_script_tag(
         content : Union[str, None]
             Raw JavaScript content to be injected into frame.
         type : Union[str, None]
-            Script type. Use 'module' in order to load a Javascript ES6 module. See
+            Script type. Use 'module' in order to load a JavaScript ES6 module. See
             [script](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script) for more details.
 
         Returns
@@ -4266,6 +4266,7 @@ def click(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4315,8 +4316,7 @@ def dblclick(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the matched element, unless `force` option is set. If
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
-        1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
+        1. Use `page.mouse` to double click in the center of the element, or the specified `position`. if
            the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -4346,9 +4346,8 @@ def dblclick(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4396,7 +4395,6 @@ def tap(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
@@ -4421,9 +4419,8 @@ def tap(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -4481,9 +4478,8 @@ def fill(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5253,7 +5249,6 @@ def hover(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
@@ -5274,9 +5269,8 @@ def hover(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -5334,9 +5328,8 @@ def drag_and_drop(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5425,6 +5418,7 @@ def select_option(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5530,9 +5524,8 @@ def set_input_files(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -5582,9 +5575,8 @@ def type(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -5651,6 +5643,7 @@ def press(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         """
 
         return mapping.from_maybe_impl(
@@ -5687,7 +5680,6 @@ def check(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -5707,9 +5699,8 @@ def check(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5753,7 +5744,6 @@ def uncheck(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -5773,9 +5763,8 @@ def uncheck(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -5920,7 +5909,6 @@ def set_checked(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -5942,9 +5930,8 @@ def set_checked(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -8537,7 +8524,7 @@ def add_script_tag(
         content : Union[str, None]
             Raw JavaScript content to be injected into frame.
         type : Union[str, None]
-            Script type. Use 'module' in order to load a Javascript ES6 module. See
+            Script type. Use 'module' in order to load a JavaScript ES6 module. See
             [script](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script) for more details.
 
         Returns
@@ -9049,7 +9036,7 @@ def go_back(
         """Page.go_back
 
         Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
-        the last redirect. If can not go back, returns `null`.
+        the last redirect. If cannot go back, returns `null`.
 
         Navigate to the previous page in history.
 
@@ -9089,7 +9076,7 @@ def go_forward(
         """Page.go_forward
 
         Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of
-        the last redirect. If can not go forward, returns `null`.
+        the last redirect. If cannot go forward, returns `null`.
 
         Navigate to the next page in history.
 
@@ -9671,6 +9658,7 @@ def click(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         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.
@@ -9721,8 +9709,6 @@ def dblclick(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
-           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
@@ -9751,9 +9737,8 @@ def dblclick(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9801,7 +9786,6 @@ def tap(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
@@ -9826,9 +9810,8 @@ def tap(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9886,9 +9869,8 @@ def fill(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -10656,7 +10638,6 @@ def hover(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
         Passing zero timeout disables this.
@@ -10677,9 +10658,8 @@ def hover(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -10753,9 +10733,8 @@ def drag_and_drop(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -10845,6 +10824,7 @@ def select_option(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -10951,9 +10931,8 @@ def set_input_files(
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -11000,9 +10979,8 @@ def type(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11085,6 +11063,7 @@ def press(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11124,7 +11103,6 @@ def check(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -11144,9 +11122,8 @@ def check(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11190,7 +11167,6 @@ def uncheck(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -11210,9 +11186,8 @@ def uncheck(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -11923,7 +11898,6 @@ def set_checked(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -11945,9 +11919,8 @@ def set_checked(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -12614,9 +12587,6 @@ def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
         Parameters
         ----------
         cookies : Sequence[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
-            Adds cookies to the browser context.
-
-            For the cookie to apply to all subdomains as well, prefix domain with a dot, like this: ".example.com".
         """
 
         return mapping.from_maybe_impl(
@@ -13501,7 +13471,8 @@ def new_context(
             typing.Union[str, typing.Pattern[str]]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
-        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None
+        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
     ) -> "BrowserContext":
         """Browser.new_context
 
@@ -13642,6 +13613,20 @@ def new_context(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+            TLS Client Authentication allows the server to request a client certificate and verify it.
+
+            **Details**
+
+            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
+            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
+            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
+            the certificate is valid for.
+
+            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
+
+            **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
+            work by replacing `localhost` with `local.playwright`.
 
         Returns
         -------
@@ -13685,6 +13670,7 @@ def new_context(
                     recordHarUrlFilter=record_har_url_filter,
                     recordHarMode=record_har_mode,
                     recordHarContent=record_har_content,
+                    clientCertificates=client_certificates,
                 )
             )
         )
@@ -13733,7 +13719,8 @@ def new_page(
             typing.Union[str, typing.Pattern[str]]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
-        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None
+        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
     ) -> "Page":
         """Browser.new_page
 
@@ -13858,6 +13845,20 @@ def new_page(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+            TLS Client Authentication allows the server to request a client certificate and verify it.
+
+            **Details**
+
+            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
+            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
+            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
+            the certificate is valid for.
+
+            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
+
+            **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
+            work by replacing `localhost` with `local.playwright`.
 
         Returns
         -------
@@ -13901,6 +13902,7 @@ def new_page(
                     recordHarUrlFilter=record_har_url_filter,
                     recordHarMode=record_har_mode,
                     recordHarContent=record_har_content,
+                    clientCertificates=client_certificates,
                 )
             )
         )
@@ -14236,7 +14238,8 @@ def launch_persistent_context(
             typing.Union[str, typing.Pattern[str]]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
-        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None
+        record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
     ) -> "BrowserContext":
         """BrowserType.launch_persistent_context
 
@@ -14407,6 +14410,20 @@ def launch_persistent_context(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+            TLS Client Authentication allows the server to request a client certificate and verify it.
+
+            **Details**
+
+            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
+            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
+            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
+            the certificate is valid for.
+
+            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
+
+            **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
+            work by replacing `localhost` with `local.playwright`.
 
         Returns
         -------
@@ -14465,6 +14482,7 @@ def launch_persistent_context(
                     recordHarUrlFilter=record_har_url_filter,
                     recordHarMode=record_har_mode,
                     recordHarContent=record_har_content,
+                    clientCertificates=client_certificates,
                 )
             )
         )
@@ -14967,7 +14985,6 @@ def check(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked. If not, this method throws.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
@@ -14992,9 +15009,8 @@ def check(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -15084,6 +15100,7 @@ def click(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         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.
@@ -15129,8 +15146,6 @@ def dblclick(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to double click in the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if
-           the first click of the `dblclick()` triggers a navigation event, this method will throw.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -15158,9 +15173,8 @@ def dblclick(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -15429,9 +15443,8 @@ def fill(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -15477,9 +15490,8 @@ def clear(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         """
@@ -16328,9 +16340,8 @@ def drag_to(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -16414,7 +16425,6 @@ def hover(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to hover over the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -16434,9 +16444,8 @@ def hover(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         trial : Union[bool, None]
@@ -16763,6 +16772,7 @@ def press(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         """
 
         return mapping.from_maybe_impl(
@@ -16972,6 +16982,7 @@ def select_option(
             Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
             can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
             navigating to inaccessible pages. Defaults to `false`.
+            Deprecated: This option will default to `true` in the future.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
 
@@ -17080,9 +17091,8 @@ def set_input_files(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -17117,7 +17127,6 @@ def tap(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.touchscreen` to tap the center of the element, or the specified `position`.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
 
@@ -17141,9 +17150,8 @@ def tap(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -17214,9 +17222,8 @@ def type(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -17270,9 +17277,8 @@ def press_sequentially(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         """
 
         return mapping.from_maybe_impl(
@@ -17310,7 +17316,6 @@ def uncheck(
         1. Wait for [actionability](https://playwright.dev/python/docs/actionability) checks on the element, unless `force` option is set.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now unchecked. If not, this method throws.
 
         If the element is detached from the DOM at any moment during the action, this method throws.
@@ -17329,9 +17334,8 @@ def uncheck(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -17461,7 +17465,6 @@ def set_checked(
            the element is detached during the checks, the whole action is retried.
         1. Scroll the element into view if needed.
         1. Use `page.mouse` to click in the center of the element.
-        1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
         1. Ensure that the element is now checked or unchecked. If not, this method throws.
 
         When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`.
@@ -17480,9 +17483,8 @@ def set_checked(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
+            This option has no effect.
+            Deprecated: This option has no effect.
         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.
@@ -17672,7 +17674,8 @@ def delete(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.delete
 
@@ -17711,6 +17714,9 @@ def delete(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -17730,6 +17736,7 @@ def delete(
                     failOnStatusCode=fail_on_status_code,
                     ignoreHTTPSErrors=ignore_https_errors,
                     maxRedirects=max_redirects,
+                    maxRetries=max_retries,
                 )
             )
         )
@@ -17750,7 +17757,8 @@ def head(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.head
 
@@ -17789,6 +17797,9 @@ def head(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -17808,6 +17819,7 @@ def head(
                     failOnStatusCode=fail_on_status_code,
                     ignoreHTTPSErrors=ignore_https_errors,
                     maxRedirects=max_redirects,
+                    maxRetries=max_retries,
                 )
             )
         )
@@ -17828,7 +17840,8 @@ def get(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.get
 
@@ -17879,6 +17892,9 @@ def get(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -17898,6 +17914,7 @@ def get(
                     failOnStatusCode=fail_on_status_code,
                     ignoreHTTPSErrors=ignore_https_errors,
                     maxRedirects=max_redirects,
+                    maxRetries=max_retries,
                 )
             )
         )
@@ -17918,7 +17935,8 @@ def patch(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.patch
 
@@ -17957,6 +17975,9 @@ def patch(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -17976,6 +17997,7 @@ def patch(
                     failOnStatusCode=fail_on_status_code,
                     ignoreHTTPSErrors=ignore_https_errors,
                     maxRedirects=max_redirects,
+                    maxRetries=max_retries,
                 )
             )
         )
@@ -17996,7 +18018,8 @@ def put(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.put
 
@@ -18035,6 +18058,9 @@ def put(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -18054,6 +18080,7 @@ def put(
                     failOnStatusCode=fail_on_status_code,
                     ignoreHTTPSErrors=ignore_https_errors,
                     maxRedirects=max_redirects,
+                    maxRetries=max_retries,
                 )
             )
         )
@@ -18074,7 +18101,8 @@ def post(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.post
 
@@ -18144,6 +18172,9 @@ def post(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -18163,6 +18194,7 @@ def post(
                     failOnStatusCode=fail_on_status_code,
                     ignoreHTTPSErrors=ignore_https_errors,
                     maxRedirects=max_redirects,
+                    maxRetries=max_retries,
                 )
             )
         )
@@ -18184,7 +18216,8 @@ def fetch(
         timeout: typing.Optional[float] = None,
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
-        max_redirects: typing.Optional[int] = None
+        max_redirects: typing.Optional[int] = None,
+        max_retries: typing.Optional[int] = None
     ) -> "APIResponse":
         """APIRequestContext.fetch
 
@@ -18244,6 +18277,9 @@ def fetch(
         max_redirects : Union[int, None]
             Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
             exceeded. Defaults to `20`. Pass `0` to not follow redirects.
+        max_retries : Union[int, None]
+            Maximum number of times network errors should be retried. Currently only `ECONNRESET` error is retried. Does not
+            retry based on HTTP response codes. An error will be thrown if the limit is exceeded. Defaults to `0` - no retries.
 
         Returns
         -------
@@ -18264,6 +18300,7 @@ def fetch(
                     failOnStatusCode=fail_on_status_code,
                     ignoreHTTPSErrors=ignore_https_errors,
                     maxRedirects=max_redirects,
+                    maxRetries=max_retries,
                 )
             )
         )
@@ -18306,7 +18343,8 @@ def new_context(
         timeout: typing.Optional[float] = None,
         storage_state: typing.Optional[
             typing.Union[StorageState, str, pathlib.Path]
-        ] = None
+        ] = None,
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
     ) -> "APIRequestContext":
         """APIRequest.new_context
 
@@ -18342,6 +18380,20 @@ def new_context(
             information obtained via `browser_context.storage_state()` or `a_pi_request_context.storage_state()`.
             Either a path to the file with saved storage, or the value returned by one of
             `browser_context.storage_state()` or `a_pi_request_context.storage_state()` methods.
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+            TLS Client Authentication allows the server to request a client certificate and verify it.
+
+            **Details**
+
+            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
+            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
+            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
+            the certificate is valid for.
+
+            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
+
+            **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
+            work by replacing `localhost` with `local.playwright`.
 
         Returns
         -------
@@ -18359,6 +18411,7 @@ def new_context(
                     userAgent=user_agent,
                     timeout=timeout,
                     storageState=storage_state,
+                    clientCertificates=client_certificates,
                 )
             )
         )
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index 3c6f26fbf..7966dbc25 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -219,7 +219,7 @@ def return_value(value: Any) -> List[str]:
 
 
 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, ViewportSize, RemoteAddr, SecurityDetails, RequestSizes, NameValue
+from playwright._impl._api_structures import Cookie, SetCookieParam, FloatRect, FilePayload, Geolocation, HttpCredentials, PdfMargins, Position, ProxySettings, ResourceTiming, SourceLocation, StorageState, ClientCertificate, ViewportSize, RemoteAddr, SecurityDetails, RequestSizes, NameValue
 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
diff --git a/setup.py b/setup.py
index 2a0454820..9380425c9 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.45.1-beta-1719996498000"
+driver_version = "1.46.0-beta-1722359450000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/assets/client-certificates/README.md b/tests/assets/client-certificates/README.md
new file mode 100644
index 000000000..b0ee78e70
--- /dev/null
+++ b/tests/assets/client-certificates/README.md
@@ -0,0 +1,60 @@
+# Client Certificate test-certificates
+
+## Server
+
+```bash
+openssl req \
+	-x509 \
+	-newkey rsa:4096 \
+	-keyout server/server_key.pem \
+	-out server/server_cert.pem \
+	-nodes \
+	-days 365 \
+	-subj "/CN=localhost/O=Client\ Certificate\ Demo" \
+	-addext "subjectAltName=DNS:localhost,DNS:local.playwright"
+```
+
+## Trusted client-certificate (server signed/valid)
+
+```
+mkdir -p client/trusted
+# generate server-signed (valid) certifcate
+openssl req \
+	-newkey rsa:4096 \
+	-keyout client/trusted/key.pem \
+	-out client/trusted/csr.pem \
+	-nodes \
+	-days 365 \
+	-subj "/CN=Alice"
+
+# sign with server_cert.pem
+openssl x509 \
+	-req \
+	-in client/trusted/csr.pem \
+	-CA server/server_cert.pem \
+	-CAkey server/server_key.pem \
+	-out client/trusted/cert.pem \
+	-set_serial 01 \
+	-days 365
+```
+
+## Self-signed certificate (invalid)
+
+```
+mkdir -p client/self-signed
+openssl req \
+	-newkey rsa:4096 \
+	-keyout client/self-signed/key.pem \
+	-out client/self-signed/csr.pem \
+	-nodes \
+	-days 365 \
+	-subj "/CN=Bob"
+
+# sign with self-signed/key.pem
+openssl x509 \
+	-req \
+	-in client/self-signed/csr.pem \
+	-signkey client/self-signed/key.pem \
+	-out client/self-signed/cert.pem \
+	-days 365
+```
diff --git a/tests/assets/client-certificates/client/trusted/cert.pem b/tests/assets/client-certificates/client/trusted/cert.pem
new file mode 100644
index 000000000..76d1e1a54
--- /dev/null
+++ b/tests/assets/client-certificates/client/trusted/cert.pem
@@ -0,0 +1,29 @@
+-----BEGIN CERTIFICATE-----
+MIIFAzCCAuugAwIBAgIBATANBgkqhkiG9w0BAQsFADA2MRIwEAYDVQQDDAlsb2Nh
+bGhvc3QxIDAeBgNVBAoMF0NsaWVudCBDZXJ0aWZpY2F0ZSBEZW1vMB4XDTI0MDcx
+OTEyNDczN1oXDTI1MDcxOTEyNDczN1owEDEOMAwGA1UEAwwFQWxpY2UwggIiMA0G
+CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCac3+4rNmH4/N1s4HqR2X168tgS/aA
+6sHW5at8mWRnq54Nm11RvnK55jHQYVAdBgJy5M07w0wakp8inxzlY95wqxBimYG6
+3Un/1p7mX9FkB4LNISCc6j/s/Ufv85MXPbn0S5rm9UcQO9cINJb1RP1YgDDLN5cx
+Mz6X4nyofN8H6Lhvh4JDdBw4DfDEFERkVfF+bkZ7YW4XHEChgzm3RxCF0eeGzIXG
+rkkK9AsSdJAhOvTlHPFCQKXTYZhsL5+3Ma4RnWnDWvLTHx6KzoU+twTM2mYhhQuQ
+gQpnmDHxGge8kGeHGtfdgAjtVJTE57xF/shP0JU+tuIV8NNhQ/vEmhL0Wa093/Ev
+pTVp0EUEuDh9ORRH5K5M4bKJyU4XX5noiht6yOn00uaoJcWduUAWsU+cDSvDTMw8
+1opWWm0QIAV3G2yuRSkumHAKqvQLeyeyiKz+OEhyEiZ7EZNExPD0TSpApSTU6aCT
+UAvPYGQ59VjsMHTuJ9r4wKIYaDvfL+t72vg2vTQma5cTOBJfIdxH9blFTjEnToH3
+LX8t0XndQ2RkiRnIze2p2jUShxo/lWCjCw+2Iaw0A0fNUK1BbOrFRPq1u7AnEuMJ
+t7HF50MloItM97R9vofDwgDIzlX/PzlVRcn1WCo8Fr/0EXxPPreX0YDIp1ANQ8fS
+v7bKb2vQIxWuCQIDAQABo0IwQDAdBgNVHQ4EFgQUVJVRJJ2k/Z4r0M1AXe6agyD4
+uCwwHwYDVR0jBBgwFoAUEHtrxWCk96Ehr60E0HBuwLk2i+IwDQYJKoZIhvcNAQEL
+BQADggIBAGEvSkxhxRKmlvKG8wCXop2OaUUAOG16+T96vd+aFYaJNlfGoPvqv4Lw
+qaHztVktnRrJ//fpNWOsdxkE1uPU4uyGjl2KbyH81JvkE6A3OX0P4B01n8lcimY2
+j3oje6KjORUouYVsypD1VcwfWJgsE3U2Txv5srD8BoemVWgWbWjfyim4kk8C5zlf
+tWEazVAaI4MWecqtU4P5gIEomCI7MG9ebxYp5oQhRxeOndOYdUbSzAkZj50gXFA1
++TNkvuhTFlJF0F7qIFVJSJTmJ+6E5B4ddbkyUYwbOdO+P8mz5N5mSljE+EiIQTxo
+AwbG8cSivMy/jI3h048tCUONAJzcSWCF4k1r9Qr6xbyW2ud2GmKiFCEYJkYTsMWV
+fM/RujTHlGvJ2+bQK5HiNyW0tO9znW9kaoxolu1YBvTh2492v3agK7nALyGGgdo1
+/nN/ikgkQiyaCpZwFeooJv1YFU5aDhR9RjIIJ9UbJ8FdAv8Xd00E3viunLTvqqXK
+RVMokw+tFQTEzjKofKWYArPDjB9LUbN+vQbumKalis3+NlJ3WolYPrCg55tqt1o3
+zXi+xv7120cJFouilRFwrafNFV6F+pRMkMmiWopMnoVJPVXcoqyJRcsmO62uslhg
+BLFgAH4H/14drYrgWIMz0no78RInEz0z507zwLkWk5d9W9pJ/4Rf
+-----END CERTIFICATE-----
diff --git a/tests/assets/client-certificates/client/trusted/csr.pem b/tests/assets/client-certificates/client/trusted/csr.pem
new file mode 100644
index 000000000..8ead6da3d
--- /dev/null
+++ b/tests/assets/client-certificates/client/trusted/csr.pem
@@ -0,0 +1,26 @@
+-----BEGIN CERTIFICATE REQUEST-----
+MIIEVTCCAj0CAQAwEDEOMAwGA1UEAwwFQWxpY2UwggIiMA0GCSqGSIb3DQEBAQUA
+A4ICDwAwggIKAoICAQCac3+4rNmH4/N1s4HqR2X168tgS/aA6sHW5at8mWRnq54N
+m11RvnK55jHQYVAdBgJy5M07w0wakp8inxzlY95wqxBimYG63Un/1p7mX9FkB4LN
+ISCc6j/s/Ufv85MXPbn0S5rm9UcQO9cINJb1RP1YgDDLN5cxMz6X4nyofN8H6Lhv
+h4JDdBw4DfDEFERkVfF+bkZ7YW4XHEChgzm3RxCF0eeGzIXGrkkK9AsSdJAhOvTl
+HPFCQKXTYZhsL5+3Ma4RnWnDWvLTHx6KzoU+twTM2mYhhQuQgQpnmDHxGge8kGeH
+GtfdgAjtVJTE57xF/shP0JU+tuIV8NNhQ/vEmhL0Wa093/EvpTVp0EUEuDh9ORRH
+5K5M4bKJyU4XX5noiht6yOn00uaoJcWduUAWsU+cDSvDTMw81opWWm0QIAV3G2yu
+RSkumHAKqvQLeyeyiKz+OEhyEiZ7EZNExPD0TSpApSTU6aCTUAvPYGQ59VjsMHTu
+J9r4wKIYaDvfL+t72vg2vTQma5cTOBJfIdxH9blFTjEnToH3LX8t0XndQ2RkiRnI
+ze2p2jUShxo/lWCjCw+2Iaw0A0fNUK1BbOrFRPq1u7AnEuMJt7HF50MloItM97R9
+vofDwgDIzlX/PzlVRcn1WCo8Fr/0EXxPPreX0YDIp1ANQ8fSv7bKb2vQIxWuCQID
+AQABoAAwDQYJKoZIhvcNAQELBQADggIBAGgf3EC8WL3RGmuGA+d/4wd1jNfrfU6n
+xjnDwdEEX0TQZGGPjh5xvoCK76yZPkO6+z0IYSepEmWBS27HJKl7nuoOvS7MjQyJ
+C+3Bdk3ToCeQjmNBlRBKsUw5ftTU902oMl5BptHGj1KGjYBLAkPdXb44wXSVKJ8q
+ihFhWlovsva6GDoUorksU3vOwijdlGzTANQHJGFncgrRud9ATavpGS3KVxR73R3A
+aBbu3Qw+QIfu8Qx5eBJp8CbMrpAmjfuq17STvqr5bC10Fnn4NegrnHOQG9JcK02+
+5Bn3+9X/n1mue7aohIdErLEiDMSqMOwFfrJeaH6YM1G4QkWyqGugtmHsWOUf0nlU
+nkH1krvfw9rb6b+03c4A6GSeHnbX5ufFDSf5gaR6Wy7c0jBnoxVbtBLH2zXlrd0k
+iRQG7C6XZzGMS7hb7GL7+bkRy9kWjmDL7z7Fp+EgzKhNmzuWII3E9X9va33HoQ/Q
+UdK3JVToxRQg6XRKOxL9+U/+8i6U8lxObLWkWh2cypZqbz5qJxa+2u5JYO/KEoHZ
+G963UX7XWezR98vZuTc1XHGZtBDMrjjDd7Kmb4/i/xBPeWwseeGtzFy9z2pnEnkL
+uKE4C8wUNpzUUlsn4LneZXObIoErE7FqAAlVFujVe7iaJBmXoUXZR36drbfiaODK
+vwAGyrYHaOlR
+-----END CERTIFICATE REQUEST-----
diff --git a/tests/assets/client-certificates/client/trusted/key.pem b/tests/assets/client-certificates/client/trusted/key.pem
new file mode 100644
index 000000000..d60201e5a
--- /dev/null
+++ b/tests/assets/client-certificates/client/trusted/key.pem
@@ -0,0 +1,52 @@
+-----BEGIN PRIVATE KEY-----
+MIIJRAIBADANBgkqhkiG9w0BAQEFAASCCS4wggkqAgEAAoICAQCac3+4rNmH4/N1
+s4HqR2X168tgS/aA6sHW5at8mWRnq54Nm11RvnK55jHQYVAdBgJy5M07w0wakp8i
+nxzlY95wqxBimYG63Un/1p7mX9FkB4LNISCc6j/s/Ufv85MXPbn0S5rm9UcQO9cI
+NJb1RP1YgDDLN5cxMz6X4nyofN8H6Lhvh4JDdBw4DfDEFERkVfF+bkZ7YW4XHECh
+gzm3RxCF0eeGzIXGrkkK9AsSdJAhOvTlHPFCQKXTYZhsL5+3Ma4RnWnDWvLTHx6K
+zoU+twTM2mYhhQuQgQpnmDHxGge8kGeHGtfdgAjtVJTE57xF/shP0JU+tuIV8NNh
+Q/vEmhL0Wa093/EvpTVp0EUEuDh9ORRH5K5M4bKJyU4XX5noiht6yOn00uaoJcWd
+uUAWsU+cDSvDTMw81opWWm0QIAV3G2yuRSkumHAKqvQLeyeyiKz+OEhyEiZ7EZNE
+xPD0TSpApSTU6aCTUAvPYGQ59VjsMHTuJ9r4wKIYaDvfL+t72vg2vTQma5cTOBJf
+IdxH9blFTjEnToH3LX8t0XndQ2RkiRnIze2p2jUShxo/lWCjCw+2Iaw0A0fNUK1B
+bOrFRPq1u7AnEuMJt7HF50MloItM97R9vofDwgDIzlX/PzlVRcn1WCo8Fr/0EXxP
+PreX0YDIp1ANQ8fSv7bKb2vQIxWuCQIDAQABAoICAAyXg/8rYGS6ydt7sgjGn2Jo
+QeFs8ADcoscBXHTBELV/AVi8pOQIMdREFyWU+XIUTljNnInVxzuXXo/1BucQuE7Z
+M3HGcBQq/GB2P+gqQaj1D83neIAyfNm2YIoIgqJvbtyi2VMhBhUlu8c4emIuqLTx
+Zoj61EG3ms/JMD6QR6Keb4LwOkeDjNVpFYr22AiSFSkolmhyrgYGUKKaTzdI/Ojc
+DxMnU3S6OsxAzzJG/IUpCFQxgt3S5XIRT9rqGwxVaYqYGcpKfOeHbvcEFUriouqM
+l6z96s5yJsYBW3j7lUvjPf1+y8CMMq4eqi5PckMGnZAcQj6lrFL7mlAgucLyiL7w
+o30seXvzoEQXlHxi/tnoZMWaBbntA6TV8t0ap7TMADPPSrXhXt+GIQt6tDTdYd8y
+9VxGAQA0s6FhdURVp0zYtTGrsFTLyHZjC0TFxsvOdRrQL3XbsQxPUCH86Z3hQt9d
+drgxPDJJo/4UUYOX7MAyE3H7zW7qSQ8tNSXPHewff0ItpcrUvBxa8cD95DGB3kws
+0Ns1ulGqOLMPZM3/MUYlDk0PEK1ClBqC1B78mkMpJe5qTYBaFg7S540X4E5Nrq5V
+5VK4QTsBGm9Xks4///psGwmstCVZAZDCyMbW3NOFtzOxsVqi027xknl7UEtfwNFf
+c8tp0CaxZhW8/YTXUtnxAoIBAQDSR/Ux4tfDp84Tyf5N8JaxY1iYA1sor4SQnoSE
+r0/J2UXQpZjNpCT/fOjBT19jJCWQUxUf3M6PE0i40VMcJgtQE9alTTz3iCCUokv+
+IcVxrS+7rdvQGPItoIIZDSKGlAJHoIsMnqGAHpks588ptgPC/FEiNX2nae2CrGRS
+jVcPOLA+St6qGEwPyaSKXjERwSQ9bHLIuKbMDs2+YpPOSp9iLKaW11UQYxF3Uxti
+pVRq5bbqlKFOxxp4PaTZRusWpdWJ1kmpmEpZg6PiUQVeOoOy+hCbLq3KW1aaTc3x
+UcYrbA2hW5vP0u4x4QNPayd8MNEsGHBClObOtD64Vz3lsMFdAoIBAQC8CBoP6Tzy
+1uGNmAOc9ipQwAcTAzPnOH+ouKBwB/5ji/RPrwGCOqjbapmriKtYxW2JOqbTzbze
++WvGwgfoPo16FZocDMrD90lQdFmfcgnHFZgXZe2k8zr3YTvXdkCCRkthrl9tKN94
+IuNL5K4wMIiPy08B7+dMxnKP4E8C8czzcyrXpdfy/gfu7UQGETYswjmLL1vOr1OE
+WaalbJn/5GDzKKLkcx+Xr4zgHzbyCXb/K+LvawGk0MQMTtbRkphNC2yNejNjQd8F
+wmccFK4LG9JqdjVhKiDiYIKe5ocWDcZ28sBuKyFxOthOywP6tnALIjQgXamsLIZj
+GhCG3g3dAfidAoIBAQDQM7EhgKHztl1DmLczgmgiIORiNsh2gzp1Wo6JNW+Bwp/u
+k1e1HLYJRSrL5APlDLAosypyTtUyMnzJiXCJqV2AHvRi3RPlXqIrqHonmFZ/VGOz
+ptPCukBnTsohdbDeoQOU2e9zQklTqngtTyP9/5q/38WRYncUYLxqqrf2SL2Pc6iF
+NOo8biw5YYSJ//MDykFQk+Ueuj1kQ7AQtlf0ZExlDyKurWwq+nwbsmymAl6QLPws
+TZddgaPCs/5Zp28zEGVawZJT2labRMzqUyBGiRdHCXORwukON9uKkki7jCTzb1wb
+jLG8VvPC7TCy3LzOqSMiTtwwAHB671o+eRrvJlB9AoIBAQCb2J85Vtj0cZPLFxbP
+jtytxytV386yM4rjnfskQAviGErrjKLUfKgeDHHH0eQrFJ/gIOPLI3gK23Iv7/w7
+yzTZ3nO4EgYxfJGghH8P/6YJA2Xm5s2cbRkPluDRiaqYD4lFMhDX2gu2eDwqWCTj
+viZCAIHAmkX8xXKIu6LhTubPVUJKMKQXO+P5bWB3IubjHCwzp5IRchHn3aKY87WE
+eZa9k43HiX/C6nb6AAU7gQrHHmnehLN9FqeXh/TXCQkAuppDfOiAuUUPcfyiMqW6
+gVnacZV2rkNJPjKlX27RoaNATZ2e8lKqldpZHD11HKcrIzNPLDKIiPLtytmt3vhg
+mNSlAoIBAQDMN3FoQfV+Tlky5xt87ImsajdIhf7JI35hq6Zb4+vwR7/vofbzoomS
++fuivH1+1skQIuEn41G4uwZps9NPRm5sWrjOo869DYPn5Nm8qTGqv/GD28OQQClB
+3/vcwrn5limm3pbQg+z+67fFmorSyLHcZ+ky60lWeE9uXCsVjt7eH6B+Rhs9Jafg
+MbWRZ1C3Gezb1J42XVZ8hczn6r+qmWFTbSY4RzNBqd83motWXIgtybJIV4LB4t06
+JkVNCotSicw0vtZk95AfjQksemAq2fFzJfASxtw8IE/WHW4jtvfZ9PPWDt9U83ll
+Y+eu85cike5J4vnz8uG04yt7rXjIrUav
+-----END PRIVATE KEY-----
diff --git a/tests/assets/client-certificates/server/server_cert.pem b/tests/assets/client-certificates/server/server_cert.pem
new file mode 100644
index 000000000..52d8f5314
--- /dev/null
+++ b/tests/assets/client-certificates/server/server_cert.pem
@@ -0,0 +1,32 @@
+-----BEGIN CERTIFICATE-----
+MIIFdTCCA12gAwIBAgIUNPWupe2xcu8YYG1ozoqk9viqDJswDQYJKoZIhvcNAQEL
+BQAwNjESMBAGA1UEAwwJbG9jYWxob3N0MSAwHgYDVQQKDBdDbGllbnQgQ2VydGlm
+aWNhdGUgRGVtbzAeFw0yNDA3MTkxMjQ3MzNaFw0yNTA3MTkxMjQ3MzNaMDYxEjAQ
+BgNVBAMMCWxvY2FsaG9zdDEgMB4GA1UECgwXQ2xpZW50IENlcnRpZmljYXRlIERl
+bW8wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC+K5JWhlfvI47ZL/Az
+L0xnOl+cMelr2BqH+7XS8187SbvluhFfFkq/7V7rwgsHI64sn8pgRCOnqKWV6jtb
+651dGzn7Nby6InmyOQzF4VwfSVWQ6BYXgXuryS9Gm0gi8sOL1Ji/jV49n1gzLyIx
+LNhd7NG2DCCedTHJnxyz4xq8MWhI/qI85iWJqcHhxkDb8wtH1Vd6nd/ZRVDbjgTv
+PH3EDK7JqmnYG9+x4Jz0yEhvV7jL3gNu2mIyttvm7oRna9oHgaKFUJt4BCfPbT5U
+3ipvcq29hdD5/5QIDzTWcExTnklolg5xpFext1+3KPSppESxcfBBNoL3h1B8ZcZa
+lEMC/IoFUIDJQj5gmSn4okwMWIxgf+AL0609MKEqQ2FavOsvBmhHcQsqLk4MO/v0
+NGFv1/xGe4tUkX4han6ykf1+sqzupJT5qnUONmvghb2SpIt83o4j4KHVzZwk8JK0
+N6hN7JEjXQwSKCh3b0FFg+kPAe12d6BBcsNzEYmt2C1KNPbXMX84zIkgPN01XMg6
+kdCdjP6DH7CK+brW9qQufOqYpd3eNhJyeBm+oP3PhnhEiMTIO8X2GdSN5Rxozgxl
+VIj/QWhLV64r5AqPr/Vpd1vcsxrg3aS5CASmoWQmTPuhEZptRtrkPkGw7k9NPZ34
+lnRenvKJ9e3DXhXRMqeYUY6wjwIDAQABo3sweTAdBgNVHQ4EFgQUEHtrxWCk96Eh
+r60E0HBuwLk2i+IwHwYDVR0jBBgwFoAUEHtrxWCk96Ehr60E0HBuwLk2i+IwDwYD
+VR0TAQH/BAUwAwEB/zAmBgNVHREEHzAdgglsb2NhbGhvc3SCEGxvY2FsLnBsYXl3
+cmlnaHQwDQYJKoZIhvcNAQELBQADggIBALP4kOAP21ZusbEH89VkZT3MkGlZuDQP
+LyTYdLzT3EzN//2+lBDmJfpIPLL/K3sNEVSzNppa6tcCXiVNes/xJM7tHRhTOJ31
+HinSsib2r6DZ6SitQJWmD5FoAdkp9qdG8mA/5vOiwiVKKFV2/Z3i+3iUI/ZnEhUq
+uUA1I3TI5LAQzgWLwYu1jSEM1EbH6uQiZ8AmXLVO4GQnVQdbyarWHxIy+zsg+MJN
+fxIG/phDpkt1mI3SkAdpWRWjCKESQhrIcRUtu5eVk0lho6ttHODXF8bM7iWLoRc7
+rpcllI4HXHoXQqQkZHRa7KwTf0YVwwQbXTecZONWXwE9Ej5R5IcZzja5FWCSstsb
+ULNW0JVxGBE7j5aOjxasYAbRexDmlfEdLvnp6bctZuvMvuBxrB+x5HSEZl6bVnbC
+nvtoslylQJM1bwlZdCqJm04JXe1787HDBef2gABv27BjvG/zn89L5ipogZCrGpl6
+P9qs0eSERHuSrm3eHUVgXSQ1nbvOpk7RPFbsbp/npc1NbEDBdAMoXhLP9A+ytxLq
+TF+w08nfCF6yJJ3jTkvABo10UH6zcPnfH3Ys7JYsHRbcloMfn+mc88KrTaCO+VZx
+qjhFcz+zDu/AbtJkDJtxX2X7jNL0pzWS+9H8jFTrd3ta8XrJiSFq2VMxEU6R0IHk
+2Ct10prMWB/3
+-----END CERTIFICATE-----
diff --git a/tests/assets/client-certificates/server/server_key.pem b/tests/assets/client-certificates/server/server_key.pem
new file mode 100644
index 000000000..ff6a3fc11
--- /dev/null
+++ b/tests/assets/client-certificates/server/server_key.pem
@@ -0,0 +1,52 @@
+-----BEGIN PRIVATE KEY-----
+MIIJQQIBADANBgkqhkiG9w0BAQEFAASCCSswggknAgEAAoICAQC+K5JWhlfvI47Z
+L/AzL0xnOl+cMelr2BqH+7XS8187SbvluhFfFkq/7V7rwgsHI64sn8pgRCOnqKWV
+6jtb651dGzn7Nby6InmyOQzF4VwfSVWQ6BYXgXuryS9Gm0gi8sOL1Ji/jV49n1gz
+LyIxLNhd7NG2DCCedTHJnxyz4xq8MWhI/qI85iWJqcHhxkDb8wtH1Vd6nd/ZRVDb
+jgTvPH3EDK7JqmnYG9+x4Jz0yEhvV7jL3gNu2mIyttvm7oRna9oHgaKFUJt4BCfP
+bT5U3ipvcq29hdD5/5QIDzTWcExTnklolg5xpFext1+3KPSppESxcfBBNoL3h1B8
+ZcZalEMC/IoFUIDJQj5gmSn4okwMWIxgf+AL0609MKEqQ2FavOsvBmhHcQsqLk4M
+O/v0NGFv1/xGe4tUkX4han6ykf1+sqzupJT5qnUONmvghb2SpIt83o4j4KHVzZwk
+8JK0N6hN7JEjXQwSKCh3b0FFg+kPAe12d6BBcsNzEYmt2C1KNPbXMX84zIkgPN01
+XMg6kdCdjP6DH7CK+brW9qQufOqYpd3eNhJyeBm+oP3PhnhEiMTIO8X2GdSN5Rxo
+zgxlVIj/QWhLV64r5AqPr/Vpd1vcsxrg3aS5CASmoWQmTPuhEZptRtrkPkGw7k9N
+PZ34lnRenvKJ9e3DXhXRMqeYUY6wjwIDAQABAoICABfDfxpj2EowUdHvDR+AShZe
+M4Njs00AKLSUbjCpq91PRfUbjr8onHemVGW2jkU6nrHB1/q2mRQC3YpBxmAirbvs
+Qo8TNH24ACgWu/NgSXA5bEFa1yPh0M/zKH60uctwNaJcEyhgpIWjy1Q+EBJADduS
+09PhaRQUBgAxa1dJSlZ5ABSbCS/9/HPa7Djn2sQBd4fm73MJlmbipAuDkDdLAlZE
+1XSq4GYaeZYTQNnPy0lql1OWbyxjisDWm90cMhxwXELy3pm1LHBPaKAhgRf+2SOr
+G23i8m3DE778E3i2eLs8POUeVzi5NiIljYboTcaDGfhoigLEKpJ+7L5Ww3YfL85Q
+xk00Y0b+cYNrlJ3vCpflDXJunZ1gJHLDTixJeVMpXnMSi01+bSb8D/PTcbG3fZ0U
+y4f2G0M+gf+m3EMMD96yerPf6jhGlTqY+eMyNVwNVk4BIG+D/8nf13keAF4kVbPJ
+QMidnCNbu8ZiC12HqLyv3YZlseXPIkhpbYEhsj58sbG4Tms+mG/zPlTZjroIEdAX
+nwI1aoG+NAbe+WSH/P4SvIMi1o/fWoXBtb+t7uy1AG/Xbu414WED7iwvxtqJRQj5
+rhrqryWTGQKY1zVJIOxwZP0f5gSIkEITyE+rO6o6pbAZFX7N0aMIvksBkEN5mdoV
+RWzxfSVNGMWooRD5d3TZAoIBAQD1dvgOsLYP8lUfkKglLTqHQe3x75BVDR9zdTIt
+tQh9UIbyovPFdLcXrHHJMBVMPTRGeRNpjCT5BNSNbidrmAxYN7YXuSA4uy3bubNU
+76km5kmL2Ji+5u+qMm9Xycyqn30rLH9hT+9c/MVuPW6CNmETKX9+v9zb1v//RrBS
+2ZNAWjJcBYv/rS/vKsW9yH/DbM21eSeokUqpkejOk1UxVZEcb9vt8VF8p+jO1wv3
++UgI4Gfkf3sjEL1m/hBvH5Z49RHTFj4npeK6Lko4NLLazU2904jbHxppH51UNH1j
+xp8Is+iNwW2qCOve8kSUUUjxLn4n45D2d+5qOqQTtsMWXHanAoIBAQDGVQ6UZqvo
+djfcULq0Jub1xpBfxIAg7jSY7aZ6H0YlG7KgpVTd2TUEEKgErxtfYufjtLjjWb/d
+lMG7UpkM5B4tFnpRDmvevltCqGsM3qi3AtPnzavgz2TAQy7qd2gJc8glE965LOfb
+l+mGzE4SzeFJ9WS7sUDf4WnX2xjt3OA0VCvcBRNIwCnEvXu81XLKZL6etBx6zdCt
+whWHIiqa4wkjuWEwvbeH4aWsh8gFY3E5mbvDdMFtyGWvTK8OGivl3CkdQxM+MOJD
+3aAEBTr0M7tSMy5IKewASlAWZEVpFFPIyiyMCTI0XcEgA7ewHw/F3c7cstgVktjm
+OYZytZPF0ZvZAoIBAB5+z0aT8ap9gtHPGPS1b8YKDNO33YiTfsrLTpabHRjkfj96
+uypW28BXLjO+g4bbO7ldpWnBfX5qeTWw77jQRQhYs4iy+SvTJVlc8siklbE9fvme
+ySs+aZwNdAPGEGVKNzS77H9cfPJifOy7ORV4SAsnZq2KjJfLWDaQw6snWMHv8r23
++rKjA4eFGtf/JtBSniPjj2fD1TDH7dJsP3NHnCWaSAqBpowEGEpKMTR3hdmEd6PN
+qrCqjb1T5xrHI9yXJcXBx6sJUueqhJIDCg1g4D2rIB+I97EDunoRo1pX/L4KC+RA
+ma08OoGSO67pglRkYEv4W7QjJj2QV34TgJ0wk5UCggEALINom0wT5z+pN+xyiv50
+NdNUEfpzW3C7I1urUpt0Td3SkJWq34Phj0EBxNNcTGNRclzcZkJ9eojpllZqfWcx
+kqMJ3ulisoJ8zxAnvqK2sSSUVOFnYzSJA1HQ1NTp570xvYihI2R9wV5uDlAKcdP9
+bXEDI9Ebo2PfMpA9Hx3EwFnn4iDNfDWM6lgwzmgFtIE5+zqnbbSF0onN9R9o+oxc
+P8Val+rspzWwznFHJlZ0Uh478xlgVHh2wgpu+7ZKBfQM0kF8ryefkOXMBTr7SVXX
+BBLyn0Wxbzs+kFf+8B+c0mL17pQdzX0BXGMZNhEypBEtXYFSWD02Ky3cDCDOwsZR
+uQKCAQAKQtsUSO80N/kzsWuSxHhuLMTvNZfiE/qK1Mz5Rw1qXxMXfYNFZbU/MqW7
+5DLd4Kn7s3v1UlBn2tbLGLzghnHYRxT9kxF7ZnY6HZv2IrEUjE2I2YTTCQr/Q7Z5
+gRBQb5z+vJbKOYnlSHurTexKmuTjgJ/y/jRQiQABccVj1w5lIm1SPoxpdKzSFyWt
+0NVmff9VetoiWKJYldPBTOmqPUytuBZyX5fJ4pPixwgAns6ZaqJtVNyMZkZ/GoDk
+XP2CvB/HyMiS7vXK5QJYYumk7oyC15H6eDChITNPV3VGH2QqcdEvDLT81W+JZ2mX
+8ynLaTs3oV3BjQya9pAUyzIX5L67
+-----END PRIVATE KEY-----
diff --git a/tests/async/test_browsercontext_client_certificates.py b/tests/async/test_browsercontext_client_certificates.py
new file mode 100644
index 000000000..14892ecd8
--- /dev/null
+++ b/tests/async/test_browsercontext_client_certificates.py
@@ -0,0 +1,135 @@
+# 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 threading
+from pathlib import Path
+from typing import Dict, Generator, cast
+
+import pytest
+from twisted.internet import reactor as _twisted_reactor
+from twisted.internet import ssl
+from twisted.internet.selectreactor import SelectReactor
+from twisted.web import resource, server
+
+from playwright.async_api import Browser, BrowserType, Playwright, Request, expect
+
+reactor = cast(SelectReactor, _twisted_reactor)
+
+
+@pytest.fixture(scope="function", autouse=True)
+def _skip_webkit_darwin(browser_name: str) -> None:
+    if browser_name == "webkit" and sys.platform == "darwin":
+        pytest.skip("WebKit does not proxy localhost on macOS")
+
+
+class Simple(resource.Resource):
+    isLeaf = True
+
+    def render_GET(self, request: Request) -> bytes:
+        return b"<html>Hello, world!</html>"
+
+
+@pytest.fixture(scope="session", autouse=True)
+def _client_certificate_server(assetdir: Path) -> Generator[None, None, None]:
+    server.Site(Simple())
+
+    certAuthCert = ssl.Certificate.loadPEM(
+        (assetdir / "client-certificates/server/server_cert.pem").read_text()
+    )
+    serverCert = ssl.PrivateCertificate.loadPEM(
+        (assetdir / "client-certificates/server/server_key.pem").read_text()
+        + (assetdir / "client-certificates/server/server_cert.pem").read_text()
+    )
+
+    contextFactory = serverCert.options(certAuthCert)
+    site = server.Site(Simple())
+
+    def _run() -> None:
+        reactor.listenSSL(8000, site, contextFactory)
+
+    thread = threading.Thread(target=_run)
+    thread.start()
+    yield
+    thread.join()
+
+
+async def test_should_work_with_new_context(browser: Browser, assetdir: Path) -> None:
+    context = await browser.new_context(
+        # TODO: Remove this once we can pass a custom CA.
+        ignore_https_errors=True,
+        client_certificates=[
+            {
+                "origin": "https://127.0.0.1:8000",
+                "certPath": assetdir / "client-certificates/client/trusted/cert.pem",
+                "keyPath": assetdir / "client-certificates/client/trusted/key.pem",
+            }
+        ],
+    )
+    page = await context.new_page()
+    await page.goto("https://localhost:8000")
+    await expect(page.get_by_text("alert certificate required")).to_be_visible()
+    await page.goto("https://127.0.0.1:8000")
+    await expect(page.get_by_text("Hello, world!")).to_be_visible()
+
+    with pytest.raises(Exception, match="alert certificate required"):
+        await page.context.request.get("https://localhost:8000")
+    response = await page.context.request.get("https://127.0.0.1:8000")
+    assert "Hello, world!" in await response.text()
+    await context.close()
+
+
+async def test_should_work_with_new_persistent_context(
+    browser_type: BrowserType, assetdir: Path, launch_arguments: Dict
+) -> None:
+    context = await browser_type.launch_persistent_context(
+        "",
+        **launch_arguments,
+        # TODO: Remove this once we can pass a custom CA.
+        ignore_https_errors=True,
+        client_certificates=[
+            {
+                "origin": "https://127.0.0.1:8000",
+                "certPath": assetdir / "client-certificates/client/trusted/cert.pem",
+                "keyPath": assetdir / "client-certificates/client/trusted/key.pem",
+            }
+        ],
+    )
+    page = await context.new_page()
+    await page.goto("https://localhost:8000")
+    await expect(page.get_by_text("alert certificate required")).to_be_visible()
+    await page.goto("https://127.0.0.1:8000")
+    await expect(page.get_by_text("Hello, world!")).to_be_visible()
+    await context.close()
+
+
+async def test_should_work_with_global_api_request_context(
+    playwright: Playwright, assetdir: Path
+) -> None:
+    request = await playwright.request.new_context(
+        # TODO: Remove this once we can pass a custom CA.
+        ignore_https_errors=True,
+        client_certificates=[
+            {
+                "origin": "https://127.0.0.1:8000",
+                "certPath": assetdir / "client-certificates/client/trusted/cert.pem",
+                "keyPath": assetdir / "client-certificates/client/trusted/key.pem",
+            }
+        ],
+    )
+    with pytest.raises(Exception, match="alert certificate required"):
+        await request.get("https://localhost:8000")
+    response = await request.get("https://127.0.0.1:8000")
+    assert "Hello, world!" in await response.text()
+    await request.dispose()
diff --git a/tests/async/test_fetch_browser_context.py b/tests/async/test_fetch_browser_context.py
index 72f957cc1..ffab7b77c 100644
--- a/tests/async/test_fetch_browser_context.py
+++ b/tests/async/test_fetch_browser_context.py
@@ -21,7 +21,7 @@
 import pytest
 
 from playwright.async_api import Browser, BrowserContext, Error, FilePayload, Page
-from tests.server import Server
+from tests.server import Server, TestServerRequest
 from tests.utils import must
 
 
@@ -312,3 +312,24 @@ async def test_should_work_after_context_dispose(
     await context.close(reason="Test ended.")
     with pytest.raises(Error, match="Test ended."):
         await context.request.get(server.EMPTY_PAGE)
+
+
+async def test_should_retry_ECONNRESET(context: BrowserContext, server: Server) -> None:
+    request_count = 0
+
+    def _handle_request(req: TestServerRequest) -> None:
+        nonlocal request_count
+        request_count += 1
+        if request_count <= 3:
+            assert req.transport
+            req.transport.abortConnection()
+            return
+        req.setHeader("content-type", "text/plain")
+        req.write(b"Hello!")
+        req.finish()
+
+    server.set_route("/test", _handle_request)
+    response = await context.request.fetch(server.PREFIX + "/test", max_retries=3)
+    assert response.status == 200
+    assert await response.text() == "Hello!"
+    assert request_count == 4
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index 82ecf38ec..838e56c7d 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -23,7 +23,7 @@
 import pytest
 
 from playwright.async_api import APIResponse, Error, Playwright, StorageState
-from tests.server import Server
+from tests.server import Server, TestServerRequest
 
 
 @pytest.mark.parametrize(
@@ -463,3 +463,26 @@ async def test_should_serialize_request_data(
         assert response.status == 200
         assert await response.text() == expected
     await request.dispose()
+
+
+async def test_should_retry_ECONNRESET(playwright: Playwright, server: Server) -> None:
+    request_count = 0
+
+    def _handle_request(req: TestServerRequest) -> None:
+        nonlocal request_count
+        request_count += 1
+        if request_count <= 3:
+            assert req.transport
+            req.transport.abortConnection()
+            return
+        req.setHeader("content-type", "text/plain")
+        req.write(b"Hello!")
+        req.finish()
+
+    server.set_route("/test", _handle_request)
+    request = await playwright.request.new_context()
+    response = await request.fetch(server.PREFIX + "/test", max_retries=3)
+    assert response.status == 200
+    assert await response.text() == "Hello!"
+    assert request_count == 4
+    await request.dispose()
diff --git a/tests/async/test_evaluate.py b/tests/async/test_page_evaluate.py
similarity index 86%
rename from tests/async/test_evaluate.py
rename to tests/async/test_page_evaluate.py
index 0b2143769..9b7712906 100644
--- a/tests/async/test_evaluate.py
+++ b/tests/async/test_page_evaluate.py
@@ -208,8 +208,52 @@ async def test_evaluate_throw_if_underlying_element_was_disposed(page: Page) ->
 
 
 async def test_evaluate_evaluate_exception(page: Page) -> None:
-    error = await page.evaluate('new Error("error message")')
-    assert "Error: error message" in error
+    error = await page.evaluate(
+        """() => {
+        function innerFunction() {
+        const e = new Error('error message');
+        e.name = 'foobar';
+        return e;
+        }
+        return innerFunction();
+    }"""
+    )
+    assert isinstance(error, Error)
+    assert error.message == "error message"
+    assert error.name == "foobar"
+    assert error.stack
+    assert "innerFunction" in error.stack
+
+
+async def test_should_pass_exception_argument(page: Page) -> None:
+    def _raise_and_get_exception(exception: Exception) -> Exception:
+        try:
+            raise exception
+        except Exception as e:
+            return e
+
+    error_for_roundtrip = Error("error message")
+    error_for_roundtrip._name = "foobar"
+    error_for_roundtrip._stack = "test stack"
+    error = await page.evaluate(
+        """e => {
+            return { message: e.message, name: e.name, stack: e.stack };
+        }""",
+        error_for_roundtrip,
+    )
+    assert error["message"] == "error message"
+    assert error["name"] == "foobar"
+    assert "test stack" in error["stack"]
+
+    error = await page.evaluate(
+        """e => {
+            return { message: e.message, name: e.name, stack: e.stack };
+        }""",
+        _raise_and_get_exception(Exception("error message")),
+    )
+    assert error["message"] == "error message"
+    assert error["name"] == "Exception"
+    assert "error message" in error["stack"]
 
 
 async def test_evaluate_evaluate_date(page: Page) -> None:
diff --git a/tests/sync/test_browsercontext_client_certificates.py b/tests/sync/test_browsercontext_client_certificates.py
new file mode 100644
index 000000000..442540ed1
--- /dev/null
+++ b/tests/sync/test_browsercontext_client_certificates.py
@@ -0,0 +1,135 @@
+# 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 threading
+from pathlib import Path
+from typing import Dict, Generator, cast
+
+import pytest
+from twisted.internet import reactor as _twisted_reactor
+from twisted.internet import ssl
+from twisted.internet.selectreactor import SelectReactor
+from twisted.web import resource, server
+
+from playwright.sync_api import Browser, BrowserType, Playwright, Request, expect
+
+reactor = cast(SelectReactor, _twisted_reactor)
+
+
+@pytest.fixture(scope="function", autouse=True)
+def _skip_webkit_darwin(browser_name: str) -> None:
+    if browser_name == "webkit" and sys.platform == "darwin":
+        pytest.skip("WebKit does not proxy localhost on macOS")
+
+
+class Simple(resource.Resource):
+    isLeaf = True
+
+    def render_GET(self, request: Request) -> bytes:
+        return b"<html>Hello, world!</html>"
+
+
+@pytest.fixture(scope="session", autouse=True)
+def _client_certificate_server(assetdir: Path) -> Generator[None, None, None]:
+    server.Site(Simple())
+
+    certAuthCert = ssl.Certificate.loadPEM(
+        (assetdir / "client-certificates/server/server_cert.pem").read_text()
+    )
+    serverCert = ssl.PrivateCertificate.loadPEM(
+        (assetdir / "client-certificates/server/server_key.pem").read_text()
+        + (assetdir / "client-certificates/server/server_cert.pem").read_text()
+    )
+
+    contextFactory = serverCert.options(certAuthCert)
+    site = server.Site(Simple())
+
+    def _run() -> None:
+        reactor.listenSSL(8000, site, contextFactory)
+
+    thread = threading.Thread(target=_run)
+    thread.start()
+    yield
+    thread.join()
+
+
+def test_should_work_with_new_context(browser: Browser, assetdir: Path) -> None:
+    context = browser.new_context(
+        # TODO: Remove this once we can pass a custom CA.
+        ignore_https_errors=True,
+        client_certificates=[
+            {
+                "origin": "https://127.0.0.1:8000",
+                "certPath": assetdir / "client-certificates/client/trusted/cert.pem",
+                "keyPath": assetdir / "client-certificates/client/trusted/key.pem",
+            }
+        ],
+    )
+    page = context.new_page()
+    page.goto("https://localhost:8000")
+    expect(page.get_by_text("alert certificate required")).to_be_visible()
+    page.goto("https://127.0.0.1:8000")
+    expect(page.get_by_text("Hello, world!")).to_be_visible()
+
+    with pytest.raises(Exception, match="alert certificate required"):
+        page.context.request.get("https://localhost:8000")
+    response = page.context.request.get("https://127.0.0.1:8000")
+    assert "Hello, world!" in response.text()
+    context.close()
+
+
+def test_should_work_with_new_persistent_context(
+    browser_type: BrowserType, assetdir: Path, launch_arguments: Dict
+) -> None:
+    context = browser_type.launch_persistent_context(
+        "",
+        **launch_arguments,
+        # TODO: Remove this once we can pass a custom CA.
+        ignore_https_errors=True,
+        client_certificates=[
+            {
+                "origin": "https://127.0.0.1:8000",
+                "certPath": assetdir / "client-certificates/client/trusted/cert.pem",
+                "keyPath": assetdir / "client-certificates/client/trusted/key.pem",
+            }
+        ],
+    )
+    page = context.new_page()
+    page.goto("https://localhost:8000")
+    expect(page.get_by_text("alert certificate required")).to_be_visible()
+    page.goto("https://127.0.0.1:8000")
+    expect(page.get_by_text("Hello, world!")).to_be_visible()
+    context.close()
+
+
+def test_should_work_with_global_api_request_context(
+    playwright: Playwright, assetdir: Path
+) -> None:
+    request = playwright.request.new_context(
+        # TODO: Remove this once we can pass a custom CA.
+        ignore_https_errors=True,
+        client_certificates=[
+            {
+                "origin": "https://127.0.0.1:8000",
+                "certPath": assetdir / "client-certificates/client/trusted/cert.pem",
+                "keyPath": assetdir / "client-certificates/client/trusted/key.pem",
+            }
+        ],
+    )
+    with pytest.raises(Exception, match="alert certificate required"):
+        request.get("https://localhost:8000")
+    response = request.get("https://127.0.0.1:8000")
+    assert "Hello, world!" in response.text()
+    request.dispose()

From 86c0191b6705ac387be7e1b9a161ab325e4865e8 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 1 Aug 2024 19:45:51 +0200
Subject: [PATCH 243/438] test: client-certificate follow-ups (#2508)

---
 playwright/_impl/_element_handle.py           |   3 -
 playwright/_impl/_frame.py                    |   3 -
 playwright/_impl/_locator.py                  |   6 +-
 playwright/_impl/_page.py                     |   2 -
 .../client/self-signed/cert.pem               |  28 ++++
 .../client/self-signed/csr.pem                |  26 ++++
 .../client/self-signed/key.pem                |  52 ++++++++
 ...test_browsercontext_client_certificates.py | 126 +++++++++++++++---
 ...test_browsercontext_client_certificates.py | 119 ++++++++++++++---
 9 files changed, 319 insertions(+), 46 deletions(-)
 create mode 100644 tests/assets/client-certificates/client/self-signed/cert.pem
 create mode 100644 tests/assets/client-certificates/client/self-signed/csr.pem
 create mode 100644 tests/assets/client-certificates/client/self-signed/key.pem

diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 74e5bdff9..39e43a6fd 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -206,7 +206,6 @@ async def set_input_files(
             "setInputFiles",
             {
                 "timeout": timeout,
-                "noWaitAfter": noWaitAfter,
                 **converted,
             },
         )
@@ -246,7 +245,6 @@ async def set_checked(
                 position=position,
                 timeout=timeout,
                 force=force,
-                noWaitAfter=noWaitAfter,
                 trial=trial,
             )
         else:
@@ -254,7 +252,6 @@ async def set_checked(
                 position=position,
                 timeout=timeout,
                 force=force,
-                noWaitAfter=noWaitAfter,
                 trial=trial,
             )
 
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index bfeef1489..7dcfe0f4e 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -703,7 +703,6 @@ async def set_input_files(
                 "selector": selector,
                 "strict": strict,
                 "timeout": timeout,
-                "noWaitAfter": noWaitAfter,
                 **converted,
             },
         )
@@ -792,7 +791,6 @@ async def set_checked(
                 position=position,
                 timeout=timeout,
                 force=force,
-                noWaitAfter=noWaitAfter,
                 strict=strict,
                 trial=trial,
             )
@@ -802,7 +800,6 @@ async def set_checked(
                 position=position,
                 timeout=timeout,
                 force=force,
-                noWaitAfter=noWaitAfter,
                 strict=strict,
                 trial=trial,
             )
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 0213ff9ea..521897978 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -213,7 +213,7 @@ async def clear(
         noWaitAfter: bool = None,
         force: bool = None,
     ) -> None:
-        await self.fill("", timeout=timeout, noWaitAfter=noWaitAfter, force=force)
+        await self.fill("", timeout=timeout, force=force)
 
     def locator(
         self,
@@ -631,7 +631,7 @@ async def press_sequentially(
         timeout: float = None,
         noWaitAfter: bool = None,
     ) -> None:
-        await self.type(text, delay=delay, timeout=timeout, noWaitAfter=noWaitAfter)
+        await self.type(text, delay=delay, timeout=timeout)
 
     async def uncheck(
         self,
@@ -685,7 +685,6 @@ async def set_checked(
                 position=position,
                 timeout=timeout,
                 force=force,
-                noWaitAfter=noWaitAfter,
                 trial=trial,
             )
         else:
@@ -693,7 +692,6 @@ async def set_checked(
                 position=position,
                 timeout=timeout,
                 force=force,
-                noWaitAfter=noWaitAfter,
                 trial=trial,
             )
 
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 97af978f3..88c6da720 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -1279,7 +1279,6 @@ async def set_checked(
                 position=position,
                 timeout=timeout,
                 force=force,
-                noWaitAfter=noWaitAfter,
                 strict=strict,
                 trial=trial,
             )
@@ -1289,7 +1288,6 @@ async def set_checked(
                 position=position,
                 timeout=timeout,
                 force=force,
-                noWaitAfter=noWaitAfter,
                 strict=strict,
                 trial=trial,
             )
diff --git a/tests/assets/client-certificates/client/self-signed/cert.pem b/tests/assets/client-certificates/client/self-signed/cert.pem
new file mode 100644
index 000000000..3c0771794
--- /dev/null
+++ b/tests/assets/client-certificates/client/self-signed/cert.pem
@@ -0,0 +1,28 @@
+-----BEGIN CERTIFICATE-----
+MIIEyzCCArOgAwIBAgIUYps4gh4MqFYg8zqQhHYL7zYfbLkwDQYJKoZIhvcNAQEL
+BQAwDjEMMAoGA1UEAwwDQm9iMB4XDTI0MDcxOTEyNDc0MFoXDTI1MDcxOTEyNDc0
+MFowDjEMMAoGA1UEAwwDQm9iMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKC
+AgEA179eTsqcc1c3AOQHzCZEyYLPta2CCAscUFqcEZ9vWvjW0uzOv9TDlB33Unov
+jch4CElZOBhzTadVsbmnYKpxwyVU89WCuQKvedz4k1vu7S1YryfNbmS8PWbnQ4ds
+9NB7SgJNHZILvx9DXuWeFEyzRIo1984z4HheBzrkf791LqpYKaKziANUo8h8t0dm
+TX/boOz8cEnQNwtTC0ZX3aD0obG/UAhr/22ZGPo/E659fh4ptyYX2LrIUHGy+Eux
+nJ9Y4cTqa88Ee6K6AkDiT/AoNQNxE4X++jqLuie8j/ZYpI1Oll38GwKVOyy1msRL
+toGmISNwkMIQDGABrJlxgpP4QQAQ+08v9srzXOlkdxdr7OCP81r+ccBXiSQEe7BA
+kdJ8l98l5dprJ++GJ+SZcV4+/iGR0dKU2IdAG5HiKZIFn6ch9Ux+UMqeGaYCpkHr
+TiietHwcXgtVBlE0jFmB/HspmI/O0abK+grMmueaH7XtTI8YHnw0mUpL8+yp7mfA
+7zFusgFgyiBPXeD/NQgg8vja67k++d1VGoXm2xr+5WPQCSbgQoMkkOBMLHWJTefd
+6F4Z5M+oI0VwYbf6eQW246wJgpCHSPR0Vdijd6MAGRWKUuLfDsA9+12iGbKvwJ2e
+nJlStft2V2LZcjBfdIMbigW1aSVNN5w6m6YVrQPry3WPkWcCAwEAAaMhMB8wHQYD
+VR0OBBYEFPxKWTFQJSg4HD2qjxL0dnXX/z4qMA0GCSqGSIb3DQEBCwUAA4ICAQBz
+4H1d5eGRU9bekUvi7LbZ5CP/I6w6PL/9AlXqO3BZKxplK7fYGHd3uqyDorJEsvjV
+hxwvFlEnS0JIU3nRzhJU/h4Yaivf1WLRFwGZ4TPBjX9KFU27exFWD3rppazkWybJ
+i4WuEdP3TJMdKLcNTtXWUDroDOgPlS66u6oZ+mUyUROil+B+fgQgVDhjRc5fvRgZ
+Lng8wuejCo3ExQyxkwn2G5guyIimgHmOQghPtLO5xlc67Z4GPUZ1m4tC+BCiFO4D
+YIXl3QiIpmU7Pss39LLKMGXXAgLRqyMzqE52lsznu18v5vDLfTaRH4u/wjzULhXz
+SrV1IUJmhgEXta4EeDmPH0itgKtkbwjgCOD7drrFrJq/EnvIaJ5cpxiI1pFmYD8g
+VVD7/KT/CyT1Uz1dI8QaP/JX8XEgtMJaSkPfjPErIViN9rh9ECCNLgFyv7Y0Plar
+A6YlvdyV1Rta/BHndf5Hqz9QWNhbFCMQRGVQNEcoKwpFyjAE9SXoKJvFIK/w5WXu
+qKzIYA26QXE3p734Xu1n8QiFJIyltVHbyUlD0k06194t5a2WK+/eDeReIsk0QOI8
+FGqhyPZ7YjR5tSZTmgljtViqBO5AA23QOVFqtjOUrjXP5pTbPJel99Z/FTkqSwvB
+Rt4OX7HfuokWQDTT0TMn5jVtJyi54cH7f9MmsNJ23g==
+-----END CERTIFICATE-----
diff --git a/tests/assets/client-certificates/client/self-signed/csr.pem b/tests/assets/client-certificates/client/self-signed/csr.pem
new file mode 100644
index 000000000..4c99e1349
--- /dev/null
+++ b/tests/assets/client-certificates/client/self-signed/csr.pem
@@ -0,0 +1,26 @@
+-----BEGIN CERTIFICATE REQUEST-----
+MIIEUzCCAjsCAQAwDjEMMAoGA1UEAwwDQm9iMIICIjANBgkqhkiG9w0BAQEFAAOC
+Ag8AMIICCgKCAgEA179eTsqcc1c3AOQHzCZEyYLPta2CCAscUFqcEZ9vWvjW0uzO
+v9TDlB33Unovjch4CElZOBhzTadVsbmnYKpxwyVU89WCuQKvedz4k1vu7S1YryfN
+bmS8PWbnQ4ds9NB7SgJNHZILvx9DXuWeFEyzRIo1984z4HheBzrkf791LqpYKaKz
+iANUo8h8t0dmTX/boOz8cEnQNwtTC0ZX3aD0obG/UAhr/22ZGPo/E659fh4ptyYX
+2LrIUHGy+EuxnJ9Y4cTqa88Ee6K6AkDiT/AoNQNxE4X++jqLuie8j/ZYpI1Oll38
+GwKVOyy1msRLtoGmISNwkMIQDGABrJlxgpP4QQAQ+08v9srzXOlkdxdr7OCP81r+
+ccBXiSQEe7BAkdJ8l98l5dprJ++GJ+SZcV4+/iGR0dKU2IdAG5HiKZIFn6ch9Ux+
+UMqeGaYCpkHrTiietHwcXgtVBlE0jFmB/HspmI/O0abK+grMmueaH7XtTI8YHnw0
+mUpL8+yp7mfA7zFusgFgyiBPXeD/NQgg8vja67k++d1VGoXm2xr+5WPQCSbgQoMk
+kOBMLHWJTefd6F4Z5M+oI0VwYbf6eQW246wJgpCHSPR0Vdijd6MAGRWKUuLfDsA9
++12iGbKvwJ2enJlStft2V2LZcjBfdIMbigW1aSVNN5w6m6YVrQPry3WPkWcCAwEA
+AaAAMA0GCSqGSIb3DQEBCwUAA4ICAQCb07d2IjUy1PeHCj/2k/z9FrZSo6K3c8y6
+b/u/MZ0AXPKLPDSo7UYpOJ8Z2cBiJ8jQapjTSEL8POUYqcvCmP55R6u68KmvINHo
++Ly7pP+xPrbA4Q0WmPnz37hQn+I1he0GuEQyjZZqUln9zwp67TsWNKxKtCH+1j8M
+Ltzx6kuHCdPtDUtv291yhVRqvbjiDs+gzdQYNJtAkUbHwHFxu8oZhg8QZGyXYMN8
+TGoQ1LTezFZXJtX69K7WnrDGrjsgB6EMvwkqAFSYNH0LFvI0xo13OOgXr9mrwohA
+76uZtjXL9B15EqrMce6mdUZi46QJuQ2avTi57Lz+fqvsBYdQO89VcFSmqu2nfspN
+QZDrooyjHrlls8MpoBd8fde9oT4uA4/d9SJtuHUnjgGN7Qr7eTruWXL8wVMwFnvL
+igWE4detO9y2gpRLq6uEqzWYMGtN9PXJCGU8C8m9E2EBUKMrT/bpNbboatLcgRrW
+acj0BRVqoVzk1sRq7Sa6ejywqgARvIhTehg6DqdMdcENCPQ7rxDRu5PSDM8/mwIj
+0KYl8d2PlECB4ofRyLcy17BZzjP6hSnkGzcFk0/bChZOSIRnwvKbvfXnB45hhPk8
+XwT/6UNSwC2STP3gtOmLqrWj+OE0gy0AkDMvP3UnQVGMUvgfYg+N4ROCVtlqzxe9
+W65c05Mm1g==
+-----END CERTIFICATE REQUEST-----
diff --git a/tests/assets/client-certificates/client/self-signed/key.pem b/tests/assets/client-certificates/client/self-signed/key.pem
new file mode 100644
index 000000000..70d5e3dd0
--- /dev/null
+++ b/tests/assets/client-certificates/client/self-signed/key.pem
@@ -0,0 +1,52 @@
+-----BEGIN PRIVATE KEY-----
+MIIJQQIBADANBgkqhkiG9w0BAQEFAASCCSswggknAgEAAoICAQDXv15OypxzVzcA
+5AfMJkTJgs+1rYIICxxQWpwRn29a+NbS7M6/1MOUHfdSei+NyHgISVk4GHNNp1Wx
+uadgqnHDJVTz1YK5Aq953PiTW+7tLVivJ81uZLw9ZudDh2z00HtKAk0dkgu/H0Ne
+5Z4UTLNEijX3zjPgeF4HOuR/v3UuqlgporOIA1SjyHy3R2ZNf9ug7PxwSdA3C1ML
+RlfdoPShsb9QCGv/bZkY+j8Trn1+Him3JhfYushQcbL4S7Gcn1jhxOprzwR7oroC
+QOJP8Cg1A3EThf76Oou6J7yP9likjU6WXfwbApU7LLWaxEu2gaYhI3CQwhAMYAGs
+mXGCk/hBABD7Ty/2yvNc6WR3F2vs4I/zWv5xwFeJJAR7sECR0nyX3yXl2msn74Yn
+5JlxXj7+IZHR0pTYh0AbkeIpkgWfpyH1TH5Qyp4ZpgKmQetOKJ60fBxeC1UGUTSM
+WYH8eymYj87Rpsr6Csya55ofte1MjxgefDSZSkvz7KnuZ8DvMW6yAWDKIE9d4P81
+CCDy+NrruT753VUahebbGv7lY9AJJuBCgySQ4EwsdYlN593oXhnkz6gjRXBht/p5
+BbbjrAmCkIdI9HRV2KN3owAZFYpS4t8OwD37XaIZsq/AnZ6cmVK1+3ZXYtlyMF90
+gxuKBbVpJU03nDqbphWtA+vLdY+RZwIDAQABAoICAETxu6J0LuDQ+xvGwxMjG5JF
+wjitlMMbQdYPzpX3HC+3G3dWA4/b3xAjL1jlAPNPH8SOI/vAHICxO7pKuMk0Tpxs
+/qPZFCgpSogn7CuzEjwq5I88qfJgMKNyke7LhS8KvItfBuOvOx+9Ttsxh323MQZz
+IGHrPDq8XFf1IvYL6deaygesHbEWV2Lre6daIsAbXsUjVlxPykD81nHg7c0+VU6i
+rZ9WwaRjkqwftC6G8UVvQCdt/erdbYv/eZDNJ5oEdfPX6I3BHw6fZs+3ilq/RSoD
+yovRozS1ptc7QY/DynnzSizVJe4/ug6p7/LgTc2pyrwGRj+MNHKv73kHo/V1cbxF
+fBJCpxlfcGcEP27BkENiTKyRQEF1bjStw+UUKygrRXLm3MDtAVX8TrDERta4LAeW
+XvPiJbSOwWk2yYCs62RyKl+T1no7alIvc6SUy8rvKKm+AihjaTsxTeACC1cBc41m
+5HMz1dqdUWcB5jbnPsV+27dNK1/zIC+e0OXtoSXvS+IbQXo/awHJyXv5ClgldbB9
+hESFTYz/uI6ftuTM6coHQfASLgmnq0fOd1gyqO6Jr9ZSvxcPNheGpyzN3I3o5i2j
+LTYJdX3AoI5rQ5d7/GS2qIwWf0q8rxQnq1/34ABWD0umSa9tenCXkl7FIB4drwPB
+4n7n+SL7rhmv0vFKIjepAoIBAQD19MuggpKRHicmNH2EzPOyahttuhnB7Le7j6FC
+afuYUBFNcxww+L34GMRhmQZrGIYmuQ3QV4RjYh2bowEEX+F5R1V90iBtYQL1P73a
+jYtTfaJn0t62EBSC//w2rtaRJPgGhbXbnyid64J0ujRFCelej8FRJdBV342ctRAL
+0RazxQ/KcTRl9pncALxGhnSsBElZlDtZd/dWnWBDZ/fg/C97VV9ZQLcpyGvL516i
+GpB8BQsHiIe9Jt5flZvcKB7z/KItGzPB4WK6dpV8t/FeQiUpZXkQlqO03XaZT4NP
+AEGH3rKIRMpP7TORYFhbYrZwov3kzLaggax2wGPTkfMFNlTjAoIBAQDgjsYfShkz
+6Dl1UTYBrDMy9pakJbC6qmd0KOKX+4XH/Dc1mOzR8NGgoY7xWXFUlozgntKKnJda
+M6GfOt/dxc0Sq7moYzA7Jv4+9hNdU3jX5YrqAbcaSFj6k4yauO2BKCBahQo8qseY
+a3N5f0gp+5ftTMvOTwGw3JRJFJq0/DvKWAYLIaJ0Oo77zGs0vxa1Aqob10MloXt5
+DMwjazWujntTzTJY1vsfsBHa8OEObMwiftqnmn6L4Qprd3AzQkaNlZEsvERyLfFq
+1pu4EsDJJGdVfpZYfo+6vTglLXFBLEUQmh4/018Mw4O4pGgCVMj/wict/gTViQGC
+qSj+IOThsTytAoIBAHu3L3nEU/8EwMJ54q0a/nW+458U3gHqlRyWCZJDhxc9Jwbj
+IMoNRFj39Ef3VgAmrMvrh2RFsUTgRG5V1pwhsmNzmzAXstHx2zALaO73BZ7wcfFx
+Yy8G9ZpTMsU6upj1lICLX0diTmbo4IzgYIxdiPJUsvOjZqDbOvsZJEIdYSL5u5Cj
+0qx7FzdPc2SyGxuvaEnTwuqk6le5/4LIWCnmD+gksDpP0BIHSxmcfsBhRk3rp3mZ
+llVxqKdBtM1PrQojCFxR833RZfzOyzCZwaIc+V5SOUw7yYqfXxmMokrpoQy72ueq
+Wm1LrgWxBaCqDYSop7cftbkUoPB2o3/3SNtVUesCggEAReqOKy3R/QRf53QaoZiw
+9DwsmP0XMndd8J/ONU3d0G9p7SkpCxC05BOJQwH7NEAPqtwoZ3nr8ezDdKVLEGzG
+tfp7ur7vRGuWm5nYW6Viqa3Re5x/GxLNiW8pRv8vC5inwidMEamGraE++eQ0XsXz
+/rF7f0fAGgYDsWFV7eXe49hWQV7+iru0yxdRhcG9WyxyNGrogC3wGLdwU9LMiwXX
+xjbMZzbAR5R1arq3B9u+Dzt57tc+cWTm7qDocT1AZFLeOZSApyBA22foYf6MwdOw
+zMC2JOV68MR7V6/3ZDhZZJrnsi2omXvCZlnh/F/TmTYlJr/BV47pxnnOxpkNSmv5
+nQKCAQBRqrsUVO7NOgR1sVX7YDaekQiJKS6Vq/7y2gR4FoLm/MMzNZQgGo9afmKg
+F2hSv6tuoqc33Wm0FnoSEMaI8ky0qgA5kwXvhfQ6pDf/2zASFBwjwhTyJziDlhum
+iwWe1F7lNaVNpxAXzJBaBTWvHznuM42cGv5bbPBSRuIRniGsyn/zYMrISWgL+h/Q
+fsQ2rfPSqollPw+IUPN0mX+1zg6PFxaR4HM9UrRX7cnRKG20GIDPodsUl8IMg+SO
+M5YG/UqDD10hfeEutvQIvl0oJraBWT34cqUZLVpUwJzf1be7zl9MzHGcym/ni7lX
+dg6m3MAyZ1IXjHlogOdmGvnq07/w
+-----END PRIVATE KEY-----
diff --git a/tests/async/test_browsercontext_client_certificates.py b/tests/async/test_browsercontext_client_certificates.py
index 14892ecd8..6e223b9c5 100644
--- a/tests/async/test_browsercontext_client_certificates.py
+++ b/tests/async/test_browsercontext_client_certificates.py
@@ -15,16 +15,20 @@
 import sys
 import threading
 from pathlib import Path
-from typing import Dict, Generator, cast
+from typing import Dict, Generator, Optional, cast
 
+import OpenSSL.crypto
+import OpenSSL.SSL
 import pytest
 from twisted.internet import reactor as _twisted_reactor
 from twisted.internet import ssl
 from twisted.internet.selectreactor import SelectReactor
 from twisted.web import resource, server
+from twisted.web.http import Request
 
-from playwright.async_api import Browser, BrowserType, Playwright, Request, expect
+from playwright.async_api import Browser, BrowserType, Playwright, expect
 
+ssl.optionsForClientTLS
 reactor = cast(SelectReactor, _twisted_reactor)
 
 
@@ -34,17 +38,61 @@ def _skip_webkit_darwin(browser_name: str) -> None:
         pytest.skip("WebKit does not proxy localhost on macOS")
 
 
-class Simple(resource.Resource):
+class HttpsResource(resource.Resource):
+    serverCertificate: ssl.PrivateCertificate
     isLeaf = True
 
+    def _verify_cert_chain(self, cert: Optional[OpenSSL.crypto.X509]) -> bool:
+        if not cert:
+            return False
+        store = OpenSSL.crypto.X509Store()
+        store.add_cert(self.serverCertificate.original)
+        store_ctx = OpenSSL.crypto.X509StoreContext(store, cert)
+        try:
+            store_ctx.verify_certificate()
+            return True
+        except OpenSSL.crypto.X509StoreContextError:
+            return False
+
     def render_GET(self, request: Request) -> bytes:
-        return b"<html>Hello, world!</html>"
+        tls_socket: OpenSSL.SSL.Connection = request.transport.getHandle()  # type: ignore
+        cert = tls_socket.get_peer_certificate()
+        parts = []
+
+        if self._verify_cert_chain(cert):
+            request.setResponseCode(200)
+            parts.append(
+                {
+                    "key": "message",
+                    "value": f"Hello {cert.get_subject().CN}, your certificate was issued by {cert.get_issuer().CN}!",  # type: ignore
+                }
+            )
+        elif cert and cert.get_subject():
+            request.setResponseCode(403)
+            parts.append(
+                {
+                    "key": "message",
+                    "value": f"Sorry {cert.get_subject().CN}, certificates from {cert.get_issuer().CN} are not welcome here.",
+                }
+            )
+        else:
+            request.setResponseCode(401)
+            parts.append(
+                {
+                    "key": "message",
+                    "value": "Sorry, but you need to provide a client certificate to continue.",
+                }
+            )
+        return b"".join(
+            [
+                f'<div data-testid="{part["key"]}">{part["value"]}</div>'.encode()
+                for part in parts
+            ]
+        )
 
 
 @pytest.fixture(scope="session", autouse=True)
 def _client_certificate_server(assetdir: Path) -> Generator[None, None, None]:
-    server.Site(Simple())
-
     certAuthCert = ssl.Certificate.loadPEM(
         (assetdir / "client-certificates/server/server_cert.pem").read_text()
     )
@@ -54,7 +102,10 @@ def _client_certificate_server(assetdir: Path) -> Generator[None, None, None]:
     )
 
     contextFactory = serverCert.options(certAuthCert)
-    site = server.Site(Simple())
+    contextFactory.requireCertificate = False
+    resource = HttpsResource()
+    resource.serverCertificate = serverCert
+    site = server.Site(resource)
 
     def _run() -> None:
         reactor.listenSSL(8000, site, contextFactory)
@@ -65,6 +116,27 @@ def _run() -> None:
     thread.join()
 
 
+async def test_should_throw_with_untrusted_client_certs(
+    playwright: Playwright, assetdir: Path
+) -> None:
+    serverURL = "https://localhost:8000/"
+    request = await playwright.request.new_context(
+        # TODO: Remove this once we can pass a custom CA.
+        ignore_https_errors=True,
+        client_certificates=[
+            {
+                "origin": serverURL,
+                "certPath": assetdir
+                / "client-certificates/client/self-signed/cert.pem",
+                "keyPath": assetdir / "client-certificates/client/self-signed/key.pem",
+            }
+        ],
+    )
+    with pytest.raises(Exception, match="alert unknown ca"):
+        await request.get(serverURL)
+    await request.dispose()
+
+
 async def test_should_work_with_new_context(browser: Browser, assetdir: Path) -> None:
     context = await browser.new_context(
         # TODO: Remove this once we can pass a custom CA.
@@ -79,14 +151,24 @@ async def test_should_work_with_new_context(browser: Browser, assetdir: Path) ->
     )
     page = await context.new_page()
     await page.goto("https://localhost:8000")
-    await expect(page.get_by_text("alert certificate required")).to_be_visible()
+    await expect(page.get_by_test_id("message")).to_have_text(
+        "Sorry, but you need to provide a client certificate to continue."
+    )
     await page.goto("https://127.0.0.1:8000")
-    await expect(page.get_by_text("Hello, world!")).to_be_visible()
+    await expect(page.get_by_test_id("message")).to_have_text(
+        "Hello Alice, your certificate was issued by localhost!"
+    )
 
-    with pytest.raises(Exception, match="alert certificate required"):
-        await page.context.request.get("https://localhost:8000")
+    response = await page.context.request.get("https://localhost:8000")
+    assert (
+        "Sorry, but you need to provide a client certificate to continue."
+        in await response.text()
+    )
     response = await page.context.request.get("https://127.0.0.1:8000")
-    assert "Hello, world!" in await response.text()
+    assert (
+        "Hello Alice, your certificate was issued by localhost!"
+        in await response.text()
+    )
     await context.close()
 
 
@@ -108,9 +190,13 @@ async def test_should_work_with_new_persistent_context(
     )
     page = await context.new_page()
     await page.goto("https://localhost:8000")
-    await expect(page.get_by_text("alert certificate required")).to_be_visible()
+    await expect(page.get_by_test_id("message")).to_have_text(
+        "Sorry, but you need to provide a client certificate to continue."
+    )
     await page.goto("https://127.0.0.1:8000")
-    await expect(page.get_by_text("Hello, world!")).to_be_visible()
+    await expect(page.get_by_test_id("message")).to_have_text(
+        "Hello Alice, your certificate was issued by localhost!"
+    )
     await context.close()
 
 
@@ -128,8 +214,14 @@ async def test_should_work_with_global_api_request_context(
             }
         ],
     )
-    with pytest.raises(Exception, match="alert certificate required"):
-        await request.get("https://localhost:8000")
+    response = await request.get("https://localhost:8000")
+    assert (
+        "Sorry, but you need to provide a client certificate to continue."
+        in await response.text()
+    )
     response = await request.get("https://127.0.0.1:8000")
-    assert "Hello, world!" in await response.text()
+    assert (
+        "Hello Alice, your certificate was issued by localhost!"
+        in await response.text()
+    )
     await request.dispose()
diff --git a/tests/sync/test_browsercontext_client_certificates.py b/tests/sync/test_browsercontext_client_certificates.py
index 442540ed1..601d6eacc 100644
--- a/tests/sync/test_browsercontext_client_certificates.py
+++ b/tests/sync/test_browsercontext_client_certificates.py
@@ -15,15 +15,18 @@
 import sys
 import threading
 from pathlib import Path
-from typing import Dict, Generator, cast
+from typing import Dict, Generator, Optional, cast
 
+import OpenSSL.crypto
+import OpenSSL.SSL
 import pytest
 from twisted.internet import reactor as _twisted_reactor
 from twisted.internet import ssl
 from twisted.internet.selectreactor import SelectReactor
 from twisted.web import resource, server
+from twisted.web.http import Request
 
-from playwright.sync_api import Browser, BrowserType, Playwright, Request, expect
+from playwright.sync_api import Browser, BrowserType, Playwright, expect
 
 reactor = cast(SelectReactor, _twisted_reactor)
 
@@ -34,17 +37,61 @@ def _skip_webkit_darwin(browser_name: str) -> None:
         pytest.skip("WebKit does not proxy localhost on macOS")
 
 
-class Simple(resource.Resource):
+class HttpsResource(resource.Resource):
+    serverCertificate: ssl.PrivateCertificate
     isLeaf = True
 
+    def _verify_cert_chain(self, cert: Optional[OpenSSL.crypto.X509]) -> bool:
+        if not cert:
+            return False
+        store = OpenSSL.crypto.X509Store()
+        store.add_cert(self.serverCertificate.original)
+        store_ctx = OpenSSL.crypto.X509StoreContext(store, cert)
+        try:
+            store_ctx.verify_certificate()
+            return True
+        except OpenSSL.crypto.X509StoreContextError:
+            return False
+
     def render_GET(self, request: Request) -> bytes:
-        return b"<html>Hello, world!</html>"
+        tls_socket: OpenSSL.SSL.Connection = request.transport.getHandle()  # type: ignore
+        cert = tls_socket.get_peer_certificate()
+        parts = []
+
+        if self._verify_cert_chain(cert):
+            request.setResponseCode(200)
+            parts.append(
+                {
+                    "key": "message",
+                    "value": f"Hello {cert.get_subject().CN}, your certificate was issued by {cert.get_issuer().CN}!",  # type: ignore
+                }
+            )
+        elif cert and cert.get_subject():
+            request.setResponseCode(403)
+            parts.append(
+                {
+                    "key": "message",
+                    "value": f"Sorry {cert.get_subject().CN}, certificates from {cert.get_issuer().CN} are not welcome here.",
+                }
+            )
+        else:
+            request.setResponseCode(401)
+            parts.append(
+                {
+                    "key": "message",
+                    "value": "Sorry, but you need to provide a client certificate to continue.",
+                }
+            )
+        return b"".join(
+            [
+                f'<div data-testid="{part["key"]}">{part["value"]}</div>'.encode()
+                for part in parts
+            ]
+        )
 
 
 @pytest.fixture(scope="session", autouse=True)
 def _client_certificate_server(assetdir: Path) -> Generator[None, None, None]:
-    server.Site(Simple())
-
     certAuthCert = ssl.Certificate.loadPEM(
         (assetdir / "client-certificates/server/server_cert.pem").read_text()
     )
@@ -54,7 +101,10 @@ def _client_certificate_server(assetdir: Path) -> Generator[None, None, None]:
     )
 
     contextFactory = serverCert.options(certAuthCert)
-    site = server.Site(Simple())
+    contextFactory.requireCertificate = False
+    resource = HttpsResource()
+    resource.serverCertificate = serverCert
+    site = server.Site(resource)
 
     def _run() -> None:
         reactor.listenSSL(8000, site, contextFactory)
@@ -65,6 +115,27 @@ def _run() -> None:
     thread.join()
 
 
+def test_should_throw_with_untrusted_client_certs(
+    playwright: Playwright, assetdir: Path
+) -> None:
+    serverURL = "https://localhost:8000/"
+    request = playwright.request.new_context(
+        # TODO: Remove this once we can pass a custom CA.
+        ignore_https_errors=True,
+        client_certificates=[
+            {
+                "origin": serverURL,
+                "certPath": assetdir
+                / "client-certificates/client/self-signed/cert.pem",
+                "keyPath": assetdir / "client-certificates/client/self-signed/key.pem",
+            }
+        ],
+    )
+    with pytest.raises(Exception, match="alert unknown ca"):
+        request.get(serverURL)
+    request.dispose()
+
+
 def test_should_work_with_new_context(browser: Browser, assetdir: Path) -> None:
     context = browser.new_context(
         # TODO: Remove this once we can pass a custom CA.
@@ -79,14 +150,21 @@ def test_should_work_with_new_context(browser: Browser, assetdir: Path) -> None:
     )
     page = context.new_page()
     page.goto("https://localhost:8000")
-    expect(page.get_by_text("alert certificate required")).to_be_visible()
+    expect(page.get_by_test_id("message")).to_have_text(
+        "Sorry, but you need to provide a client certificate to continue."
+    )
     page.goto("https://127.0.0.1:8000")
-    expect(page.get_by_text("Hello, world!")).to_be_visible()
+    expect(page.get_by_test_id("message")).to_have_text(
+        "Hello Alice, your certificate was issued by localhost!"
+    )
 
-    with pytest.raises(Exception, match="alert certificate required"):
-        page.context.request.get("https://localhost:8000")
+    response = page.context.request.get("https://localhost:8000")
+    assert (
+        "Sorry, but you need to provide a client certificate to continue."
+        in response.text()
+    )
     response = page.context.request.get("https://127.0.0.1:8000")
-    assert "Hello, world!" in response.text()
+    assert "Hello Alice, your certificate was issued by localhost!" in response.text()
     context.close()
 
 
@@ -108,9 +186,13 @@ def test_should_work_with_new_persistent_context(
     )
     page = context.new_page()
     page.goto("https://localhost:8000")
-    expect(page.get_by_text("alert certificate required")).to_be_visible()
+    expect(page.get_by_test_id("message")).to_have_text(
+        "Sorry, but you need to provide a client certificate to continue."
+    )
     page.goto("https://127.0.0.1:8000")
-    expect(page.get_by_text("Hello, world!")).to_be_visible()
+    expect(page.get_by_test_id("message")).to_have_text(
+        "Hello Alice, your certificate was issued by localhost!"
+    )
     context.close()
 
 
@@ -128,8 +210,11 @@ def test_should_work_with_global_api_request_context(
             }
         ],
     )
-    with pytest.raises(Exception, match="alert certificate required"):
-        request.get("https://localhost:8000")
+    response = request.get("https://localhost:8000")
+    assert (
+        "Sorry, but you need to provide a client certificate to continue."
+        in response.text()
+    )
     response = request.get("https://127.0.0.1:8000")
-    assert "Hello, world!" in response.text()
+    assert "Hello Alice, your certificate was issued by localhost!" in response.text()
     request.dispose()

From 1b12403a6ffdf34d03c9b55720d6d8f13ddb3445 Mon Sep 17 00:00:00 2001
From: KRRT7 <106575910+KRRT7@users.noreply.github.com>
Date: Thu, 8 Aug 2024 03:43:02 -0400
Subject: [PATCH 244/438] fix(Nuitka): Python single executable bundler support
 (#2518)

---
 playwright/_impl/_transport.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index f2f455c50..124f57823 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -107,7 +107,7 @@ async def connect(self) -> None:
         try:
             # For pyinstaller and Nuitka
             env = get_driver_env()
-            if getattr(sys, "frozen", False) or globals().get("_compiled__"):
+            if getattr(sys, "frozen", False) or globals().get("__compiled__"):
                 env.setdefault("PLAYWRIGHT_BROWSERS_PATH", "0")
 
             startupinfo = None

From 11cb324c97392a709525d90591d9586adffaa7c1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 8 Aug 2024 09:43:20 +0200
Subject: [PATCH 245/438] build(deps): bump black from 24.4.2 to 24.8.0 (#2512)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index a47b06315..6d410218a 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,6 +1,6 @@
 auditwheel==6.0.0
 autobahn==23.1.2
-black==24.4.2
+black==24.8.0
 flake8==7.1.0
 flaky==3.8.1
 mypy==1.11.0

From e71bbeb043ddcd79f06970a475832c920d93d9c1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 8 Aug 2024 09:43:36 +0200
Subject: [PATCH 246/438] build(deps): bump mypy from 1.11.0 to 1.11.1 (#2516)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 6d410218a..6e39a5145 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ autobahn==23.1.2
 black==24.8.0
 flake8==7.1.0
 flaky==3.8.1
-mypy==1.11.0
+mypy==1.11.1
 objgraph==3.6.1
 Pillow==10.4.0
 pixelmatch==0.3.0

From 8b9bcdc73b2828235c655c7c73ab709101d84670 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 12 Aug 2024 11:19:33 +0200
Subject: [PATCH 247/438] chore(roll): roll Playwright to v1.46.0 (#2519)

---
 README.md | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index fdd043e95..9de46843e 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->128.0.6613.7<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->128.0.6613.18<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->18.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | Firefox <!-- GEN:firefox-version -->128.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
diff --git a/setup.py b/setup.py
index 9380425c9..2a6195600 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.46.0-beta-1722359450000"
+driver_version = "1.46.0"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 475935e67274012d13ebb7535b114af200df1b7b Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 12 Aug 2024 14:02:31 +0200
Subject: [PATCH 248/438] chore: add todo for waitFor* / browser.disconnected
 event ordering (#2520)

---
 playwright/_impl/_browser_type.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 70525949c..1c9303c7f 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -231,6 +231,13 @@ def handle_transport_close(reason: Optional[str]) -> None:
                     context._on_close()
                 browser._on_close()
             connection.cleanup(reason)
+            # TODO: Backport https://github.com/microsoft/playwright/commit/d8d5289e8692c9b1265d23ee66988d1ac5122f33
+            # Give a chance to any API call promises to reject upon page/context closure.
+            # This happens naturally when we receive page.onClose and browser.onClose from the server
+            # in separate tasks. However, upon pipe closure we used to dispatch them all synchronously
+            # here and promises did not have a chance to reject.
+            # The order of rejects vs closure is a part of the API contract and our test runner
+            # relies on it to attribute rejections to the right test.
 
         transport.once("close", handle_transport_close)
 

From 8a940e4814c27c3d75bd351129e61a175ad3ba81 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 13 Aug 2024 12:09:32 +0200
Subject: [PATCH 249/438] build(deps): bump twisted from 24.3.0 to 24.7.0
 (#2523)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 6e39a5145..e60db17de 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -18,7 +18,7 @@ pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.1.0
 setuptools==72.1.0
-twisted==24.3.0
+twisted==24.7.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20240712
 wheel==0.42.0

From f72a79ee10e89e1510c6ea068dadf6ef12569835 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 13 Aug 2024 12:10:58 +0200
Subject: [PATCH 250/438] build(deps): bump auditwheel from 6.0.0 to 6.1.0
 (#2522)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index e60db17de..6712ce150 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,4 +1,4 @@
-auditwheel==6.0.0
+auditwheel==6.1.0
 autobahn==23.1.2
 black==24.8.0
 flake8==7.1.0

From 799c12428dc0999f75a81d57f2e6b9617b12e168 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 13 Aug 2024 12:11:36 +0200
Subject: [PATCH 251/438] build(deps): bump flake8 from 7.1.0 to 7.1.1 (#2524)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 6712ce150..979dba8e6 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,7 +1,7 @@
 auditwheel==6.1.0
 autobahn==23.1.2
 black==24.8.0
-flake8==7.1.0
+flake8==7.1.1
 flaky==3.8.1
 mypy==1.11.1
 objgraph==3.6.1

From e70dcec4ac01075722da7c85ca2b9c34b26c5b15 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 13 Aug 2024 12:12:45 +0200
Subject: [PATCH 252/438] devops: add Ubuntu 24.04 (noble) Docker images
 (#2521)

---
 .github/workflows/publish_docker.yml |  9 -----
 .github/workflows/test_docker.yml    |  3 +-
 utils/docker/Dockerfile.noble        | 52 ++++++++++++++++++++++++++++
 utils/docker/publish_docker.sh       | 36 +++++++++----------
 4 files changed, 72 insertions(+), 28 deletions(-)
 create mode 100644 utils/docker/Dockerfile.noble

diff --git a/.github/workflows/publish_docker.yml b/.github/workflows/publish_docker.yml
index 87db48384..d0db5543d 100644
--- a/.github/workflows/publish_docker.yml
+++ b/.github/workflows/publish_docker.yml
@@ -2,12 +2,6 @@ name: "publish release - Docker"
 
 on:
   workflow_dispatch:
-    inputs:
-      is_release:
-        required: false
-        type: boolean
-        description: "Is this a release image?"
-
   release:
     types: [published]
 
@@ -44,6 +38,3 @@ jobs:
         pip install -r local-requirements.txt
         pip install -e .
     - run: ./utils/docker/publish_docker.sh stable
-      if: (github.event_name != 'workflow_dispatch' && !github.event.release.prerelease) || (github.event_name == 'workflow_dispatch' && github.event.inputs.is_release == 'true')
-    - run: ./utils/docker/publish_docker.sh canary
-      if: (github.event_name != 'workflow_dispatch' && github.event.release.prerelease) || (github.event_name == 'workflow_dispatch' && github.event.inputs.is_release != 'true')
diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index 5a3266197..178200f75 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -19,13 +19,14 @@ on:
 jobs:
   build:
     timeout-minutes: 120
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     strategy:
       fail-fast: false
       matrix:
         docker-image-variant:
           - focal
           - jammy
+          - noble
     steps:
     - uses: actions/checkout@v3
     - name: Set up Python
diff --git a/utils/docker/Dockerfile.noble b/utils/docker/Dockerfile.noble
new file mode 100644
index 000000000..8262bf6a9
--- /dev/null
+++ b/utils/docker/Dockerfile.noble
@@ -0,0 +1,52 @@
+FROM ubuntu:noble
+
+ARG DEBIAN_FRONTEND=noninteractive
+ARG TZ=America/Los_Angeles
+ARG DOCKER_IMAGE_NAME_TEMPLATE="mcr.microsoft.com/playwright/python:v%version%-noble"
+
+# === INSTALL Python ===
+
+RUN apt-get update && \
+    # Install Python
+    apt-get install -y python3 curl && \
+    # Align with upstream Python image and don't be externally managed:
+    # https://github.com/docker-library/python/issues/948
+    rm /usr/lib/python3.12/EXTERNALLY-MANAGED && \
+    update-alternatives --install /usr/bin/python python /usr/bin/python3 1 && \
+    curl -sSL https://bootstrap.pypa.io/get-pip.py -o get-pip.py && \
+    python get-pip.py && \
+    rm get-pip.py && \
+    # Feature-parity with node.js base images.
+    apt-get install -y --no-install-recommends git openssh-client gpg && \
+    # clean apt cache
+    rm -rf /var/lib/apt/lists/* && \
+    # Create the pwuser
+    adduser pwuser
+
+# === BAKE BROWSERS INTO IMAGE ===
+
+ENV PLAYWRIGHT_BROWSERS_PATH=/ms-playwright
+
+# 1. Add tip-of-tree Playwright package to install its browsers.
+#    The package should be built beforehand from tip-of-tree Playwright.
+COPY ./dist/*-manylinux*.whl /tmp/
+
+# 2. Bake in browsers & deps.
+#    Browsers will be downloaded in `/ms-playwright`.
+#    Note: make sure to set 777 to the registry so that any user can access
+#    registry.
+RUN mkdir /ms-playwright && \
+    mkdir /ms-playwright-agent && \
+    cd /ms-playwright-agent && \
+    pip install virtualenv && \
+    virtualenv venv && \
+    . venv/bin/activate && \
+    # if its amd64 then install the manylinux1_x86_64 pip package
+    if [ "$(uname -m)" = "x86_64" ]; then pip install /tmp/*manylinux1_x86_64*.whl; fi && \
+    # if its arm64 then install the manylinux1_aarch64 pip package
+    if [ "$(uname -m)" = "aarch64" ]; then pip install /tmp/*manylinux_2_17_aarch64*.whl; fi && \
+    playwright mark-docker-image "${DOCKER_IMAGE_NAME_TEMPLATE}" && \
+    playwright install --with-deps && rm -rf /var/lib/apt/lists/* && \
+    rm /tmp/*.whl && \
+    rm -rf /ms-playwright-agent && \
+    chmod -R 777 /ms-playwright
diff --git a/utils/docker/publish_docker.sh b/utils/docker/publish_docker.sh
index 2b4e73a53..309edb63a 100755
--- a/utils/docker/publish_docker.sh
+++ b/utils/docker/publish_docker.sh
@@ -15,35 +15,27 @@ if [[ "${RELEASE_CHANNEL}" == "stable" ]]; then
     echo "ERROR: cannot publish stable docker with Playwright version '${PW_VERSION}'"
     exit 1
   fi
-elif [[ "${RELEASE_CHANNEL}" == "canary" ]]; then
-  if [[ "${PW_VERSION}" != *dev* ]]; then
-    echo "ERROR: cannot publish canary docker with Playwright version '${PW_VERSION}'"
-    exit 1
-  fi
 else
   echo "ERROR: unknown release channel - ${RELEASE_CHANNEL}"
   echo "Must be either 'stable' or 'canary'"
   exit 1
 fi
 
+# Ubuntu 20.04
 FOCAL_TAGS=(
-  "next-focal"
+  "v${PW_VERSION}-focal"
 )
-if [[ "$RELEASE_CHANNEL" == "stable" ]]; then
-  FOCAL_TAGS+=("focal")
-  FOCAL_TAGS+=("v${PW_VERSION}-focal")
-fi
 
+# Ubuntu 22.04
 JAMMY_TAGS=(
-  "next"
-  "next-jammy"
+  "v${PW_VERSION}-jammy"
+)
+
+# Ubuntu 24.04
+NOBLE_TAGS=(
+  "v${PW_VERSION}"
+  "v${PW_VERSION}-noble"
 )
-if [[ "$RELEASE_CHANNEL" == "stable" ]]; then
-  JAMMY_TAGS+=("latest")
-  JAMMY_TAGS+=("jammy")
-  JAMMY_TAGS+=("v${PW_VERSION}-jammy")
-  JAMMY_TAGS+=("v${PW_VERSION}")
-fi
 
 tag_and_push() {
   local source="$1"
@@ -81,6 +73,8 @@ publish_docker_images_with_arch_suffix() {
     TAGS=("${FOCAL_TAGS[@]}")
   elif [[ "$FLAVOR" == "jammy" ]]; then
     TAGS=("${JAMMY_TAGS[@]}")
+  elif [[ "$FLAVOR" == "noble" ]]; then
+    TAGS=("${NOBLE_TAGS[@]}")
   else
     echo "ERROR: unknown flavor - $FLAVOR. Must be either 'focal', or 'jammy'"
     exit 1
@@ -107,6 +101,8 @@ publish_docker_manifest () {
     TAGS=("${FOCAL_TAGS[@]}")
   elif [[ "$FLAVOR" == "jammy" ]]; then
     TAGS=("${JAMMY_TAGS[@]}")
+  elif [[ "$FLAVOR" == "noble" ]]; then
+    TAGS=("${NOBLE_TAGS[@]}")
   else
     echo "ERROR: unknown flavor - $FLAVOR. Must be either 'focal', or 'jammy'"
     exit 1
@@ -136,3 +132,7 @@ publish_docker_manifest focal amd64 arm64
 publish_docker_images_with_arch_suffix jammy amd64
 publish_docker_images_with_arch_suffix jammy arm64
 publish_docker_manifest jammy amd64 arm64
+
+publish_docker_images_with_arch_suffix noble amd64
+publish_docker_images_with_arch_suffix noble arm64
+publish_docker_manifest noble amd64 arm64

From b5a3541815c91b49731825e29a3c9cd7c568fe94 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 20 Aug 2024 08:58:56 +0200
Subject: [PATCH 253/438] build(deps): bump setuptools from 72.1.0 to 72.2.0
 (#2526)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 979dba8e6..3f605d7af 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.1.0
-setuptools==72.1.0
+setuptools==72.2.0
 twisted==24.7.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20240712

From 04b78516a96fb18d0df912652698d0d5b6a55bb6 Mon Sep 17 00:00:00 2001
From: Yury Semikhatsky <yurys@chromium.org>
Date: Wed, 28 Aug 2024 11:12:40 -0700
Subject: [PATCH 254/438] docs: add SUPPORT.md (#2538)

---
 SUPPORT.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 SUPPORT.md

diff --git a/SUPPORT.md b/SUPPORT.md
new file mode 100644
index 000000000..0fd849315
--- /dev/null
+++ b/SUPPORT.md
@@ -0,0 +1,17 @@
+# Support
+
+## How to file issues and get help
+
+This project uses GitHub issues to track bugs and feature requests. Please search the [existing issues][gh-issues] before filing new ones to avoid duplicates. For new issues, file your bug or feature request as a new issue using corresponding template.
+
+For help and questions about using this project, please see the [docs site for Playwright for Python][docs].
+
+Join our community [Discord Server][discord-server] to connect with other developers using Playwright and ask questions in our 'help-playwright' forum.
+
+## Microsoft Support Policy
+
+Support for Playwright for Python is limited to the resources listed above.
+
+[gh-issues]: https://github.com/microsoft/playwright-python/issues/
+[docs]: https://playwright.dev/python/
+[discord-server]: https://aka.ms/playwright/discord

From bc88ac946caafd738ff3a73235d17f1a73e0e984 Mon Sep 17 00:00:00 2001
From: Daniel Henderson <77417639+danphenderson@users.noreply.github.com>
Date: Fri, 6 Sep 2024 05:56:58 -0400
Subject: [PATCH 255/438] fix: patch bug in locals_to_params (#2300)

---
 .gitignore                               |  3 +++
 playwright/_impl/_helper.py              |  6 +++++-
 tests/async/test_browsercontext_proxy.py | 23 +++++++++++++++++++++++
 tests/async/test_proxy.py                | 23 +++++++++++++++++++++++
 4 files changed, 54 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 919e041a6..8424e9bfc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,3 +18,6 @@ coverage.xml
 junit/
 htmldocs/
 utils/docker/dist/
+Pipfile
+Pipfile.lock
+.venv/
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index ec633c6e8..a27f4a789 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -246,7 +246,11 @@ def locals_to_params(args: Dict) -> Dict:
         if key == "self":
             continue
         if args[key] is not None:
-            copy[key] = args[key]
+            copy[key] = (
+                args[key]
+                if not isinstance(args[key], Dict)
+                else locals_to_params(args[key])
+            )
     return copy
 
 
diff --git a/tests/async/test_browsercontext_proxy.py b/tests/async/test_browsercontext_proxy.py
index 6f2f21440..b5fbdbcb4 100644
--- a/tests/async/test_browsercontext_proxy.py
+++ b/tests/async/test_browsercontext_proxy.py
@@ -48,6 +48,29 @@ async def test_should_use_proxy(
     assert await page.title() == "Served by the proxy"
 
 
+async def test_proxy_should_allow_none_for_optional_settings(
+    context_factory: "Callable[..., asyncio.Future[BrowserContext]]", server: Server
+) -> None:
+    server.set_route(
+        "/target.html",
+        lambda r: (
+            r.write(b"<html><title>Served by the proxy</title></html>"),
+            r.finish(),
+        ),
+    )
+    context = await context_factory(
+        proxy={
+            "server": f"localhost:{server.PORT}",
+            "username": None,
+            "password": None,
+            "bypass": None,
+        }
+    )
+    page = await context.new_page()
+    await page.goto("http://non-existent.com/target.html")
+    assert await page.title() == "Served by the proxy"
+
+
 async def test_should_use_proxy_for_second_page(
     context_factory: "Callable[..., Awaitable[BrowserContext]]", server: Server
 ) -> None:
diff --git a/tests/async/test_proxy.py b/tests/async/test_proxy.py
index d85613964..694786aae 100644
--- a/tests/async/test_proxy.py
+++ b/tests/async/test_proxy.py
@@ -46,6 +46,29 @@ async def test_should_use_proxy(
     assert await page.title() == "Served by the proxy"
 
 
+async def test_proxy_should_allow_none_for_optional_settings(
+    browser_factory: "Callable[..., asyncio.Future[Browser]]", server: Server
+) -> None:
+    server.set_route(
+        "/target.html",
+        lambda r: (
+            r.write(b"<html><title>Served by the proxy</title></html>"),
+            r.finish(),
+        ),
+    )
+    browser = await browser_factory(
+        proxy={
+            "server": f"localhost:{server.PORT}",
+            "username": None,
+            "password": None,
+            "bypass": None,
+        }
+    )
+    page = await browser.new_page()
+    await page.goto("http://non-existent.com/target.html")
+    assert await page.title() == "Served by the proxy"
+
+
 async def test_should_use_proxy_for_second_page(
     browser_factory: "Callable[..., asyncio.Future[Browser]]", server: Server
 ) -> None:

From b833485fb8bfea10dc8d29d150ad6399071a3af5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 6 Sep 2024 11:57:15 +0200
Subject: [PATCH 256/438] build(deps): bump setuptools from 72.2.0 to 74.0.0
 (#2544)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 3f605d7af..b1e9f781b 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.1.0
-setuptools==72.2.0
+setuptools==74.0.0
 twisted==24.7.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20240712

From 876a4140a3cc17ea03e37ce558993228363bcd13 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 6 Sep 2024 11:57:23 +0200
Subject: [PATCH 257/438] build(deps): bump mypy from 1.11.1 to 1.11.2 (#2536)

Bumps [mypy](https://github.com/python/mypy) from 1.11.1 to 1.11.2.
- [Changelog](https://github.com/python/mypy/blob/master/CHANGELOG.md)
- [Commits](https://github.com/python/mypy/compare/v1.11.1...v1.11.2)

---
updated-dependencies:
- dependency-name: mypy
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index b1e9f781b..6e5fd056f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ autobahn==23.1.2
 black==24.8.0
 flake8==7.1.1
 flaky==3.8.1
-mypy==1.11.1
+mypy==1.11.2
 objgraph==3.6.1
 Pillow==10.4.0
 pixelmatch==0.3.0

From eb28cc7c2ccec97f7e71346d9435412bfeb48e9b Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 9 Sep 2024 17:15:22 +0200
Subject: [PATCH 258/438] chore(roll): roll Playwright to v1.47.0 (#2546)

---
 README.md                                     |   4 +-
 playwright/_impl/_api_structures.py           |   3 +
 playwright/_impl/_element_handle.py           |   1 -
 playwright/_impl/_fetch.py                    |  22 +++-
 playwright/_impl/_frame.py                    |   1 -
 playwright/_impl/_network.py                  |   6 +
 playwright/async_api/_generated.py            | 122 +++++++++---------
 playwright/sync_api/_generated.py             | 122 +++++++++---------
 setup.py                                      |   2 +-
 ...test_browsercontext_client_certificates.py |  41 ++++++
 tests/async/test_fetch_browser_context.py     |  44 ++++++-
 ...test_browsercontext_client_certificates.py |  38 ++++++
 tests/sync/test_fetch_browser_context.py      |  39 +++++-
 13 files changed, 306 insertions(+), 139 deletions(-)

diff --git a/README.md b/README.md
index 9de46843e..d94692919 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 -->128.0.6613.18<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->129.0.6668.29<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->18.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->128.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->130.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index 34cfc8a48..904a590a9 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -104,8 +104,11 @@ class StorageState(TypedDict, total=False):
 class ClientCertificate(TypedDict, total=False):
     origin: str
     certPath: Optional[Union[str, Path]]
+    cert: Optional[bytes]
     keyPath: Optional[Union[str, Path]]
+    key: Optional[bytes]
     pfxPath: Optional[Union[str, Path]]
+    pfx: Optional[bytes]
     passphrase: Optional[str]
 
 
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 39e43a6fd..d7482fdea 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -157,7 +157,6 @@ async def select_option(
         params = locals_to_params(
             dict(
                 timeout=timeout,
-                noWaitAfter=noWaitAfter,
                 force=force,
                 **convert_select_option_values(value, index, label, element)
             )
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index 8dde5a541..a4de751bd 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -18,6 +18,7 @@
 import typing
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Union, cast
+from urllib.parse import parse_qs
 
 import playwright._impl._network as network
 from playwright._impl._api_structures import (
@@ -53,7 +54,7 @@
 FormType = Dict[str, Union[bool, float, str]]
 DataType = Union[Any, bytes, str]
 MultipartType = Dict[str, Union[bytes, bool, float, str, FilePayload]]
-ParamsType = Dict[str, Union[bool, float, str]]
+ParamsType = Union[Dict[str, Union[bool, float, str]], str]
 
 
 class APIRequest:
@@ -404,7 +405,7 @@ async def _inner_fetch(
             "fetch",
             {
                 "url": url,
-                "params": object_to_array(params),
+                "params": params_to_protocol(params),
                 "method": method,
                 "headers": serialized_headers,
                 "postData": post_data,
@@ -429,6 +430,23 @@ async def storage_state(
         return result
 
 
+def params_to_protocol(params: Optional[ParamsType]) -> Optional[List[NameValue]]:
+    if not params:
+        return None
+    if isinstance(params, dict):
+        return object_to_array(params)
+    if params.startswith("?"):
+        params = params[1:]
+    parsed = parse_qs(params)
+    if not parsed:
+        return None
+    out = []
+    for name, values in parsed.items():
+        for value in values:
+            out.append(NameValue(name=name, value=value))
+    return out
+
+
 def file_payload_to_json(payload: FilePayload) -> ServerFilePayload:
     return ServerFilePayload(
         name=payload["name"],
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 7dcfe0f4e..1ce813636 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -670,7 +670,6 @@ async def select_option(
             dict(
                 selector=selector,
                 timeout=timeout,
-                noWaitAfter=noWaitAfter,
                 strict=strict,
                 force=force,
                 **convert_select_option_values(value, index, label, element),
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index d6df048bc..91c2a460c 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -96,14 +96,20 @@ async def to_client_certificates_protocol(
         }
         if passphrase := clientCertificate.get("passphrase"):
             out_record["passphrase"] = passphrase
+        if pfx := clientCertificate.get("pfx"):
+            out_record["pfx"] = base64.b64encode(pfx).decode()
         if pfx_path := clientCertificate.get("pfxPath"):
             out_record["pfx"] = base64.b64encode(
                 await async_readfile(pfx_path)
             ).decode()
+        if cert := clientCertificate.get("cert"):
+            out_record["cert"] = base64.b64encode(cert).decode()
         if cert_path := clientCertificate.get("certPath"):
             out_record["cert"] = base64.b64encode(
                 await async_readfile(cert_path)
             ).decode()
+        if key := clientCertificate.get("key"):
+            out_record["key"] = base64.b64encode(key).decode()
         if key_path := clientCertificate.get("keyPath"):
             out_record["key"] = base64.b64encode(
                 await async_readfile(key_path)
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index dbd9a36b7..98bf96cc0 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -808,13 +808,16 @@ async def fallback(
     ) -> None:
         """Route.fallback
 
+        Continues route's request with optional overrides. The method is similar to `route.continue_()` with the
+        difference that other matching handlers will be invoked before sending the request.
+
+        **Usage**
+
         When several routes match the given pattern, they run in the order opposite to their registration. That way the
         last registered route can always override all the previous ones. In the example below, request will be handled by
         the bottom-most handler first, then it'll fall back to the previous one and in the end will be aborted by the first
         registered route.
 
-        **Usage**
-
         ```py
         await page.route(\"**/*\", lambda route: route.abort())  # Runs last.
         await page.route(\"**/*\", lambda route: route.fallback())  # Runs second.
@@ -861,6 +864,9 @@ async def handle(route, request):
         await page.route(\"**/*\", handle)
         ```
 
+        Use `route.continue_()` to immediately send the request to the network, other matching handlers won't be
+        invoked in that case.
+
         Parameters
         ----------
         url : Union[str, None]
@@ -893,7 +899,7 @@ async def continue_(
     ) -> None:
         """Route.continue_
 
-        Continues route's request with optional overrides.
+        Sends route's request to the network with optional overrides.
 
         **Usage**
 
@@ -916,6 +922,9 @@ async def handle(route, request):
         in a redirect, overrides will not be applied to the new redirected request. If you want to propagate a header
         through redirects, use the combination of `route.fetch()` and `route.fulfill()` instead.
 
+        `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.
+
         Parameters
         ----------
         url : Union[str, None]
@@ -2115,10 +2124,8 @@ async def select_option(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
-            Deprecated: This option will default to `true` in the future.
+            This option has no effect.
+            Deprecated: This option has no effect.
 
         Returns
         -------
@@ -5316,10 +5323,8 @@ async def select_option(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
-            Deprecated: This option will default to `true` in the future.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9390,7 +9395,8 @@ async def route_from_har(
             separate files or entries in the ZIP archive. If `embed` is specified, content is stored inline the HAR file.
         update_mode : Union["full", "minimal", None]
             When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
-            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to
+            `minimal`.
         """
 
         return mapping.from_maybe_impl(
@@ -10749,10 +10755,8 @@ async def select_option(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
-            Deprecated: This option will default to `true` in the future.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -13531,10 +13535,6 @@ async def new_context(
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings to use with this context. Defaults to none.
-
-            **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
-            all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
-            proxy: { server: 'http://per-context' } })`.
         record_har_path : Union[pathlib.Path, str, None]
             Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
             on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
@@ -13581,15 +13581,15 @@ async def new_context(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
-        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], cert: Union[bytes, None], keyPath: Union[pathlib.Path, str, None], key: Union[bytes, None], pfxPath: Union[pathlib.Path, str, None], pfx: Union[bytes, None], passphrase: Union[str, None]}], None]
             TLS Client Authentication allows the server to request a client certificate and verify it.
 
             **Details**
 
-            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
-            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
-            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
-            the certificate is valid for.
+            An array of client certificates to be used. Each certificate object must have either both `certPath` and `keyPath`,
+            a single `pfxPath`, or their corresponding direct value equivalents (`cert` and `key`, or `pfx`). Optionally,
+            `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
+            with an exact match to the request origin that the certificate is valid for.
 
             **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
 
@@ -13761,10 +13761,6 @@ async def new_page(
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings to use with this context. Defaults to none.
-
-            **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
-            all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
-            proxy: { server: 'http://per-context' } })`.
         record_har_path : Union[pathlib.Path, str, None]
             Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
             on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
@@ -13811,15 +13807,15 @@ async def new_page(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
-        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], cert: Union[bytes, None], keyPath: Union[pathlib.Path, str, None], key: Union[bytes, None], pfxPath: Union[pathlib.Path, str, None], pfx: Union[bytes, None], passphrase: Union[str, None]}], None]
             TLS Client Authentication allows the server to request a client certificate and verify it.
 
             **Details**
 
-            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
-            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
-            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
-            the certificate is valid for.
+            An array of client certificates to be used. Each certificate object must have either both `certPath` and `keyPath`,
+            a single `pfxPath`, or their corresponding direct value equivalents (`cert` and `key`, or `pfx`). Optionally,
+            `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
+            with an exact match to the request origin that the certificate is valid for.
 
             **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
 
@@ -14370,15 +14366,15 @@ async def launch_persistent_context(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
-        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], cert: Union[bytes, None], keyPath: Union[pathlib.Path, str, None], key: Union[bytes, None], pfxPath: Union[pathlib.Path, str, None], pfx: Union[bytes, None], passphrase: Union[str, None]}], None]
             TLS Client Authentication allows the server to request a client certificate and verify it.
 
             **Details**
 
-            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
-            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
-            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
-            the certificate is valid for.
+            An array of client certificates to be used. Each certificate object must have either both `certPath` and `keyPath`,
+            a single `pfxPath`, or their corresponding direct value equivalents (`cert` and `key`, or `pfx`). Optionally,
+            `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
+            with an exact match to the request origin that the certificate is valid for.
 
             **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
 
@@ -16893,10 +16889,8 @@ async def select_option(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
-            Deprecated: This option will default to `true` in the future.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
 
@@ -17479,8 +17473,8 @@ def headers(self) -> typing.Dict[str, str]:
     def headers_array(self) -> typing.List[NameValue]:
         """APIResponse.headers_array
 
-        An array with all the request HTTP headers associated with this response. Header names are not lower-cased. Headers
-        with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
+        An array with all the response HTTP headers associated with this response. Header names are not lower-cased.
+        Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
 
         Returns
         -------
@@ -17559,7 +17553,7 @@ async def delete(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -17583,7 +17577,7 @@ async def delete(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -17640,7 +17634,7 @@ async def head(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -17664,7 +17658,7 @@ async def head(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -17721,7 +17715,7 @@ async def get(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -17757,7 +17751,7 @@ async def get(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -17814,7 +17808,7 @@ async def patch(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -17838,7 +17832,7 @@ async def patch(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -17895,7 +17889,7 @@ async def put(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -17919,7 +17913,7 @@ async def put(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -17976,7 +17970,7 @@ async def post(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -18031,7 +18025,7 @@ async def post(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -18088,7 +18082,7 @@ async def fetch(
         url_or_request: typing.Union[str, "Request"],
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
@@ -18127,7 +18121,7 @@ async def fetch(
         ----------
         url_or_request : Union[Request, str]
             Target URL or Request to get all parameters from.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         method : Union[str, None]
             If set changes the fetch method (e.g. [PUT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT) or
@@ -18258,15 +18252,15 @@ async def new_context(
             information obtained via `browser_context.storage_state()` or `a_pi_request_context.storage_state()`.
             Either a path to the file with saved storage, or the value returned by one of
             `browser_context.storage_state()` or `a_pi_request_context.storage_state()` methods.
-        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], cert: Union[bytes, None], keyPath: Union[pathlib.Path, str, None], key: Union[bytes, None], pfxPath: Union[pathlib.Path, str, None], pfx: Union[bytes, None], passphrase: Union[str, None]}], None]
             TLS Client Authentication allows the server to request a client certificate and verify it.
 
             **Details**
 
-            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
-            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
-            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
-            the certificate is valid for.
+            An array of client certificates to be used. Each certificate object must have either both `certPath` and `keyPath`,
+            a single `pfxPath`, or their corresponding direct value equivalents (`cert` and `key`, or `pfx`). Optionally,
+            `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
+            with an exact match to the request origin that the certificate is valid for.
 
             **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index aa4e60166..69eb53b79 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -820,13 +820,16 @@ def fallback(
     ) -> None:
         """Route.fallback
 
+        Continues route's request with optional overrides. The method is similar to `route.continue_()` with the
+        difference that other matching handlers will be invoked before sending the request.
+
+        **Usage**
+
         When several routes match the given pattern, they run in the order opposite to their registration. That way the
         last registered route can always override all the previous ones. In the example below, request will be handled by
         the bottom-most handler first, then it'll fall back to the previous one and in the end will be aborted by the first
         registered route.
 
-        **Usage**
-
         ```py
         page.route(\"**/*\", lambda route: route.abort())  # Runs last.
         page.route(\"**/*\", lambda route: route.fallback())  # Runs second.
@@ -873,6 +876,9 @@ def handle(route, request):
         page.route(\"**/*\", handle)
         ```
 
+        Use `route.continue_()` to immediately send the request to the network, other matching handlers won't be
+        invoked in that case.
+
         Parameters
         ----------
         url : Union[str, None]
@@ -907,7 +913,7 @@ def continue_(
     ) -> None:
         """Route.continue_
 
-        Continues route's request with optional overrides.
+        Sends route's request to the network with optional overrides.
 
         **Usage**
 
@@ -930,6 +936,9 @@ def handle(route, request):
         in a redirect, overrides will not be applied to the new redirected request. If you want to propagate a header
         through redirects, use the combination of `route.fetch()` and `route.fulfill()` instead.
 
+        `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.
+
         Parameters
         ----------
         url : Union[str, None]
@@ -2129,10 +2138,8 @@ def select_option(
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
-            Deprecated: This option will default to `true` in the future.
+            This option has no effect.
+            Deprecated: This option has no effect.
 
         Returns
         -------
@@ -5415,10 +5422,8 @@ def select_option(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
-            Deprecated: This option will default to `true` in the future.
+            This option has no effect.
+            Deprecated: This option has no effect.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9436,7 +9441,8 @@ def route_from_har(
             separate files or entries in the ZIP archive. If `embed` is specified, content is stored inline the HAR file.
         update_mode : Union["full", "minimal", None]
             When set to `minimal`, only record information necessary for routing from HAR. This omits sizes, timing, page,
-            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to `full`.
+            cookies, security and other types of HAR information that are not used when replaying from HAR. Defaults to
+            `minimal`.
         """
 
         return mapping.from_maybe_impl(
@@ -10821,10 +10827,8 @@ def select_option(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
-            Deprecated: This option will default to `true` in the future.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         strict : Union[bool, None]
@@ -13563,10 +13567,6 @@ def new_context(
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings to use with this context. Defaults to none.
-
-            **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
-            all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
-            proxy: { server: 'http://per-context' } })`.
         record_har_path : Union[pathlib.Path, str, None]
             Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
             on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
@@ -13613,15 +13613,15 @@ def new_context(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
-        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], cert: Union[bytes, None], keyPath: Union[pathlib.Path, str, None], key: Union[bytes, None], pfxPath: Union[pathlib.Path, str, None], pfx: Union[bytes, None], passphrase: Union[str, None]}], None]
             TLS Client Authentication allows the server to request a client certificate and verify it.
 
             **Details**
 
-            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
-            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
-            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
-            the certificate is valid for.
+            An array of client certificates to be used. Each certificate object must have either both `certPath` and `keyPath`,
+            a single `pfxPath`, or their corresponding direct value equivalents (`cert` and `key`, or `pfx`). Optionally,
+            `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
+            with an exact match to the request origin that the certificate is valid for.
 
             **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
 
@@ -13795,10 +13795,6 @@ def new_page(
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings to use with this context. Defaults to none.
-
-            **NOTE** For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If
-            all contexts override the proxy, global proxy will be never used and can be any string, for example `launch({
-            proxy: { server: 'http://per-context' } })`.
         record_har_path : Union[pathlib.Path, str, None]
             Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
             on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
@@ -13845,15 +13841,15 @@ def new_page(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
-        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], cert: Union[bytes, None], keyPath: Union[pathlib.Path, str, None], key: Union[bytes, None], pfxPath: Union[pathlib.Path, str, None], pfx: Union[bytes, None], passphrase: Union[str, None]}], None]
             TLS Client Authentication allows the server to request a client certificate and verify it.
 
             **Details**
 
-            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
-            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
-            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
-            the certificate is valid for.
+            An array of client certificates to be used. Each certificate object must have either both `certPath` and `keyPath`,
+            a single `pfxPath`, or their corresponding direct value equivalents (`cert` and `key`, or `pfx`). Optionally,
+            `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
+            with an exact match to the request origin that the certificate is valid for.
 
             **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
 
@@ -14410,15 +14406,15 @@ def launch_persistent_context(
             Optional setting to control resource content management. If `omit` is specified, content is not persisted. If
             `attach` is specified, resources are persisted as separate files and all of these files are archived along with the
             HAR file. Defaults to `embed`, which stores content inline the HAR file as per HAR specification.
-        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], cert: Union[bytes, None], keyPath: Union[pathlib.Path, str, None], key: Union[bytes, None], pfxPath: Union[pathlib.Path, str, None], pfx: Union[bytes, None], passphrase: Union[str, None]}], None]
             TLS Client Authentication allows the server to request a client certificate and verify it.
 
             **Details**
 
-            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
-            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
-            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
-            the certificate is valid for.
+            An array of client certificates to be used. Each certificate object must have either both `certPath` and `keyPath`,
+            a single `pfxPath`, or their corresponding direct value equivalents (`cert` and `key`, or `pfx`). Optionally,
+            `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
+            with an exact match to the request origin that the certificate is valid for.
 
             **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
 
@@ -16979,10 +16975,8 @@ def select_option(
             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.
         no_wait_after : Union[bool, None]
-            Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You
-            can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as
-            navigating to inaccessible pages. Defaults to `false`.
-            Deprecated: This option will default to `true` in the future.
+            This option has no effect.
+            Deprecated: This option has no effect.
         force : Union[bool, None]
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
 
@@ -17581,8 +17575,8 @@ def headers(self) -> typing.Dict[str, str]:
     def headers_array(self) -> typing.List[NameValue]:
         """APIResponse.headers_array
 
-        An array with all the request HTTP headers associated with this response. Header names are not lower-cased. Headers
-        with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
+        An array with all the response HTTP headers associated with this response. Header names are not lower-cased.
+        Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
 
         Returns
         -------
@@ -17663,7 +17657,7 @@ def delete(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -17687,7 +17681,7 @@ def delete(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -17746,7 +17740,7 @@ def head(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -17770,7 +17764,7 @@ def head(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -17829,7 +17823,7 @@ def get(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -17865,7 +17859,7 @@ def get(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -17924,7 +17918,7 @@ def patch(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -17948,7 +17942,7 @@ def patch(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -18007,7 +18001,7 @@ def put(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -18031,7 +18025,7 @@ def put(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -18090,7 +18084,7 @@ def post(
         url: str,
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            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,
@@ -18145,7 +18139,7 @@ def post(
         ----------
         url : str
             Target URL.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         headers : Union[Dict[str, str], None]
             Allows to set HTTP headers. These headers will apply to the fetched request as well as any redirects initiated by
@@ -18204,7 +18198,7 @@ def fetch(
         url_or_request: typing.Union[str, "Request"],
         *,
         params: typing.Optional[
-            typing.Dict[str, typing.Union[str, float, bool]]
+            typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
@@ -18247,7 +18241,7 @@ def fetch(
         ----------
         url_or_request : Union[Request, str]
             Target URL or Request to get all parameters from.
-        params : Union[Dict[str, Union[bool, float, str]], None]
+        params : Union[Dict[str, Union[bool, float, str]], str, None]
             Query parameters to be sent with the URL.
         method : Union[str, None]
             If set changes the fetch method (e.g. [PUT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT) or
@@ -18380,15 +18374,15 @@ def new_context(
             information obtained via `browser_context.storage_state()` or `a_pi_request_context.storage_state()`.
             Either a path to the file with saved storage, or the value returned by one of
             `browser_context.storage_state()` or `a_pi_request_context.storage_state()` methods.
-        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], keyPath: Union[pathlib.Path, str, None], pfxPath: Union[pathlib.Path, str, None], passphrase: Union[str, None]}], None]
+        client_certificates : Union[Sequence[{origin: str, certPath: Union[pathlib.Path, str, None], cert: Union[bytes, None], keyPath: Union[pathlib.Path, str, None], key: Union[bytes, None], pfxPath: Union[pathlib.Path, str, None], pfx: Union[bytes, None], passphrase: Union[str, None]}], None]
             TLS Client Authentication allows the server to request a client certificate and verify it.
 
             **Details**
 
-            An array of client certificates to be used. Each certificate object must have both `certPath` and `keyPath` or a
-            single `pfxPath` to load the client certificate. Optionally, `passphrase` property should be provided if the
-            certficiate is encrypted. The `origin` property should be provided with an exact match to the request origin that
-            the certificate is valid for.
+            An array of client certificates to be used. Each certificate object must have either both `certPath` and `keyPath`,
+            a single `pfxPath`, or their corresponding direct value equivalents (`cert` and `key`, or `pfx`). Optionally,
+            `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
+            with an exact match to the request origin that the certificate is valid for.
 
             **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
 
diff --git a/setup.py b/setup.py
index 2a6195600..a1cb4a6c4 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.46.0"
+driver_version = "1.47.0-beta-1725889926000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_browsercontext_client_certificates.py b/tests/async/test_browsercontext_client_certificates.py
index 6e223b9c5..9578a69f7 100644
--- a/tests/async/test_browsercontext_client_certificates.py
+++ b/tests/async/test_browsercontext_client_certificates.py
@@ -172,6 +172,47 @@ async def test_should_work_with_new_context(browser: Browser, assetdir: Path) ->
     await context.close()
 
 
+async def test_should_work_with_new_context_passing_as_content(
+    browser: Browser, assetdir: Path
+) -> None:
+    context = await browser.new_context(
+        # TODO: Remove this once we can pass a custom CA.
+        ignore_https_errors=True,
+        client_certificates=[
+            {
+                "origin": "https://127.0.0.1:8000",
+                "cert": (
+                    assetdir / "client-certificates/client/trusted/cert.pem"
+                ).read_bytes(),
+                "key": (
+                    assetdir / "client-certificates/client/trusted/key.pem"
+                ).read_bytes(),
+            }
+        ],
+    )
+    page = await context.new_page()
+    await page.goto("https://localhost:8000")
+    await expect(page.get_by_test_id("message")).to_have_text(
+        "Sorry, but you need to provide a client certificate to continue."
+    )
+    await page.goto("https://127.0.0.1:8000")
+    await expect(page.get_by_test_id("message")).to_have_text(
+        "Hello Alice, your certificate was issued by localhost!"
+    )
+
+    response = await page.context.request.get("https://localhost:8000")
+    assert (
+        "Sorry, but you need to provide a client certificate to continue."
+        in await response.text()
+    )
+    response = await page.context.request.get("https://127.0.0.1:8000")
+    assert (
+        "Hello Alice, your certificate was issued by localhost!"
+        in await response.text()
+    )
+    await context.close()
+
+
 async def test_should_work_with_new_persistent_context(
     browser_type: BrowserType, assetdir: Path, launch_arguments: Dict
 ) -> None:
diff --git a/tests/async/test_fetch_browser_context.py b/tests/async/test_fetch_browser_context.py
index ffab7b77c..cc4e2b555 100644
--- a/tests/async/test_fetch_browser_context.py
+++ b/tests/async/test_fetch_browser_context.py
@@ -97,8 +97,48 @@ async def test_should_support_query_params(
             server.EMPTY_PAGE + "?p1=foo", params=expected_params
         ),
     )
-    assert server_req.args["p1".encode()][0].decode() == "v1"
-    assert len(server_req.args["p1".encode()]) == 1
+    assert list(map(lambda x: x.decode(), server_req.args["p1".encode()])) == [
+        "foo",
+        "v1",
+    ]
+    assert server_req.args["парам2".encode()][0].decode() == "знач2"
+
+
+@pytest.mark.parametrize(
+    "method", ["fetch", "delete", "get", "head", "patch", "post", "put"]
+)
+async def test_should_support_params_passed_as_object(
+    context: BrowserContext, server: Server, method: str
+) -> None:
+    params = {
+        "param1": "value1",
+        "парам2": "знач2",
+    }
+    [server_req, _] = await asyncio.gather(
+        server.wait_for_request("/empty.html"),
+        getattr(context.request, method)(server.EMPTY_PAGE, params=params),
+    )
+    assert server_req.args["param1".encode()][0].decode() == "value1"
+    assert len(server_req.args["param1".encode()]) == 1
+    assert server_req.args["парам2".encode()][0].decode() == "знач2"
+
+
+@pytest.mark.parametrize(
+    "method", ["fetch", "delete", "get", "head", "patch", "post", "put"]
+)
+async def test_should_support_params_passed_as_strings(
+    context: BrowserContext, server: Server, method: str
+) -> None:
+    params = "?param1=value1&param1=value2&парам2=знач2"
+    [server_req, _] = await asyncio.gather(
+        server.wait_for_request("/empty.html"),
+        getattr(context.request, method)(server.EMPTY_PAGE, params=params),
+    )
+    assert list(map(lambda x: x.decode(), server_req.args["param1".encode()])) == [
+        "value1",
+        "value2",
+    ]
+    assert len(server_req.args["param1".encode()]) == 2
     assert server_req.args["парам2".encode()][0].decode() == "знач2"
 
 
diff --git a/tests/sync/test_browsercontext_client_certificates.py b/tests/sync/test_browsercontext_client_certificates.py
index 601d6eacc..7a6d4f8cf 100644
--- a/tests/sync/test_browsercontext_client_certificates.py
+++ b/tests/sync/test_browsercontext_client_certificates.py
@@ -168,6 +168,44 @@ def test_should_work_with_new_context(browser: Browser, assetdir: Path) -> None:
     context.close()
 
 
+def test_should_work_with_new_context_passing_as_content(
+    browser: Browser, assetdir: Path
+) -> None:
+    context = browser.new_context(
+        # TODO: Remove this once we can pass a custom CA.
+        ignore_https_errors=True,
+        client_certificates=[
+            {
+                "origin": "https://127.0.0.1:8000",
+                "cert": (
+                    assetdir / "client-certificates/client/trusted/cert.pem"
+                ).read_bytes(),
+                "key": (
+                    assetdir / "client-certificates/client/trusted/key.pem"
+                ).read_bytes(),
+            }
+        ],
+    )
+    page = context.new_page()
+    page.goto("https://localhost:8000")
+    expect(page.get_by_test_id("message")).to_have_text(
+        "Sorry, but you need to provide a client certificate to continue."
+    )
+    page.goto("https://127.0.0.1:8000")
+    expect(page.get_by_test_id("message")).to_have_text(
+        "Hello Alice, your certificate was issued by localhost!"
+    )
+
+    response = page.context.request.get("https://localhost:8000")
+    assert (
+        "Sorry, but you need to provide a client certificate to continue."
+        in response.text()
+    )
+    response = page.context.request.get("https://127.0.0.1:8000")
+    assert "Hello Alice, your certificate was issued by localhost!" in response.text()
+    context.close()
+
+
 def test_should_work_with_new_persistent_context(
     browser_type: BrowserType, assetdir: Path, launch_arguments: Dict
 ) -> None:
diff --git a/tests/sync/test_fetch_browser_context.py b/tests/sync/test_fetch_browser_context.py
index dd10d5adf..e4d880631 100644
--- a/tests/sync/test_fetch_browser_context.py
+++ b/tests/sync/test_fetch_browser_context.py
@@ -89,8 +89,43 @@ def test_should_support_query_params(
         getattr(context.request, method)(
             server.EMPTY_PAGE + "?p1=foo", params=expected_params
         )
-    assert server_req.value.args["p1".encode()][0].decode() == "v1"
-    assert len(server_req.value.args["p1".encode()]) == 1
+    assert list(map(lambda x: x.decode(), server_req.value.args["p1".encode()])) == [
+        "foo",
+        "v1",
+    ]
+    assert server_req.value.args["парам2".encode()][0].decode() == "знач2"
+
+
+@pytest.mark.parametrize(
+    "method", ["fetch", "delete", "get", "head", "patch", "post", "put"]
+)
+def test_should_support_params_passed_as_object(
+    context: BrowserContext, server: Server, method: str
+) -> None:
+    params = {
+        "param1": "value1",
+        "парам2": "знач2",
+    }
+    with server.expect_request("/empty.html") as server_req:
+        getattr(context.request, method)(server.EMPTY_PAGE, params=params)
+    assert server_req.value.args["param1".encode()][0].decode() == "value1"
+    assert len(server_req.value.args["param1".encode()]) == 1
+    assert server_req.value.args["парам2".encode()][0].decode() == "знач2"
+
+
+@pytest.mark.parametrize(
+    "method", ["fetch", "delete", "get", "head", "patch", "post", "put"]
+)
+def test_should_support_params_passed_as_strings(
+    context: BrowserContext, server: Server, method: str
+) -> None:
+    params = "?param1=value1&param1=value2&парам2=знач2"
+    with server.expect_request("/empty.html") as server_req:
+        getattr(context.request, method)(server.EMPTY_PAGE, params=params)
+    assert list(
+        map(lambda x: x.decode(), server_req.value.args["param1".encode()])
+    ) == ["value1", "value2"]
+    assert len(server_req.value.args["param1".encode()]) == 2
     assert server_req.value.args["парам2".encode()][0].decode() == "знач2"
 
 

From b940055c3c84fde67b5b54cfed0f2f62be313252 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 9 Sep 2024 20:52:07 +0200
Subject: [PATCH 259/438] build(deps): bump pyee from 11.1.0 to 12.0.0 (#2548)

---
 meta.yaml | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/meta.yaml b/meta.yaml
index f9d1618d5..4b416db9c 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -27,7 +27,7 @@ requirements:
   run:
     - python >=3.8
     - greenlet ==3.0.3
-    - pyee ==11.1.0
+    - pyee ==12.0.0
 
 test: # [build_platform == target_platform]
   requires:
diff --git a/setup.py b/setup.py
index a1cb4a6c4..437958a4e 100644
--- a/setup.py
+++ b/setup.py
@@ -219,7 +219,7 @@ def _download_and_extract_local_driver(
     include_package_data=True,
     install_requires=[
         "greenlet==3.0.3",
-        "pyee==11.1.0",
+        "pyee==12.0.0",
     ],
     # TODO: Can be removed once we migrate to pypa/build or pypa/installer.
     setup_requires=["setuptools-scm==8.1.0", "wheel==0.42.0"],

From 082db40160ea10354adc9b64d478213f63784e53 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 12 Sep 2024 18:47:09 +0200
Subject: [PATCH 260/438] chore: roll to Playwright 1.47.0-beta-1726138322000
 (#2557)

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

diff --git a/setup.py b/setup.py
index 437958a4e..df6613283 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.47.0-beta-1725889926000"
+driver_version = "1.47.0-beta-1726138322000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:

From 0f68c18598098e4c78079aeaea3a9544b11995f0 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 20 Sep 2024 17:29:18 +0200
Subject: [PATCH 261/438] chore: support Python 3.13 (#2565)

---
 .github/workflows/ci.yml | 12 +++++++++++-
 meta.yaml                |  2 +-
 setup.py                 |  2 +-
 3 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 55f66440c..7528da114 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -77,11 +77,21 @@ jobs:
         - os: ubuntu-latest
           python-version: '3.12'
           browser: chromium
+        - os: windows-latest
+          # TODO: Change to actual version when it's released
+          python-version: '3.13.0-rc.2'
+          browser: chromium
+        - os: macos-latest
+          python-version: '3.13.0-rc.2'
+          browser: chromium
+        - os: ubuntu-latest
+          python-version: '3.13.0-rc.2'
+          browser: chromium
     runs-on: ${{ matrix.os }}
     steps:
     - uses: actions/checkout@v3
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies & browsers
diff --git a/meta.yaml b/meta.yaml
index 4b416db9c..9ff34b664 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -26,7 +26,7 @@ requirements:
     - setuptools_scm
   run:
     - python >=3.8
-    - greenlet ==3.0.3
+    - greenlet ==3.1.0
     - pyee ==12.0.0
 
 test: # [build_platform == target_platform]
diff --git a/setup.py b/setup.py
index df6613283..b02765a58 100644
--- a/setup.py
+++ b/setup.py
@@ -218,7 +218,7 @@ def _download_and_extract_local_driver(
     ],
     include_package_data=True,
     install_requires=[
-        "greenlet==3.0.3",
+        "greenlet==3.1.0",
         "pyee==12.0.0",
     ],
     # TODO: Can be removed once we migrate to pypa/build or pypa/installer.

From 4ebe5d42b9a1e14dd885644850ccf58037fbde63 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 20 Sep 2024 18:23:18 +0200
Subject: [PATCH 262/438] build(deps): bump pytest from 8.3.2 to 8.3.3 (#2559)

Bumps [pytest](https://github.com/pytest-dev/pytest) from 8.3.2 to 8.3.3.
- [Release notes](https://github.com/pytest-dev/pytest/releases)
- [Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pytest-dev/pytest/compare/8.3.2...8.3.3)

---
updated-dependencies:
- dependency-name: pytest
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 6e5fd056f..bfe96d491 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,7 +9,7 @@ Pillow==10.4.0
 pixelmatch==0.3.0
 pre-commit==3.4.0
 pyOpenSSL==24.2.1
-pytest==8.3.2
+pytest==8.3.3
 pytest-asyncio==0.21.2
 pytest-cov==5.0.0
 pytest-repeat==0.9.3

From a5c544159afc13a4c5736110922091c603364118 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 20 Sep 2024 18:23:28 +0200
Subject: [PATCH 263/438] build(deps): bump types-requests from 2.32.0.20240712
 to 2.32.0.20240914 (#2561)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index bfe96d491..7ee4cc341 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -20,5 +20,5 @@ service_identity==24.1.0
 setuptools==74.0.0
 twisted==24.7.0
 types-pyOpenSSL==24.1.0.20240722
-types-requests==2.32.0.20240712
+types-requests==2.32.0.20240914
 wheel==0.42.0

From 65a86d90b6a1643b19544cfe1e2108863a84aa24 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 20 Sep 2024 18:23:41 +0200
Subject: [PATCH 264/438] build(deps): bump setuptools from 74.0.0 to 75.1.0
 (#2560)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 7ee4cc341..775d3b850 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.1.0
-setuptools==74.0.0
+setuptools==75.1.0
 twisted==24.7.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20240914

From d9cdfbb1e178b6770625e9f857139aff77516af0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 23 Sep 2024 22:33:16 +0200
Subject: [PATCH 265/438] build(deps): bump greenlet from 3.1.0 to 3.1.1
 (#2568)

---
 meta.yaml | 2 +-
 setup.py  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/meta.yaml b/meta.yaml
index 9ff34b664..69dbbcec7 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -26,7 +26,7 @@ requirements:
     - setuptools_scm
   run:
     - python >=3.8
-    - greenlet ==3.1.0
+    - greenlet ==3.1.1
     - pyee ==12.0.0
 
 test: # [build_platform == target_platform]
diff --git a/setup.py b/setup.py
index b02765a58..20047ebe6 100644
--- a/setup.py
+++ b/setup.py
@@ -218,7 +218,7 @@ def _download_and_extract_local_driver(
     ],
     include_package_data=True,
     install_requires=[
-        "greenlet==3.1.0",
+        "greenlet==3.1.1",
         "pyee==12.0.0",
     ],
     # TODO: Can be removed once we migrate to pypa/build or pypa/installer.

From 5f2661655ce256c111cb06454595ac2fe38bc6e1 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 9 Oct 2024 14:32:48 +0200
Subject: [PATCH 266/438] chore: update linters (pyright/mypy/pre-commit)
 (#2588)

---
 .pre-commit-config.yaml                  | 12 ++++----
 local-requirements.txt                   |  2 +-
 playwright/_impl/_assertions.py          | 16 +++++++----
 playwright/_impl/_async_base.py          |  9 +++---
 playwright/_impl/_browser_context.py     | 24 ++++++++--------
 playwright/_impl/_connection.py          | 12 ++++----
 playwright/_impl/_impl_to_api_mapping.py |  2 +-
 playwright/_impl/_js_handle.py           | 18 +++++++-----
 playwright/_impl/_json_pipe.py           |  1 -
 playwright/_impl/_sync_base.py           |  7 +++--
 playwright/async_api/__init__.py         | 11 ++++----
 playwright/async_api/_generated.py       | 36 ++++++++++++++++++++++++
 playwright/sync_api/__init__.py          | 11 ++++----
 playwright/sync_api/_generated.py        | 36 ++++++++++++++++++++++++
 pyproject.toml                           |  2 ++
 scripts/documentation_provider.py        |  6 ++--
 setup.cfg                                |  2 ++
 tests/async/test_accessibility.py        | 14 +++++----
 tests/async/test_keyboard.py             |  4 ++-
 tests/async/test_page_route.py           |  6 ++--
 tests/server.py                          |  6 ++--
 tests/sync/test_accessibility.py         | 14 +++++----
 tests/test_reference_count_async.py      |  1 +
 23 files changed, 171 insertions(+), 81 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 5198070e1..5c8c8f1db 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -2,7 +2,7 @@
 # See https://pre-commit.com/hooks.html for more hooks
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v5.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -15,16 +15,16 @@ repos:
       - id: check-executables-have-shebangs
       - id: check-merge-conflict
   - repo: https://github.com/psf/black
-    rev: 23.9.1
+    rev: 24.8.0
     hooks:
       - id: black
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.8.0
+    rev: v1.11.2
     hooks:
       - id: mypy
-        additional_dependencies: [types-pyOpenSSL==23.2.0.2, types-requests==2.31.0.10]
+        additional_dependencies: [types-pyOpenSSL==24.1.0.20240722, types-requests==2.32.0.20240914]
   - repo: https://github.com/pycqa/flake8
-    rev: 6.1.0
+    rev: 7.1.1
     hooks:
       - id: flake8
   - repo: https://github.com/pycqa/isort
@@ -39,7 +39,7 @@ repos:
         language: node
         pass_filenames: false
         types: [python]
-        additional_dependencies: ["pyright@1.1.278"]
+        additional_dependencies: ["pyright@1.1.384"]
   - repo: local
     hooks:
       - id: check-license-header
diff --git a/local-requirements.txt b/local-requirements.txt
index 775d3b850..8826bc3d5 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -7,7 +7,7 @@ mypy==1.11.2
 objgraph==3.6.1
 Pillow==10.4.0
 pixelmatch==0.3.0
-pre-commit==3.4.0
+pre-commit==3.5.0
 pyOpenSSL==24.2.1
 pytest==8.3.3
 pytest-asyncio==0.21.2
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 5841eca5a..163b156ed 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -512,9 +512,11 @@ async def to_be_attached(
     ) -> None:
         __tracebackhide__ = True
         await self._expect_impl(
-            "to.be.attached"
-            if (attached is None or attached is True)
-            else "to.be.detached",
+            (
+                "to.be.attached"
+                if (attached is None or attached is True)
+                else "to.be.detached"
+            ),
             FrameExpectOptions(timeout=timeout),
             None,
             "Locator expected to be attached",
@@ -527,9 +529,11 @@ async def to_be_checked(
     ) -> None:
         __tracebackhide__ = True
         await self._expect_impl(
-            "to.be.checked"
-            if checked is None or checked is True
-            else "to.be.unchecked",
+            (
+                "to.be.checked"
+                if checked is None or checked is True
+                else "to.be.unchecked"
+            ),
             FrameExpectOptions(timeout=timeout),
             None,
             "Locator expected to be checked",
diff --git a/playwright/_impl/_async_base.py b/playwright/_impl/_async_base.py
index e9544b733..b06994a65 100644
--- a/playwright/_impl/_async_base.py
+++ b/playwright/_impl/_async_base.py
@@ -15,7 +15,7 @@
 import asyncio
 from contextlib import AbstractAsyncContextManager
 from types import TracebackType
-from typing import Any, Callable, Generic, Optional, Type, TypeVar
+from typing import Any, Callable, Generic, Optional, Type, TypeVar, Union
 
 from playwright._impl._impl_to_api_mapping import ImplToApiMapping, ImplWrapper
 
@@ -68,7 +68,9 @@ def __init__(self, impl_obj: Any) -> None:
     def __str__(self) -> str:
         return self._impl_obj.__str__()
 
-    def _wrap_handler(self, handler: Any) -> Callable[..., None]:
+    def _wrap_handler(
+        self, handler: Union[Callable[..., Any], Any]
+    ) -> Callable[..., None]:
         if callable(handler):
             return mapping.wrap_handler(handler)
         return handler
@@ -100,5 +102,4 @@ async def __aexit__(
     ) -> None:
         await self.close()
 
-    async def close(self) -> None:
-        ...
+    async def close(self) -> None: ...
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 455bf3410..7da85e9a4 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -316,21 +316,21 @@ async def clear_cookies(
             {
                 "name": name if isinstance(name, str) else None,
                 "nameRegexSource": name.pattern if isinstance(name, Pattern) else None,
-                "nameRegexFlags": escape_regex_flags(name)
-                if isinstance(name, Pattern)
-                else None,
+                "nameRegexFlags": (
+                    escape_regex_flags(name) if isinstance(name, Pattern) else None
+                ),
                 "domain": domain if isinstance(domain, str) else None,
-                "domainRegexSource": domain.pattern
-                if isinstance(domain, Pattern)
-                else None,
-                "domainRegexFlags": escape_regex_flags(domain)
-                if isinstance(domain, Pattern)
-                else None,
+                "domainRegexSource": (
+                    domain.pattern if isinstance(domain, Pattern) else None
+                ),
+                "domainRegexFlags": (
+                    escape_regex_flags(domain) if isinstance(domain, Pattern) else None
+                ),
                 "path": path if isinstance(path, str) else None,
                 "pathRegexSource": path.pattern if isinstance(path, Pattern) else None,
-                "pathRegexFlags": escape_regex_flags(path)
-                if isinstance(path, Pattern)
-                else None,
+                "pathRegexFlags": (
+                    escape_regex_flags(path) if isinstance(path, Pattern) else None
+                ),
             },
         )
 
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index eb4d182d3..c15d82e79 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -197,9 +197,9 @@ def cb(task: asyncio.Task) -> None:
         if current_task:
             current_task.add_done_callback(cb)
             self.future.add_done_callback(
-                lambda _: current_task.remove_done_callback(cb)
-                if current_task
-                else None
+                lambda _: (
+                    current_task.remove_done_callback(cb) if current_task else None
+                )
             )
 
 
@@ -243,9 +243,9 @@ def __init__(
         self._error: Optional[BaseException] = None
         self.is_remote = False
         self._init_task: Optional[asyncio.Task] = None
-        self._api_zone: contextvars.ContextVar[
-            Optional[ParsedStackTrace]
-        ] = contextvars.ContextVar("ApiZone", default=None)
+        self._api_zone: contextvars.ContextVar[Optional[ParsedStackTrace]] = (
+            contextvars.ContextVar("ApiZone", default=None)
+        )
         self._local_utils: Optional["LocalUtils"] = local_utils
         self._tracing_count = 0
         self._closed_error: Optional[Exception] = None
diff --git a/playwright/_impl/_impl_to_api_mapping.py b/playwright/_impl/_impl_to_api_mapping.py
index 4315e1868..e26d22025 100644
--- a/playwright/_impl/_impl_to_api_mapping.py
+++ b/playwright/_impl/_impl_to_api_mapping.py
@@ -117,7 +117,7 @@ def to_impl(
         except RecursionError:
             raise Error("Maximum argument depth exceeded")
 
-    def wrap_handler(self, handler: Callable[..., None]) -> Callable[..., None]:
+    def wrap_handler(self, handler: Callable[..., Any]) -> Callable[..., None]:
         def wrapper_func(*args: Any) -> Any:
             arg_count = len(inspect.signature(handler).parameters)
             return handler(
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index a8be0ee18..572d4975e 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -145,13 +145,17 @@ def serialize_value(
         return {
             "e": {
                 "m": str(value),
-                "n": (value.name or "")
-                if isinstance(value, Error)
-                else value.__class__.__name__,
-                "s": (value.stack or "")
-                if isinstance(value, Error)
-                else "".join(
-                    traceback.format_exception(type(value), value=value, tb=None)
+                "n": (
+                    (value.name or "")
+                    if isinstance(value, Error)
+                    else value.__class__.__name__
+                ),
+                "s": (
+                    (value.stack or "")
+                    if isinstance(value, Error)
+                    else "".join(
+                        traceback.format_exception(type(value), value=value, tb=None)
+                    )
                 ),
             }
         }
diff --git a/playwright/_impl/_json_pipe.py b/playwright/_impl/_json_pipe.py
index f76bc7175..3a6973baf 100644
--- a/playwright/_impl/_json_pipe.py
+++ b/playwright/_impl/_json_pipe.py
@@ -33,7 +33,6 @@ def __init__(
         Transport.__init__(self, loop)
         self._stop_requested = False
         self._pipe_channel = pipe_channel
-        self._loop: asyncio.AbstractEventLoop
 
     def request_stop(self) -> None:
         self._stop_requested = True
diff --git a/playwright/_impl/_sync_base.py b/playwright/_impl/_sync_base.py
index f07b947b2..b50c7479d 100644
--- a/playwright/_impl/_sync_base.py
+++ b/playwright/_impl/_sync_base.py
@@ -114,7 +114,9 @@ def _sync(
         asyncio._set_running_loop(self._loop)
         return task.result()
 
-    def _wrap_handler(self, handler: Any) -> Callable[..., None]:
+    def _wrap_handler(
+        self, handler: Union[Callable[..., Any], Any]
+    ) -> Callable[..., None]:
         if callable(handler):
             return mapping.wrap_handler(handler)
         return handler
@@ -146,5 +148,4 @@ def __exit__(
     ) -> None:
         self.close()
 
-    def close(self) -> None:
-        ...
+    def close(self) -> None: ...
diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index 554e83927..12ea5febd 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.py
@@ -107,20 +107,19 @@ def set_options(self, timeout: Optional[float] = _unset) -> None:
             self._timeout = timeout
 
     @overload
-    def __call__(self, actual: Page, message: Optional[str] = None) -> PageAssertions:
-        ...
+    def __call__(
+        self, actual: Page, message: Optional[str] = None
+    ) -> PageAssertions: ...
 
     @overload
     def __call__(
         self, actual: Locator, message: Optional[str] = None
-    ) -> LocatorAssertions:
-        ...
+    ) -> LocatorAssertions: ...
 
     @overload
     def __call__(
         self, actual: APIResponse, message: Optional[str] = None
-    ) -> APIResponseAssertions:
-        ...
+    ) -> APIResponseAssertions: ...
 
     def __call__(
         self, actual: Union[Page, Locator, APIResponse], message: Optional[str] = None
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 98bf96cc0..1d4badbe7 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -85,6 +85,7 @@
 
 
 class Request(AsyncBase):
+
     @property
     def url(self) -> str:
         """Request.url
@@ -385,6 +386,7 @@ async def header_value(self, name: str) -> typing.Optional[str]:
 
 
 class Response(AsyncBase):
+
     @property
     def url(self) -> str:
         """Response.url
@@ -621,6 +623,7 @@ async def json(self) -> typing.Any:
 
 
 class Route(AsyncBase):
+
     @property
     def request(self) -> "Request":
         """Route.request
@@ -951,6 +954,7 @@ async def handle(route, request):
 
 
 class WebSocket(AsyncBase):
+
     @typing.overload
     def on(
         self,
@@ -1143,6 +1147,7 @@ def is_closed(self) -> bool:
 
 
 class Keyboard(AsyncBase):
+
     async def down(self, key: str) -> None:
         """Keyboard.down
 
@@ -1306,6 +1311,7 @@ async def press(self, key: str, *, delay: typing.Optional[float] = None) -> None
 
 
 class Mouse(AsyncBase):
+
     async def move(
         self, x: float, y: float, *, steps: typing.Optional[int] = None
     ) -> None:
@@ -1457,6 +1463,7 @@ async def wheel(self, delta_x: float, delta_y: float) -> None:
 
 
 class Touchscreen(AsyncBase):
+
     async def tap(self, x: float, y: float) -> None:
         """Touchscreen.tap
 
@@ -1479,6 +1486,7 @@ async def tap(self, x: float, y: float) -> None:
 
 
 class JSHandle(AsyncBase):
+
     async def evaluate(
         self, expression: str, arg: typing.Optional[typing.Any] = None
     ) -> typing.Any:
@@ -1634,6 +1642,7 @@ async def json_value(self) -> typing.Any:
 
 
 class ElementHandle(JSHandle):
+
     def as_element(self) -> typing.Optional["ElementHandle"]:
         """ElementHandle.as_element
 
@@ -2948,6 +2957,7 @@ async def wait_for_selector(
 
 
 class Accessibility(AsyncBase):
+
     async def snapshot(
         self,
         *,
@@ -3013,6 +3023,7 @@ def find_focused_node(node):
 
 
 class FileChooser(AsyncBase):
+
     @property
     def page(self) -> "Page":
         """FileChooser.page
@@ -3089,6 +3100,7 @@ async def set_files(
 
 
 class Frame(AsyncBase):
+
     @property
     def page(self) -> "Page":
         """Frame.page
@@ -5851,6 +5863,7 @@ async def set_checked(
 
 
 class FrameLocator(AsyncBase):
+
     @property
     def first(self) -> "FrameLocator":
         """FrameLocator.first
@@ -6458,6 +6471,7 @@ def nth(self, index: int) -> "FrameLocator":
 
 
 class Worker(AsyncBase):
+
     def on(
         self,
         event: Literal["close"],
@@ -6558,6 +6572,7 @@ async def evaluate_handle(
 
 
 class Selectors(AsyncBase):
+
     async def register(
         self,
         name: str,
@@ -6655,6 +6670,7 @@ def set_test_id_attribute(self, attribute_name: str) -> None:
 
 
 class Clock(AsyncBase):
+
     async def install(
         self,
         *,
@@ -6813,6 +6829,7 @@ async def set_system_time(
 
 
 class ConsoleMessage(AsyncBase):
+
     @property
     def type(self) -> str:
         """ConsoleMessage.type
@@ -6878,6 +6895,7 @@ def page(self) -> typing.Optional["Page"]:
 
 
 class Dialog(AsyncBase):
+
     @property
     def type(self) -> str:
         """Dialog.type
@@ -6954,6 +6972,7 @@ async def dismiss(self) -> None:
 
 
 class Download(AsyncBase):
+
     @property
     def page(self) -> "Page":
         """Download.page
@@ -7063,6 +7082,7 @@ async def cancel(self) -> None:
 
 
 class Video(AsyncBase):
+
     async def path(self) -> pathlib.Path:
         """Video.path
 
@@ -7103,6 +7123,7 @@ async def delete(self) -> None:
 
 
 class Page(AsyncContextManager):
+
     @typing.overload
     def on(
         self,
@@ -11999,6 +12020,7 @@ async def remove_locator_handler(self, locator: "Locator") -> None:
 
 
 class WebError(AsyncBase):
+
     @property
     def page(self) -> typing.Optional["Page"]:
         """WebError.page
@@ -12028,6 +12050,7 @@ def error(self) -> "Error":
 
 
 class BrowserContext(AsyncContextManager):
+
     @typing.overload
     def on(
         self,
@@ -13283,6 +13306,7 @@ async def new_cdp_session(
 
 
 class CDPSession(AsyncBase):
+
     async def send(
         self, method: str, params: typing.Optional[typing.Dict] = None
     ) -> typing.Dict:
@@ -13318,6 +13342,7 @@ async def detach(self) -> None:
 
 
 class Browser(AsyncContextManager):
+
     def on(
         self,
         event: Literal["disconnected"],
@@ -13973,6 +13998,7 @@ async def stop_tracing(self) -> bytes:
 
 
 class BrowserType(AsyncBase):
+
     @property
     def name(self) -> str:
         """BrowserType.name
@@ -14554,6 +14580,7 @@ async def connect(
 
 
 class Playwright(AsyncBase):
+
     @property
     def devices(self) -> typing.Dict:
         """Playwright.devices
@@ -14648,6 +14675,7 @@ def request(self) -> "APIRequest":
         return mapping.from_impl(self._impl_obj.request)
 
     def __getitem__(self, value: str) -> "BrowserType":
+
         return mapping.from_impl(self._impl_obj.__getitem__(value=value))
 
     async def stop(self) -> None:
@@ -14678,6 +14706,7 @@ async def stop(self) -> None:
 
 
 class Tracing(AsyncBase):
+
     async def start(
         self,
         *,
@@ -14804,6 +14833,7 @@ async def stop(
 
 
 class Locator(AsyncBase):
+
     @property
     def page(self) -> "Page":
         """Locator.page
@@ -17409,6 +17439,7 @@ async def highlight(self) -> None:
 
 
 class APIResponse(AsyncBase):
+
     @property
     def ok(self) -> bool:
         """APIResponse.ok
@@ -17533,6 +17564,7 @@ async def dispose(self) -> None:
 
 
 class APIRequestContext(AsyncBase):
+
     async def dispose(self, *, reason: typing.Optional[str] = None) -> None:
         """APIRequestContext.dispose
 
@@ -18203,6 +18235,7 @@ async def storage_state(
 
 
 class APIRequest(AsyncBase):
+
     async def new_context(
         self,
         *,
@@ -18291,6 +18324,7 @@ async def new_context(
 
 
 class PageAssertions(AsyncBase):
+
     async def to_have_title(
         self,
         title_or_reg_exp: typing.Union[typing.Pattern[str], str],
@@ -18424,6 +18458,7 @@ async def not_to_have_url(
 
 
 class LocatorAssertions(AsyncBase):
+
     async def to_contain_text(
         self,
         expected: typing.Union[
@@ -20072,6 +20107,7 @@ async def not_to_have_role(
 
 
 class APIResponseAssertions(AsyncBase):
+
     async def to_be_ok(self) -> None:
         """APIResponseAssertions.to_be_ok
 
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index e17c0e305..e326fd9f5 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -107,20 +107,19 @@ def set_options(self, timeout: Optional[float] = _unset) -> None:
             self._timeout = timeout
 
     @overload
-    def __call__(self, actual: Page, message: Optional[str] = None) -> PageAssertions:
-        ...
+    def __call__(
+        self, actual: Page, message: Optional[str] = None
+    ) -> PageAssertions: ...
 
     @overload
     def __call__(
         self, actual: Locator, message: Optional[str] = None
-    ) -> LocatorAssertions:
-        ...
+    ) -> LocatorAssertions: ...
 
     @overload
     def __call__(
         self, actual: APIResponse, message: Optional[str] = None
-    ) -> APIResponseAssertions:
-        ...
+    ) -> APIResponseAssertions: ...
 
     def __call__(
         self, actual: Union[Page, Locator, APIResponse], message: Optional[str] = None
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 69eb53b79..1553c2598 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -85,6 +85,7 @@
 
 
 class Request(SyncBase):
+
     @property
     def url(self) -> str:
         """Request.url
@@ -387,6 +388,7 @@ def header_value(self, name: str) -> typing.Optional[str]:
 
 
 class Response(SyncBase):
+
     @property
     def url(self) -> str:
         """Response.url
@@ -627,6 +629,7 @@ def json(self) -> typing.Any:
 
 
 class Route(SyncBase):
+
     @property
     def request(self) -> "Request":
         """Route.request
@@ -967,6 +970,7 @@ def handle(route, request):
 
 
 class WebSocket(SyncBase):
+
     @typing.overload
     def on(
         self, event: Literal["close"], f: typing.Callable[["WebSocket"], "None"]
@@ -1139,6 +1143,7 @@ def is_closed(self) -> bool:
 
 
 class Keyboard(SyncBase):
+
     def down(self, key: str) -> None:
         """Keyboard.down
 
@@ -1306,6 +1311,7 @@ def press(self, key: str, *, delay: typing.Optional[float] = None) -> None:
 
 
 class Mouse(SyncBase):
+
     def move(self, x: float, y: float, *, steps: typing.Optional[int] = None) -> None:
         """Mouse.move
 
@@ -1459,6 +1465,7 @@ def wheel(self, delta_x: float, delta_y: float) -> None:
 
 
 class Touchscreen(SyncBase):
+
     def tap(self, x: float, y: float) -> None:
         """Touchscreen.tap
 
@@ -1481,6 +1488,7 @@ def tap(self, x: float, y: float) -> None:
 
 
 class JSHandle(SyncBase):
+
     def evaluate(
         self, expression: str, arg: typing.Optional[typing.Any] = None
     ) -> typing.Any:
@@ -1638,6 +1646,7 @@ def json_value(self) -> typing.Any:
 
 
 class ElementHandle(JSHandle):
+
     def as_element(self) -> typing.Optional["ElementHandle"]:
         """ElementHandle.as_element
 
@@ -2992,6 +3001,7 @@ def wait_for_selector(
 
 
 class Accessibility(SyncBase):
+
     def snapshot(
         self,
         *,
@@ -3059,6 +3069,7 @@ def find_focused_node(node):
 
 
 class FileChooser(SyncBase):
+
     @property
     def page(self) -> "Page":
         """FileChooser.page
@@ -3139,6 +3150,7 @@ def set_files(
 
 
 class Frame(SyncBase):
+
     @property
     def page(self) -> "Page":
         """Frame.page
@@ -5965,6 +5977,7 @@ def set_checked(
 
 
 class FrameLocator(SyncBase):
+
     @property
     def first(self) -> "FrameLocator":
         """FrameLocator.first
@@ -6572,6 +6585,7 @@ def nth(self, index: int) -> "FrameLocator":
 
 
 class Worker(SyncBase):
+
     def on(
         self, event: Literal["close"], f: typing.Callable[["Worker"], "None"]
     ) -> None:
@@ -6670,6 +6684,7 @@ def evaluate_handle(
 
 
 class Selectors(SyncBase):
+
     def register(
         self,
         name: str,
@@ -6765,6 +6780,7 @@ def set_test_id_attribute(self, attribute_name: str) -> None:
 
 
 class Clock(SyncBase):
+
     def install(
         self,
         *,
@@ -6927,6 +6943,7 @@ def set_system_time(
 
 
 class ConsoleMessage(SyncBase):
+
     @property
     def type(self) -> str:
         """ConsoleMessage.type
@@ -6992,6 +7009,7 @@ def page(self) -> typing.Optional["Page"]:
 
 
 class Dialog(SyncBase):
+
     @property
     def type(self) -> str:
         """Dialog.type
@@ -7068,6 +7086,7 @@ def dismiss(self) -> None:
 
 
 class Download(SyncBase):
+
     @property
     def page(self) -> "Page":
         """Download.page
@@ -7177,6 +7196,7 @@ def cancel(self) -> None:
 
 
 class Video(SyncBase):
+
     def path(self) -> pathlib.Path:
         """Video.path
 
@@ -7217,6 +7237,7 @@ def delete(self) -> None:
 
 
 class Page(SyncContextManager):
+
     @typing.overload
     def on(self, event: Literal["close"], f: typing.Callable[["Page"], "None"]) -> None:
         """
@@ -12090,6 +12111,7 @@ def remove_locator_handler(self, locator: "Locator") -> None:
 
 
 class WebError(SyncBase):
+
     @property
     def page(self) -> typing.Optional["Page"]:
         """WebError.page
@@ -12119,6 +12141,7 @@ def error(self) -> "Error":
 
 
 class BrowserContext(SyncContextManager):
+
     @typing.overload
     def on(
         self, event: Literal["backgroundpage"], f: typing.Callable[["Page"], "None"]
@@ -13317,6 +13340,7 @@ def new_cdp_session(self, page: typing.Union["Page", "Frame"]) -> "CDPSession":
 
 
 class CDPSession(SyncBase):
+
     def send(
         self, method: str, params: typing.Optional[typing.Dict] = None
     ) -> typing.Dict:
@@ -13354,6 +13378,7 @@ def detach(self) -> None:
 
 
 class Browser(SyncContextManager):
+
     def on(
         self, event: Literal["disconnected"], f: typing.Callable[["Browser"], "None"]
     ) -> None:
@@ -14011,6 +14036,7 @@ def stop_tracing(self) -> bytes:
 
 
 class BrowserType(SyncBase):
+
     @property
     def name(self) -> str:
         """BrowserType.name
@@ -14600,6 +14626,7 @@ def connect(
 
 
 class Playwright(SyncBase):
+
     @property
     def devices(self) -> typing.Dict:
         """Playwright.devices
@@ -14691,6 +14718,7 @@ def request(self) -> "APIRequest":
         return mapping.from_impl(self._impl_obj.request)
 
     def __getitem__(self, value: str) -> "BrowserType":
+
         return mapping.from_impl(self._impl_obj.__getitem__(value=value))
 
     def stop(self) -> None:
@@ -14721,6 +14749,7 @@ def stop(self) -> None:
 
 
 class Tracing(SyncBase):
+
     def start(
         self,
         *,
@@ -14849,6 +14878,7 @@ def stop(
 
 
 class Locator(SyncBase):
+
     @property
     def page(self) -> "Page":
         """Locator.page
@@ -17511,6 +17541,7 @@ def highlight(self) -> None:
 
 
 class APIResponse(SyncBase):
+
     @property
     def ok(self) -> bool:
         """APIResponse.ok
@@ -17635,6 +17666,7 @@ def dispose(self) -> None:
 
 
 class APIRequestContext(SyncBase):
+
     def dispose(self, *, reason: typing.Optional[str] = None) -> None:
         """APIRequestContext.dispose
 
@@ -18325,6 +18357,7 @@ def storage_state(
 
 
 class APIRequest(SyncBase):
+
     def new_context(
         self,
         *,
@@ -18415,6 +18448,7 @@ def new_context(
 
 
 class PageAssertions(SyncBase):
+
     def to_have_title(
         self,
         title_or_reg_exp: typing.Union[typing.Pattern[str], str],
@@ -18556,6 +18590,7 @@ def not_to_have_url(
 
 
 class LocatorAssertions(SyncBase):
+
     def to_contain_text(
         self,
         expected: typing.Union[
@@ -20246,6 +20281,7 @@ def not_to_have_role(
 
 
 class APIResponseAssertions(SyncBase):
+
     def to_be_ok(self) -> None:
         """APIResponseAssertions.to_be_ok
 
diff --git a/pyproject.toml b/pyproject.toml
index 34504380f..709e0ffa1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -35,6 +35,7 @@ profile = "black"
 
 [tool.pyright]
 include = ["playwright", "tests", "scripts"]
+exclude = ["**/node_modules", "**/__pycache__", "**/.*", "./build"]
 pythonVersion = "3.8"
 reportMissingImports = false
 reportTypedDictNotRequiredAccess = false
@@ -42,3 +43,4 @@ reportCallInDefaultInitializer = true
 reportOptionalSubscript = false
 reportUnboundVariable = false
 strictParameterNoneValue = false
+reportIncompatibleVariableOverride = false
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 82e3f4bb6..9acbe6c7d 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -96,9 +96,9 @@ def _add_link(self, kind: str, clazz: str, member: str, alias: str) -> None:
         new_name = to_snake_case(alias)
         if kind == "event":
             new_name = new_name.lower()
-            self.links[
-                f"[`event: {clazz}.{member}`]"
-            ] = f"`{var_name}.on('{new_name}')`"
+            self.links[f"[`event: {clazz}.{member}`]"] = (
+                f"`{var_name}.on('{new_name}')`"
+            )
         elif kind == "property":
             self.links[f"[`property: {clazz}.{member}`]"] = f"`{var_name}.{new_name}`"
         else:
diff --git a/setup.cfg b/setup.cfg
index 5594a677b..35d6f7007 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -3,3 +3,5 @@ ignore =
     E501
     W503
     E302
+    # Conflicts with black https://github.com/PyCQA/flake8/issues/1921
+    E704
diff --git a/tests/async/test_accessibility.py b/tests/async/test_accessibility.py
index 201ba8483..ec7b42190 100644
--- a/tests/async/test_accessibility.py
+++ b/tests/async/test_accessibility.py
@@ -100,12 +100,14 @@ async def test_accessibility_should_work(
                 {"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!",
+                    "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
             ],
diff --git a/tests/async/test_keyboard.py b/tests/async/test_keyboard.py
index d94f036e7..e175f429a 100644
--- a/tests/async/test_keyboard.py
+++ b/tests/async/test_keyboard.py
@@ -109,7 +109,9 @@ async def test_should_send_a_character_with_send_character(
         '() => window.addEventListener("keydown", e => e.preventDefault(), true)'
     )
     await page.keyboard.insert_text("a")
-    assert await page.evaluate('() => document.querySelector("textarea").value') == "嗨a"
+    assert (
+        await page.evaluate('() => document.querySelector("textarea").value') == "嗨a"
+    )
 
 
 async def test_should_only_emit_input_event(page: Page, server: Server) -> None:
diff --git a/tests/async/test_page_route.py b/tests/async/test_page_route.py
index 8e0b74130..017bdac9a 100644
--- a/tests/async/test_page_route.py
+++ b/tests/async/test_page_route.py
@@ -605,9 +605,9 @@ async def test_page_route_should_support_cors_with_GET(
 
     async def handle_route(route: Route, request: Request) -> None:
         headers = {
-            "access-control-allow-origin": "*"
-            if request.url.endswith("allow")
-            else "none"
+            "access-control-allow-origin": (
+                "*" if request.url.endswith("allow") else "none"
+            )
         }
         await route.fulfill(
             content_type="application/json",
diff --git a/tests/server.py b/tests/server.py
index 23d7ff374..f9072d448 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -185,7 +185,7 @@ def start(self) -> None:
 
         ws_factory = WebSocketServerFactory()
         ws_factory.protocol = WebSocketProtocol
-        ws_factory.server_instance = self
+        setattr(ws_factory, "server_instance", self)
         self._ws_resource = WebSocketResource(ws_factory)
 
         self.listen(factory)
@@ -281,8 +281,8 @@ def listen(self, factory: http.HTTPFactory) -> None:
 
 class WebSocketProtocol(WebSocketServerProtocol):
     def onOpen(self) -> None:
-        for handler in self.factory.server_instance._ws_handlers.copy():
-            self.factory.server_instance._ws_handlers.remove(handler)
+        for handler in getattr(self.factory, "server_instance")._ws_handlers.copy():
+            getattr(self.factory, "server_instance")._ws_handlers.remove(handler)
             handler(self)
 
 
diff --git a/tests/sync/test_accessibility.py b/tests/sync/test_accessibility.py
index d7516d6d9..625a46999 100644
--- a/tests/sync/test_accessibility.py
+++ b/tests/sync/test_accessibility.py
@@ -100,12 +100,14 @@ def test_accessibility_should_work(
                 {"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!",
+                    "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
             ],
diff --git a/tests/test_reference_count_async.py b/tests/test_reference_count_async.py
index cc1564aa6..4f4cac102 100644
--- a/tests/test_reference_count_async.py
+++ b/tests/test_reference_count_async.py
@@ -59,6 +59,7 @@ def handle_network_response_received(event: Any) -> None:
 
     pw_objects: defaultdict = defaultdict(int)
     for o in objgraph.by_type("dict"):
+        assert isinstance(o, dict)
         name = o.get("_type")
         # https://github.com/microsoft/playwright-python/issues/1602
         if o.get("__pw__is_last_network_response_received_event", False):

From a71a0ce3609fb8027c88cb26cdcb581fbfcabf9b Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 9 Oct 2024 15:14:11 +0200
Subject: [PATCH 267/438] chore: support Python 3.13 (#2589)

---
 .github/workflows/ci.yml | 9 ++++-----
 setup.py                 | 1 +
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7528da114..1779d3ae7 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -47,7 +47,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: [3.8, 3.9]
+        python-version: ['3.8', '3.9']
         browser: [chromium, firefox, webkit]
         include:
         - os: ubuntu-latest
@@ -78,14 +78,13 @@ jobs:
           python-version: '3.12'
           browser: chromium
         - os: windows-latest
-          # TODO: Change to actual version when it's released
-          python-version: '3.13.0-rc.2'
+          python-version: '3.13'
           browser: chromium
         - os: macos-latest
-          python-version: '3.13.0-rc.2'
+          python-version: '3.13'
           browser: chromium
         - os: ubuntu-latest
-          python-version: '3.13.0-rc.2'
+          python-version: '3.13'
           browser: chromium
     runs-on: ${{ matrix.os }}
     steps:
diff --git a/setup.py b/setup.py
index 20047ebe6..97fc4c5d2 100644
--- a/setup.py
+++ b/setup.py
@@ -233,6 +233,7 @@ def _download_and_extract_local_driver(
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
         "License :: OSI Approved :: Apache Software License",
         "Operating System :: OS Independent",
     ],

From 4d31bdc3154653d3234457efa9cd97f0dadf83b5 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 11 Oct 2024 11:33:33 +0200
Subject: [PATCH 268/438] fix(asyncio): already cancelled tasks ends up in
 'InvalidStateError: invalid state' (#2593)

---
 playwright/_impl/_connection.py |  2 ++
 tests/async/test_asyncio.py     | 22 +++++++++++++++++++++-
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index c15d82e79..19b68fb13 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -294,6 +294,8 @@ def cleanup(self, cause: str = None) -> None:
             # To prevent 'Future exception was never retrieved' we ignore all callbacks that are no_reply.
             if callback.no_reply:
                 continue
+            if callback.future.cancelled():
+                continue
             callback.future.set_exception(self._closed_error)
         self._callbacks.clear()
         self.emit("close")
diff --git a/tests/async/test_asyncio.py b/tests/async/test_asyncio.py
index 1d4423afb..33edc71ce 100644
--- a/tests/async/test_asyncio.py
+++ b/tests/async/test_asyncio.py
@@ -13,11 +13,12 @@
 # limitations under the License.
 import asyncio
 import gc
+import sys
 from typing import Dict
 
 import pytest
 
-from playwright.async_api import async_playwright
+from playwright.async_api import Page, async_playwright
 from tests.server import Server
 from tests.utils import TARGET_CLOSED_ERROR_MESSAGE
 
@@ -67,3 +68,22 @@ async def test_cancel_pending_protocol_call_on_playwright_stop(server: Server) -
     with pytest.raises(Exception) as exc_info:
         await pending_task
     assert TARGET_CLOSED_ERROR_MESSAGE in str(exc_info.value)
+
+
+async def test_should_not_throw_with_taskgroup(page: Page) -> None:
+    if sys.version_info < (3, 11):
+        pytest.skip("TaskGroup is only available in Python 3.11+")
+
+    from builtins import ExceptionGroup  # type: ignore
+
+    async def raise_exception() -> None:
+        raise ValueError("Something went wrong")
+
+    with pytest.raises(ExceptionGroup) as exc_info:
+        async with asyncio.TaskGroup() as group:  # type: ignore
+            group.create_task(page.locator(".this-element-does-not-exist").inner_text())
+            group.create_task(raise_exception())
+    assert len(exc_info.value.exceptions) == 1
+    assert "Something went wrong" in str(exc_info.value.exceptions[0])
+    assert isinstance(exc_info.value.exceptions[0], ValueError)
+    assert await page.evaluate("() => 11 * 11") == 121

From a5c347f7733e88d442f6de4c94c65732013b4f9e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Oct 2024 22:26:26 +0200
Subject: [PATCH 269/438] build(deps): bump objgraph from 3.6.1 to 3.6.2
 (#2599)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 8826bc3d5..160b132ce 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -4,7 +4,7 @@ black==24.8.0
 flake8==7.1.1
 flaky==3.8.1
 mypy==1.11.2
-objgraph==3.6.1
+objgraph==3.6.2
 Pillow==10.4.0
 pixelmatch==0.3.0
 pre-commit==3.5.0

From ece2d01d2d330a368cba4a76c5d2dc7280ee3d06 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Oct 2024 22:26:57 +0200
Subject: [PATCH 270/438] build(deps): bump mypy from 1.11.2 to 1.12.0 (#2598)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 160b132ce..07155ee34 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ autobahn==23.1.2
 black==24.8.0
 flake8==7.1.1
 flaky==3.8.1
-mypy==1.11.2
+mypy==1.12.0
 objgraph==3.6.2
 Pillow==10.4.0
 pixelmatch==0.3.0

From b8074060540a2f88026cb870547d3859eed9a6a2 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 21 Oct 2024 15:38:25 +0200
Subject: [PATCH 271/438] chore(roll): roll Playwright to
 1.48.0-beta-1728034490000 (#2584)

---
 README.md                            |   4 +-
 playwright/_impl/_browser_context.py |  55 +++-
 playwright/_impl/_connection.py      |   6 +-
 playwright/_impl/_fetch.py           |  21 +-
 playwright/_impl/_helper.py          |   3 +-
 playwright/_impl/_local_utils.py     |   1 +
 playwright/_impl/_network.py         | 264 +++++++++++++++++---
 playwright/_impl/_object_factory.py  |  10 +-
 playwright/_impl/_page.py            |  53 +++-
 playwright/_impl/_tracing.py         |  21 +-
 playwright/async_api/__init__.py     |   2 +
 playwright/async_api/_generated.py   | 357 ++++++++++++++++++++++----
 playwright/sync_api/__init__.py      |   2 +
 playwright/sync_api/_generated.py    | 361 +++++++++++++++++++++++----
 scripts/documentation_provider.py    |   6 +-
 scripts/expected_api_mismatch.txt    |   5 +
 scripts/generate_api.py              |  11 +-
 setup.py                             |   2 +-
 tests/async/test_navigation.py       |   2 +-
 tests/async/test_page_request_gc.py  |  34 +++
 tests/async/test_route_web_socket.py | 321 ++++++++++++++++++++++++
 tests/server.py                      |  36 +++
 tests/sync/test_page_request_gc.py   |  34 +++
 tests/sync/test_route_web_socket.py  | 316 +++++++++++++++++++++++
 24 files changed, 1759 insertions(+), 168 deletions(-)
 create mode 100644 tests/async/test_page_request_gc.py
 create mode 100644 tests/async/test_route_web_socket.py
 create mode 100644 tests/sync/test_page_request_gc.py
 create mode 100644 tests/sync/test_route_web_socket.py

diff --git a/README.md b/README.md
index d94692919..e99460db3 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 -->129.0.6668.29<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->130.0.6723.31<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->18.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->130.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->131.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 7da85e9a4..4645e2415 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -62,6 +62,7 @@
     TimeoutSettings,
     URLMatch,
     URLMatcher,
+    WebSocketRouteHandlerCallback,
     async_readfile,
     async_writefile,
     locals_to_params,
@@ -69,7 +70,14 @@
     prepare_record_har_options,
     to_impl,
 )
-from playwright._impl._network import Request, Response, Route, serialize_headers
+from playwright._impl._network import (
+    Request,
+    Response,
+    Route,
+    WebSocketRoute,
+    WebSocketRouteHandler,
+    serialize_headers,
+)
 from playwright._impl._page import BindingCall, Page, Worker
 from playwright._impl._str_utils import escape_regex_flags
 from playwright._impl._tracing import Tracing
@@ -106,6 +114,7 @@ def __init__(
             self._browser._contexts.append(self)
         self._pages: List[Page] = []
         self._routes: List[RouteHandler] = []
+        self._web_socket_routes: List[WebSocketRouteHandler] = []
         self._bindings: Dict[str, Any] = {}
         self._timeout_settings = TimeoutSettings(None)
         self._owner_page: Optional[Page] = None
@@ -132,7 +141,14 @@ def __init__(
                 )
             ),
         )
-
+        self._channel.on(
+            "webSocketRoute",
+            lambda params: self._loop.create_task(
+                self._on_web_socket_route(
+                    from_channel(params["webSocketRoute"]),
+                )
+            ),
+        )
         self._channel.on(
             "backgroundPage",
             lambda params: self._on_background_page(from_channel(params["page"])),
@@ -244,10 +260,24 @@ async def _on_route(self, route: Route) -> None:
         try:
             # If the page is closed or unrouteAll() was called without waiting and interception disabled,
             # the method will throw an error - silence it.
-            await route._internal_continue(is_internal=True)
+            await route._inner_continue(True)
         except Exception:
             pass
 
+    async def _on_web_socket_route(self, web_socket_route: WebSocketRoute) -> None:
+        route_handler = next(
+            (
+                route_handler
+                for route_handler in self._web_socket_routes
+                if route_handler.matches(web_socket_route.url)
+            ),
+            None,
+        )
+        if route_handler:
+            await route_handler.handle(web_socket_route)
+        else:
+            web_socket_route.connect_to_server()
+
     def _on_binding(self, binding_call: BindingCall) -> None:
         func = self._bindings.get(binding_call._initializer["name"])
         if func is None:
@@ -418,6 +448,17 @@ async def _unroute_internal(
             return
         await asyncio.gather(*map(lambda router: router.stop(behavior), removed))  # type: ignore
 
+    async def route_web_socket(
+        self, url: URLMatch, handler: WebSocketRouteHandlerCallback
+    ) -> None:
+        self._web_socket_routes.insert(
+            0,
+            WebSocketRouteHandler(
+                URLMatcher(self._options.get("baseURL"), url), handler
+            ),
+        )
+        await self._update_web_socket_interception_patterns()
+
     def _dispose_har_routers(self) -> None:
         for router in self._har_routers:
             router.dispose()
@@ -488,6 +529,14 @@ async def _update_interception_patterns(self) -> None:
             "setNetworkInterceptionPatterns", {"patterns": patterns}
         )
 
+    async def _update_web_socket_interception_patterns(self) -> None:
+        patterns = WebSocketRouteHandler.prepare_interception_patterns(
+            self._web_socket_routes
+        )
+        await self._channel.send(
+            "setWebSocketInterceptionPatterns", {"patterns": patterns}
+        )
+
     def expect_event(
         self,
         event: str,
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 19b68fb13..95c87deb8 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -132,6 +132,7 @@ def __init__(
         self._channel: Channel = Channel(self._connection, self)
         self._initializer = initializer
         self._was_collected = False
+        self._is_internal_type = False
 
         self._connection._objects[guid] = self
         if self._parent:
@@ -156,6 +157,9 @@ def _adopt(self, child: "ChannelOwner") -> None:
         self._objects[child._guid] = child
         child._parent = self
 
+    def mark_as_internal_type(self) -> None:
+        self._is_internal_type = True
+
     def _set_event_to_subscription_mapping(self, mapping: Dict[str, str]) -> None:
         self._event_to_subscription_mapping = mapping
 
@@ -355,7 +359,7 @@ def _send_message_to_server(
             "params": self._replace_channels_with_guids(params),
             "metadata": metadata,
         }
-        if self._tracing_count > 0 and frames and object._guid != "localUtils":
+        if self._tracing_count > 0 and frames and not object._is_internal_type:
             self.local_utils.add_stack_to_tracing_no_reply(id, frames)
 
         self._transport.send(message)
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index a4de751bd..93144ac55 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -18,7 +18,6 @@
 import typing
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Union, cast
-from urllib.parse import parse_qs
 
 import playwright._impl._network as network
 from playwright._impl._api_structures import (
@@ -405,7 +404,8 @@ async def _inner_fetch(
             "fetch",
             {
                 "url": url,
-                "params": params_to_protocol(params),
+                "params": object_to_array(params) if isinstance(params, dict) else None,
+                "encodedParams": params if isinstance(params, str) else None,
                 "method": method,
                 "headers": serialized_headers,
                 "postData": post_data,
@@ -430,23 +430,6 @@ async def storage_state(
         return result
 
 
-def params_to_protocol(params: Optional[ParamsType]) -> Optional[List[NameValue]]:
-    if not params:
-        return None
-    if isinstance(params, dict):
-        return object_to_array(params)
-    if params.startswith("?"):
-        params = params[1:]
-    parsed = parse_qs(params)
-    if not parsed:
-        return None
-    out = []
-    for name, values in parsed.items():
-        for value in values:
-            out.append(NameValue(name=name, value=value))
-    return out
-
-
 def file_payload_to_json(payload: FilePayload) -> ServerFilePayload:
     return ServerFilePayload(
         name=payload["name"],
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index a27f4a789..027b3e1f5 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -50,7 +50,7 @@
 
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._api_structures import HeadersArray
-    from playwright._impl._network import Request, Response, Route
+    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]]
@@ -58,6 +58,7 @@
 RouteHandlerCallback = Union[
     Callable[["Route"], Any], Callable[["Route", "Request"], Any]
 ]
+WebSocketRouteHandlerCallback = Callable[["WebSocketRoute"], Any]
 
 ColorScheme = Literal["dark", "light", "no-preference", "null"]
 ForcedColors = Literal["active", "none", "null"]
diff --git a/playwright/_impl/_local_utils.py b/playwright/_impl/_local_utils.py
index 7172ee58a..26a3417c4 100644
--- a/playwright/_impl/_local_utils.py
+++ b/playwright/_impl/_local_utils.py
@@ -25,6 +25,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        self.mark_as_internal_type()
         self.devices = {
             device["name"]: parse_device_descriptor(device["descriptor"])
             for device in initializer["deviceDescriptors"]
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 91c2a460c..376b2b8cb 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -18,6 +18,7 @@
 import json
 import json as json_utils
 import mimetypes
+import re
 from collections import defaultdict
 from pathlib import Path
 from types import SimpleNamespace
@@ -51,7 +52,13 @@
 )
 from playwright._impl._errors import Error
 from playwright._impl._event_context_manager import EventContextManagerImpl
-from playwright._impl._helper import async_readfile, locals_to_params
+from playwright._impl._helper import (
+    URLMatcher,
+    WebSocketRouteHandlerCallback,
+    async_readfile,
+    locals_to_params,
+)
+from playwright._impl._str_utils import escape_regex_flags
 from playwright._impl._waiter import Waiter
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -310,6 +317,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        self.mark_as_internal_type()
         self._handling_future: Optional[asyncio.Future["bool"]] = None
         self._context: "BrowserContext" = cast("BrowserContext", None)
         self._did_throw = False
@@ -342,7 +350,6 @@ async def abort(self, errorCode: str = None) -> None:
                     "abort",
                     {
                         "errorCode": errorCode,
-                        "requestUrl": self.request._initializer["url"],
                     },
                 )
             )
@@ -425,7 +432,6 @@ async def _inner_fulfill(
         if length and "content-length" not in headers:
             headers["content-length"] = str(length)
         params["headers"] = serialize_headers(headers)
-        params["requestUrl"] = self.request._initializer["url"]
 
         await self._race_with_page_close(self._channel.send("fulfill", params))
 
@@ -484,43 +490,30 @@ async def continue_(
 
         async def _inner() -> None:
             self.request._apply_fallback_overrides(overrides)
-            await self._internal_continue()
+            await self._inner_continue(False)
 
         return await self._handle_route(_inner)
 
-    def _internal_continue(
-        self, is_internal: bool = False
-    ) -> Coroutine[Any, Any, None]:
-        async def continue_route() -> None:
-            try:
-                params: Dict[str, Any] = {}
-                params["url"] = self.request._fallback_overrides.url
-                params["method"] = self.request._fallback_overrides.method
-                params["headers"] = self.request._fallback_overrides.headers
-                if self.request._fallback_overrides.post_data_buffer is not None:
-                    params["postData"] = base64.b64encode(
-                        self.request._fallback_overrides.post_data_buffer
-                    ).decode()
-                params = locals_to_params(params)
-
-                if "headers" in params:
-                    params["headers"] = serialize_headers(params["headers"])
-                params["requestUrl"] = self.request._initializer["url"]
-                params["isFallback"] = is_internal
-                await self._connection.wrap_api_call(
-                    lambda: self._race_with_page_close(
-                        self._channel.send(
-                            "continue",
-                            params,
-                        )
+    async def _inner_continue(self, is_fallback: bool = False) -> None:
+        options = self.request._fallback_overrides
+        await self._race_with_page_close(
+            self._channel.send(
+                "continue",
+                {
+                    "url": options.url,
+                    "method": options.method,
+                    "headers": (
+                        serialize_headers(options.headers) if options.headers else None
                     ),
-                    is_internal,
-                )
-            except Exception as e:
-                if not is_internal:
-                    raise e
-
-        return continue_route()
+                    "postData": (
+                        base64.b64encode(options.post_data_buffer).decode()
+                        if options.post_data_buffer is not None
+                        else None
+                    ),
+                    "isFallback": is_fallback,
+                },
+            )
+        )
 
     async def _redirected_navigation_request(self, url: str) -> None:
         await self._handle_route(
@@ -548,6 +541,205 @@ async def _race_with_page_close(self, future: Coroutine) -> None:
             await asyncio.gather(fut, return_exceptions=True)
 
 
+def _create_task_and_ignore_exception(coro: Coroutine) -> None:
+    async def _ignore_exception() -> None:
+        try:
+            await coro
+        except Exception:
+            pass
+
+    asyncio.create_task(_ignore_exception())
+
+
+class ServerWebSocketRoute:
+    def __init__(self, ws: "WebSocketRoute"):
+        self._ws = ws
+
+    def on_message(self, handler: Callable[[Union[str, bytes]], Any]) -> None:
+        self._ws._on_server_message = handler
+
+    def on_close(self, handler: Callable[[Optional[int], Optional[str]], Any]) -> None:
+        self._ws._on_server_close = handler
+
+    def connect_to_server(self) -> None:
+        raise NotImplementedError(
+            "connectToServer must be called on the page-side WebSocketRoute"
+        )
+
+    @property
+    def url(self) -> str:
+        return self._ws._initializer["url"]
+
+    def close(self, code: int = None, reason: str = None) -> None:
+        _create_task_and_ignore_exception(
+            self._ws._channel.send(
+                "closeServer",
+                {
+                    "code": code,
+                    "reason": reason,
+                    "wasClean": True,
+                },
+            )
+        )
+
+    def send(self, message: Union[str, bytes]) -> None:
+        if isinstance(message, str):
+            _create_task_and_ignore_exception(
+                self._ws._channel.send(
+                    "sendToServer", {"message": message, "isBase64": False}
+                )
+            )
+        else:
+            _create_task_and_ignore_exception(
+                self._ws._channel.send(
+                    "sendToServer",
+                    {"message": base64.b64encode(message).decode(), "isBase64": True},
+                )
+            )
+
+
+class WebSocketRoute(ChannelOwner):
+    def __init__(
+        self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
+    ) -> None:
+        super().__init__(parent, type, guid, initializer)
+        self.mark_as_internal_type()
+        self._on_page_message: Optional[Callable[[Union[str, bytes]], Any]] = None
+        self._on_page_close: Optional[Callable[[Optional[int], Optional[str]], Any]] = (
+            None
+        )
+        self._on_server_message: Optional[Callable[[Union[str, bytes]], Any]] = None
+        self._on_server_close: Optional[
+            Callable[[Optional[int], Optional[str]], Any]
+        ] = None
+        self._server = ServerWebSocketRoute(self)
+        self._connected = False
+
+        self._channel.on("messageFromPage", self._channel_message_from_page)
+        self._channel.on("messageFromServer", self._channel_message_from_server)
+        self._channel.on("closePage", self._channel_close_page)
+        self._channel.on("closeServer", self._channel_close_server)
+
+    def _channel_message_from_page(self, event: Dict) -> None:
+        if self._on_page_message:
+            self._on_page_message(
+                base64.b64decode(event["message"])
+                if event["isBase64"]
+                else event["message"]
+            )
+        elif self._connected:
+            _create_task_and_ignore_exception(self._channel.send("sendToServer", event))
+
+    def _channel_message_from_server(self, event: Dict) -> None:
+        if self._on_server_message:
+            self._on_server_message(
+                base64.b64decode(event["message"])
+                if event["isBase64"]
+                else event["message"]
+            )
+        else:
+            _create_task_and_ignore_exception(self._channel.send("sendToPage", event))
+
+    def _channel_close_page(self, event: Dict) -> None:
+        if self._on_page_close:
+            self._on_page_close(event["code"], event["reason"])
+        else:
+            _create_task_and_ignore_exception(self._channel.send("closeServer", event))
+
+    def _channel_close_server(self, event: Dict) -> None:
+        if self._on_server_close:
+            self._on_server_close(event["code"], event["reason"])
+        else:
+            _create_task_and_ignore_exception(self._channel.send("closePage", event))
+
+    @property
+    def url(self) -> str:
+        return self._initializer["url"]
+
+    async def close(self, code: int = None, reason: str = None) -> None:
+        try:
+            await self._channel.send(
+                "closePage", {"code": code, "reason": reason, "wasClean": True}
+            )
+        except Exception:
+            pass
+
+    def connect_to_server(self) -> "WebSocketRoute":
+        if self._connected:
+            raise Error("Already connected to the server")
+        self._connected = True
+        asyncio.create_task(self._channel.send("connect"))
+        return cast("WebSocketRoute", self._server)
+
+    def send(self, message: Union[str, bytes]) -> None:
+        if isinstance(message, str):
+            _create_task_and_ignore_exception(
+                self._channel.send(
+                    "sendToPage", {"message": message, "isBase64": False}
+                )
+            )
+        else:
+            _create_task_and_ignore_exception(
+                self._channel.send(
+                    "sendToPage",
+                    {
+                        "message": base64.b64encode(message).decode(),
+                        "isBase64": True,
+                    },
+                )
+            )
+
+    def on_message(self, handler: Callable[[Union[str, bytes]], Any]) -> None:
+        self._on_page_message = handler
+
+    def on_close(self, handler: Callable[[Optional[int], Optional[str]], Any]) -> None:
+        self._on_page_close = handler
+
+    async def _after_handle(self) -> None:
+        if self._connected:
+            return
+        # Ensure that websocket is "open" and can send messages without an actual server connection.
+        await self._channel.send("ensureOpened")
+
+
+class WebSocketRouteHandler:
+    def __init__(self, matcher: URLMatcher, handler: WebSocketRouteHandlerCallback):
+        self.matcher = matcher
+        self.handler = handler
+
+    @staticmethod
+    def prepare_interception_patterns(
+        handlers: List["WebSocketRouteHandler"],
+    ) -> List[dict]:
+        patterns = []
+        all_urls = False
+        for handler in handlers:
+            if isinstance(handler.matcher.match, str):
+                patterns.append({"glob": handler.matcher.match})
+            elif isinstance(handler.matcher._regex_obj, re.Pattern):
+                patterns.append(
+                    {
+                        "regexSource": handler.matcher._regex_obj.pattern,
+                        "regexFlags": escape_regex_flags(handler.matcher._regex_obj),
+                    }
+                )
+            else:
+                all_urls = True
+
+        if all_urls:
+            return [{"glob": "**/*"}]
+        return patterns
+
+    def matches(self, ws_url: str) -> bool:
+        return self.matcher.matches(ws_url)
+
+    async def handle(self, websocket_route: "WebSocketRoute") -> None:
+        coro_or_future = self.handler(websocket_route)
+        if asyncio.iscoroutine(coro_or_future):
+            await coro_or_future
+        await websocket_route._after_handle()
+
+
 class Response(ChannelOwner):
     def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
diff --git a/playwright/_impl/_object_factory.py b/playwright/_impl/_object_factory.py
index 2652e41fe..5f38b781b 100644
--- a/playwright/_impl/_object_factory.py
+++ b/playwright/_impl/_object_factory.py
@@ -26,7 +26,13 @@
 from playwright._impl._frame import Frame
 from playwright._impl._js_handle import JSHandle
 from playwright._impl._local_utils import LocalUtils
-from playwright._impl._network import Request, Response, Route, WebSocket
+from playwright._impl._network import (
+    Request,
+    Response,
+    Route,
+    WebSocket,
+    WebSocketRoute,
+)
 from playwright._impl._page import BindingCall, Page, Worker
 from playwright._impl._playwright import Playwright
 from playwright._impl._selectors import SelectorsOwner
@@ -88,6 +94,8 @@ def create_remote_object(
         return Tracing(parent, type, guid, initializer)
     if type == "WebSocket":
         return WebSocket(parent, type, guid, initializer)
+    if type == "WebSocketRoute":
+        return WebSocketRoute(parent, type, guid, initializer)
     if type == "Worker":
         return Worker(parent, type, guid, initializer)
     if type == "WritableStream":
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 88c6da720..15195b28b 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -74,6 +74,7 @@
     URLMatcher,
     URLMatchRequest,
     URLMatchResponse,
+    WebSocketRouteHandlerCallback,
     async_readfile,
     async_writefile,
     locals_to_params,
@@ -88,7 +89,14 @@
     parse_result,
     serialize_argument,
 )
-from playwright._impl._network import Request, Response, Route, serialize_headers
+from playwright._impl._network import (
+    Request,
+    Response,
+    Route,
+    WebSocketRoute,
+    WebSocketRouteHandler,
+    serialize_headers,
+)
 from playwright._impl._video import Video
 from playwright._impl._waiter import Waiter
 
@@ -163,6 +171,7 @@ def __init__(
         self._workers: List["Worker"] = []
         self._bindings: Dict[str, Any] = {}
         self._routes: List[RouteHandler] = []
+        self._web_socket_routes: List[WebSocketRouteHandler] = []
         self._owned_context: Optional["BrowserContext"] = None
         self._timeout_settings: TimeoutSettings = TimeoutSettings(
             self._browser_context._timeout_settings
@@ -210,6 +219,12 @@ def __init__(
                 self._on_route(from_channel(params["route"]))
             ),
         )
+        self._channel.on(
+            "webSocketRoute",
+            lambda params: self._loop.create_task(
+                self._on_web_socket_route(from_channel(params["webSocketRoute"]))
+            ),
+        )
         self._channel.on("video", lambda params: self._on_video(params))
         self._channel.on(
             "webSocket",
@@ -298,6 +313,20 @@ async def _update_interceptor_patterns_ignore_exceptions() -> None:
                 return
         await self._browser_context._on_route(route)
 
+    async def _on_web_socket_route(self, web_socket_route: WebSocketRoute) -> None:
+        route_handler = next(
+            (
+                route_handler
+                for route_handler in self._web_socket_routes
+                if route_handler.matches(web_socket_route.url)
+            ),
+            None,
+        )
+        if route_handler:
+            await route_handler.handle(web_socket_route)
+        else:
+            await self._browser_context._on_web_socket_route(web_socket_route)
+
     def _on_binding(self, binding_call: "BindingCall") -> None:
         func = self._bindings.get(binding_call._initializer["name"])
         if func:
@@ -572,6 +601,9 @@ async def go_forward(
             await self._channel.send("goForward", locals_to_params(locals()))
         )
 
+    async def request_gc(self) -> None:
+        await self._channel.send("requestGC")
+
     async def emulate_media(
         self,
         media: Literal["null", "print", "screen"] = None,
@@ -661,6 +693,17 @@ async def _unroute_internal(
             )
         )
 
+    async def route_web_socket(
+        self, url: URLMatch, handler: WebSocketRouteHandlerCallback
+    ) -> None:
+        self._web_socket_routes.insert(
+            0,
+            WebSocketRouteHandler(
+                URLMatcher(self._browser_context._options.get("baseURL"), url), handler
+            ),
+        )
+        await self._update_web_socket_interception_patterns()
+
     def _dispose_har_routers(self) -> None:
         for router in self._har_routers:
             router.dispose()
@@ -705,6 +748,14 @@ async def _update_interception_patterns(self) -> None:
             "setNetworkInterceptionPatterns", {"patterns": patterns}
         )
 
+    async def _update_web_socket_interception_patterns(self) -> None:
+        patterns = WebSocketRouteHandler.prepare_interception_patterns(
+            self._web_socket_routes
+        )
+        await self._channel.send(
+            "setWebSocketInterceptionPatterns", {"patterns": patterns}
+        )
+
     async def screenshot(
         self,
         timeout: float = None,
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index b2d4b5df9..5c59b749f 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -25,6 +25,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        self.mark_as_internal_type()
         self._include_sources: bool = False
         self._stacks_id: Optional[str] = None
         self._is_tracing: bool = False
@@ -41,13 +42,10 @@ async def start(
         params = locals_to_params(locals())
         self._include_sources = bool(sources)
 
-        async def _inner_start() -> str:
-            await self._channel.send("tracingStart", params)
-            return await self._channel.send(
-                "tracingStartChunk", {"title": title, "name": name}
-            )
-
-        trace_name = await self._connection.wrap_api_call(_inner_start, True)
+        await self._channel.send("tracingStart", params)
+        trace_name = await self._channel.send(
+            "tracingStartChunk", {"title": title, "name": name}
+        )
         await self._start_collecting_stacks(trace_name)
 
     async def start_chunk(self, title: str = None, name: str = None) -> None:
@@ -64,14 +62,11 @@ async def _start_collecting_stacks(self, trace_name: str) -> None:
         )
 
     async def stop_chunk(self, path: Union[pathlib.Path, str] = None) -> None:
-        await self._connection.wrap_api_call(lambda: self._do_stop_chunk(path), True)
+        await self._do_stop_chunk(path)
 
     async def stop(self, path: Union[pathlib.Path, str] = None) -> None:
-        async def _inner() -> None:
-            await self._do_stop_chunk(path)
-            await self._channel.send("tracingStop")
-
-        await self._connection.wrap_api_call(_inner, True)
+        await self._do_stop_chunk(path)
+        await self._channel.send("tracingStop")
 
     async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> None:
         self._reset_stack_counter()
diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index 12ea5febd..a64a066c2 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.py
@@ -61,6 +61,7 @@
     Touchscreen,
     Video,
     WebSocket,
+    WebSocketRoute,
     Worker,
 )
 
@@ -190,5 +191,6 @@ def __call__(
     "Video",
     "ViewportSize",
     "WebSocket",
+    "WebSocketRoute",
     "Worker",
 ]
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 1d4badbe7..3730d8127 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -75,6 +75,7 @@
 from playwright._impl._network import Response as ResponseImpl
 from playwright._impl._network import Route as RouteImpl
 from playwright._impl._network import WebSocket as WebSocketImpl
+from playwright._impl._network import WebSocketRoute as WebSocketRouteImpl
 from playwright._impl._page import Page as PageImpl
 from playwright._impl._page import Worker as WorkerImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
@@ -1146,6 +1147,133 @@ def is_closed(self) -> bool:
 mapping.register(WebSocketImpl, WebSocket)
 
 
+class WebSocketRoute(AsyncBase):
+
+    @property
+    def url(self) -> str:
+        """WebSocketRoute.url
+
+        URL of the WebSocket created in the page.
+
+        Returns
+        -------
+        str
+        """
+        return mapping.from_maybe_impl(self._impl_obj.url)
+
+    async def close(
+        self, *, code: typing.Optional[int] = None, reason: typing.Optional[str] = None
+    ) -> None:
+        """WebSocketRoute.close
+
+        Closes one side of the WebSocket connection.
+
+        Parameters
+        ----------
+        code : Union[int, None]
+            Optional [close code](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#code).
+        reason : Union[str, None]
+            Optional [close reason](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#reason).
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.close(code=code, reason=reason)
+        )
+
+    def connect_to_server(self) -> "WebSocketRoute":
+        """WebSocketRoute.connect_to_server
+
+        By default, routed WebSocket does not connect to the server, so you can mock entire WebSocket communication. This
+        method connects to the actual WebSocket server, and returns the server-side `WebSocketRoute` instance, giving the
+        ability to send and receive messages from the server.
+
+        Once connected to the server:
+        - Messages received from the server will be **automatically forwarded** to the WebSocket in the page, unless
+          `web_socket_route.on_message()` is called on the server-side `WebSocketRoute`.
+        - Messages sent by the [`WebSocket.send()`](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/send) call
+          in the page will be **automatically forwarded** to the server, unless `web_socket_route.on_message()` is
+          called on the original `WebSocketRoute`.
+
+        See examples at the top for more details.
+
+        Returns
+        -------
+        WebSocketRoute
+        """
+
+        return mapping.from_impl(self._impl_obj.connect_to_server())
+
+    def send(self, message: typing.Union[str, bytes]) -> None:
+        """WebSocketRoute.send
+
+        Sends a message to the WebSocket. When called on the original WebSocket, sends the message to the page. When called
+        on the result of `web_socket_route.connect_to_server()`, sends the message to the server. See examples at the
+        top for more details.
+
+        Parameters
+        ----------
+        message : Union[bytes, str]
+            Message to send.
+        """
+
+        return mapping.from_maybe_impl(self._impl_obj.send(message=message))
+
+    def on_message(
+        self, handler: typing.Callable[[typing.Union[str, bytes]], typing.Any]
+    ) -> None:
+        """WebSocketRoute.on_message
+
+        This method allows to handle messages that are sent by the WebSocket, either from the page or from the server.
+
+        When called on the original WebSocket route, this method handles messages sent from the page. You can handle this
+        messages by responding to them with `web_socket_route.send()`, forwarding them to the server-side connection
+        returned by `web_socket_route.connect_to_server()` or do something else.
+
+        Once this method is called, messages are not automatically forwarded to the server or to the page - you should do
+        that manually by calling `web_socket_route.send()`. See examples at the top for more details.
+
+        Calling this method again will override the handler with a new one.
+
+        Parameters
+        ----------
+        handler : Callable[[Union[bytes, str]], Any]
+            Function that will handle messages.
+        """
+
+        return mapping.from_maybe_impl(
+            self._impl_obj.on_message(handler=self._wrap_handler(handler))
+        )
+
+    def on_close(
+        self,
+        handler: typing.Callable[
+            [typing.Optional[int], typing.Optional[str]], typing.Any
+        ],
+    ) -> None:
+        """WebSocketRoute.on_close
+
+        Allows to handle [`WebSocket.close`](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close).
+
+        By default, closing one side of the connection, either in the page or on the server, will close the other side.
+        However, when `web_socket_route.on_close()` handler is set up, the default forwarding of closure is disabled,
+        and handler should take care of it.
+
+        Parameters
+        ----------
+        handler : Callable[[Union[int, None], Union[str, None]], Any]
+            Function that will handle WebSocket closure. Received an optional
+            [close code](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#code) and an optional
+            [close reason](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#reason).
+        """
+
+        return mapping.from_maybe_impl(
+            self._impl_obj.on_close(handler=self._wrap_handler(handler))
+        )
+
+
+mapping.register(WebSocketRouteImpl, WebSocketRoute)
+
+
 class Keyboard(AsyncBase):
 
     async def down(self, key: str) -> None:
@@ -4212,7 +4340,9 @@ async def click(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4291,7 +4421,9 @@ async def dblclick(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4362,7 +4494,9 @@ async def tap(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4761,6 +4895,7 @@ def get_by_role(
 
             **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
 
@@ -5202,7 +5337,9 @@ async def hover(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -5902,7 +6039,7 @@ def owner(self) -> "Locator":
         **Usage**
 
         ```py
-        frame_locator = page.frame_locator(\"iframe[name=\\\"embedded\\\"]\")
+        frame_locator = page.locator(\"iframe[name=\\\"embedded\\\"]\").content_frame
         # ...
         locator = frame_locator.owner
         await expect(locator).to_be_visible()
@@ -6240,6 +6377,7 @@ def get_by_role(
 
             **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
 
@@ -9090,6 +9228,28 @@ async def go_forward(
             await self._impl_obj.go_forward(timeout=timeout, waitUntil=wait_until)
         )
 
+    async def request_gc(self) -> None:
+        """Page.request_gc
+
+        Request the page to perform garbage collection. Note that there is no guarantee that all unreachable objects will
+        be collected.
+
+        This is useful to help detect memory leaks. For example, if your page has a large object `'suspect'` that might be
+        leaked, you can check that it does not leak by using a
+        [`WeakRef`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakRef).
+
+        ```py
+        # 1. In your page, save a WeakRef for the \"suspect\".
+        await page.evaluate(\"globalThis.suspectWeakRef = new WeakRef(suspect)\")
+        # 2. Request garbage collection.
+        await page.request_gc()
+        # 3. Check that weak ref does not deref to the original object.
+        assert await page.evaluate(\"!globalThis.suspectWeakRef.deref()\")
+        ```
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.request_gc())
+
     async def emulate_media(
         self,
         *,
@@ -9259,7 +9419,7 @@ async def route(
 
         **NOTE** `page.route()` will not intercept requests intercepted by Service Worker. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
-        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        using request interception by setting `serviceWorkers` to `'block'`.
 
         **NOTE** `page.route()` will not intercept the first request of a popup page. Use
         `browser_context.route()` instead.
@@ -9352,6 +9512,49 @@ async def unroute(
             )
         )
 
+    async def route_web_socket(
+        self,
+        url: typing.Union[str, typing.Pattern[str], typing.Callable[[str], bool]],
+        handler: typing.Callable[["WebSocketRoute"], typing.Any],
+    ) -> None:
+        """Page.route_web_socket
+
+        This method allows to modify websocket connections that are made by the page.
+
+        Note that only `WebSocket`s created after this method was called will be routed. It is recommended to call this
+        method before navigating the page.
+
+        **Usage**
+
+        Below is an example of a simple mock that responds to a single message. See `WebSocketRoute` for more details and
+        examples.
+
+        ```py
+        def message_handler(ws: WebSocketRoute, message: Union[str, bytes]):
+          if message == \"request\":
+            ws.send(\"response\")
+
+        def handler(ws: WebSocketRoute):
+          ws.on_message(lambda message: message_handler(ws, message))
+
+        await page.route_web_socket(\"/ws\", handler)
+        ```
+
+        Parameters
+        ----------
+        url : Union[Callable[[str], bool], Pattern[str], str]
+            Only WebSockets with the url matching this pattern will be routed. A string pattern can be relative to the
+            `baseURL` context option.
+        handler : Callable[[WebSocketRoute], Any]
+            Handler function to route the WebSocket.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.route_web_socket(
+                url=self._wrap_handler(url), handler=self._wrap_handler(handler)
+            )
+        )
+
     async def unroute_all(
         self,
         *,
@@ -9393,7 +9596,7 @@ async def route_from_har(
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
-        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        using request interception by setting `serviceWorkers` to `'block'`.
 
         Parameters
         ----------
@@ -9636,7 +9839,9 @@ async def click(
             Deprecated: This option will default to `true` in the future.
         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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9717,7 +9922,9 @@ async def dblclick(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -9788,7 +9995,9 @@ async def tap(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -10185,6 +10394,7 @@ def get_by_role(
 
             **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
 
@@ -10626,7 +10836,9 @@ async def hover(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -11254,8 +11466,7 @@ async def pause(self) -> None:
         User can inspect selectors or perform manual steps while paused. Resume will continue running the original script
         from the place it was paused.
 
-        **NOTE** This method requires Playwright to be started in a headed mode, with a falsy `headless` value in the
-        `browser_type.launch()`.
+        **NOTE** This method requires Playwright to be started in a headed mode, with a falsy `headless` option.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.pause())
@@ -11916,13 +12127,16 @@ async def add_locator_handler(
 
         **NOTE** Running the handler will alter your page state mid-test. For example it will change the currently focused
         element and move the mouse. Make sure that actions that run after the handler are self-contained and do not rely on
-        the focus and mouse state being unchanged. <br /> <br /> For example, consider a test that calls
-        `locator.focus()` followed by `keyboard.press()`. If your handler clicks a button between these two
-        actions, the focused element most likely will be wrong, and key press will happen on the unexpected element. Use
-        `locator.press()` instead to avoid this problem. <br /> <br /> Another example is a series of mouse
-        actions, where `mouse.move()` is followed by `mouse.down()`. Again, when the handler runs between
-        these two actions, the mouse position will be wrong during the mouse down. Prefer self-contained actions like
-        `locator.click()` that do not rely on the state being unchanged by a handler.
+        the focus and mouse state being unchanged.
+
+        For example, consider a test that calls `locator.focus()` followed by `keyboard.press()`. If your
+        handler clicks a button between these two actions, the focused element most likely will be wrong, and key press
+        will happen on the unexpected element. Use `locator.press()` instead to avoid this problem.
+
+        Another example is a series of mouse actions, where `mouse.move()` is followed by `mouse.down()`.
+        Again, when the handler runs between these two actions, the mouse position will be wrong during the mouse down.
+        Prefer self-contained actions like `locator.click()` that do not rely on the state being unchanged by a
+        handler.
 
         **Usage**
 
@@ -12931,7 +13145,7 @@ async def route(
 
         **NOTE** `browser_context.route()` will not intercept requests intercepted by Service Worker. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
-        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        using request interception by setting `serviceWorkers` to `'block'`.
 
         **Usage**
 
@@ -13025,6 +13239,51 @@ async def unroute(
             )
         )
 
+    async def route_web_socket(
+        self,
+        url: typing.Union[str, typing.Pattern[str], typing.Callable[[str], bool]],
+        handler: typing.Callable[["WebSocketRoute"], typing.Any],
+    ) -> None:
+        """BrowserContext.route_web_socket
+
+        This method allows to modify websocket connections that are made by any page in the browser context.
+
+        Note that only `WebSocket`s created after this method was called will be routed. It is recommended to call this
+        method before creating any pages.
+
+        **Usage**
+
+        Below is an example of a simple handler that blocks some websocket messages. See `WebSocketRoute` for more details
+        and examples.
+
+        ```py
+        def message_handler(ws: WebSocketRoute, message: Union[str, bytes]):
+          if message == \"to-be-blocked\":
+            return
+          ws.send(message)
+
+        async def handler(ws: WebSocketRoute):
+          ws.route_send(lambda message: message_handler(ws, message))
+          await ws.connect()
+
+        await context.route_web_socket(\"/ws\", handler)
+        ```
+
+        Parameters
+        ----------
+        url : Union[Callable[[str], bool], Pattern[str], str]
+            Only WebSockets with the url matching this pattern will be routed. A string pattern can be relative to the
+            `baseURL` context option.
+        handler : Callable[[WebSocketRoute], Any]
+            Handler function to route the WebSocket.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.route_web_socket(
+                url=self._wrap_handler(url), handler=self._wrap_handler(handler)
+            )
+        )
+
     async def unroute_all(
         self,
         *,
@@ -13066,7 +13325,7 @@ async def route_from_har(
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
-        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        using request interception by setting `serviceWorkers` to `'block'`.
 
         Parameters
         ----------
@@ -13616,11 +13875,10 @@ async def new_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
-            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
-
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
+
         Returns
         -------
         BrowserContext
@@ -13842,11 +14100,10 @@ async def new_page(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
-            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
-
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
+
         Returns
         -------
         Page
@@ -14402,11 +14659,10 @@ async def launch_persistent_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
-            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
-
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
+
         Returns
         -------
         BrowserContext
@@ -14733,8 +14989,8 @@ async def start(
         ----------
         name : Union[str, None]
             If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the
-            `tracesDir` folder specified in `browser_type.launch()`. To specify the final trace zip file name, you need
-            to pass `path` option to `tracing.stop()` instead.
+            `tracesDir` directory specified in `browser_type.launch()`. To specify the final trace zip file name, you
+            need to pass `path` option to `tracing.stop()` instead.
         title : Union[str, None]
             Trace name to be shown in the Trace Viewer.
         snapshots : Union[bool, None]
@@ -14790,8 +15046,8 @@ async def start_chunk(
             Trace name to be shown in the Trace Viewer.
         name : Union[str, None]
             If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the
-            `tracesDir` folder specified in `browser_type.launch()`. To specify the final trace zip file name, you need
-            to pass `path` option to `tracing.stop_chunk()` instead.
+            `tracesDir` directory specified in `browser_type.launch()`. To specify the final trace zip file name, you
+            need to pass `path` option to `tracing.stop_chunk()` instead.
         """
 
         return mapping.from_maybe_impl(
@@ -15082,7 +15338,9 @@ async def click(
             Deprecated: This option will default to `true` in the future.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15154,7 +15412,9 @@ async def dblclick(
             Deprecated: This option has no effect.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15793,6 +16053,7 @@ def get_by_role(
 
             **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
 
@@ -16131,7 +16392,10 @@ def filter(
     def or_(self, locator: "Locator") -> "Locator":
         """Locator.or_
 
-        Creates a locator that matches either of the two locators.
+        Creates a locator matching all elements that match one or both of the two locators.
+
+        Note that when both locators match something, the resulting locator will have multiple matches and violate
+        [locator strictness](https://playwright.dev/python/docs/locators#strictness) guidelines.
 
         **Usage**
 
@@ -16219,9 +16483,13 @@ async def all(self) -> typing.List["Locator"]:
         elements.
 
         **NOTE** `locator.all()` does not wait for elements to match the locator, and instead immediately returns
-        whatever is present in the page.  When the list of elements changes dynamically, `locator.all()` will
-        produce unpredictable and flaky results.  When the list of elements is stable, but loaded dynamically, wait for the
-        full list to finish loading before calling `locator.all()`.
+        whatever is present in the page.
+
+        When the list of elements changes dynamically, `locator.all()` will produce unpredictable and flaky
+        results.
+
+        When the list of elements is stable, but loaded dynamically, wait for the full list to finish loading before
+        calling `locator.all()`.
 
         **Usage**
 
@@ -16408,7 +16676,9 @@ async def hover(
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -17086,7 +17356,9 @@ async def tap(
             Deprecated: This option has no effect.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -18147,7 +18419,7 @@ async def fetch(
         ```
 
         The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
-        encoding. Use `FormData` to construct request body and pass it to the request as `multipart` parameter:
+        encoding, by specifiying the `multipart` parameter:
 
         Parameters
         ----------
@@ -18295,11 +18567,10 @@ async def new_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
-            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
-
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
+
         Returns
         -------
         APIRequestContext
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index e326fd9f5..80eaf71db 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -61,6 +61,7 @@
     Touchscreen,
     Video,
     WebSocket,
+    WebSocketRoute,
     Worker,
 )
 
@@ -190,5 +191,6 @@ def __call__(
     "Video",
     "ViewportSize",
     "WebSocket",
+    "WebSocketRoute",
     "Worker",
 ]
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 1553c2598..773c763dd 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -69,6 +69,7 @@
 from playwright._impl._network import Response as ResponseImpl
 from playwright._impl._network import Route as RouteImpl
 from playwright._impl._network import WebSocket as WebSocketImpl
+from playwright._impl._network import WebSocketRoute as WebSocketRouteImpl
 from playwright._impl._page import Page as PageImpl
 from playwright._impl._page import Worker as WorkerImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
@@ -1142,6 +1143,133 @@ def is_closed(self) -> bool:
 mapping.register(WebSocketImpl, WebSocket)
 
 
+class WebSocketRoute(SyncBase):
+
+    @property
+    def url(self) -> str:
+        """WebSocketRoute.url
+
+        URL of the WebSocket created in the page.
+
+        Returns
+        -------
+        str
+        """
+        return mapping.from_maybe_impl(self._impl_obj.url)
+
+    def close(
+        self, *, code: typing.Optional[int] = None, reason: typing.Optional[str] = None
+    ) -> None:
+        """WebSocketRoute.close
+
+        Closes one side of the WebSocket connection.
+
+        Parameters
+        ----------
+        code : Union[int, None]
+            Optional [close code](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#code).
+        reason : Union[str, None]
+            Optional [close reason](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#reason).
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.close(code=code, reason=reason))
+        )
+
+    def connect_to_server(self) -> "WebSocketRoute":
+        """WebSocketRoute.connect_to_server
+
+        By default, routed WebSocket does not connect to the server, so you can mock entire WebSocket communication. This
+        method connects to the actual WebSocket server, and returns the server-side `WebSocketRoute` instance, giving the
+        ability to send and receive messages from the server.
+
+        Once connected to the server:
+        - Messages received from the server will be **automatically forwarded** to the WebSocket in the page, unless
+          `web_socket_route.on_message()` is called on the server-side `WebSocketRoute`.
+        - Messages sent by the [`WebSocket.send()`](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/send) call
+          in the page will be **automatically forwarded** to the server, unless `web_socket_route.on_message()` is
+          called on the original `WebSocketRoute`.
+
+        See examples at the top for more details.
+
+        Returns
+        -------
+        WebSocketRoute
+        """
+
+        return mapping.from_impl(self._impl_obj.connect_to_server())
+
+    def send(self, message: typing.Union[str, bytes]) -> None:
+        """WebSocketRoute.send
+
+        Sends a message to the WebSocket. When called on the original WebSocket, sends the message to the page. When called
+        on the result of `web_socket_route.connect_to_server()`, sends the message to the server. See examples at the
+        top for more details.
+
+        Parameters
+        ----------
+        message : Union[bytes, str]
+            Message to send.
+        """
+
+        return mapping.from_maybe_impl(self._impl_obj.send(message=message))
+
+    def on_message(
+        self, handler: typing.Callable[[typing.Union[str, bytes]], typing.Any]
+    ) -> None:
+        """WebSocketRoute.on_message
+
+        This method allows to handle messages that are sent by the WebSocket, either from the page or from the server.
+
+        When called on the original WebSocket route, this method handles messages sent from the page. You can handle this
+        messages by responding to them with `web_socket_route.send()`, forwarding them to the server-side connection
+        returned by `web_socket_route.connect_to_server()` or do something else.
+
+        Once this method is called, messages are not automatically forwarded to the server or to the page - you should do
+        that manually by calling `web_socket_route.send()`. See examples at the top for more details.
+
+        Calling this method again will override the handler with a new one.
+
+        Parameters
+        ----------
+        handler : Callable[[Union[bytes, str]], Any]
+            Function that will handle messages.
+        """
+
+        return mapping.from_maybe_impl(
+            self._impl_obj.on_message(handler=self._wrap_handler(handler))
+        )
+
+    def on_close(
+        self,
+        handler: typing.Callable[
+            [typing.Optional[int], typing.Optional[str]], typing.Any
+        ],
+    ) -> None:
+        """WebSocketRoute.on_close
+
+        Allows to handle [`WebSocket.close`](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close).
+
+        By default, closing one side of the connection, either in the page or on the server, will close the other side.
+        However, when `web_socket_route.on_close()` handler is set up, the default forwarding of closure is disabled,
+        and handler should take care of it.
+
+        Parameters
+        ----------
+        handler : Callable[[Union[int, None], Union[str, None]], Any]
+            Function that will handle WebSocket closure. Received an optional
+            [close code](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#code) and an optional
+            [close reason](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/close#reason).
+        """
+
+        return mapping.from_maybe_impl(
+            self._impl_obj.on_close(handler=self._wrap_handler(handler))
+        )
+
+
+mapping.register(WebSocketRouteImpl, WebSocketRoute)
+
+
 class Keyboard(SyncBase):
 
     def down(self, key: str) -> None:
@@ -4291,7 +4419,9 @@ def click(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4372,7 +4502,9 @@ def dblclick(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4445,7 +4577,9 @@ def tap(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -4848,6 +4982,7 @@ def get_by_role(
 
             **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
 
@@ -5297,7 +5432,9 @@ def hover(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -6016,7 +6153,7 @@ def owner(self) -> "Locator":
         **Usage**
 
         ```py
-        frame_locator = page.frame_locator(\"iframe[name=\\\"embedded\\\"]\")
+        frame_locator = page.locator(\"iframe[name=\\\"embedded\\\"]\").content_frame
         # ...
         locator = frame_locator.owner
         expect(locator).to_be_visible()
@@ -6354,6 +6491,7 @@ def get_by_role(
 
             **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
 
@@ -9131,6 +9269,28 @@ def go_forward(
             self._sync(self._impl_obj.go_forward(timeout=timeout, waitUntil=wait_until))
         )
 
+    def request_gc(self) -> None:
+        """Page.request_gc
+
+        Request the page to perform garbage collection. Note that there is no guarantee that all unreachable objects will
+        be collected.
+
+        This is useful to help detect memory leaks. For example, if your page has a large object `'suspect'` that might be
+        leaked, you can check that it does not leak by using a
+        [`WeakRef`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakRef).
+
+        ```py
+        # 1. In your page, save a WeakRef for the \"suspect\".
+        page.evaluate(\"globalThis.suspectWeakRef = new WeakRef(suspect)\")
+        # 2. Request garbage collection.
+        page.request_gc()
+        # 3. Check that weak ref does not deref to the original object.
+        assert page.evaluate(\"!globalThis.suspectWeakRef.deref()\")
+        ```
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.request_gc()))
+
     def emulate_media(
         self,
         *,
@@ -9301,7 +9461,7 @@ def route(
 
         **NOTE** `page.route()` will not intercept requests intercepted by Service Worker. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
-        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        using request interception by setting `serviceWorkers` to `'block'`.
 
         **NOTE** `page.route()` will not intercept the first request of a popup page. Use
         `browser_context.route()` instead.
@@ -9398,6 +9558,51 @@ def unroute(
             )
         )
 
+    def route_web_socket(
+        self,
+        url: typing.Union[str, typing.Pattern[str], typing.Callable[[str], bool]],
+        handler: typing.Callable[["WebSocketRoute"], typing.Any],
+    ) -> None:
+        """Page.route_web_socket
+
+        This method allows to modify websocket connections that are made by the page.
+
+        Note that only `WebSocket`s created after this method was called will be routed. It is recommended to call this
+        method before navigating the page.
+
+        **Usage**
+
+        Below is an example of a simple mock that responds to a single message. See `WebSocketRoute` for more details and
+        examples.
+
+        ```py
+        def message_handler(ws: WebSocketRoute, message: Union[str, bytes]):
+          if message == \"request\":
+            ws.send(\"response\")
+
+        def handler(ws: WebSocketRoute):
+          ws.on_message(lambda message: message_handler(ws, message))
+
+        page.route_web_socket(\"/ws\", handler)
+        ```
+
+        Parameters
+        ----------
+        url : Union[Callable[[str], bool], Pattern[str], str]
+            Only WebSockets with the url matching this pattern will be routed. A string pattern can be relative to the
+            `baseURL` context option.
+        handler : Callable[[WebSocketRoute], Any]
+            Handler function to route the WebSocket.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.route_web_socket(
+                    url=self._wrap_handler(url), handler=self._wrap_handler(handler)
+                )
+            )
+        )
+
     def unroute_all(
         self,
         *,
@@ -9439,7 +9644,7 @@ def route_from_har(
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
-        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        using request interception by setting `serviceWorkers` to `'block'`.
 
         Parameters
         ----------
@@ -9688,7 +9893,9 @@ def click(
             Deprecated: This option will default to `true` in the future.
         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.
+            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.
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
@@ -9771,7 +9978,9 @@ def dblclick(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -9844,7 +10053,9 @@ def tap(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -10245,6 +10456,7 @@ def get_by_role(
 
             **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
 
@@ -10694,7 +10906,9 @@ def hover(
             element, the call throws an exception.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -11339,8 +11553,7 @@ def pause(self) -> None:
         User can inspect selectors or perform manual steps while paused. Resume will continue running the original script
         from the place it was paused.
 
-        **NOTE** This method requires Playwright to be started in a headed mode, with a falsy `headless` value in the
-        `browser_type.launch()`.
+        **NOTE** This method requires Playwright to be started in a headed mode, with a falsy `headless` option.
         """
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.pause()))
@@ -12005,13 +12218,16 @@ def add_locator_handler(
 
         **NOTE** Running the handler will alter your page state mid-test. For example it will change the currently focused
         element and move the mouse. Make sure that actions that run after the handler are self-contained and do not rely on
-        the focus and mouse state being unchanged. <br /> <br /> For example, consider a test that calls
-        `locator.focus()` followed by `keyboard.press()`. If your handler clicks a button between these two
-        actions, the focused element most likely will be wrong, and key press will happen on the unexpected element. Use
-        `locator.press()` instead to avoid this problem. <br /> <br /> Another example is a series of mouse
-        actions, where `mouse.move()` is followed by `mouse.down()`. Again, when the handler runs between
-        these two actions, the mouse position will be wrong during the mouse down. Prefer self-contained actions like
-        `locator.click()` that do not rely on the state being unchanged by a handler.
+        the focus and mouse state being unchanged.
+
+        For example, consider a test that calls `locator.focus()` followed by `keyboard.press()`. If your
+        handler clicks a button between these two actions, the focused element most likely will be wrong, and key press
+        will happen on the unexpected element. Use `locator.press()` instead to avoid this problem.
+
+        Another example is a series of mouse actions, where `mouse.move()` is followed by `mouse.down()`.
+        Again, when the handler runs between these two actions, the mouse position will be wrong during the mouse down.
+        Prefer self-contained actions like `locator.click()` that do not rely on the state being unchanged by a
+        handler.
 
         **Usage**
 
@@ -12956,7 +13172,7 @@ def route(
 
         **NOTE** `browser_context.route()` will not intercept requests intercepted by Service Worker. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
-        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        using request interception by setting `serviceWorkers` to `'block'`.
 
         **Usage**
 
@@ -13055,6 +13271,53 @@ def unroute(
             )
         )
 
+    def route_web_socket(
+        self,
+        url: typing.Union[str, typing.Pattern[str], typing.Callable[[str], bool]],
+        handler: typing.Callable[["WebSocketRoute"], typing.Any],
+    ) -> None:
+        """BrowserContext.route_web_socket
+
+        This method allows to modify websocket connections that are made by any page in the browser context.
+
+        Note that only `WebSocket`s created after this method was called will be routed. It is recommended to call this
+        method before creating any pages.
+
+        **Usage**
+
+        Below is an example of a simple handler that blocks some websocket messages. See `WebSocketRoute` for more details
+        and examples.
+
+        ```py
+        def message_handler(ws: WebSocketRoute, message: Union[str, bytes]):
+          if message == \"to-be-blocked\":
+            return
+          ws.send(message)
+
+        def handler(ws: WebSocketRoute):
+          ws.route_send(lambda message: message_handler(ws, message))
+          ws.connect()
+
+        context.route_web_socket(\"/ws\", handler)
+        ```
+
+        Parameters
+        ----------
+        url : Union[Callable[[str], bool], Pattern[str], str]
+            Only WebSockets with the url matching this pattern will be routed. A string pattern can be relative to the
+            `baseURL` context option.
+        handler : Callable[[WebSocketRoute], Any]
+            Handler function to route the WebSocket.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.route_web_socket(
+                    url=self._wrap_handler(url), handler=self._wrap_handler(handler)
+                )
+            )
+        )
+
     def unroute_all(
         self,
         *,
@@ -13096,7 +13359,7 @@ def route_from_har(
 
         Playwright will not serve requests intercepted by Service Worker from the HAR file. See
         [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when
-        using request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+        using request interception by setting `serviceWorkers` to `'block'`.
 
         Parameters
         ----------
@@ -13648,11 +13911,10 @@ def new_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
-            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
-
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
+
         Returns
         -------
         BrowserContext
@@ -13876,11 +14138,10 @@ def new_page(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
-            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
-
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
+
         Returns
         -------
         Page
@@ -14442,11 +14703,10 @@ def launch_persistent_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
-            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
-
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
+
         Returns
         -------
         BrowserContext
@@ -14776,8 +15036,8 @@ def start(
         ----------
         name : Union[str, None]
             If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the
-            `tracesDir` folder specified in `browser_type.launch()`. To specify the final trace zip file name, you need
-            to pass `path` option to `tracing.stop()` instead.
+            `tracesDir` directory specified in `browser_type.launch()`. To specify the final trace zip file name, you
+            need to pass `path` option to `tracing.stop()` instead.
         title : Union[str, None]
             Trace name to be shown in the Trace Viewer.
         snapshots : Union[bool, None]
@@ -14835,8 +15095,8 @@ def start_chunk(
             Trace name to be shown in the Trace Viewer.
         name : Union[str, None]
             If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the
-            `tracesDir` folder specified in `browser_type.launch()`. To specify the final trace zip file name, you need
-            to pass `path` option to `tracing.stop_chunk()` instead.
+            `tracesDir` directory specified in `browser_type.launch()`. To specify the final trace zip file name, you
+            need to pass `path` option to `tracing.stop_chunk()` instead.
         """
 
         return mapping.from_maybe_impl(
@@ -15129,7 +15389,9 @@ def click(
             Deprecated: This option will default to `true` in the future.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15203,7 +15465,9 @@ def dblclick(
             Deprecated: This option has no effect.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -15856,6 +16120,7 @@ def get_by_role(
 
             **NOTE** Unlike most other attributes, `disabled` is inherited through the DOM hierarchy. Learn more about
             [`aria-disabled`](https://www.w3.org/TR/wai-aria-1.2/#aria-disabled).
+
         expanded : Union[bool, None]
             An attribute that is usually set by `aria-expanded`.
 
@@ -16195,7 +16460,10 @@ def filter(
     def or_(self, locator: "Locator") -> "Locator":
         """Locator.or_
 
-        Creates a locator that matches either of the two locators.
+        Creates a locator matching all elements that match one or both of the two locators.
+
+        Note that when both locators match something, the resulting locator will have multiple matches and violate
+        [locator strictness](https://playwright.dev/python/docs/locators#strictness) guidelines.
 
         **Usage**
 
@@ -16285,9 +16553,13 @@ def all(self) -> typing.List["Locator"]:
         elements.
 
         **NOTE** `locator.all()` does not wait for elements to match the locator, and instead immediately returns
-        whatever is present in the page.  When the list of elements changes dynamically, `locator.all()` will
-        produce unpredictable and flaky results.  When the list of elements is stable, but loaded dynamically, wait for the
-        full list to finish loading before calling `locator.all()`.
+        whatever is present in the page.
+
+        When the list of elements changes dynamically, `locator.all()` will produce unpredictable and flaky
+        results.
+
+        When the list of elements is stable, but loaded dynamically, wait for the full list to finish loading before
+        calling `locator.all()`.
 
         **Usage**
 
@@ -16476,7 +16748,9 @@ def hover(
             Whether to bypass the [actionability](../actionability.md) checks. Defaults to `false`.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -17178,7 +17452,9 @@ def tap(
             Deprecated: This option has no effect.
         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.
+            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.
         """
 
         return mapping.from_maybe_impl(
@@ -18255,7 +18531,7 @@ def fetch(
         JSON objects can be passed directly to the request:
 
         The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data`
-        encoding. Use `FormData` to construct request body and pass it to the request as `multipart` parameter:
+        encoding, by specifiying the `multipart` parameter:
 
         ```python
         api_request_context.fetch(
@@ -18417,11 +18693,10 @@ def new_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
-            **NOTE** Using Client Certificates in combination with Proxy Servers is not supported.
-
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
+
         Returns
         -------
         APIRequestContext
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 9acbe6c7d..608c4319d 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -132,7 +132,11 @@ def print_entry(
         doc_is_property = (
             not method.get("async") and not len(method["args"]) and "type" in method
         )
-        if method["name"].startswith("is_") or method["name"].startswith("as_"):
+        if (
+            method["name"].startswith("is_")
+            or method["name"].startswith("as_")
+            or method["name"] == "connect_to_server"
+        ):
             doc_is_property = False
         if doc_is_property != is_property:
             self.errors.add(f"Method vs property mismatch: {fqname}")
diff --git a/scripts/expected_api_mismatch.txt b/scripts/expected_api_mismatch.txt
index c101bba16..c6b3c7a95 100644
--- a/scripts/expected_api_mismatch.txt
+++ b/scripts/expected_api_mismatch.txt
@@ -15,3 +15,8 @@ Parameter type mismatch in Page.unroute(handler=): documented as Union[Callable[
 
 # One vs two arguments in the callback, Python explicitly unions.
 Parameter type mismatch in Page.add_locator_handler(handler=): documented as Callable[[Locator], Any], code has Union[Callable[[Locator], Any], Callable[[], Any]]
+
+Parameter type mismatch in BrowserContext.route_web_socket(handler=): documented as Callable[[WebSocketRoute], Union[Any, Any]], code has Callable[[WebSocketRoute], Any]
+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]
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index 7966dbc25..e609dae73 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -40,7 +40,13 @@
 from playwright._impl._input import Keyboard, Mouse, Touchscreen
 from playwright._impl._js_handle import JSHandle, Serializable
 from playwright._impl._locator import FrameLocator, Locator
-from playwright._impl._network import Request, Response, Route, WebSocket
+from playwright._impl._network import (
+    Request,
+    Response,
+    Route,
+    WebSocket,
+    WebSocketRoute,
+)
 from playwright._impl._page import Page, Worker
 from playwright._impl._playwright import Playwright
 from playwright._impl._selectors import Selectors
@@ -233,7 +239,7 @@ def return_value(value: Any) -> List[str]:
 from playwright._impl._frame import Frame as FrameImpl
 from playwright._impl._input import Keyboard as KeyboardImpl, Mouse as MouseImpl, Touchscreen as TouchscreenImpl
 from playwright._impl._js_handle import JSHandle as JSHandleImpl
-from playwright._impl._network import Request as RequestImpl, Response as ResponseImpl, Route as RouteImpl, WebSocket as WebSocketImpl
+from playwright._impl._network import Request as RequestImpl, Response as ResponseImpl, Route as RouteImpl, WebSocket as WebSocketImpl, WebSocketRoute as WebSocketRouteImpl
 from playwright._impl._page import Page as PageImpl, Worker as WorkerImpl
 from playwright._impl._web_error import WebError as WebErrorImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
@@ -252,6 +258,7 @@ def return_value(value: Any) -> List[str]:
     Response,
     Route,
     WebSocket,
+    WebSocketRoute,
     Keyboard,
     Mouse,
     Touchscreen,
diff --git a/setup.py b/setup.py
index 97fc4c5d2..8a67ab2c8 100644
--- a/setup.py
+++ b/setup.py
@@ -30,7 +30,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.47.0-beta-1726138322000"
+driver_version = "1.48.1"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index de4a2f5e9..fb34fb75b 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -264,7 +264,7 @@ async def test_goto_should_fail_when_main_resources_failed_to_load(
     if is_chromium:
         assert "net::ERR_CONNECTION_REFUSED" in exc_info.value.message
     elif is_webkit and is_win:
-        assert "Couldn't connect to server" in exc_info.value.message
+        assert "Could not connect to server" in exc_info.value.message
     elif is_webkit:
         assert "Could not connect" in exc_info.value.message
     else:
diff --git a/tests/async/test_page_request_gc.py b/tests/async/test_page_request_gc.py
new file mode 100644
index 000000000..7d0cce9ef
--- /dev/null
+++ b/tests/async/test_page_request_gc.py
@@ -0,0 +1,34 @@
+# 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.async_api import Page
+from tests.server import Server
+
+
+async def test_should_work(page: Page, server: Server) -> None:
+    await page.evaluate(
+        """() => {
+        globalThis.objectToDestroy = { hello: 'world' };
+        globalThis.weakRef = new WeakRef(globalThis.objectToDestroy);
+    }"""
+    )
+    await page.request_gc()
+    assert await page.evaluate("() => globalThis.weakRef.deref()") == {"hello": "world"}
+
+    await page.request_gc()
+    assert await page.evaluate("() => globalThis.weakRef.deref()") == {"hello": "world"}
+
+    await page.evaluate("() => globalThis.objectToDestroy = null")
+    await page.request_gc()
+    assert await page.evaluate("() => globalThis.weakRef.deref()") is None
diff --git a/tests/async/test_route_web_socket.py b/tests/async/test_route_web_socket.py
new file mode 100644
index 000000000..4996aff60
--- /dev/null
+++ b/tests/async/test_route_web_socket.py
@@ -0,0 +1,321 @@
+# 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 re
+from typing import Any, Awaitable, Callable, Literal, Tuple, Union
+
+from playwright.async_api import Frame, Page, WebSocketRoute
+from tests.server import Server, WebSocketProtocol
+
+
+async def assert_equal(
+    actual_cb: Callable[[], Union[Any, Awaitable[Any]]], expected: Any
+) -> None:
+    __tracebackhide__ = True
+    start_time = asyncio.get_event_loop().time()
+    attempts = 0
+    while True:
+        actual = actual_cb()
+        if asyncio.iscoroutine(actual):
+            actual = await actual
+        if actual == expected:
+            return
+        attempts += 1
+        if asyncio.get_event_loop().time() - start_time > 5:
+            raise TimeoutError(f"Timed out after 10 seconds. Last actual was: {actual}")
+        await asyncio.sleep(0.2)
+
+
+async def setup_ws(
+    target: Union[Page, Frame],
+    port: int,
+    protocol: Union[Literal["blob"], Literal["arraybuffer"]],
+) -> None:
+    await target.goto("about:blank")
+    await target.evaluate(
+        """({ port, binaryType }) => {
+    window.log = [];
+    window.ws = new WebSocket('ws://localhost:' + port + '/ws');
+    window.ws.binaryType = binaryType;
+    window.ws.addEventListener('open', () => window.log.push('open'));
+    window.ws.addEventListener('close', event => window.log.push(`close code=${event.code} reason=${event.reason} wasClean=${event.wasClean}`));
+    window.ws.addEventListener('error', event => window.log.push(`error`));
+    window.ws.addEventListener('message', async event => {
+      let data;
+      if (typeof event.data === 'string')
+        data = event.data;
+      else if (event.data instanceof Blob)
+        data = 'blob:' + await event.data.text();
+      else
+        data = 'arraybuffer:' + await (new Blob([event.data])).text();
+      window.log.push(`message: data=${data} origin=${event.origin} lastEventId=${event.lastEventId}`);
+    });
+    window.wsOpened = new Promise(f => window.ws.addEventListener('open', () => f()));
+  }""",
+        {"port": port, "binaryType": protocol},
+    )
+
+
+async def test_should_work_with_ws_close(page: Page, server: Server) -> None:
+    future: asyncio.Future[WebSocketRoute] = asyncio.Future()
+
+    def _handle_ws(ws: WebSocketRoute) -> None:
+        ws.connect_to_server()
+        future.set_result(ws)
+
+    await page.route_web_socket(re.compile(".*"), _handle_ws)
+
+    ws_task = server.wait_for_web_socket()
+    await setup_ws(page, server.PORT, "blob")
+    ws = await ws_task
+
+    route = await future
+    route.send("hello")
+    await assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=hello origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
+
+    closed_promise: asyncio.Future[Tuple[int, str]] = asyncio.Future()
+    ws.events.once(
+        "close", lambda code, reason: closed_promise.set_result((code, reason))
+    )
+    await route.close(code=3009, reason="oops")
+    await assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=hello origin=ws://localhost:{server.PORT} lastEventId=",
+            "close code=3009 reason=oops wasClean=true",
+        ],
+    )
+    assert await closed_promise == (3009, "oops")
+
+
+async def test_should_pattern_match(page: Page, server: Server) -> None:
+    await page.route_web_socket(
+        re.compile(r".*/ws$"), lambda ws: ws.connect_to_server()
+    )
+    await page.route_web_socket(
+        "**/mock-ws", lambda ws: ws.on_message(lambda message: ws.send("mock-response"))
+    )
+
+    ws_task = server.wait_for_web_socket()
+    await page.goto("about:blank")
+    await page.evaluate(
+        """async ({ port }) => {
+        window.log = [];
+        window.ws1 = new WebSocket('ws://localhost:' + port + '/ws');
+        window.ws1.addEventListener('message', event => window.log.push(`ws1:${event.data}`));
+        window.ws2 = new WebSocket('ws://localhost:' + port + '/something/something/mock-ws');
+        window.ws2.addEventListener('message', event => window.log.push(`ws2:${event.data}`));
+        await Promise.all([
+            new Promise(f => window.ws1.addEventListener('open', f)),
+            new Promise(f => window.ws2.addEventListener('open', f)),
+        ]);
+    }""",
+        {"port": server.PORT},
+    )
+
+    ws = await ws_task
+    ws.events.on("message", lambda payload, isBinary: ws.sendMessage(b"response"))
+
+    await page.evaluate("window.ws1.send('request')")
+    await assert_equal(lambda: page.evaluate("window.log"), ["ws1:response"])
+
+    await page.evaluate("window.ws2.send('request')")
+    await assert_equal(
+        lambda: page.evaluate("window.log"), ["ws1:response", "ws2:mock-response"]
+    )
+
+
+async def test_should_work_with_server(page: Page, server: Server) -> None:
+    future: asyncio.Future[WebSocketRoute] = asyncio.Future()
+
+    async def _handle_ws(ws: WebSocketRoute) -> None:
+        server = ws.connect_to_server()
+
+        def _ws_on_message(message: Union[str, bytes]) -> None:
+            if message == "to-respond":
+                ws.send("response")
+                return
+            if message == "to-block":
+                return
+            if message == "to-modify":
+                server.send("modified")
+                return
+            server.send(message)
+
+        ws.on_message(_ws_on_message)
+
+        def _server_on_message(message: Union[str, bytes]) -> None:
+            if message == "to-block":
+                return
+            if message == "to-modify":
+                ws.send("modified")
+                return
+            ws.send(message)
+
+        server.on_message(_server_on_message)
+        server.send("fake")
+        future.set_result(ws)
+
+    await page.route_web_socket(re.compile(".*"), _handle_ws)
+    ws_task = server.wait_for_web_socket()
+    log = []
+
+    def _once_web_socket_connection(ws: WebSocketProtocol) -> None:
+        ws.events.on(
+            "message", lambda data, is_binary: log.append(f"message: {data.decode()}")
+        )
+        ws.events.on(
+            "close",
+            lambda code, reason: log.append(f"close: code={code} reason={reason}"),
+        )
+
+    server.once_web_socket_connection(_once_web_socket_connection)
+
+    await setup_ws(page, server.PORT, "blob")
+    ws = await ws_task
+    await assert_equal(lambda: log, ["message: fake"])
+
+    ws.sendMessage(b"to-modify")
+    ws.sendMessage(b"to-block")
+    ws.sendMessage(b"pass-server")
+    await assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=modified origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=pass-server origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
+
+    await page.evaluate(
+        """() => {
+        window.ws.send('to-respond');
+        window.ws.send('to-modify');
+        window.ws.send('to-block');
+        window.ws.send('pass-client');
+    }"""
+    )
+    await assert_equal(
+        lambda: log, ["message: fake", "message: modified", "message: pass-client"]
+    )
+    await assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=modified origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=pass-server origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
+
+    route = await future
+    route.send("another")
+    await assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=modified origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=pass-server origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=another origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
+
+    await page.evaluate(
+        """() => {
+        window.ws.send('pass-client-2');
+    }"""
+    )
+    await assert_equal(
+        lambda: log,
+        [
+            "message: fake",
+            "message: modified",
+            "message: pass-client",
+            "message: pass-client-2",
+        ],
+    )
+
+    await page.evaluate(
+        """() => {
+        window.ws.close(3009, 'problem');
+    }"""
+    )
+    await assert_equal(
+        lambda: log,
+        [
+            "message: fake",
+            "message: modified",
+            "message: pass-client",
+            "message: pass-client-2",
+            "close: code=3009 reason=problem",
+        ],
+    )
+
+
+async def test_should_work_without_server(page: Page, server: Server) -> None:
+    future: asyncio.Future[WebSocketRoute] = asyncio.Future()
+
+    async def _handle_ws(ws: WebSocketRoute) -> None:
+        def _ws_on_message(message: Union[str, bytes]) -> None:
+            if message == "to-respond":
+                ws.send("response")
+
+        ws.on_message(_ws_on_message)
+        future.set_result(ws)
+
+    await page.route_web_socket(re.compile(".*"), _handle_ws)
+    await setup_ws(page, server.PORT, "blob")
+
+    await page.evaluate(
+        """async () => {
+        await window.wsOpened;
+        window.ws.send('to-respond');
+        window.ws.send('to-block');
+        window.ws.send('to-respond');
+    }"""
+    )
+
+    await assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
+
+    route = await future
+    route.send("another")
+    # wait for the message to be processed
+    await page.wait_for_timeout(100)
+    await route.close(code=3008, reason="oops")
+    await assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=another origin=ws://localhost:{server.PORT} lastEventId=",
+            "close code=3008 reason=oops wasClean=true",
+        ],
+    )
diff --git a/tests/server.py b/tests/server.py
index f9072d448..89048b0ba 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -32,6 +32,7 @@
     Set,
     Tuple,
     TypeVar,
+    Union,
     cast,
 )
 from urllib.parse import urlparse
@@ -39,6 +40,7 @@
 from autobahn.twisted.resource import WebSocketResource
 from autobahn.twisted.websocket import WebSocketServerFactory, WebSocketServerProtocol
 from OpenSSL import crypto
+from pyee import EventEmitter
 from twisted.internet import reactor as _twisted_reactor
 from twisted.internet import ssl
 from twisted.internet.selectreactor import SelectReactor
@@ -197,6 +199,11 @@ async def wait_for_request(self, path: str) -> TestServerRequest:
         self.request_subscribers[path] = future
         return await future
 
+    def wait_for_web_socket(self) -> 'asyncio.Future["WebSocketProtocol"]':
+        future: asyncio.Future[WebSocketProtocol] = asyncio.Future()
+        self.once_web_socket_connection(future.set_result)
+        return future
+
     @contextlib.contextmanager
     def expect_request(
         self, path: str
@@ -211,6 +218,20 @@ def done_cb(task: asyncio.Task) -> None:
         future.add_done_callback(done_cb)
         yield cb_wrapper
 
+    @contextlib.contextmanager
+    def expect_websocket(
+        self,
+    ) -> Generator[ExpectResponse["WebSocketProtocol"], None, None]:
+        future = self.wait_for_web_socket()
+
+        cb_wrapper: ExpectResponse["WebSocketProtocol"] = ExpectResponse()
+
+        def done_cb(_: asyncio.Future) -> None:
+            cb_wrapper._value = future.result()
+
+        future.add_done_callback(done_cb)
+        yield cb_wrapper
+
     def set_auth(self, path: str, username: str, password: str) -> None:
         self.auth[path] = (username, password)
 
@@ -280,6 +301,21 @@ def listen(self, factory: http.HTTPFactory) -> None:
 
 
 class WebSocketProtocol(WebSocketServerProtocol):
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        super().__init__(*args, **kwargs)
+        self.events = EventEmitter()
+
+    def onClose(self, wasClean: bool, code: int, reason: str) -> None:
+        super().onClose(wasClean, code, reason)
+        self.events.emit(
+            "close",
+            code,
+            reason,
+        )
+
+    def onMessage(self, payload: Union[str, bytes], isBinary: bool) -> None:
+        self.events.emit("message", payload, isBinary)
+
     def onOpen(self) -> None:
         for handler in getattr(self.factory, "server_instance")._ws_handlers.copy():
             getattr(self.factory, "server_instance")._ws_handlers.remove(handler)
diff --git a/tests/sync/test_page_request_gc.py b/tests/sync/test_page_request_gc.py
new file mode 100644
index 000000000..bfddc2320
--- /dev/null
+++ b/tests/sync/test_page_request_gc.py
@@ -0,0 +1,34 @@
+# 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 Page
+from tests.server import Server
+
+
+def test_should_work(page: Page, server: Server) -> None:
+    page.evaluate(
+        """() => {
+        globalThis.objectToDestroy = { hello: 'world' };
+        globalThis.weakRef = new WeakRef(globalThis.objectToDestroy);
+    }"""
+    )
+    page.request_gc()
+    assert page.evaluate("() => globalThis.weakRef.deref()") == {"hello": "world"}
+
+    page.request_gc()
+    assert page.evaluate("() => globalThis.weakRef.deref()") == {"hello": "world"}
+
+    page.evaluate("() => globalThis.objectToDestroy = null")
+    page.request_gc()
+    assert page.evaluate("() => globalThis.weakRef.deref()") is None
diff --git a/tests/sync/test_route_web_socket.py b/tests/sync/test_route_web_socket.py
new file mode 100644
index 000000000..11e509cee
--- /dev/null
+++ b/tests/sync/test_route_web_socket.py
@@ -0,0 +1,316 @@
+# 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 re
+import time
+from typing import Any, Awaitable, Callable, Literal, Optional, Union
+
+from playwright.sync_api import Frame, Page, WebSocketRoute
+from tests.server import Server, WebSocketProtocol
+
+
+def assert_equal(
+    actual_cb: Callable[[], Union[Any, Awaitable[Any]]], expected: Any
+) -> None:
+    __tracebackhide__ = True
+    start_time = time.time()
+    attempts = 0
+    while True:
+        actual = actual_cb()
+        if actual == expected:
+            return
+        attempts += 1
+        if time.time() - start_time > 10:
+            raise TimeoutError(f"Timed out after 10 seconds. Last actual was: {actual}")
+        time.sleep(0.1)
+
+
+def setup_ws(
+    target: Union[Page, Frame],
+    port: int,
+    protocol: Union[Literal["blob"], Literal["arraybuffer"]],
+) -> None:
+    target.goto("about:blank")
+    target.evaluate(
+        """({ port, binaryType }) => {
+    window.log = [];
+    window.ws = new WebSocket('ws://localhost:' + port + '/ws');
+    window.ws.binaryType = binaryType;
+    window.ws.addEventListener('open', () => window.log.push('open'));
+    window.ws.addEventListener('close', event => window.log.push(`close code=${event.code} reason=${event.reason} wasClean=${event.wasClean}`));
+    window.ws.addEventListener('error', event => window.log.push(`error`));
+    window.ws.addEventListener('message', async event => {
+      let data;
+      if (typeof event.data === 'string')
+        data = event.data;
+      else if (event.data instanceof Blob)
+        data = 'blob:' + event.data.text();
+      else
+        data = 'arraybuffer:' + (new Blob([event.data])).text();
+      window.log.push(`message: data=${data} origin=${event.origin} lastEventId=${event.lastEventId}`);
+    });
+    window.wsOpened = new Promise(f => window.ws.addEventListener('open', () => f()));
+  }""",
+        {"port": port, "binaryType": protocol},
+    )
+
+
+def test_should_work_with_ws_close(page: Page, server: Server) -> None:
+    route: Optional["WebSocketRoute"] = None
+
+    def _handle_ws(ws: WebSocketRoute) -> None:
+        ws.connect_to_server()
+        nonlocal route
+        route = ws
+
+    page.route_web_socket(re.compile(".*"), _handle_ws)
+
+    with server.expect_websocket() as ws_task:
+        setup_ws(page, server.PORT, "blob")
+    page.evaluate("window.wsOpened")
+    ws = ws_task.value
+    assert route
+    route.send("hello")
+    assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=hello origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
+
+    closed_event = []
+    ws.events.once("close", lambda code, reason: closed_event.append((code, reason)))
+    route.close(code=3009, reason="oops")
+    assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=hello origin=ws://localhost:{server.PORT} lastEventId=",
+            "close code=3009 reason=oops wasClean=true",
+        ],
+    )
+    assert_equal(lambda: closed_event, [(3009, "oops")])
+
+
+def test_should_pattern_match(page: Page, server: Server) -> None:
+    page.route_web_socket(re.compile(r".*/ws$"), lambda ws: ws.connect_to_server())
+    page.route_web_socket(
+        "**/mock-ws", lambda ws: ws.on_message(lambda message: ws.send("mock-response"))
+    )
+
+    page.goto("about:blank")
+    with server.expect_websocket() as ws_info:
+        page.evaluate(
+            """async ({ port }) => {
+                window.log = [];
+                window.ws1 = new WebSocket('ws://localhost:' + port + '/ws');
+                window.ws1.addEventListener('message', event => window.log.push(`ws1:${event.data}`));
+                window.ws2 = new WebSocket('ws://localhost:' + port + '/something/something/mock-ws');
+                window.ws2.addEventListener('message', event => window.log.push(`ws2:${event.data}`));
+                await Promise.all([
+                    new Promise(f => window.ws1.addEventListener('open', f)),
+                    new Promise(f => window.ws2.addEventListener('open', f)),
+                ]);
+            }""",
+            {"port": server.PORT},
+        )
+    ws = ws_info.value
+    ws.events.on("message", lambda payload, isBinary: ws.sendMessage(b"response"))
+
+    page.evaluate("window.ws1.send('request')")
+    assert_equal(lambda: page.evaluate("window.log"), ["ws1:response"])
+
+    page.evaluate("window.ws2.send('request')")
+    assert_equal(
+        lambda: page.evaluate("window.log"), ["ws1:response", "ws2:mock-response"]
+    )
+
+
+def test_should_work_with_server(page: Page, server: Server) -> None:
+    route = None
+
+    def _handle_ws(ws: WebSocketRoute) -> None:
+        server = ws.connect_to_server()
+
+        def _ws_on_message(message: Union[str, bytes]) -> None:
+            if message == "to-respond":
+                ws.send("response")
+                return
+            if message == "to-block":
+                return
+            if message == "to-modify":
+                server.send("modified")
+                return
+            server.send(message)
+
+        ws.on_message(_ws_on_message)
+
+        def _server_on_message(message: Union[str, bytes]) -> None:
+            if message == "to-block":
+                return
+            if message == "to-modify":
+                ws.send("modified")
+                return
+            ws.send(message)
+
+        server.on_message(_server_on_message)
+        server.send("fake")
+        nonlocal route
+        route = ws
+
+    page.route_web_socket(re.compile(".*"), _handle_ws)
+    log = []
+
+    def _once_web_socket_connection(ws: WebSocketProtocol) -> None:
+        ws.events.on(
+            "message", lambda data, is_binary: log.append(f"message: {data.decode()}")
+        )
+        ws.events.on(
+            "close",
+            lambda code, reason: log.append(f"close: code={code} reason={reason}"),
+        )
+
+    server.once_web_socket_connection(_once_web_socket_connection)
+
+    with server.expect_websocket() as ws_info:
+        setup_ws(page, server.PORT, "blob")
+    page.evaluate("window.wsOpened")
+    ws = ws_info.value
+    assert_equal(lambda: log, ["message: fake"])
+
+    ws.sendMessage(b"to-modify")
+    ws.sendMessage(b"to-block")
+    ws.sendMessage(b"pass-server")
+    assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=modified origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=pass-server origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
+
+    page.evaluate(
+        """() => {
+        window.ws.send('to-respond');
+        window.ws.send('to-modify');
+        window.ws.send('to-block');
+        window.ws.send('pass-client');
+    }"""
+    )
+    assert_equal(
+        lambda: log, ["message: fake", "message: modified", "message: pass-client"]
+    )
+    assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=modified origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=pass-server origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
+    assert route
+    route.send("another")
+    assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=modified origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=pass-server origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=another origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
+
+    page.evaluate(
+        """() => {
+        window.ws.send('pass-client-2');
+    }"""
+    )
+    assert_equal(
+        lambda: log,
+        [
+            "message: fake",
+            "message: modified",
+            "message: pass-client",
+            "message: pass-client-2",
+        ],
+    )
+
+    page.evaluate(
+        """() => {
+        window.ws.close(3009, 'problem');
+    }"""
+    )
+    assert_equal(
+        lambda: log,
+        [
+            "message: fake",
+            "message: modified",
+            "message: pass-client",
+            "message: pass-client-2",
+            "close: code=3009 reason=problem",
+        ],
+    )
+
+
+def test_should_work_without_server(page: Page, server: Server) -> None:
+    route = None
+
+    def _handle_ws(ws: WebSocketRoute) -> None:
+        def _ws_on_message(message: Union[str, bytes]) -> None:
+            if message == "to-respond":
+                ws.send("response")
+
+        ws.on_message(_ws_on_message)
+        nonlocal route
+        route = ws
+
+    page.route_web_socket(re.compile(".*"), _handle_ws)
+    setup_ws(page, server.PORT, "blob")
+
+    page.evaluate(
+        """async () => {
+        await window.wsOpened;
+        window.ws.send('to-respond');
+        window.ws.send('to-block');
+        window.ws.send('to-respond');
+    }"""
+    )
+
+    assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
+    assert route
+    route.send("another")
+    # wait for the message to be processed
+    page.wait_for_timeout(100)
+    route.close(code=3008, reason="oops")
+    assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=response origin=ws://localhost:{server.PORT} lastEventId=",
+            f"message: data=another origin=ws://localhost:{server.PORT} lastEventId=",
+            "close code=3008 reason=oops wasClean=true",
+        ],
+    )

From d32d7c8869330c074e56dcf9c8a1b18afda3cd2a Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 21 Oct 2024 16:59:07 +0200
Subject: [PATCH 272/438] devops: stop publishing Ubuntu 20.04 focal image
 (#2601)

---
 .github/workflows/ci.yml                     |  2 +-
 .github/workflows/test_docker.yml            |  1 -
 .github/workflows/trigger_internal_tests.yml |  2 +-
 utils/docker/Dockerfile.focal                | 49 --------------------
 utils/docker/build.sh                        |  6 +--
 utils/docker/publish_docker.sh               | 22 ++-------
 6 files changed, 9 insertions(+), 73 deletions(-)
 delete mode 100644 utils/docker/Dockerfile.focal

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 1779d3ae7..87bb1317f 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -166,7 +166,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-20.04, macos-13, windows-2019]
+        os: [ubuntu-22.04, macos-13, windows-2019]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v3
diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index 178200f75..7abe9d60a 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -24,7 +24,6 @@ jobs:
       fail-fast: false
       matrix:
         docker-image-variant:
-          - focal
           - jammy
           - noble
     steps:
diff --git a/.github/workflows/trigger_internal_tests.yml b/.github/workflows/trigger_internal_tests.yml
index b4e6c21db..04288d1b0 100644
--- a/.github/workflows/trigger_internal_tests.yml
+++ b/.github/workflows/trigger_internal_tests.yml
@@ -9,7 +9,7 @@ on:
 jobs:
   trigger:
     name: "trigger"
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     steps:
     - run: |
         curl -X POST \
diff --git a/utils/docker/Dockerfile.focal b/utils/docker/Dockerfile.focal
deleted file mode 100644
index 247b58b49..000000000
--- a/utils/docker/Dockerfile.focal
+++ /dev/null
@@ -1,49 +0,0 @@
-FROM ubuntu:focal
-
-ARG DEBIAN_FRONTEND=noninteractive
-ARG TZ=America/Los_Angeles
-ARG DOCKER_IMAGE_NAME_TEMPLATE="mcr.microsoft.com/playwright/python:v%version%-focal"
-
-# === INSTALL Python ===
-
-RUN apt-get update && \
-    # Install Python
-    apt-get install -y python3 python3-distutils curl && \
-    update-alternatives --install /usr/bin/python python /usr/bin/python3 1 && \
-    curl -sSL https://bootstrap.pypa.io/get-pip.py -o get-pip.py && \
-    python get-pip.py && \
-    rm get-pip.py && \
-    # Feature-parity with node.js base images.
-    apt-get install -y --no-install-recommends git openssh-client gpg && \
-    # clean apt cache
-    rm -rf /var/lib/apt/lists/* && \
-    # Create the pwuser
-    adduser pwuser
-
-# === BAKE BROWSERS INTO IMAGE ===
-
-ENV PLAYWRIGHT_BROWSERS_PATH=/ms-playwright
-
-# 1. Add tip-of-tree Playwright package to install its browsers.
-#    The package should be built beforehand from tip-of-tree Playwright.
-COPY ./dist/*-manylinux*.whl /tmp/
-
-# 2. Bake in browsers & deps.
-#    Browsers will be downloaded in `/ms-playwright`.
-#    Note: make sure to set 777 to the registry so that any user can access
-#    registry.
-RUN mkdir /ms-playwright && \
-    mkdir /ms-playwright-agent && \
-    cd /ms-playwright-agent && \
-    pip install virtualenv && \
-    virtualenv venv && \
-    . venv/bin/activate && \
-    # if its amd64 then install the manylinux1_x86_64 pip package
-    if [ "$(uname -m)" = "x86_64" ]; then pip install /tmp/*manylinux1_x86_64*.whl; fi && \
-    # if its arm64 then install the manylinux1_aarch64 pip package
-    if [ "$(uname -m)" = "aarch64" ]; then pip install /tmp/*manylinux_2_17_aarch64*.whl; fi && \
-    playwright mark-docker-image "${DOCKER_IMAGE_NAME_TEMPLATE}" && \
-    playwright install --with-deps && rm -rf /var/lib/apt/lists/* && \
-    rm /tmp/*.whl && \
-    rm -rf /ms-playwright-agent && \
-    chmod -R 777 /ms-playwright
diff --git a/utils/docker/build.sh b/utils/docker/build.sh
index b28a4807a..1a5c62fb9 100755
--- a/utils/docker/build.sh
+++ b/utils/docker/build.sh
@@ -3,12 +3,12 @@ set -e
 set +x
 
 if [[ ($1 == '--help') || ($1 == '-h') || ($1 == '') || ($2 == '') ]]; then
-  echo "usage: $(basename $0) {--arm64,--amd64} {focal,jammy} playwright:localbuild-focal"
+  echo "usage: $(basename $0) {--arm64,--amd64} {jammy,noble} playwright:localbuild-noble"
   echo
-  echo "Build Playwright docker image and tag it as 'playwright:localbuild-focal'."
+  echo "Build Playwright docker image and tag it as 'playwright:localbuild-noble'."
   echo "Once image is built, you can run it with"
   echo ""
-  echo "  docker run --rm -it playwright:localbuild-focal /bin/bash"
+  echo "  docker run --rm -it playwright:localbuild-noble /bin/bash"
   echo ""
   echo "NOTE: this requires on Playwright PIP dependencies to be installed"
   echo ""
diff --git a/utils/docker/publish_docker.sh b/utils/docker/publish_docker.sh
index 309edb63a..3af48306b 100755
--- a/utils/docker/publish_docker.sh
+++ b/utils/docker/publish_docker.sh
@@ -21,11 +21,6 @@ else
   exit 1
 fi
 
-# Ubuntu 20.04
-FOCAL_TAGS=(
-  "v${PW_VERSION}-focal"
-)
-
 # Ubuntu 22.04
 JAMMY_TAGS=(
   "v${PW_VERSION}-jammy"
@@ -69,14 +64,12 @@ install_oras_if_needed() {
 publish_docker_images_with_arch_suffix() {
   local FLAVOR="$1"
   local TAGS=()
-  if [[ "$FLAVOR" == "focal" ]]; then
-    TAGS=("${FOCAL_TAGS[@]}")
-  elif [[ "$FLAVOR" == "jammy" ]]; then
+  if [[ "$FLAVOR" == "jammy" ]]; then
     TAGS=("${JAMMY_TAGS[@]}")
   elif [[ "$FLAVOR" == "noble" ]]; then
     TAGS=("${NOBLE_TAGS[@]}")
   else
-    echo "ERROR: unknown flavor - $FLAVOR. Must be either 'focal', or 'jammy'"
+    echo "ERROR: unknown flavor - $FLAVOR. Must be either 'jammy', or 'noble'"
     exit 1
   fi
   local ARCH="$2"
@@ -97,14 +90,12 @@ publish_docker_images_with_arch_suffix() {
 publish_docker_manifest () {
   local FLAVOR="$1"
   local TAGS=()
-  if [[ "$FLAVOR" == "focal" ]]; then
-    TAGS=("${FOCAL_TAGS[@]}")
-  elif [[ "$FLAVOR" == "jammy" ]]; then
+  if [[ "$FLAVOR" == "jammy" ]]; then
     TAGS=("${JAMMY_TAGS[@]}")
   elif [[ "$FLAVOR" == "noble" ]]; then
     TAGS=("${NOBLE_TAGS[@]}")
   else
-    echo "ERROR: unknown flavor - $FLAVOR. Must be either 'focal', or 'jammy'"
+    echo "ERROR: unknown flavor - $FLAVOR. Must be either 'jammy', or 'noble'"
     exit 1
   fi
 
@@ -123,11 +114,6 @@ publish_docker_manifest () {
   done
 }
 
-# Focal
-publish_docker_images_with_arch_suffix focal amd64
-publish_docker_images_with_arch_suffix focal arm64
-publish_docker_manifest focal amd64 arm64
-
 # Jammy
 publish_docker_images_with_arch_suffix jammy amd64
 publish_docker_images_with_arch_suffix jammy arm64

From 1c07b629ba07b3b693fc106af08ba548fe3d22f5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 21 Oct 2024 20:18:10 +0200
Subject: [PATCH 273/438] build(deps): bump types-requests from 2.32.0.20240914
 to 2.32.0.20241016 (#2602)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 07155ee34..e828693b5 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -20,5 +20,5 @@ service_identity==24.1.0
 setuptools==75.1.0
 twisted==24.7.0
 types-pyOpenSSL==24.1.0.20240722
-types-requests==2.32.0.20240914
+types-requests==2.32.0.20241016
 wheel==0.42.0

From d2586c624996843eeb13d2865e0008add03b8758 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 21 Oct 2024 20:18:24 +0200
Subject: [PATCH 274/438] build(deps): bump mypy from 1.12.0 to 1.12.1 (#2603)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index e828693b5..693b5b5dd 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ autobahn==23.1.2
 black==24.8.0
 flake8==7.1.1
 flaky==3.8.1
-mypy==1.12.0
+mypy==1.12.1
 objgraph==3.6.2
 Pillow==10.4.0
 pixelmatch==0.3.0

From 6c9a36dc41bd5204bd5e800031e0be76a1ccc4c0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 21 Oct 2024 20:18:32 +0200
Subject: [PATCH 275/438] build(deps): bump setuptools from 75.1.0 to 75.2.0
 (#2605)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 693b5b5dd..0095df1bd 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.1.0
-setuptools==75.1.0
+setuptools==75.2.0
 twisted==24.7.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20241016

From 8cb44c5281459fd39a9b33a7c6f9430068c69fc8 Mon Sep 17 00:00:00 2001
From: shettysudhird <shettysudhird@gmail.com>
Date: Thu, 24 Oct 2024 19:27:03 +1100
Subject: [PATCH 276/438] chore: Fix broke CI configuration link (#2613)

---
 CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a5ab7d4bd..b4fe2f71d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -47,7 +47,7 @@ pre-commit install
 pre-commit run --all-files
 ```
 
-For more details look at the [CI configuration](./blob/main/.github/workflows/ci.yml).
+For more details look at the [CI configuration](./.github/workflows/ci.yml).
 
 Collect coverage
 

From 3352d85e4493c4b95de8304d6c16df787058cadd Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 24 Oct 2024 17:00:59 +0200
Subject: [PATCH 277/438] fix: hide page.route calls from traces (#2614)

---
 playwright/_impl/_connection.py  | 23 +++++++++++++++--------
 playwright/_impl/_local_utils.py |  2 +-
 playwright/_impl/_network.py     |  4 ++--
 playwright/_impl/_tracing.py     |  2 +-
 tests/async/test_tracing.py      |  1 -
 tests/sync/test_tracing.py       |  1 -
 6 files changed, 19 insertions(+), 14 deletions(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 95c87deb8..910693f9e 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -54,15 +54,18 @@ def __init__(self, connection: "Connection", object: "ChannelOwner") -> None:
         self._guid = object._guid
         self._object = object
         self.on("error", lambda exc: self._connection._on_event_listener_error(exc))
+        self._is_internal_type = False
 
     async def send(self, method: str, params: Dict = None) -> Any:
         return await self._connection.wrap_api_call(
-            lambda: self.inner_send(method, params, False)
+            lambda: self._inner_send(method, params, False),
+            self._is_internal_type,
         )
 
     async def send_return_as_dict(self, method: str, params: Dict = None) -> Any:
         return await self._connection.wrap_api_call(
-            lambda: self.inner_send(method, params, True)
+            lambda: self._inner_send(method, params, True),
+            self._is_internal_type,
         )
 
     def send_no_reply(self, method: str, params: Dict = None) -> None:
@@ -73,7 +76,7 @@ def send_no_reply(self, method: str, params: Dict = None) -> None:
             )
         )
 
-    async def inner_send(
+    async def _inner_send(
         self, method: str, params: Optional[Dict], return_as_dict: bool
     ) -> Any:
         if params is None:
@@ -108,6 +111,9 @@ async def inner_send(
         key = next(iter(result))
         return result[key]
 
+    def mark_as_internal_type(self) -> None:
+        self._is_internal_type = True
+
 
 class ChannelOwner(AsyncIOEventEmitter):
     def __init__(
@@ -132,7 +138,6 @@ def __init__(
         self._channel: Channel = Channel(self._connection, self)
         self._initializer = initializer
         self._was_collected = False
-        self._is_internal_type = False
 
         self._connection._objects[guid] = self
         if self._parent:
@@ -157,9 +162,6 @@ def _adopt(self, child: "ChannelOwner") -> None:
         self._objects[child._guid] = child
         child._parent = self
 
-    def mark_as_internal_type(self) -> None:
-        self._is_internal_type = True
-
     def _set_event_to_subscription_mapping(self, mapping: Dict[str, str]) -> None:
         self._event_to_subscription_mapping = mapping
 
@@ -359,7 +361,12 @@ def _send_message_to_server(
             "params": self._replace_channels_with_guids(params),
             "metadata": metadata,
         }
-        if self._tracing_count > 0 and frames and not object._is_internal_type:
+        if (
+            self._tracing_count > 0
+            and frames
+            and frames
+            and object._guid != "localUtils"
+        ):
             self.local_utils.add_stack_to_tracing_no_reply(id, frames)
 
         self._transport.send(message)
diff --git a/playwright/_impl/_local_utils.py b/playwright/_impl/_local_utils.py
index 26a3417c4..5ea8b644d 100644
--- a/playwright/_impl/_local_utils.py
+++ b/playwright/_impl/_local_utils.py
@@ -25,7 +25,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self.mark_as_internal_type()
+        self._channel.mark_as_internal_type()
         self.devices = {
             device["name"]: parse_device_descriptor(device["descriptor"])
             for device in initializer["deviceDescriptors"]
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 376b2b8cb..649b89198 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -317,7 +317,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self.mark_as_internal_type()
+        self._channel.mark_as_internal_type()
         self._handling_future: Optional[asyncio.Future["bool"]] = None
         self._context: "BrowserContext" = cast("BrowserContext", None)
         self._did_throw = False
@@ -603,7 +603,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self.mark_as_internal_type()
+        self._channel.mark_as_internal_type()
         self._on_page_message: Optional[Callable[[Union[str, bytes]], Any]] = None
         self._on_page_close: Optional[Callable[[Optional[int], Optional[str]], Any]] = (
             None
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index 5c59b749f..d645e41da 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -25,7 +25,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self.mark_as_internal_type()
+        self._channel.mark_as_internal_type()
         self._include_sources: bool = False
         self._stacks_id: Optional[str] = None
         self._is_tracing: bool = False
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index a9cfdfbcb..027457586 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -119,7 +119,6 @@ async def test_should_collect_trace_with_resources_but_no_js(
         "Page.wait_for_timeout",
         "Page.route",
         "Page.goto",
-        "Route.continue_",
         "Page.goto",
         "Page.close",
     ]
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index eaef24e00..cdf669f4f 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -112,7 +112,6 @@ def test_should_collect_trace_with_resources_but_no_js(
         "Page.wait_for_timeout",
         "Page.route",
         "Page.goto",
-        "Route.continue_",
         "Page.goto",
         "Page.close",
     ]

From 257a6ae9f301bf51a55ba0b2f9476ab00a04406e Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 28 Oct 2024 12:36:22 +0100
Subject: [PATCH 278/438] fix(assertions): error messages from negated matchers
 (#2619)

---
 playwright/_impl/_assertions.py |  31 +++----
 tests/async/test_assertions.py  | 144 ++++++++++++++++++++++++++++++--
 tests/sync/test_assertions.py   |  47 +++++++++--
 3 files changed, 195 insertions(+), 27 deletions(-)

diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 163b156ed..13e7ac481 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -511,15 +511,14 @@ async def to_be_attached(
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
+        if attached is None:
+            attached = True
+        attached_string = "attached" if attached else "detached"
         await self._expect_impl(
-            (
-                "to.be.attached"
-                if (attached is None or attached is True)
-                else "to.be.detached"
-            ),
+            ("to.be.attached" if attached else "to.be.detached"),
             FrameExpectOptions(timeout=timeout),
             None,
-            "Locator expected to be attached",
+            f"Locator expected to be {attached_string}",
         )
 
     async def to_be_checked(
@@ -528,15 +527,14 @@ async def to_be_checked(
         checked: bool = None,
     ) -> None:
         __tracebackhide__ = True
+        if checked is None:
+            checked = True
+        checked_string = "checked" if checked else "unchecked"
         await self._expect_impl(
-            (
-                "to.be.checked"
-                if checked is None or checked is True
-                else "to.be.unchecked"
-            ),
+            ("to.be.checked" if checked else "to.be.unchecked"),
             FrameExpectOptions(timeout=timeout),
             None,
-            "Locator expected to be checked",
+            f"Locator expected to be {checked_string}",
         )
 
     async def not_to_be_attached(
@@ -581,11 +579,12 @@ async def to_be_editable(
         __tracebackhide__ = True
         if editable is None:
             editable = True
+        editable_string = "editable" if editable else "readonly"
         await self._expect_impl(
             "to.be.editable" if editable else "to.be.readonly",
             FrameExpectOptions(timeout=timeout),
             None,
-            "Locator expected to be editable",
+            f"Locator expected to be {editable_string}",
         )
 
     async def not_to_be_editable(
@@ -623,11 +622,12 @@ async def to_be_enabled(
         __tracebackhide__ = True
         if enabled is None:
             enabled = True
+        enabled_string = "enabled" if enabled else "disabled"
         await self._expect_impl(
             "to.be.enabled" if enabled else "to.be.disabled",
             FrameExpectOptions(timeout=timeout),
             None,
-            "Locator expected to be enabled",
+            f"Locator expected to be {enabled_string}",
         )
 
     async def not_to_be_enabled(
@@ -665,11 +665,12 @@ async def to_be_visible(
         __tracebackhide__ = True
         if visible is None:
             visible = True
+        visible_string = "visible" if visible else "hidden"
         await self._expect_impl(
             "to.be.visible" if visible else "to.be.hidden",
             FrameExpectOptions(timeout=timeout),
             None,
-            "Locator expected to be visible",
+            f"Locator expected to be {visible_string}",
         )
 
     async def not_to_be_visible(
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index d61e625c7..88b9c1b4f 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -510,14 +510,14 @@ async def test_assertions_locator_to_be_checked(page: Page, server: Server) -> N
     await page.set_content("<input type=checkbox>")
     my_checkbox = page.locator("input")
     await expect(my_checkbox).not_to_be_checked()
-    with pytest.raises(AssertionError):
+    with pytest.raises(AssertionError, match="Locator expected to be checked"):
         await expect(my_checkbox).to_be_checked(timeout=100)
     await expect(my_checkbox).to_be_checked(timeout=100, checked=False)
     with pytest.raises(AssertionError):
         await expect(my_checkbox).to_be_checked(timeout=100, checked=True)
     await my_checkbox.check()
     await expect(my_checkbox).to_be_checked(timeout=100, checked=True)
-    with pytest.raises(AssertionError):
+    with pytest.raises(AssertionError, match="Locator expected to be unchecked"):
         await expect(my_checkbox).to_be_checked(timeout=100, checked=False)
     await expect(my_checkbox).to_be_checked()
 
@@ -534,19 +534,91 @@ async def test_assertions_locator_to_be_disabled_enabled(
         await expect(my_checkbox).to_be_disabled(timeout=100)
     await my_checkbox.evaluate("e => e.disabled = true")
     await expect(my_checkbox).to_be_disabled()
-    with pytest.raises(AssertionError):
+    with pytest.raises(AssertionError, match="Locator expected to be enabled"):
         await expect(my_checkbox).to_be_enabled(timeout=100)
 
 
+async def test_assertions_locator_to_be_enabled_with_true(page: Page) -> None:
+    await page.set_content("<button>Text</button>")
+    await expect(page.locator("button")).to_be_enabled(enabled=True)
+
+
+async def test_assertions_locator_to_be_enabled_with_false_throws_good_exception(
+    page: Page,
+) -> None:
+    await page.set_content("<button>Text</button>")
+    with pytest.raises(AssertionError, match="Locator expected to be disabled"):
+        await expect(page.locator("button")).to_be_enabled(enabled=False)
+
+
+async def test_assertions_locator_to_be_enabled_with_false(page: Page) -> None:
+    await page.set_content("<button disabled>Text</button>")
+    await expect(page.locator("button")).to_be_enabled(enabled=False)
+
+
+async def test_assertions_locator_to_be_enabled_with_not_and_false(page: Page) -> None:
+    await page.set_content("<button>Text</button>")
+    await expect(page.locator("button")).not_to_be_enabled(enabled=False)
+
+
+async def test_assertions_locator_to_be_enabled_eventually(page: Page) -> None:
+    await page.set_content("<button disabled>Text</button>")
+    await page.eval_on_selector(
+        "button",
+        """
+        button => setTimeout(() => {
+            button.removeAttribute('disabled');
+        }, 700);
+    """,
+    )
+    await expect(page.locator("button")).to_be_enabled()
+
+
+async def test_assertions_locator_to_be_enabled_eventually_with_not(page: Page) -> None:
+    await page.set_content("<button>Text</button>")
+    await page.eval_on_selector(
+        "button",
+        """
+        button => setTimeout(() => {
+            button.setAttribute('disabled', '');
+        }, 700);
+    """,
+    )
+    await expect(page.locator("button")).not_to_be_enabled()
+
+
 async def test_assertions_locator_to_be_editable(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content("<input></input><button disabled>Text</button>")
     await expect(page.locator("button")).not_to_be_editable()
     await expect(page.locator("input")).to_be_editable()
-    with pytest.raises(AssertionError):
+    with pytest.raises(AssertionError, match="Locator expected to be editable"):
         await expect(page.locator("button")).to_be_editable(timeout=100)
 
 
+async def test_assertions_locator_to_be_editable_with_true(page: Page) -> None:
+    await page.set_content("<input></input>")
+    await expect(page.locator("input")).to_be_editable(editable=True)
+
+
+async def test_assertions_locator_to_be_editable_with_false(page: Page) -> None:
+    await page.set_content("<input readonly></input>")
+    await expect(page.locator("input")).to_be_editable(editable=False)
+
+
+async def test_assertions_locator_to_be_editable_with_false_and_throw_good_exception(
+    page: Page,
+) -> None:
+    await page.set_content("<input></input>")
+    with pytest.raises(AssertionError, match="Locator expected to be readonly"):
+        await expect(page.locator("input")).to_be_editable(editable=False)
+
+
+async def test_assertions_locator_to_be_editable_with_not_and_false(page: Page) -> None:
+    await page.set_content("<input></input>")
+    await expect(page.locator("input")).not_to_be_editable(editable=False)
+
+
 async def test_assertions_locator_to_be_empty(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content(
@@ -579,10 +651,59 @@ async def test_assertions_locator_to_be_hidden_visible(
         await expect(my_checkbox).to_be_hidden(timeout=100)
     await my_checkbox.evaluate("e => e.style.display = 'none'")
     await expect(my_checkbox).to_be_hidden()
-    with pytest.raises(AssertionError):
+    with pytest.raises(AssertionError, match="Locator expected to be visible"):
         await expect(my_checkbox).to_be_visible(timeout=100)
 
 
+async def test_assertions_locator_to_be_visible_with_true(page: Page) -> None:
+    await page.set_content("<button>hello</button>")
+    await expect(page.locator("button")).to_be_visible(visible=True)
+
+
+async def test_assertions_locator_to_be_visible_with_false(page: Page) -> None:
+    await page.set_content("<button hidden>hello</button>")
+    await expect(page.locator("button")).to_be_visible(visible=False)
+
+
+async def test_assertions_locator_to_be_visible_with_false_throws_good_exception(
+    page: Page,
+) -> None:
+    await page.set_content("<button>hello</button>")
+    with pytest.raises(AssertionError, match="Locator expected to be hidden"):
+        await expect(page.locator("button")).to_be_visible(visible=False)
+
+
+async def test_assertions_locator_to_be_visible_with_not_and_false(page: Page) -> None:
+    await page.set_content("<button>hello</button>")
+    await expect(page.locator("button")).not_to_be_visible(visible=False)
+
+
+async def test_assertions_locator_to_be_visible_eventually(page: Page) -> None:
+    await page.set_content("<div></div>")
+    await page.eval_on_selector(
+        "div",
+        """
+        div => setTimeout(() => {
+            div.innerHTML = '<span>Hello</span>';
+        }, 700);
+    """,
+    )
+    await expect(page.locator("span")).to_be_visible()
+
+
+async def test_assertions_locator_to_be_visible_eventually_with_not(page: Page) -> None:
+    await page.set_content("<div><span>Hello</span></div>")
+    await page.eval_on_selector(
+        "span",
+        """
+        span => setTimeout(() => {
+            span.textContent = '';
+        }, 700);
+    """,
+    )
+    await expect(page.locator("span")).not_to_be_visible()
+
+
 async def test_assertions_should_serialize_regexp_correctly(
     page: Page, server: Server
 ) -> None:
@@ -746,6 +867,15 @@ async def test_should_be_attached_with_attached_false(page: Page) -> None:
     await expect(locator).to_be_attached(attached=False)
 
 
+async def test_should_be_attached_with_attached_false_and_throw_good_error(
+    page: Page,
+) -> None:
+    await page.set_content("<button>hello</button>")
+    locator = page.locator("button")
+    with pytest.raises(AssertionError, match="Locator expected to be detached"):
+        await expect(locator).to_be_attached(attached=False, timeout=1)
+
+
 async def test_should_be_attached_with_not_and_attached_false(page: Page) -> None:
     await page.set_content("<button>hello</button>")
     locator = page.locator("button")
@@ -773,7 +903,9 @@ async def test_should_be_attached_eventually_with_not(page: Page) -> None:
 async def test_should_be_attached_fail(page: Page) -> None:
     await page.set_content("<button>Hello</button>")
     locator = page.locator("input")
-    with pytest.raises(AssertionError) as exc_info:
+    with pytest.raises(
+        AssertionError, match="Locator expected to be attached"
+    ) as exc_info:
         await expect(locator).to_be_attached(timeout=1000)
     assert "locator resolved to" not in exc_info.value.args[0]
 
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index d7180fc94..6f27e0a25 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -490,14 +490,14 @@ def test_assertions_locator_to_be_checked(page: Page, server: Server) -> None:
     page.set_content("<input type=checkbox>")
     my_checkbox = page.locator("input")
     expect(my_checkbox).not_to_be_checked()
-    with pytest.raises(AssertionError):
+    with pytest.raises(AssertionError, match="Locator expected to be checked"):
         expect(my_checkbox).to_be_checked(timeout=100)
     expect(my_checkbox).to_be_checked(timeout=100, checked=False)
     with pytest.raises(AssertionError):
         expect(my_checkbox).to_be_checked(timeout=100, checked=True)
     my_checkbox.check()
     expect(my_checkbox).to_be_checked(timeout=100, checked=True)
-    with pytest.raises(AssertionError):
+    with pytest.raises(AssertionError, match="Locator expected to be unchecked"):
         expect(my_checkbox).to_be_checked(timeout=100, checked=False)
     expect(my_checkbox).to_be_checked()
 
@@ -512,7 +512,7 @@ def test_assertions_locator_to_be_disabled_enabled(page: Page, server: Server) -
         expect(my_checkbox).to_be_disabled(timeout=100)
     my_checkbox.evaluate("e => e.disabled = true")
     expect(my_checkbox).to_be_disabled()
-    with pytest.raises(AssertionError):
+    with pytest.raises(AssertionError, match="Locator expected to be enabled"):
         expect(my_checkbox).to_be_enabled(timeout=100)
 
 
@@ -521,6 +521,14 @@ def test_assertions_locator_to_be_enabled_with_true(page: Page) -> None:
     expect(page.locator("button")).to_be_enabled(enabled=True)
 
 
+def test_assertions_locator_to_be_enabled_with_false_throws_good_exception(
+    page: Page,
+) -> None:
+    page.set_content("<button>Text</button>")
+    with pytest.raises(AssertionError, match="Locator expected to be disabled"):
+        expect(page.locator("button")).to_be_enabled(enabled=False)
+
+
 def test_assertions_locator_to_be_enabled_with_false(page: Page) -> None:
     page.set_content("<button disabled>Text</button>")
     expect(page.locator("button")).to_be_enabled(enabled=False)
@@ -562,7 +570,7 @@ def test_assertions_locator_to_be_editable(page: Page, server: Server) -> None:
     page.set_content("<input></input><button disabled>Text</button>")
     expect(page.locator("button")).not_to_be_editable()
     expect(page.locator("input")).to_be_editable()
-    with pytest.raises(AssertionError):
+    with pytest.raises(AssertionError, match="Locator expected to be editable"):
         expect(page.locator("button")).to_be_editable(timeout=100)
 
 
@@ -576,6 +584,14 @@ def test_assertions_locator_to_be_editable_with_false(page: Page) -> None:
     expect(page.locator("input")).to_be_editable(editable=False)
 
 
+def test_assertions_locator_to_be_editable_with_false_and_throw_good_exception(
+    page: Page,
+) -> None:
+    page.set_content("<input></input>")
+    with pytest.raises(AssertionError, match="Locator expected to be readonly"):
+        expect(page.locator("input")).to_be_editable(editable=False)
+
+
 def test_assertions_locator_to_be_editable_with_not_and_false(page: Page) -> None:
     page.set_content("<input></input>")
     expect(page.locator("input")).not_to_be_editable(editable=False)
@@ -611,7 +627,7 @@ def test_assertions_locator_to_be_hidden_visible(page: Page, server: Server) ->
         expect(my_checkbox).to_be_hidden(timeout=100)
     my_checkbox.evaluate("e => e.style.display = 'none'")
     expect(my_checkbox).to_be_hidden()
-    with pytest.raises(AssertionError):
+    with pytest.raises(AssertionError, match="Locator expected to be visible"):
         expect(my_checkbox).to_be_visible(timeout=100)
 
 
@@ -625,6 +641,14 @@ def test_assertions_locator_to_be_visible_with_false(page: Page) -> None:
     expect(page.locator("button")).to_be_visible(visible=False)
 
 
+def test_assertions_locator_to_be_visible_with_false_throws_good_exception(
+    page: Page,
+) -> None:
+    page.set_content("<button>hello</button>")
+    with pytest.raises(AssertionError, match="Locator expected to be hidden"):
+        expect(page.locator("button")).to_be_visible(visible=False)
+
+
 def test_assertions_locator_to_be_visible_with_not_and_false(page: Page) -> None:
     page.set_content("<button>hello</button>")
     expect(page.locator("button")).not_to_be_visible(visible=False)
@@ -813,6 +837,15 @@ def test_should_be_attached_with_attached_false(page: Page) -> None:
     expect(locator).to_be_attached(attached=False)
 
 
+def test_should_be_attached_with_attached_false_and_throw_good_error(
+    page: Page,
+) -> None:
+    page.set_content("<button>hello</button>")
+    locator = page.locator("button")
+    with pytest.raises(AssertionError, match="Locator expected to be detached"):
+        expect(locator).to_be_attached(attached=False, timeout=1)
+
+
 def test_should_be_attached_with_not_and_attached_false(page: Page) -> None:
     page.set_content("<button>hello</button>")
     locator = page.locator("button")
@@ -838,7 +871,9 @@ def test_should_be_attached_eventually_with_not(page: Page) -> None:
 def test_should_be_attached_fail(page: Page) -> None:
     page.set_content("<button>Hello</button>")
     locator = page.locator("input")
-    with pytest.raises(AssertionError) as exc_info:
+    with pytest.raises(
+        AssertionError, match="Locator expected to be attached"
+    ) as exc_info:
         expect(locator).to_be_attached(timeout=1000)
     assert "locator resolved to" not in exc_info.value.args[0]
 

From ec79ef27d64ba7e00f4992062df226ed2ae2b2fa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 28 Oct 2024 23:07:29 +0100
Subject: [PATCH 279/438] build(deps): bump mypy from 1.12.1 to 1.13.0 (#2622)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 0095df1bd..9a413b59f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ autobahn==23.1.2
 black==24.8.0
 flake8==7.1.1
 flaky==3.8.1
-mypy==1.12.1
+mypy==1.13.0
 objgraph==3.6.2
 Pillow==10.4.0
 pixelmatch==0.3.0

From 84986c9b0fd57ad472b5ecc179cbc1e08845f056 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 28 Oct 2024 23:07:51 +0100
Subject: [PATCH 280/438] build(deps): bump twisted from 24.7.0 to 24.10.0
 (#2620)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 9a413b59f..517637e24 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -18,7 +18,7 @@ pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.1.0
 setuptools==75.2.0
-twisted==24.7.0
+twisted==24.10.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20241016
 wheel==0.42.0

From 9d6adda814d080b3fa09e96103dc53d7b51bf8f4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 28 Oct 2024 23:07:59 +0100
Subject: [PATCH 281/438] build(deps): bump service-identity from 24.1.0 to
 24.2.0 (#2621)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 517637e24..22b08775f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -16,7 +16,7 @@ pytest-repeat==0.9.3
 pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
-service_identity==24.1.0
+service_identity==24.2.0
 setuptools==75.2.0
 twisted==24.10.0
 types-pyOpenSSL==24.1.0.20240722

From 286d49e8ccb3cf06e09f8b3c2645fd292d9c3f6b Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 31 Oct 2024 11:27:33 +0100
Subject: [PATCH 282/438] chore: create WebSocket reply only calls using own
 loop (#2626)

---
 playwright/_impl/_network.py | 37 +++++++++++++++++++++++++-----------
 1 file changed, 26 insertions(+), 11 deletions(-)

diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 649b89198..53f97a46c 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -541,14 +541,16 @@ async def _race_with_page_close(self, future: Coroutine) -> None:
             await asyncio.gather(fut, return_exceptions=True)
 
 
-def _create_task_and_ignore_exception(coro: Coroutine) -> None:
+def _create_task_and_ignore_exception(
+    loop: asyncio.AbstractEventLoop, coro: Coroutine
+) -> None:
     async def _ignore_exception() -> None:
         try:
             await coro
         except Exception:
             pass
 
-    asyncio.create_task(_ignore_exception())
+    loop.create_task(_ignore_exception())
 
 
 class ServerWebSocketRoute:
@@ -572,6 +574,7 @@ def url(self) -> str:
 
     def close(self, code: int = None, reason: str = None) -> None:
         _create_task_and_ignore_exception(
+            self._ws._loop,
             self._ws._channel.send(
                 "closeServer",
                 {
@@ -579,22 +582,24 @@ def close(self, code: int = None, reason: str = None) -> None:
                     "reason": reason,
                     "wasClean": True,
                 },
-            )
+            ),
         )
 
     def send(self, message: Union[str, bytes]) -> None:
         if isinstance(message, str):
             _create_task_and_ignore_exception(
+                self._ws._loop,
                 self._ws._channel.send(
                     "sendToServer", {"message": message, "isBase64": False}
-                )
+                ),
             )
         else:
             _create_task_and_ignore_exception(
+                self._ws._loop,
                 self._ws._channel.send(
                     "sendToServer",
                     {"message": base64.b64encode(message).decode(), "isBase64": True},
-                )
+                ),
             )
 
 
@@ -628,7 +633,9 @@ def _channel_message_from_page(self, event: Dict) -> None:
                 else event["message"]
             )
         elif self._connected:
-            _create_task_and_ignore_exception(self._channel.send("sendToServer", event))
+            _create_task_and_ignore_exception(
+                self._loop, self._channel.send("sendToServer", event)
+            )
 
     def _channel_message_from_server(self, event: Dict) -> None:
         if self._on_server_message:
@@ -638,19 +645,25 @@ def _channel_message_from_server(self, event: Dict) -> None:
                 else event["message"]
             )
         else:
-            _create_task_and_ignore_exception(self._channel.send("sendToPage", event))
+            _create_task_and_ignore_exception(
+                self._loop, self._channel.send("sendToPage", event)
+            )
 
     def _channel_close_page(self, event: Dict) -> None:
         if self._on_page_close:
             self._on_page_close(event["code"], event["reason"])
         else:
-            _create_task_and_ignore_exception(self._channel.send("closeServer", event))
+            _create_task_and_ignore_exception(
+                self._loop, self._channel.send("closeServer", event)
+            )
 
     def _channel_close_server(self, event: Dict) -> None:
         if self._on_server_close:
             self._on_server_close(event["code"], event["reason"])
         else:
-            _create_task_and_ignore_exception(self._channel.send("closePage", event))
+            _create_task_and_ignore_exception(
+                self._loop, self._channel.send("closePage", event)
+            )
 
     @property
     def url(self) -> str:
@@ -674,19 +687,21 @@ def connect_to_server(self) -> "WebSocketRoute":
     def send(self, message: Union[str, bytes]) -> None:
         if isinstance(message, str):
             _create_task_and_ignore_exception(
+                self._loop,
                 self._channel.send(
                     "sendToPage", {"message": message, "isBase64": False}
-                )
+                ),
             )
         else:
             _create_task_and_ignore_exception(
+                self._loop,
                 self._channel.send(
                     "sendToPage",
                     {
                         "message": base64.b64encode(message).decode(),
                         "isBase64": True,
                     },
-                )
+                ),
             )
 
     def on_message(self, handler: Callable[[Union[str, bytes]], Any]) -> None:

From f7cfdac7152506c4c41931e453a1ce5dff0474d4 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 31 Oct 2024 22:36:22 +0100
Subject: [PATCH 283/438] chore: drop Python 3.8 (#2627)

---
 .azure-pipelines/publish.yml |  2 +-
 .github/workflows/ci.yml     | 11 +----------
 meta.yaml                    |  6 +++---
 pyproject.toml               |  4 ++--
 setup.py                     |  3 +--
 5 files changed, 8 insertions(+), 18 deletions(-)

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index 52af52ceb..cd8916184 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -33,7 +33,7 @@ extends:
         steps:
         - task: UsePythonVersion@0
           inputs:
-            versionSpec: '3.8'
+            versionSpec: '3.9'
           displayName: 'Use Python'
         - script: |
             python -m pip install --upgrade pip
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 87bb1317f..6288bde7e 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -47,18 +47,9 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ['3.8', '3.9']
+        python-version: ['3.9', '3.10']
         browser: [chromium, firefox, webkit]
         include:
-        - os: ubuntu-latest
-          python-version: '3.10'
-          browser: chromium
-        - os: windows-latest
-          python-version: '3.10'
-          browser: chromium
-        - os: macos-latest
-          python-version: '3.10'
-          browser: chromium
         - os: windows-latest
           python-version: '3.11'
           browser: chromium
diff --git a/meta.yaml b/meta.yaml
index 69dbbcec7..cb2da8460 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -15,17 +15,17 @@ build:
 
 requirements:
   build:
-    - python >=3.8                        # [build_platform != target_platform]
+    - python >=3.9                        # [build_platform != target_platform]
     - pip                                 # [build_platform != target_platform]
     - cross-python_{{ target_platform }}  # [build_platform != target_platform]
   host:
-    - python >=3.8
+    - python >=3.9
     - wheel
     - pip
     - curl
     - setuptools_scm
   run:
-    - python >=3.8
+    - python >=3.9
     - greenlet ==3.1.1
     - pyee ==12.0.0
 
diff --git a/pyproject.toml b/pyproject.toml
index 709e0ffa1..e65384134 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -18,7 +18,7 @@ asyncio_mode = "auto"
 
 [tool.mypy]
 ignore_missing_imports = true
-python_version = "3.8"
+python_version = "3.9"
 warn_unused_ignores = false
 warn_redundant_casts = true
 warn_unused_configs = true
@@ -36,7 +36,7 @@ profile = "black"
 [tool.pyright]
 include = ["playwright", "tests", "scripts"]
 exclude = ["**/node_modules", "**/__pycache__", "**/.*", "./build"]
-pythonVersion = "3.8"
+pythonVersion = "3.9"
 reportMissingImports = false
 reportTypedDictNotRequiredAccess = false
 reportCallInDefaultInitializer = true
diff --git a/setup.py b/setup.py
index 8a67ab2c8..a98358b45 100644
--- a/setup.py
+++ b/setup.py
@@ -228,7 +228,6 @@ def _download_and_extract_local_driver(
         "Topic :: Internet :: WWW/HTTP :: Browsers",
         "Intended Audience :: Developers",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
@@ -237,7 +236,7 @@ def _download_and_extract_local_driver(
         "License :: OSI Approved :: Apache Software License",
         "Operating System :: OS Independent",
     ],
-    python_requires=">=3.8",
+    python_requires=">=3.9",
     cmdclass={"bdist_wheel": PlaywrightBDistWheelCommand},
     entry_points={
         "console_scripts": [

From 65bb4507e93d7201ec3058de670a74b124d30982 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 4 Nov 2024 21:42:58 +0100
Subject: [PATCH 284/438] build(deps): bump pytest-cov from 5.0.0 to 6.0.0
 (#2630)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 22b08775f..6fb150f2f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -11,7 +11,7 @@ pre-commit==3.5.0
 pyOpenSSL==24.2.1
 pytest==8.3.3
 pytest-asyncio==0.21.2
-pytest-cov==5.0.0
+pytest-cov==6.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1
 pytest-xdist==3.6.1

From 7a981cf8b1c86c337d8a6ace6c9b3c3a8a729af0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 4 Nov 2024 21:43:06 +0100
Subject: [PATCH 285/438] build(deps): bump setuptools from 75.2.0 to 75.3.0
 (#2629)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 6fb150f2f..3be80758b 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.2.0
-setuptools==75.2.0
+setuptools==75.3.0
 twisted==24.10.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20241016

From d0ac4c0d62619c061eb66aa6671d8862bb347768 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 7 Nov 2024 09:12:03 +0100
Subject: [PATCH 286/438] test: update pytest-asyncio to 0.24.0 (#2635)

---
 local-requirements.txt  |  2 +-
 pyproject.toml          |  1 +
 tests/async/conftest.py | 11 +++++++----
 tests/conftest.py       | 12 ++----------
 4 files changed, 11 insertions(+), 15 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 3be80758b..4f7771e58 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -10,7 +10,7 @@ pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==24.2.1
 pytest==8.3.3
-pytest-asyncio==0.21.2
+pytest-asyncio==0.24.0
 pytest-cov==6.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1
diff --git a/pyproject.toml b/pyproject.toml
index e65384134..ebf205069 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -15,6 +15,7 @@ markers = [
 ]
 junit_family = "xunit2"
 asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "session"
 
 [tool.mypy]
 ignore_missing_imports = true
diff --git a/tests/async/conftest.py b/tests/async/conftest.py
index 268c8a433..c568067e5 100644
--- a/tests/async/conftest.py
+++ b/tests/async/conftest.py
@@ -16,6 +16,7 @@
 from typing import Any, AsyncGenerator, Awaitable, Callable, Dict, Generator, List
 
 import pytest
+from pytest_asyncio import is_async_test
 
 from playwright.async_api import (
     Browser,
@@ -38,8 +39,10 @@ def utils() -> Generator[Utils, None, None]:
 
 # Will mark all the tests as async
 def pytest_collection_modifyitems(items: List[pytest.Item]) -> None:
-    for item in items:
-        item.add_marker(pytest.mark.asyncio)
+    pytest_asyncio_tests = (item for item in items if is_async_test(item))
+    session_scope_marker = pytest.mark.asyncio(loop_scope="session")
+    for async_test in pytest_asyncio_tests:
+        async_test.add_marker(session_scope_marker, append=False)
 
 
 @pytest.fixture(scope="session")
@@ -85,7 +88,7 @@ async def browser(
 
 
 @pytest.fixture(scope="session")
-async def browser_version(browser: Browser) -> str:
+def browser_version(browser: Browser) -> str:
     return browser.version
 
 
@@ -106,7 +109,7 @@ async def launch(**kwargs: Any) -> BrowserContext:
 
 
 @pytest.fixture(scope="session")
-async def default_same_site_cookie_value(browser_name: str, is_linux: bool) -> str:
+def default_same_site_cookie_value(browser_name: str, is_linux: bool) -> str:
     if browser_name == "chromium":
         return "Lax"
     if browser_name == "firefox":
diff --git a/tests/conftest.py b/tests/conftest.py
index 770bd9c30..968f10b2b 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -12,7 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import asyncio
 import inspect
 import io
 import json
@@ -20,7 +19,7 @@
 import subprocess
 import sys
 from pathlib import Path
-from typing import Any, AsyncGenerator, Callable, Dict, Generator, List, Optional, cast
+from typing import Any, Callable, Dict, Generator, List, Optional, cast
 
 import pytest
 from PIL import Image
@@ -41,13 +40,6 @@ def pytest_generate_tests(metafunc: pytest.Metafunc) -> None:
         metafunc.parametrize("browser_name", browsers, scope="session")
 
 
-@pytest.fixture(scope="session")
-def event_loop() -> Generator[asyncio.AbstractEventLoop, None, None]:
-    loop = asyncio.get_event_loop()
-    yield loop
-    loop.close()
-
-
 @pytest.fixture(scope="session")
 def assetdir() -> Path:
     return _dirname / "assets"
@@ -77,7 +69,7 @@ def https_server() -> Generator[Server, None, None]:
 
 
 @pytest.fixture(autouse=True, scope="session")
-async def start_server() -> AsyncGenerator[None, None]:
+def start_server() -> Generator[None, None, None]:
     test_server.start()
     yield
     test_server.stop()

From 92003d27037d76cfd0d03345c7794dc1adeaa933 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 7 Nov 2024 12:34:43 +0100
Subject: [PATCH 287/438] devops: do not pin conda-build (#2636)

---
 .github/workflows/publish.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index cae28da1a..0c2c0f877 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -33,8 +33,7 @@ jobs:
           channels: conda-forge
           miniconda-version: latest
       - name: Prepare
-        # Pinned because of https://github.com/conda/conda-build/issues/5267
-        run: conda install anaconda-client conda-build=24.1.2 conda-verify py-lief=0.12.3
+        run: conda install anaconda-client conda-build conda-verify
       - name: Build and Upload
         env:
           ANACONDA_API_TOKEN: ${{ secrets.ANACONDA_API_TOKEN }}

From 6ef181b8390d9716142e6e5b65db88c39eab917c Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 7 Nov 2024 12:35:53 +0100
Subject: [PATCH 288/438] devops: allow publish.yml on workflow dispatch

---
 .github/workflows/publish.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 0c2c0f877..f7fb18040 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -2,6 +2,7 @@ name: Upload Python Package
 on:
   release:
     types: [published]
+  workflow_dispatch:
 jobs:
   deploy-conda:
     strategy:

From e7553114fb640b400c61e1fe10f95bee083afb8b Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 7 Nov 2024 13:59:25 +0100
Subject: [PATCH 289/438] devops: fix conda release pipeline (linux-arm64)
 (#2637)

---
 .github/workflows/publish.yml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index f7fb18040..30646905b 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -6,6 +6,7 @@ on:
 jobs:
   deploy-conda:
     strategy:
+      fail-fast: false
       matrix:
         include:
           - os: ubuntu-latest
@@ -24,7 +25,7 @@ jobs:
         # Required for conda-incubator/setup-miniconda@v3
         shell: bash -el {0}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: Get conda
@@ -43,7 +44,8 @@ jobs:
           if [ "${{ matrix.target-platform }}" == "osx-arm64" ]; then
             conda build --user microsoft . -m conda_build_config_osx_arm64.yaml
           elif [ "${{ matrix.target-platform }}" == "linux-aarch64" ]; then
-            conda install cross-python_linux-aarch64
+            # Needs to be pinned until https://github.com/conda-forge/cross-python-feedstock/issues/93 is resolved.
+            conda install cross-python_linux-aarch64=3.12=47_cpython
             conda build --user microsoft . -m conda_build_config_linux_aarch64.yaml
           else
             conda build --user microsoft .

From 67a30645c0886f747a9511c2f7ae9e6e0c929589 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 7 Nov 2024 17:29:04 +0000
Subject: [PATCH 290/438] devops: do not install cross-python_linux-aarch64 on
 conda publishing

---
 .github/workflows/publish.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 30646905b..54c7ab80e 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -44,8 +44,6 @@ jobs:
           if [ "${{ matrix.target-platform }}" == "osx-arm64" ]; then
             conda build --user microsoft . -m conda_build_config_osx_arm64.yaml
           elif [ "${{ matrix.target-platform }}" == "linux-aarch64" ]; then
-            # Needs to be pinned until https://github.com/conda-forge/cross-python-feedstock/issues/93 is resolved.
-            conda install cross-python_linux-aarch64=3.12=47_cpython
             conda build --user microsoft . -m conda_build_config_linux_aarch64.yaml
           else
             conda build --user microsoft .

From 8d8d8ab7c78622bd5ba66027e3754472712bf521 Mon Sep 17 00:00:00 2001
From: oxy-star <101326713+oxy-star@users.noreply.github.com>
Date: Mon, 11 Nov 2024 14:46:13 +0200
Subject: [PATCH 291/438] fix(transport): use `Process.communicate` instead of
 `Process.wait` (#2634)

---
 playwright/_impl/_transport.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index 124f57823..2ca84d459 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -167,7 +167,7 @@ async def run(self) -> None:
                 break
             await asyncio.sleep(0)
 
-        await self._proc.wait()
+        await self._proc.communicate()
         self._stopped_future.set_result(None)
 
     def send(self, message: Dict) -> None:

From e608ff27c1455fb48f539db03b441f6a783c0007 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 11 Nov 2024 22:58:31 +0100
Subject: [PATCH 292/438] build(deps): bump auditwheel from 5.4.0 to 6.1.0
 (#2640)

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index ebf205069..03067acf5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==68.2.2", "setuptools-scm==8.1.0", "wheel==0.42.0", "auditwheel==5.4.0"]
+requires = ["setuptools==68.2.2", "setuptools-scm==8.1.0", "wheel==0.42.0", "auditwheel==6.1.0"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools_scm]

From 094536104e1f5d0a1d2800a8a9a9c51c3c8c984f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 11 Nov 2024 23:01:33 +0100
Subject: [PATCH 293/438] build(deps): bump setuptools from 68.2.2 to 75.4.0
 (#2641)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 pyproject.toml         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 4f7771e58..485104ae7 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,7 +17,7 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.2.0
-setuptools==75.3.0
+setuptools==75.4.0
 twisted==24.10.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20241016
diff --git a/pyproject.toml b/pyproject.toml
index 03067acf5..7558bd451 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==68.2.2", "setuptools-scm==8.1.0", "wheel==0.42.0", "auditwheel==6.1.0"]
+requires = ["setuptools==75.4.0", "setuptools-scm==8.1.0", "wheel==0.42.0", "auditwheel==6.1.0"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools_scm]

From 1e1122c5278103e2c146de6a1b4af28d521147bb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 11 Nov 2024 23:14:58 +0100
Subject: [PATCH 294/438] build(deps): bump wheel from 0.42.0 to 0.45.0 (#2638)

---
 local-requirements.txt | 2 +-
 pyproject.toml         | 2 +-
 setup.py               | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 485104ae7..170ed7edb 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -21,4 +21,4 @@ setuptools==75.4.0
 twisted==24.10.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20241016
-wheel==0.42.0
+wheel==0.45.0
diff --git a/pyproject.toml b/pyproject.toml
index 7558bd451..8a067f8e2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==75.4.0", "setuptools-scm==8.1.0", "wheel==0.42.0", "auditwheel==6.1.0"]
+requires = ["setuptools==75.4.0", "setuptools-scm==8.1.0", "wheel==0.45.0", "auditwheel==6.1.0"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools_scm]
diff --git a/setup.py b/setup.py
index a98358b45..5fdc27645 100644
--- a/setup.py
+++ b/setup.py
@@ -222,7 +222,7 @@ def _download_and_extract_local_driver(
         "pyee==12.0.0",
     ],
     # TODO: Can be removed once we migrate to pypa/build or pypa/installer.
-    setup_requires=["setuptools-scm==8.1.0", "wheel==0.42.0"],
+    setup_requires=["setuptools-scm==8.1.0", "wheel==0.45.0"],
     classifiers=[
         "Topic :: Software Development :: Testing",
         "Topic :: Internet :: WWW/HTTP :: Browsers",

From 4fd5de05438f31990d4612c1dd9252da86e34155 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 12 Nov 2024 11:41:36 +0100
Subject: [PATCH 295/438] chore: convert setup.py to build (#2642)

---
 .azure-pipelines/publish.yml        |   4 +-
 .github/workflows/ci.yml            |   6 +-
 .github/workflows/test_docker.yml   |   2 +-
 CONTRIBUTING.md                     |   4 +-
 ROLLING.md                          |   2 +-
 local-requirements.txt              |   4 +-
 playwright/_impl/_element_handle.py |   2 +-
 playwright/async_api/_generated.py  | 480 ++++++++++++++--------------
 playwright/sync_api/_generated.py   | 480 ++++++++++++++--------------
 pyproject.toml                      |  48 +++
 setup.py                            | 242 ++++++--------
 tests/async/test_navigation.py      |   7 +-
 tests/async/test_worker.py          |  14 +-
 utils/docker/build.sh               |   4 +-
 14 files changed, 650 insertions(+), 649 deletions(-)

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index cd8916184..6674eaae2 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -39,7 +39,9 @@ extends:
             python -m pip install --upgrade pip
             pip install -r local-requirements.txt
             pip install -e .
-            python setup.py bdist_wheel --all
+            for wheel in $(python setup.py --list-wheels); do
+              PLAYWRIGHT_TARGET_WHEEL=$wheel python -m build --wheel
+            done
           displayName: 'Install & Build'
         - task: EsrpRelease@7
           inputs:
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 6288bde7e..586ed6cff 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -31,7 +31,7 @@ jobs:
         python -m pip install --upgrade pip
         pip install -r local-requirements.txt
         pip install -e .
-        python setup.py bdist_wheel
+        python -m build --wheel
         python -m playwright install --with-deps
     - name: Lint
       run: pre-commit run --show-diff-on-failure --color=always --all-files
@@ -89,7 +89,7 @@ jobs:
         python -m pip install --upgrade pip
         pip install -r local-requirements.txt
         pip install -e .
-        python setup.py bdist_wheel
+        python -m build --wheel
         python -m playwright install --with-deps ${{ matrix.browser }}
     - name: Common Tests
       run: pytest tests/common --browser=${{ matrix.browser }} --timeout 90
@@ -135,7 +135,7 @@ jobs:
         python -m pip install --upgrade pip
         pip install -r local-requirements.txt
         pip install -e .
-        python setup.py bdist_wheel
+        python -m build --wheel
         python -m playwright install ${{ matrix.browser-channel }} --with-deps
     - name: Common Tests
       run: pytest tests/common --browser=chromium --browser-channel=${{ matrix.browser-channel }} --timeout 90
diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index 7abe9d60a..40377309b 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -46,6 +46,6 @@ jobs:
         docker exec "${CONTAINER_ID}" chown -R root:root /root/playwright
         docker exec "${CONTAINER_ID}" pip install -r local-requirements.txt
         docker exec "${CONTAINER_ID}" pip install -e .
-        docker exec "${CONTAINER_ID}" python setup.py bdist_wheel
+        docker exec "${CONTAINER_ID}" python -m build --wheel
         docker exec "${CONTAINER_ID}" xvfb-run pytest -vv tests/sync/
         docker exec "${CONTAINER_ID}" xvfb-run pytest -vv tests/async/
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index b4fe2f71d..b59e281c8 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -23,9 +23,7 @@ Build and install drivers:
 
 ```sh
 pip install -e .
-python setup.py bdist_wheel
-# For all platforms
-python setup.py bdist_wheel --all
+python -m build --wheel
 ```
 
 Run tests:
diff --git a/ROLLING.md b/ROLLING.md
index 2d35ee1e7..f5f500a3f 100644
--- a/ROLLING.md
+++ b/ROLLING.md
@@ -10,7 +10,7 @@
      - `pre-commit install`
      - `pip install -e .`
 * change driver version in `setup.py`
-* download new driver: `python setup.py bdist_wheel`
+* download new driver: `python -m build --wheel`
 * generate API: `./scripts/update_api.sh`
 * commit changes & send PR
 * wait for bots to pass & merge the PR
diff --git a/local-requirements.txt b/local-requirements.txt
index 170ed7edb..3a1791441 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,6 +1,6 @@
-auditwheel==6.1.0
 autobahn==23.1.2
 black==24.8.0
+build==1.2.2.post1
 flake8==7.1.1
 flaky==3.8.1
 mypy==1.13.0
@@ -17,8 +17,6 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.2.0
-setuptools==75.4.0
 twisted==24.10.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20241016
-wheel==0.45.0
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index d7482fdea..07d055ebc 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -158,7 +158,7 @@ async def select_option(
             dict(
                 timeout=timeout,
                 force=force,
-                **convert_select_option_values(value, index, label, element)
+                **convert_select_option_values(value, index, label, element),
             )
         )
         return await self._channel.send("selectOption", params)
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 3730d8127..c01b23fc2 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -675,7 +675,7 @@ async def fulfill(
         json: typing.Optional[typing.Any] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         content_type: typing.Optional[str] = None,
-        response: typing.Optional["APIResponse"] = None
+        response: typing.Optional["APIResponse"] = None,
     ) -> None:
         """Route.fulfill
 
@@ -739,7 +739,7 @@ async def fetch(
         post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
         max_redirects: typing.Optional[int] = None,
         max_retries: typing.Optional[int] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> "APIResponse":
         """Route.fetch
 
@@ -808,7 +808,7 @@ async def fallback(
         url: typing.Optional[str] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
     ) -> None:
         """Route.fallback
 
@@ -899,7 +899,7 @@ async def continue_(
         url: typing.Optional[str] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
     ) -> None:
         """Route.continue_
 
@@ -1067,7 +1067,7 @@ def expect_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager:
         """WebSocket.expect_event
 
@@ -1100,7 +1100,7 @@ async def wait_for_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Any:
         """WebSocket.wait_for_event
 
@@ -1463,7 +1463,7 @@ async def down(
         self,
         *,
         button: typing.Optional[Literal["left", "middle", "right"]] = None,
-        click_count: typing.Optional[int] = None
+        click_count: typing.Optional[int] = None,
     ) -> None:
         """Mouse.down
 
@@ -1485,7 +1485,7 @@ async def up(
         self,
         *,
         button: typing.Optional[Literal["left", "middle", "right"]] = None,
-        click_count: typing.Optional[int] = None
+        click_count: typing.Optional[int] = None,
     ) -> None:
         """Mouse.up
 
@@ -1510,7 +1510,7 @@ async def click(
         *,
         delay: typing.Optional[float] = None,
         button: typing.Optional[Literal["left", "middle", "right"]] = None,
-        click_count: typing.Optional[int] = None
+        click_count: typing.Optional[int] = None,
     ) -> None:
         """Mouse.click
 
@@ -1542,7 +1542,7 @@ async def dblclick(
         y: float,
         *,
         delay: typing.Optional[float] = None,
-        button: typing.Optional[Literal["left", "middle", "right"]] = None
+        button: typing.Optional[Literal["left", "middle", "right"]] = None,
     ) -> None:
         """Mouse.dblclick
 
@@ -2019,7 +2019,7 @@ async def hover(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.hover
 
@@ -2079,7 +2079,7 @@ async def click(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.click
 
@@ -2150,7 +2150,7 @@ async def dblclick(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.dblclick
 
@@ -2216,7 +2216,7 @@ async def select_option(
         ] = None,
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> typing.List[str]:
         """ElementHandle.select_option
 
@@ -2291,7 +2291,7 @@ async def tap(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.tap
 
@@ -2346,7 +2346,7 @@ async def fill(
         *,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.fill
 
@@ -2384,7 +2384,7 @@ async def select_text(
         self,
         *,
         force: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """ElementHandle.select_text
 
@@ -2443,7 +2443,7 @@ async def set_input_files(
         ],
         *,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.set_input_files
 
@@ -2487,7 +2487,7 @@ async def type(
         *,
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.type
 
@@ -2524,7 +2524,7 @@ async def press(
         *,
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.press
 
@@ -2580,7 +2580,7 @@ async def set_checked(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.set_checked
 
@@ -2634,7 +2634,7 @@ async def check(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.check
 
@@ -2686,7 +2686,7 @@ async def uncheck(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.uncheck
 
@@ -2774,7 +2774,7 @@ async def screenshot(
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None,
-        style: typing.Optional[str] = None
+        style: typing.Optional[str] = None,
     ) -> bytes:
         """ElementHandle.screenshot
 
@@ -2987,7 +2987,7 @@ async def wait_for_element_state(
             "disabled", "editable", "enabled", "hidden", "stable", "visible"
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """ElementHandle.wait_for_element_state
 
@@ -3027,7 +3027,7 @@ async def wait_for_selector(
             Literal["attached", "detached", "hidden", "visible"]
         ] = None,
         timeout: typing.Optional[float] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> typing.Optional["ElementHandle"]:
         """ElementHandle.wait_for_selector
 
@@ -3090,7 +3090,7 @@ async def snapshot(
         self,
         *,
         interesting_only: typing.Optional[bool] = None,
-        root: typing.Optional["ElementHandle"] = None
+        root: typing.Optional["ElementHandle"] = None,
     ) -> typing.Optional[typing.Dict]:
         """Accessibility.snapshot
 
@@ -3199,7 +3199,7 @@ async def set_files(
         ],
         *,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """FileChooser.set_files
 
@@ -3300,7 +3300,7 @@ async def goto(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        referer: typing.Optional[str] = None
+        referer: typing.Optional[str] = None,
     ) -> typing.Optional["Response"]:
         """Frame.goto
 
@@ -3365,7 +3365,7 @@ def expect_navigation(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["Response"]:
         """Frame.expect_navigation
 
@@ -3425,7 +3425,7 @@ async def wait_for_url(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Frame.wait_for_url
 
@@ -3471,7 +3471,7 @@ async def wait_for_load_state(
             Literal["domcontentloaded", "load", "networkidle"]
         ] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Frame.wait_for_load_state
 
@@ -3707,7 +3707,7 @@ async def wait_for_selector(
         timeout: typing.Optional[float] = None,
         state: typing.Optional[
             Literal["attached", "detached", "hidden", "visible"]
-        ] = None
+        ] = None,
     ) -> typing.Optional["ElementHandle"]:
         """Frame.wait_for_selector
 
@@ -3780,7 +3780,7 @@ async def is_checked(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_checked
 
@@ -3814,7 +3814,7 @@ async def is_disabled(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_disabled
 
@@ -3848,7 +3848,7 @@ async def is_editable(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_editable
 
@@ -3882,7 +3882,7 @@ async def is_enabled(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_enabled
 
@@ -3916,7 +3916,7 @@ async def is_hidden(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_hidden
 
@@ -3950,7 +3950,7 @@ async def is_visible(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_visible
 
@@ -3986,7 +3986,7 @@ async def dispatch_event(
         event_init: typing.Optional[typing.Dict] = None,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Frame.dispatch_event
 
@@ -4056,7 +4056,7 @@ async def eval_on_selector(
         expression: str,
         arg: typing.Optional[typing.Any] = None,
         *,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> typing.Any:
         """Frame.eval_on_selector
 
@@ -4162,7 +4162,7 @@ async def set_content(
         timeout: typing.Optional[float] = None,
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
-        ] = None
+        ] = None,
     ) -> None:
         """Frame.set_content
 
@@ -4212,7 +4212,7 @@ async def add_script_tag(
         url: typing.Optional[str] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         content: typing.Optional[str] = None,
-        type: typing.Optional[str] = None
+        type: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Frame.add_script_tag
 
@@ -4249,7 +4249,7 @@ async def add_style_tag(
         *,
         url: typing.Optional[str] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
-        content: typing.Optional[str] = None
+        content: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Frame.add_style_tag
 
@@ -4292,7 +4292,7 @@ async def click(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.click
 
@@ -4375,7 +4375,7 @@ async def dblclick(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.dblclick
 
@@ -4453,7 +4453,7 @@ async def tap(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.tap
 
@@ -4520,7 +4520,7 @@ async def fill(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> None:
         """Frame.fill
 
@@ -4573,7 +4573,7 @@ def locator(
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
-        has_not: typing.Optional["Locator"] = None
+        has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
         """Frame.locator
 
@@ -4631,7 +4631,7 @@ def get_by_alt_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_alt_text
 
@@ -4668,7 +4668,7 @@ def get_by_label(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_label
 
@@ -4709,7 +4709,7 @@ def get_by_placeholder(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_placeholder
 
@@ -4841,7 +4841,7 @@ def get_by_role(
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_role
 
@@ -4989,7 +4989,7 @@ def get_by_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_text
 
@@ -5053,7 +5053,7 @@ def get_by_title(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_title
 
@@ -5121,7 +5121,7 @@ async def focus(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Frame.focus
 
@@ -5152,7 +5152,7 @@ async def text_content(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Optional[str]:
         """Frame.text_content
 
@@ -5186,7 +5186,7 @@ async def inner_text(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Frame.inner_text
 
@@ -5220,7 +5220,7 @@ async def inner_html(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Frame.inner_html
 
@@ -5255,7 +5255,7 @@ async def get_attribute(
         name: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Optional[str]:
         """Frame.get_attribute
 
@@ -5298,7 +5298,7 @@ async def hover(
         no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.hover
 
@@ -5366,7 +5366,7 @@ async def drag_and_drop(
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.drag_and_drop
 
@@ -5427,7 +5427,7 @@ async def select_option(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> typing.List[str]:
         """Frame.select_option
 
@@ -5504,7 +5504,7 @@ async def input_value(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Frame.input_value
 
@@ -5550,7 +5550,7 @@ async def set_input_files(
         *,
         strict: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Frame.set_input_files
 
@@ -5597,7 +5597,7 @@ async def type(
         delay: typing.Optional[float] = None,
         strict: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Frame.type
 
@@ -5647,7 +5647,7 @@ async def press(
         delay: typing.Optional[float] = None,
         strict: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Frame.press
 
@@ -5713,7 +5713,7 @@ async def check(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.check
 
@@ -5775,7 +5775,7 @@ async def uncheck(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.uncheck
 
@@ -5852,7 +5852,7 @@ async def wait_for_function(
         *,
         arg: typing.Optional[typing.Any] = None,
         timeout: typing.Optional[float] = None,
-        polling: typing.Optional[typing.Union[float, Literal["raf"]]] = None
+        polling: typing.Optional[typing.Union[float, Literal["raf"]]] = None,
     ) -> "JSHandle":
         """Frame.wait_for_function
 
@@ -5939,7 +5939,7 @@ async def set_checked(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.set_checked
 
@@ -6058,7 +6058,7 @@ def locator(
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
-        has_not: typing.Optional["Locator"] = None
+        has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
         """FrameLocator.locator
 
@@ -6113,7 +6113,7 @@ def get_by_alt_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_alt_text
 
@@ -6150,7 +6150,7 @@ def get_by_label(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_label
 
@@ -6191,7 +6191,7 @@ def get_by_placeholder(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_placeholder
 
@@ -6323,7 +6323,7 @@ def get_by_role(
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_role
 
@@ -6471,7 +6471,7 @@ def get_by_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_text
 
@@ -6535,7 +6535,7 @@ def get_by_title(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_title
 
@@ -6717,7 +6717,7 @@ async def register(
         script: typing.Optional[str] = None,
         *,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
-        content_script: typing.Optional[bool] = None
+        content_script: typing.Optional[bool] = None,
     ) -> None:
         """Selectors.register
 
@@ -6812,7 +6812,7 @@ class Clock(AsyncBase):
     async def install(
         self,
         *,
-        time: typing.Optional[typing.Union[float, str, datetime.datetime]] = None
+        time: typing.Optional[typing.Union[float, str, datetime.datetime]] = None,
     ) -> None:
         """Clock.install
 
@@ -7969,7 +7969,7 @@ def frame(
         *,
         url: typing.Optional[
             typing.Union[str, typing.Pattern[str], typing.Callable[[str], bool]]
-        ] = None
+        ] = None,
     ) -> typing.Optional["Frame"]:
         """Page.frame
 
@@ -8092,7 +8092,7 @@ async def wait_for_selector(
         state: typing.Optional[
             Literal["attached", "detached", "hidden", "visible"]
         ] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> typing.Optional["ElementHandle"]:
         """Page.wait_for_selector
 
@@ -8165,7 +8165,7 @@ async def is_checked(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_checked
 
@@ -8199,7 +8199,7 @@ async def is_disabled(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_disabled
 
@@ -8233,7 +8233,7 @@ async def is_editable(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_editable
 
@@ -8267,7 +8267,7 @@ async def is_enabled(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_enabled
 
@@ -8301,7 +8301,7 @@ async def is_hidden(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_hidden
 
@@ -8335,7 +8335,7 @@ async def is_visible(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_visible
 
@@ -8371,7 +8371,7 @@ async def dispatch_event(
         event_init: typing.Optional[typing.Dict] = None,
         *,
         timeout: typing.Optional[float] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> None:
         """Page.dispatch_event
 
@@ -8553,7 +8553,7 @@ async def eval_on_selector(
         expression: str,
         arg: typing.Optional[typing.Any] = None,
         *,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> typing.Any:
         """Page.eval_on_selector
 
@@ -8642,7 +8642,7 @@ async def add_script_tag(
         url: typing.Optional[str] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         content: typing.Optional[str] = None,
-        type: typing.Optional[str] = None
+        type: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Page.add_script_tag
 
@@ -8678,7 +8678,7 @@ async def add_style_tag(
         *,
         url: typing.Optional[str] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
-        content: typing.Optional[str] = None
+        content: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Page.add_style_tag
 
@@ -8771,7 +8771,7 @@ async def expose_binding(
         name: str,
         callback: typing.Callable,
         *,
-        handle: typing.Optional[bool] = None
+        handle: typing.Optional[bool] = None,
     ) -> None:
         """Page.expose_binding
 
@@ -8873,7 +8873,7 @@ async def set_content(
         timeout: typing.Optional[float] = None,
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
-        ] = None
+        ] = None,
     ) -> None:
         """Page.set_content
 
@@ -8913,7 +8913,7 @@ async def goto(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        referer: typing.Optional[str] = None
+        referer: typing.Optional[str] = None,
     ) -> typing.Optional["Response"]:
         """Page.goto
 
@@ -8977,7 +8977,7 @@ async def reload(
         timeout: typing.Optional[float] = None,
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
-        ] = None
+        ] = None,
     ) -> typing.Optional["Response"]:
         """Page.reload
 
@@ -9016,7 +9016,7 @@ async def wait_for_load_state(
             Literal["domcontentloaded", "load", "networkidle"]
         ] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Page.wait_for_load_state
 
@@ -9072,7 +9072,7 @@ async def wait_for_url(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Page.wait_for_url
 
@@ -9117,7 +9117,7 @@ async def wait_for_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Any:
         """Page.wait_for_event
 
@@ -9154,7 +9154,7 @@ async def go_back(
         timeout: typing.Optional[float] = None,
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
-        ] = None
+        ] = None,
     ) -> typing.Optional["Response"]:
         """Page.go_back
 
@@ -9194,7 +9194,7 @@ async def go_forward(
         timeout: typing.Optional[float] = None,
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
-        ] = None
+        ] = None,
     ) -> typing.Optional["Response"]:
         """Page.go_forward
 
@@ -9260,7 +9260,7 @@ async def emulate_media(
         reduced_motion: typing.Optional[
             Literal["no-preference", "null", "reduce"]
         ] = None,
-        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None
+        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
     ) -> None:
         """Page.emulate_media
 
@@ -9361,7 +9361,7 @@ async def add_init_script(
         self,
         script: typing.Optional[str] = None,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
     ) -> None:
         """Page.add_init_script
 
@@ -9406,7 +9406,7 @@ async def route(
             typing.Callable[["Route", "Request"], typing.Any],
         ],
         *,
-        times: typing.Optional[int] = None
+        times: typing.Optional[int] = None,
     ) -> None:
         """Page.route
 
@@ -9558,7 +9558,7 @@ def handler(ws: WebSocketRoute):
     async def unroute_all(
         self,
         *,
-        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None
+        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None,
     ) -> None:
         """Page.unroute_all
 
@@ -9587,7 +9587,7 @@ async def route_from_har(
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
         update_content: typing.Optional[Literal["attach", "embed"]] = None,
-        update_mode: typing.Optional[Literal["full", "minimal"]] = None
+        update_mode: typing.Optional[Literal["full", "minimal"]] = None,
     ) -> None:
         """Page.route_from_har
 
@@ -9649,7 +9649,7 @@ async def screenshot(
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None,
-        style: typing.Optional[str] = None
+        style: typing.Optional[str] = None,
     ) -> bytes:
         """Page.screenshot
 
@@ -9742,7 +9742,7 @@ async def close(
         self,
         *,
         run_before_unload: typing.Optional[bool] = None,
-        reason: typing.Optional[str] = None
+        reason: typing.Optional[str] = None,
     ) -> None:
         """Page.close
 
@@ -9794,7 +9794,7 @@ async def click(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> None:
         """Page.click
 
@@ -9877,7 +9877,7 @@ async def dblclick(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.dblclick
 
@@ -9954,7 +9954,7 @@ async def tap(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.tap
 
@@ -10021,7 +10021,7 @@ async def fill(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> None:
         """Page.fill
 
@@ -10074,7 +10074,7 @@ def locator(
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
-        has_not: typing.Optional["Locator"] = None
+        has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
         """Page.locator
 
@@ -10130,7 +10130,7 @@ def get_by_alt_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_alt_text
 
@@ -10167,7 +10167,7 @@ def get_by_label(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_label
 
@@ -10208,7 +10208,7 @@ def get_by_placeholder(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_placeholder
 
@@ -10340,7 +10340,7 @@ def get_by_role(
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_role
 
@@ -10488,7 +10488,7 @@ def get_by_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_text
 
@@ -10552,7 +10552,7 @@ def get_by_title(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_title
 
@@ -10620,7 +10620,7 @@ async def focus(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Page.focus
 
@@ -10651,7 +10651,7 @@ async def text_content(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Optional[str]:
         """Page.text_content
 
@@ -10685,7 +10685,7 @@ async def inner_text(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Page.inner_text
 
@@ -10719,7 +10719,7 @@ async def inner_html(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Page.inner_html
 
@@ -10754,7 +10754,7 @@ async def get_attribute(
         name: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Optional[str]:
         """Page.get_attribute
 
@@ -10797,7 +10797,7 @@ async def hover(
         no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.hover
 
@@ -10865,7 +10865,7 @@ async def drag_and_drop(
         no_wait_after: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.drag_and_drop
 
@@ -10942,7 +10942,7 @@ async def select_option(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> typing.List[str]:
         """Page.select_option
 
@@ -11020,7 +11020,7 @@ async def input_value(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Page.input_value
 
@@ -11066,7 +11066,7 @@ async def set_input_files(
         *,
         timeout: typing.Optional[float] = None,
         strict: typing.Optional[bool] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Page.set_input_files
 
@@ -11114,7 +11114,7 @@ async def type(
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> None:
         """Page.type
 
@@ -11164,7 +11164,7 @@ async def press(
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> None:
         """Page.press
 
@@ -11246,7 +11246,7 @@ async def check(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.check
 
@@ -11308,7 +11308,7 @@ async def uncheck(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.uncheck
 
@@ -11392,7 +11392,7 @@ async def wait_for_function(
         *,
         arg: typing.Optional[typing.Any] = None,
         timeout: typing.Optional[float] = None,
-        polling: typing.Optional[typing.Union[float, Literal["raf"]]] = None
+        polling: typing.Optional[typing.Union[float, Literal["raf"]]] = None,
     ) -> "JSHandle":
         """Page.wait_for_function
 
@@ -11488,7 +11488,7 @@ async def pdf(
         margin: typing.Optional[PdfMargins] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         outline: typing.Optional[bool] = None,
-        tagged: typing.Optional[bool] = None
+        tagged: typing.Optional[bool] = None,
     ) -> bytes:
         """Page.pdf
 
@@ -11612,7 +11612,7 @@ def expect_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager:
         """Page.expect_event
 
@@ -11652,7 +11652,7 @@ def expect_console_message(
         self,
         predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["ConsoleMessage"]:
         """Page.expect_console_message
 
@@ -11683,7 +11683,7 @@ def expect_download(
         self,
         predicate: typing.Optional[typing.Callable[["Download"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["Download"]:
         """Page.expect_download
 
@@ -11714,7 +11714,7 @@ def expect_file_chooser(
         self,
         predicate: typing.Optional[typing.Callable[["FileChooser"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["FileChooser"]:
         """Page.expect_file_chooser
 
@@ -11750,7 +11750,7 @@ def expect_navigation(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["Response"]:
         """Page.expect_navigation
 
@@ -11809,7 +11809,7 @@ def expect_popup(
         self,
         predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["Page"]:
         """Page.expect_popup
 
@@ -11842,7 +11842,7 @@ def expect_request(
             str, typing.Pattern[str], typing.Callable[["Request"], bool]
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["Request"]:
         """Page.expect_request
 
@@ -11887,7 +11887,7 @@ def expect_request_finished(
         self,
         predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["Request"]:
         """Page.expect_request_finished
 
@@ -11920,7 +11920,7 @@ def expect_response(
             str, typing.Pattern[str], typing.Callable[["Response"], bool]
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["Response"]:
         """Page.expect_response
 
@@ -11967,7 +11967,7 @@ def expect_websocket(
         self,
         predicate: typing.Optional[typing.Callable[["WebSocket"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["WebSocket"]:
         """Page.expect_websocket
 
@@ -11998,7 +11998,7 @@ def expect_worker(
         self,
         predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["Worker"]:
         """Page.expect_worker
 
@@ -12035,7 +12035,7 @@ async def set_checked(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.set_checked
 
@@ -12099,7 +12099,7 @@ async def add_locator_handler(
         ],
         *,
         no_wait_after: typing.Optional[bool] = None,
-        times: typing.Optional[int] = None
+        times: typing.Optional[int] = None,
     ) -> None:
         """Page.add_locator_handler
 
@@ -12814,7 +12814,7 @@ async def clear_cookies(
         *,
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         domain: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        path: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None
+        path: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
     ) -> None:
         """BrowserContext.clear_cookies
 
@@ -12963,7 +12963,7 @@ async def add_init_script(
         self,
         script: typing.Optional[str] = None,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
     ) -> None:
         """BrowserContext.add_init_script
 
@@ -13005,7 +13005,7 @@ async def expose_binding(
         name: str,
         callback: typing.Callable,
         *,
-        handle: typing.Optional[bool] = None
+        handle: typing.Optional[bool] = None,
     ) -> None:
         """BrowserContext.expose_binding
 
@@ -13136,7 +13136,7 @@ async def route(
             typing.Callable[["Route", "Request"], typing.Any],
         ],
         *,
-        times: typing.Optional[int] = None
+        times: typing.Optional[int] = None,
     ) -> None:
         """BrowserContext.route
 
@@ -13287,7 +13287,7 @@ async def handler(ws: WebSocketRoute):
     async def unroute_all(
         self,
         *,
-        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None
+        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None,
     ) -> None:
         """BrowserContext.unroute_all
 
@@ -13316,7 +13316,7 @@ async def route_from_har(
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
         update_content: typing.Optional[Literal["attach", "embed"]] = None,
-        update_mode: typing.Optional[Literal["full", "minimal"]] = None
+        update_mode: typing.Optional[Literal["full", "minimal"]] = None,
     ) -> None:
         """BrowserContext.route_from_har
 
@@ -13368,7 +13368,7 @@ def expect_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager:
         """BrowserContext.expect_event
 
@@ -13444,7 +13444,7 @@ async def wait_for_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Any:
         """BrowserContext.wait_for_event
 
@@ -13479,7 +13479,7 @@ def expect_console_message(
         self,
         predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["ConsoleMessage"]:
         """BrowserContext.expect_console_message
 
@@ -13511,7 +13511,7 @@ def expect_page(
         self,
         predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> AsyncEventContextManager["Page"]:
         """BrowserContext.expect_page
 
@@ -13728,7 +13728,7 @@ async def new_context(
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
-        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
     ) -> "BrowserContext":
         """Browser.new_context
 
@@ -13969,7 +13969,7 @@ async def new_page(
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
-        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
     ) -> "Page":
         """Browser.new_page
 
@@ -14192,7 +14192,7 @@ async def start_tracing(
         page: typing.Optional["Page"] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         screenshots: typing.Optional[bool] = None,
-        categories: typing.Optional[typing.Sequence[str]] = None
+        categories: typing.Optional[typing.Sequence[str]] = None,
     ) -> None:
         """Browser.start_tracing
 
@@ -14303,7 +14303,7 @@ async def launch(
         chromium_sandbox: typing.Optional[bool] = None,
         firefox_user_prefs: typing.Optional[
             typing.Dict[str, typing.Union[str, float, bool]]
-        ] = None
+        ] = None,
     ) -> "Browser":
         """BrowserType.launch
 
@@ -14478,7 +14478,7 @@ async def launch_persistent_context(
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
-        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
     ) -> "BrowserContext":
         """BrowserType.launch_persistent_context
 
@@ -14729,7 +14729,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
+        headers: typing.Optional[typing.Dict[str, str]] = None,
     ) -> "Browser":
         """BrowserType.connect_over_cdp
 
@@ -14782,7 +14782,7 @@ async def connect(
         timeout: typing.Optional[float] = None,
         slow_mo: typing.Optional[float] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        expose_network: typing.Optional[str] = None
+        expose_network: typing.Optional[str] = None,
     ) -> "Browser":
         """BrowserType.connect
 
@@ -14970,7 +14970,7 @@ async def start(
         title: typing.Optional[str] = None,
         snapshots: typing.Optional[bool] = None,
         screenshots: typing.Optional[bool] = None,
-        sources: typing.Optional[bool] = None
+        sources: typing.Optional[bool] = None,
     ) -> None:
         """Tracing.start
 
@@ -15208,7 +15208,7 @@ async def check(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.check
 
@@ -15276,7 +15276,7 @@ async def click(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.click
 
@@ -15369,7 +15369,7 @@ async def dblclick(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.dblclick
 
@@ -15435,7 +15435,7 @@ async def dispatch_event(
         type: str,
         event_init: typing.Optional[typing.Dict] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Locator.dispatch_event
 
@@ -15498,7 +15498,7 @@ async def evaluate(
         expression: str,
         arg: typing.Optional[typing.Any] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Any:
         """Locator.evaluate
 
@@ -15589,7 +15589,7 @@ async def evaluate_handle(
         expression: str,
         arg: typing.Optional[typing.Any] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> "JSHandle":
         """Locator.evaluate_handle
 
@@ -15638,7 +15638,7 @@ async def fill(
         *,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> None:
         """Locator.fill
 
@@ -15687,7 +15687,7 @@ async def clear(
         *,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> None:
         """Locator.clear
 
@@ -15734,7 +15734,7 @@ def locator(
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
-        has_not: typing.Optional["Locator"] = None
+        has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
         """Locator.locator
 
@@ -15789,7 +15789,7 @@ def get_by_alt_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_alt_text
 
@@ -15826,7 +15826,7 @@ def get_by_label(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_label
 
@@ -15867,7 +15867,7 @@ def get_by_placeholder(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_placeholder
 
@@ -15999,7 +15999,7 @@ def get_by_role(
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_role
 
@@ -16147,7 +16147,7 @@ def get_by_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_text
 
@@ -16211,7 +16211,7 @@ def get_by_title(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_title
 
@@ -16332,7 +16332,7 @@ def filter(
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
-        has_not: typing.Optional["Locator"] = None
+        has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
         """Locator.filter
 
@@ -16535,7 +16535,7 @@ async def drag_to(
         timeout: typing.Optional[float] = None,
         trial: typing.Optional[bool] = None,
         source_position: typing.Optional[Position] = None,
-        target_position: typing.Optional[Position] = None
+        target_position: typing.Optional[Position] = None,
     ) -> None:
         """Locator.drag_to
 
@@ -16633,7 +16633,7 @@ async def hover(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.hover
 
@@ -16937,7 +16937,7 @@ async def press(
         *,
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Locator.press
 
@@ -17008,7 +17008,7 @@ async def screenshot(
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None,
-        style: typing.Optional[str] = None
+        style: typing.Optional[str] = None,
     ) -> bytes:
         """Locator.screenshot
 
@@ -17134,7 +17134,7 @@ async def select_option(
         ] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> typing.List[str]:
         """Locator.select_option
 
@@ -17215,7 +17215,7 @@ async def select_text(
         self,
         *,
         force: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Locator.select_text
 
@@ -17250,7 +17250,7 @@ async def set_input_files(
         ],
         *,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Locator.set_input_files
 
@@ -17317,7 +17317,7 @@ async def tap(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.tap
 
@@ -17403,7 +17403,7 @@ async def type(
         *,
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Locator.type
 
@@ -17440,7 +17440,7 @@ async def press_sequentially(
         *,
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Locator.press_sequentially
 
@@ -17494,7 +17494,7 @@ async def uncheck(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.uncheck
 
@@ -17597,7 +17597,7 @@ async def wait_for(
         timeout: typing.Optional[float] = None,
         state: typing.Optional[
             Literal["attached", "detached", "hidden", "visible"]
-        ] = None
+        ] = None,
     ) -> None:
         """Locator.wait_for
 
@@ -17640,7 +17640,7 @@ async def set_checked(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.set_checked
 
@@ -17869,7 +17869,7 @@ async def delete(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.delete
 
@@ -17950,7 +17950,7 @@ async def head(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.head
 
@@ -18031,7 +18031,7 @@ async def get(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.get
 
@@ -18124,7 +18124,7 @@ async def patch(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.patch
 
@@ -18205,7 +18205,7 @@ async def put(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.put
 
@@ -18286,7 +18286,7 @@ async def post(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.post
 
@@ -18399,7 +18399,7 @@ async def fetch(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.fetch
 
@@ -18521,7 +18521,7 @@ async def new_context(
         storage_state: typing.Optional[
             typing.Union[StorageState, str, pathlib.Path]
         ] = None,
-        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
     ) -> "APIRequestContext":
         """APIRequest.new_context
 
@@ -18600,7 +18600,7 @@ async def to_have_title(
         self,
         title_or_reg_exp: typing.Union[typing.Pattern[str], str],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """PageAssertions.to_have_title
 
@@ -18635,7 +18635,7 @@ async def not_to_have_title(
         self,
         title_or_reg_exp: typing.Union[typing.Pattern[str], str],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """PageAssertions.not_to_have_title
 
@@ -18661,7 +18661,7 @@ async def to_have_url(
         url_or_reg_exp: typing.Union[str, typing.Pattern[str]],
         *,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """PageAssertions.to_have_url
 
@@ -18700,7 +18700,7 @@ async def not_to_have_url(
         url_or_reg_exp: typing.Union[typing.Pattern[str], str],
         *,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """PageAssertions.not_to_have_url
 
@@ -18742,7 +18742,7 @@ async def to_contain_text(
         *,
         use_inner_text: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.to_contain_text
 
@@ -18834,7 +18834,7 @@ async def not_to_contain_text(
         *,
         use_inner_text: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.not_to_contain_text
 
@@ -18869,7 +18869,7 @@ async def to_have_attribute(
         value: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_attribute
 
@@ -18910,7 +18910,7 @@ async def not_to_have_attribute(
         value: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_attribute
 
@@ -18946,7 +18946,7 @@ async def to_have_class(
             str,
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_class
 
@@ -19001,7 +19001,7 @@ async def not_to_have_class(
             str,
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_class
 
@@ -19076,7 +19076,7 @@ async def to_have_css(
         name: str,
         value: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_css
 
@@ -19111,7 +19111,7 @@ async def not_to_have_css(
         name: str,
         value: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_css
 
@@ -19138,7 +19138,7 @@ async def to_have_id(
         self,
         id: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_id
 
@@ -19170,7 +19170,7 @@ async def not_to_have_id(
         self,
         id: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_id
 
@@ -19251,7 +19251,7 @@ async def to_have_value(
         self,
         value: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_value
 
@@ -19285,7 +19285,7 @@ async def not_to_have_value(
         self,
         value: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_value
 
@@ -19312,7 +19312,7 @@ async def to_have_values(
             typing.Sequence[typing.Union[typing.Pattern[str], str]],
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_values
 
@@ -19363,7 +19363,7 @@ async def not_to_have_values(
             typing.Sequence[typing.Union[typing.Pattern[str], str]],
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_values
 
@@ -19396,7 +19396,7 @@ async def to_have_text(
         *,
         use_inner_text: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.to_have_text
 
@@ -19487,7 +19487,7 @@ async def not_to_have_text(
         *,
         use_inner_text: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_text
 
@@ -19520,7 +19520,7 @@ async def to_be_attached(
         self,
         *,
         attached: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_be_attached
 
@@ -19549,7 +19549,7 @@ async def to_be_checked(
         self,
         *,
         timeout: typing.Optional[float] = None,
-        checked: typing.Optional[bool] = None
+        checked: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.to_be_checked
 
@@ -19580,7 +19580,7 @@ async def not_to_be_attached(
         self,
         *,
         attached: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_be_attached
 
@@ -19667,7 +19667,7 @@ async def to_be_editable(
         self,
         *,
         editable: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_be_editable
 
@@ -19698,7 +19698,7 @@ async def not_to_be_editable(
         self,
         *,
         editable: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_be_editable
 
@@ -19761,7 +19761,7 @@ async def to_be_enabled(
         self,
         *,
         enabled: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_be_enabled
 
@@ -19792,7 +19792,7 @@ async def not_to_be_enabled(
         self,
         *,
         enabled: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_be_enabled
 
@@ -19856,7 +19856,7 @@ async def to_be_visible(
         self,
         *,
         visible: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_be_visible
 
@@ -19897,7 +19897,7 @@ async def not_to_be_visible(
         self,
         *,
         visible: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_be_visible
 
@@ -19962,7 +19962,7 @@ async def to_be_in_viewport(
         self,
         *,
         ratio: typing.Optional[float] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_be_in_viewport
 
@@ -20001,7 +20001,7 @@ async def not_to_be_in_viewport(
         self,
         *,
         ratio: typing.Optional[float] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_be_in_viewport
 
@@ -20024,7 +20024,7 @@ async def to_have_accessible_description(
         description: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_accessible_description
 
@@ -20061,7 +20061,7 @@ async def not_to_have_accessible_description(
         name: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_accessible_description
 
@@ -20090,7 +20090,7 @@ async def to_have_accessible_name(
         name: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_accessible_name
 
@@ -20127,7 +20127,7 @@ async def not_to_have_accessible_name(
         name: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_accessible_name
 
@@ -20238,7 +20238,7 @@ async def to_have_role(
             "treeitem",
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_role
 
@@ -20354,7 +20354,7 @@ async def not_to_have_role(
             "treeitem",
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_role
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 773c763dd..23aebc560 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -683,7 +683,7 @@ def fulfill(
         json: typing.Optional[typing.Any] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         content_type: typing.Optional[str] = None,
-        response: typing.Optional["APIResponse"] = None
+        response: typing.Optional["APIResponse"] = None,
     ) -> None:
         """Route.fulfill
 
@@ -749,7 +749,7 @@ def fetch(
         post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
         max_redirects: typing.Optional[int] = None,
         max_retries: typing.Optional[int] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> "APIResponse":
         """Route.fetch
 
@@ -820,7 +820,7 @@ def fallback(
         url: typing.Optional[str] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
     ) -> None:
         """Route.fallback
 
@@ -913,7 +913,7 @@ def continue_(
         url: typing.Optional[str] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None
+        post_data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
     ) -> None:
         """Route.continue_
 
@@ -1059,7 +1059,7 @@ def expect_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager:
         """WebSocket.expect_event
 
@@ -1092,7 +1092,7 @@ def wait_for_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Any:
         """WebSocket.wait_for_event
 
@@ -1463,7 +1463,7 @@ def down(
         self,
         *,
         button: typing.Optional[Literal["left", "middle", "right"]] = None,
-        click_count: typing.Optional[int] = None
+        click_count: typing.Optional[int] = None,
     ) -> None:
         """Mouse.down
 
@@ -1485,7 +1485,7 @@ def up(
         self,
         *,
         button: typing.Optional[Literal["left", "middle", "right"]] = None,
-        click_count: typing.Optional[int] = None
+        click_count: typing.Optional[int] = None,
     ) -> None:
         """Mouse.up
 
@@ -1510,7 +1510,7 @@ def click(
         *,
         delay: typing.Optional[float] = None,
         button: typing.Optional[Literal["left", "middle", "right"]] = None,
-        click_count: typing.Optional[int] = None
+        click_count: typing.Optional[int] = None,
     ) -> None:
         """Mouse.click
 
@@ -1544,7 +1544,7 @@ def dblclick(
         y: float,
         *,
         delay: typing.Optional[float] = None,
-        button: typing.Optional[Literal["left", "middle", "right"]] = None
+        button: typing.Optional[Literal["left", "middle", "right"]] = None,
     ) -> None:
         """Mouse.dblclick
 
@@ -2027,7 +2027,7 @@ def hover(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.hover
 
@@ -2089,7 +2089,7 @@ def click(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.click
 
@@ -2162,7 +2162,7 @@ def dblclick(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.dblclick
 
@@ -2230,7 +2230,7 @@ def select_option(
         ] = None,
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> typing.List[str]:
         """ElementHandle.select_option
 
@@ -2307,7 +2307,7 @@ def tap(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.tap
 
@@ -2364,7 +2364,7 @@ def fill(
         *,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.fill
 
@@ -2404,7 +2404,7 @@ def select_text(
         self,
         *,
         force: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """ElementHandle.select_text
 
@@ -2463,7 +2463,7 @@ def set_input_files(
         ],
         *,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.set_input_files
 
@@ -2511,7 +2511,7 @@ def type(
         *,
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.type
 
@@ -2550,7 +2550,7 @@ def press(
         *,
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.press
 
@@ -2608,7 +2608,7 @@ def set_checked(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.set_checked
 
@@ -2664,7 +2664,7 @@ def check(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.check
 
@@ -2718,7 +2718,7 @@ def uncheck(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """ElementHandle.uncheck
 
@@ -2808,7 +2808,7 @@ def screenshot(
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None,
-        style: typing.Optional[str] = None
+        style: typing.Optional[str] = None,
     ) -> bytes:
         """ElementHandle.screenshot
 
@@ -3027,7 +3027,7 @@ def wait_for_element_state(
             "disabled", "editable", "enabled", "hidden", "stable", "visible"
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """ElementHandle.wait_for_element_state
 
@@ -3069,7 +3069,7 @@ def wait_for_selector(
             Literal["attached", "detached", "hidden", "visible"]
         ] = None,
         timeout: typing.Optional[float] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> typing.Optional["ElementHandle"]:
         """ElementHandle.wait_for_selector
 
@@ -3134,7 +3134,7 @@ def snapshot(
         self,
         *,
         interesting_only: typing.Optional[bool] = None,
-        root: typing.Optional["ElementHandle"] = None
+        root: typing.Optional["ElementHandle"] = None,
     ) -> typing.Optional[typing.Dict]:
         """Accessibility.snapshot
 
@@ -3245,7 +3245,7 @@ def set_files(
         ],
         *,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """FileChooser.set_files
 
@@ -3350,7 +3350,7 @@ def goto(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        referer: typing.Optional[str] = None
+        referer: typing.Optional[str] = None,
     ) -> typing.Optional["Response"]:
         """Frame.goto
 
@@ -3417,7 +3417,7 @@ def expect_navigation(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["Response"]:
         """Frame.expect_navigation
 
@@ -3477,7 +3477,7 @@ def wait_for_url(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Frame.wait_for_url
 
@@ -3525,7 +3525,7 @@ def wait_for_load_state(
             Literal["domcontentloaded", "load", "networkidle"]
         ] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Frame.wait_for_load_state
 
@@ -3763,7 +3763,7 @@ def wait_for_selector(
         timeout: typing.Optional[float] = None,
         state: typing.Optional[
             Literal["attached", "detached", "hidden", "visible"]
-        ] = None
+        ] = None,
     ) -> typing.Optional["ElementHandle"]:
         """Frame.wait_for_selector
 
@@ -3835,7 +3835,7 @@ def is_checked(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_checked
 
@@ -3871,7 +3871,7 @@ def is_disabled(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_disabled
 
@@ -3907,7 +3907,7 @@ def is_editable(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_editable
 
@@ -3943,7 +3943,7 @@ def is_enabled(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_enabled
 
@@ -3979,7 +3979,7 @@ def is_hidden(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_hidden
 
@@ -4015,7 +4015,7 @@ def is_visible(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Frame.is_visible
 
@@ -4053,7 +4053,7 @@ def dispatch_event(
         event_init: typing.Optional[typing.Dict] = None,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Frame.dispatch_event
 
@@ -4125,7 +4125,7 @@ def eval_on_selector(
         expression: str,
         arg: typing.Optional[typing.Any] = None,
         *,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> typing.Any:
         """Frame.eval_on_selector
 
@@ -4235,7 +4235,7 @@ def set_content(
         timeout: typing.Optional[float] = None,
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
-        ] = None
+        ] = None,
     ) -> None:
         """Frame.set_content
 
@@ -4287,7 +4287,7 @@ def add_script_tag(
         url: typing.Optional[str] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         content: typing.Optional[str] = None,
-        type: typing.Optional[str] = None
+        type: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Frame.add_script_tag
 
@@ -4326,7 +4326,7 @@ def add_style_tag(
         *,
         url: typing.Optional[str] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
-        content: typing.Optional[str] = None
+        content: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Frame.add_style_tag
 
@@ -4371,7 +4371,7 @@ def click(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.click
 
@@ -4456,7 +4456,7 @@ def dblclick(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.dblclick
 
@@ -4536,7 +4536,7 @@ def tap(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.tap
 
@@ -4605,7 +4605,7 @@ def fill(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> None:
         """Frame.fill
 
@@ -4660,7 +4660,7 @@ def locator(
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
-        has_not: typing.Optional["Locator"] = None
+        has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
         """Frame.locator
 
@@ -4718,7 +4718,7 @@ def get_by_alt_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_alt_text
 
@@ -4755,7 +4755,7 @@ def get_by_label(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_label
 
@@ -4796,7 +4796,7 @@ def get_by_placeholder(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_placeholder
 
@@ -4928,7 +4928,7 @@ def get_by_role(
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_role
 
@@ -5076,7 +5076,7 @@ def get_by_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_text
 
@@ -5140,7 +5140,7 @@ def get_by_title(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Frame.get_by_title
 
@@ -5208,7 +5208,7 @@ def focus(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Frame.focus
 
@@ -5239,7 +5239,7 @@ def text_content(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Optional[str]:
         """Frame.text_content
 
@@ -5275,7 +5275,7 @@ def inner_text(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Frame.inner_text
 
@@ -5311,7 +5311,7 @@ def inner_html(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Frame.inner_html
 
@@ -5348,7 +5348,7 @@ def get_attribute(
         name: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Optional[str]:
         """Frame.get_attribute
 
@@ -5393,7 +5393,7 @@ def hover(
         no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.hover
 
@@ -5463,7 +5463,7 @@ def drag_and_drop(
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.drag_and_drop
 
@@ -5526,7 +5526,7 @@ def select_option(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> typing.List[str]:
         """Frame.select_option
 
@@ -5605,7 +5605,7 @@ def input_value(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Frame.input_value
 
@@ -5653,7 +5653,7 @@ def set_input_files(
         *,
         strict: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Frame.set_input_files
 
@@ -5702,7 +5702,7 @@ def type(
         delay: typing.Optional[float] = None,
         strict: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Frame.type
 
@@ -5754,7 +5754,7 @@ def press(
         delay: typing.Optional[float] = None,
         strict: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Frame.press
 
@@ -5822,7 +5822,7 @@ def check(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.check
 
@@ -5886,7 +5886,7 @@ def uncheck(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.uncheck
 
@@ -5965,7 +5965,7 @@ def wait_for_function(
         *,
         arg: typing.Optional[typing.Any] = None,
         timeout: typing.Optional[float] = None,
-        polling: typing.Optional[typing.Union[float, Literal["raf"]]] = None
+        polling: typing.Optional[typing.Union[float, Literal["raf"]]] = None,
     ) -> "JSHandle":
         """Frame.wait_for_function
 
@@ -6051,7 +6051,7 @@ def set_checked(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Frame.set_checked
 
@@ -6172,7 +6172,7 @@ def locator(
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
-        has_not: typing.Optional["Locator"] = None
+        has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
         """FrameLocator.locator
 
@@ -6227,7 +6227,7 @@ def get_by_alt_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_alt_text
 
@@ -6264,7 +6264,7 @@ def get_by_label(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_label
 
@@ -6305,7 +6305,7 @@ def get_by_placeholder(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_placeholder
 
@@ -6437,7 +6437,7 @@ def get_by_role(
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_role
 
@@ -6585,7 +6585,7 @@ def get_by_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_text
 
@@ -6649,7 +6649,7 @@ def get_by_title(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """FrameLocator.get_by_title
 
@@ -6829,7 +6829,7 @@ def register(
         script: typing.Optional[str] = None,
         *,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
-        content_script: typing.Optional[bool] = None
+        content_script: typing.Optional[bool] = None,
     ) -> None:
         """Selectors.register
 
@@ -6922,7 +6922,7 @@ class Clock(SyncBase):
     def install(
         self,
         *,
-        time: typing.Optional[typing.Union[float, str, datetime.datetime]] = None
+        time: typing.Optional[typing.Union[float, str, datetime.datetime]] = None,
     ) -> None:
         """Clock.install
 
@@ -7979,7 +7979,7 @@ def frame(
         *,
         url: typing.Optional[
             typing.Union[str, typing.Pattern[str], typing.Callable[[str], bool]]
-        ] = None
+        ] = None,
     ) -> typing.Optional["Frame"]:
         """Page.frame
 
@@ -8102,7 +8102,7 @@ def wait_for_selector(
         state: typing.Optional[
             Literal["attached", "detached", "hidden", "visible"]
         ] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> typing.Optional["ElementHandle"]:
         """Page.wait_for_selector
 
@@ -8174,7 +8174,7 @@ def is_checked(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_checked
 
@@ -8210,7 +8210,7 @@ def is_disabled(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_disabled
 
@@ -8246,7 +8246,7 @@ def is_editable(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_editable
 
@@ -8282,7 +8282,7 @@ def is_enabled(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_enabled
 
@@ -8318,7 +8318,7 @@ def is_hidden(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_hidden
 
@@ -8354,7 +8354,7 @@ def is_visible(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> bool:
         """Page.is_visible
 
@@ -8392,7 +8392,7 @@ def dispatch_event(
         event_init: typing.Optional[typing.Dict] = None,
         *,
         timeout: typing.Optional[float] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> None:
         """Page.dispatch_event
 
@@ -8578,7 +8578,7 @@ def eval_on_selector(
         expression: str,
         arg: typing.Optional[typing.Any] = None,
         *,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> typing.Any:
         """Page.eval_on_selector
 
@@ -8671,7 +8671,7 @@ def add_script_tag(
         url: typing.Optional[str] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         content: typing.Optional[str] = None,
-        type: typing.Optional[str] = None
+        type: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Page.add_script_tag
 
@@ -8709,7 +8709,7 @@ def add_style_tag(
         *,
         url: typing.Optional[str] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
-        content: typing.Optional[str] = None
+        content: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Page.add_style_tag
 
@@ -8803,7 +8803,7 @@ def expose_binding(
         name: str,
         callback: typing.Callable,
         *,
-        handle: typing.Optional[bool] = None
+        handle: typing.Optional[bool] = None,
     ) -> None:
         """Page.expose_binding
 
@@ -8904,7 +8904,7 @@ def set_content(
         timeout: typing.Optional[float] = None,
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
-        ] = None
+        ] = None,
     ) -> None:
         """Page.set_content
 
@@ -8946,7 +8946,7 @@ def goto(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        referer: typing.Optional[str] = None
+        referer: typing.Optional[str] = None,
     ) -> typing.Optional["Response"]:
         """Page.goto
 
@@ -9012,7 +9012,7 @@ def reload(
         timeout: typing.Optional[float] = None,
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
-        ] = None
+        ] = None,
     ) -> typing.Optional["Response"]:
         """Page.reload
 
@@ -9051,7 +9051,7 @@ def wait_for_load_state(
             Literal["domcontentloaded", "load", "networkidle"]
         ] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Page.wait_for_load_state
 
@@ -9107,7 +9107,7 @@ def wait_for_url(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Page.wait_for_url
 
@@ -9154,7 +9154,7 @@ def wait_for_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Any:
         """Page.wait_for_event
 
@@ -9195,7 +9195,7 @@ def go_back(
         timeout: typing.Optional[float] = None,
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
-        ] = None
+        ] = None,
     ) -> typing.Optional["Response"]:
         """Page.go_back
 
@@ -9235,7 +9235,7 @@ def go_forward(
         timeout: typing.Optional[float] = None,
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
-        ] = None
+        ] = None,
     ) -> typing.Optional["Response"]:
         """Page.go_forward
 
@@ -9301,7 +9301,7 @@ def emulate_media(
         reduced_motion: typing.Optional[
             Literal["no-preference", "null", "reduce"]
         ] = None,
-        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None
+        forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
     ) -> None:
         """Page.emulate_media
 
@@ -9403,7 +9403,7 @@ def add_init_script(
         self,
         script: typing.Optional[str] = None,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
     ) -> None:
         """Page.add_init_script
 
@@ -9448,7 +9448,7 @@ def route(
             typing.Callable[["Route", "Request"], typing.Any],
         ],
         *,
-        times: typing.Optional[int] = None
+        times: typing.Optional[int] = None,
     ) -> None:
         """Page.route
 
@@ -9606,7 +9606,7 @@ def handler(ws: WebSocketRoute):
     def unroute_all(
         self,
         *,
-        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None
+        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None,
     ) -> None:
         """Page.unroute_all
 
@@ -9635,7 +9635,7 @@ def route_from_har(
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
         update_content: typing.Optional[Literal["attach", "embed"]] = None,
-        update_mode: typing.Optional[Literal["full", "minimal"]] = None
+        update_mode: typing.Optional[Literal["full", "minimal"]] = None,
     ) -> None:
         """Page.route_from_har
 
@@ -9699,7 +9699,7 @@ def screenshot(
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None,
-        style: typing.Optional[str] = None
+        style: typing.Optional[str] = None,
     ) -> bytes:
         """Page.screenshot
 
@@ -9794,7 +9794,7 @@ def close(
         self,
         *,
         run_before_unload: typing.Optional[bool] = None,
-        reason: typing.Optional[str] = None
+        reason: typing.Optional[str] = None,
     ) -> None:
         """Page.close
 
@@ -9848,7 +9848,7 @@ def click(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> None:
         """Page.click
 
@@ -9933,7 +9933,7 @@ def dblclick(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.dblclick
 
@@ -10012,7 +10012,7 @@ def tap(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.tap
 
@@ -10081,7 +10081,7 @@ def fill(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> None:
         """Page.fill
 
@@ -10136,7 +10136,7 @@ def locator(
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
-        has_not: typing.Optional["Locator"] = None
+        has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
         """Page.locator
 
@@ -10192,7 +10192,7 @@ def get_by_alt_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_alt_text
 
@@ -10229,7 +10229,7 @@ def get_by_label(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_label
 
@@ -10270,7 +10270,7 @@ def get_by_placeholder(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_placeholder
 
@@ -10402,7 +10402,7 @@ def get_by_role(
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_role
 
@@ -10550,7 +10550,7 @@ def get_by_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_text
 
@@ -10614,7 +10614,7 @@ def get_by_title(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Page.get_by_title
 
@@ -10682,7 +10682,7 @@ def focus(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Page.focus
 
@@ -10713,7 +10713,7 @@ def text_content(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Optional[str]:
         """Page.text_content
 
@@ -10749,7 +10749,7 @@ def inner_text(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Page.inner_text
 
@@ -10785,7 +10785,7 @@ def inner_html(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Page.inner_html
 
@@ -10822,7 +10822,7 @@ def get_attribute(
         name: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Optional[str]:
         """Page.get_attribute
 
@@ -10867,7 +10867,7 @@ def hover(
         no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.hover
 
@@ -10937,7 +10937,7 @@ def drag_and_drop(
         no_wait_after: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.drag_and_drop
 
@@ -11016,7 +11016,7 @@ def select_option(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> typing.List[str]:
         """Page.select_option
 
@@ -11096,7 +11096,7 @@ def input_value(
         selector: str,
         *,
         strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> str:
         """Page.input_value
 
@@ -11144,7 +11144,7 @@ def set_input_files(
         *,
         timeout: typing.Optional[float] = None,
         strict: typing.Optional[bool] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Page.set_input_files
 
@@ -11194,7 +11194,7 @@ def type(
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> None:
         """Page.type
 
@@ -11246,7 +11246,7 @@ def press(
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        strict: typing.Optional[bool] = None
+        strict: typing.Optional[bool] = None,
     ) -> None:
         """Page.press
 
@@ -11330,7 +11330,7 @@ def check(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.check
 
@@ -11394,7 +11394,7 @@ def uncheck(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.uncheck
 
@@ -11480,7 +11480,7 @@ def wait_for_function(
         *,
         arg: typing.Optional[typing.Any] = None,
         timeout: typing.Optional[float] = None,
-        polling: typing.Optional[typing.Union[float, Literal["raf"]]] = None
+        polling: typing.Optional[typing.Union[float, Literal["raf"]]] = None,
     ) -> "JSHandle":
         """Page.wait_for_function
 
@@ -11575,7 +11575,7 @@ def pdf(
         margin: typing.Optional[PdfMargins] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         outline: typing.Optional[bool] = None,
-        tagged: typing.Optional[bool] = None
+        tagged: typing.Optional[bool] = None,
     ) -> bytes:
         """Page.pdf
 
@@ -11701,7 +11701,7 @@ def expect_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager:
         """Page.expect_event
 
@@ -11741,7 +11741,7 @@ def expect_console_message(
         self,
         predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["ConsoleMessage"]:
         """Page.expect_console_message
 
@@ -11772,7 +11772,7 @@ def expect_download(
         self,
         predicate: typing.Optional[typing.Callable[["Download"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["Download"]:
         """Page.expect_download
 
@@ -11803,7 +11803,7 @@ def expect_file_chooser(
         self,
         predicate: typing.Optional[typing.Callable[["FileChooser"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["FileChooser"]:
         """Page.expect_file_chooser
 
@@ -11839,7 +11839,7 @@ def expect_navigation(
         wait_until: typing.Optional[
             Literal["commit", "domcontentloaded", "load", "networkidle"]
         ] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["Response"]:
         """Page.expect_navigation
 
@@ -11898,7 +11898,7 @@ def expect_popup(
         self,
         predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["Page"]:
         """Page.expect_popup
 
@@ -11931,7 +11931,7 @@ def expect_request(
             str, typing.Pattern[str], typing.Callable[["Request"], bool]
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["Request"]:
         """Page.expect_request
 
@@ -11976,7 +11976,7 @@ def expect_request_finished(
         self,
         predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["Request"]:
         """Page.expect_request_finished
 
@@ -12009,7 +12009,7 @@ def expect_response(
             str, typing.Pattern[str], typing.Callable[["Response"], bool]
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["Response"]:
         """Page.expect_response
 
@@ -12056,7 +12056,7 @@ def expect_websocket(
         self,
         predicate: typing.Optional[typing.Callable[["WebSocket"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["WebSocket"]:
         """Page.expect_websocket
 
@@ -12087,7 +12087,7 @@ def expect_worker(
         self,
         predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["Worker"]:
         """Page.expect_worker
 
@@ -12124,7 +12124,7 @@ def set_checked(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         strict: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Page.set_checked
 
@@ -12190,7 +12190,7 @@ def add_locator_handler(
         ],
         *,
         no_wait_after: typing.Optional[bool] = None,
-        times: typing.Optional[int] = None
+        times: typing.Optional[int] = None,
     ) -> None:
         """Page.add_locator_handler
 
@@ -12841,7 +12841,7 @@ def clear_cookies(
         *,
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         domain: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        path: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None
+        path: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
     ) -> None:
         """BrowserContext.clear_cookies
 
@@ -12992,7 +12992,7 @@ def add_init_script(
         self,
         script: typing.Optional[str] = None,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
     ) -> None:
         """BrowserContext.add_init_script
 
@@ -13034,7 +13034,7 @@ def expose_binding(
         name: str,
         callback: typing.Callable,
         *,
-        handle: typing.Optional[bool] = None
+        handle: typing.Optional[bool] = None,
     ) -> None:
         """BrowserContext.expose_binding
 
@@ -13163,7 +13163,7 @@ def route(
             typing.Callable[["Route", "Request"], typing.Any],
         ],
         *,
-        times: typing.Optional[int] = None
+        times: typing.Optional[int] = None,
     ) -> None:
         """BrowserContext.route
 
@@ -13321,7 +13321,7 @@ def handler(ws: WebSocketRoute):
     def unroute_all(
         self,
         *,
-        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None
+        behavior: typing.Optional[Literal["default", "ignoreErrors", "wait"]] = None,
     ) -> None:
         """BrowserContext.unroute_all
 
@@ -13350,7 +13350,7 @@ def route_from_har(
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
         update_content: typing.Optional[Literal["attach", "embed"]] = None,
-        update_mode: typing.Optional[Literal["full", "minimal"]] = None
+        update_mode: typing.Optional[Literal["full", "minimal"]] = None,
     ) -> None:
         """BrowserContext.route_from_har
 
@@ -13404,7 +13404,7 @@ def expect_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager:
         """BrowserContext.expect_event
 
@@ -13480,7 +13480,7 @@ def wait_for_event(
         event: str,
         predicate: typing.Optional[typing.Callable] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Any:
         """BrowserContext.wait_for_event
 
@@ -13519,7 +13519,7 @@ def expect_console_message(
         self,
         predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["ConsoleMessage"]:
         """BrowserContext.expect_console_message
 
@@ -13551,7 +13551,7 @@ def expect_page(
         self,
         predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> EventContextManager["Page"]:
         """BrowserContext.expect_page
 
@@ -13764,7 +13764,7 @@ def new_context(
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
-        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
     ) -> "BrowserContext":
         """Browser.new_context
 
@@ -14007,7 +14007,7 @@ def new_page(
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
-        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
     ) -> "Page":
         """Browser.new_page
 
@@ -14232,7 +14232,7 @@ def start_tracing(
         page: typing.Optional["Page"] = None,
         path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         screenshots: typing.Optional[bool] = None,
-        categories: typing.Optional[typing.Sequence[str]] = None
+        categories: typing.Optional[typing.Sequence[str]] = None,
     ) -> None:
         """Browser.start_tracing
 
@@ -14345,7 +14345,7 @@ def launch(
         chromium_sandbox: typing.Optional[bool] = None,
         firefox_user_prefs: typing.Optional[
             typing.Dict[str, typing.Union[str, float, bool]]
-        ] = None
+        ] = None,
     ) -> "Browser":
         """BrowserType.launch
 
@@ -14522,7 +14522,7 @@ def launch_persistent_context(
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
-        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
     ) -> "BrowserContext":
         """BrowserType.launch_persistent_context
 
@@ -14775,7 +14775,7 @@ def connect_over_cdp(
         *,
         timeout: typing.Optional[float] = None,
         slow_mo: typing.Optional[float] = None,
-        headers: typing.Optional[typing.Dict[str, str]] = None
+        headers: typing.Optional[typing.Dict[str, str]] = None,
     ) -> "Browser":
         """BrowserType.connect_over_cdp
 
@@ -14830,7 +14830,7 @@ def connect(
         timeout: typing.Optional[float] = None,
         slow_mo: typing.Optional[float] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        expose_network: typing.Optional[str] = None
+        expose_network: typing.Optional[str] = None,
     ) -> "Browser":
         """BrowserType.connect
 
@@ -15017,7 +15017,7 @@ def start(
         title: typing.Optional[str] = None,
         snapshots: typing.Optional[bool] = None,
         screenshots: typing.Optional[bool] = None,
-        sources: typing.Optional[bool] = None
+        sources: typing.Optional[bool] = None,
     ) -> None:
         """Tracing.start
 
@@ -15257,7 +15257,7 @@ def check(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.check
 
@@ -15327,7 +15327,7 @@ def click(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.click
 
@@ -15422,7 +15422,7 @@ def dblclick(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.dblclick
 
@@ -15490,7 +15490,7 @@ def dispatch_event(
         type: str,
         event_init: typing.Optional[typing.Dict] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Locator.dispatch_event
 
@@ -15555,7 +15555,7 @@ def evaluate(
         expression: str,
         arg: typing.Optional[typing.Any] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> typing.Any:
         """Locator.evaluate
 
@@ -15650,7 +15650,7 @@ def evaluate_handle(
         expression: str,
         arg: typing.Optional[typing.Any] = None,
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> "JSHandle":
         """Locator.evaluate_handle
 
@@ -15701,7 +15701,7 @@ def fill(
         *,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> None:
         """Locator.fill
 
@@ -15752,7 +15752,7 @@ def clear(
         *,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> None:
         """Locator.clear
 
@@ -15801,7 +15801,7 @@ def locator(
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
-        has_not: typing.Optional["Locator"] = None
+        has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
         """Locator.locator
 
@@ -15856,7 +15856,7 @@ def get_by_alt_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_alt_text
 
@@ -15893,7 +15893,7 @@ def get_by_label(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_label
 
@@ -15934,7 +15934,7 @@ def get_by_placeholder(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_placeholder
 
@@ -16066,7 +16066,7 @@ def get_by_role(
         name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_role
 
@@ -16214,7 +16214,7 @@ def get_by_text(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_text
 
@@ -16278,7 +16278,7 @@ def get_by_title(
         self,
         text: typing.Union[str, typing.Pattern[str]],
         *,
-        exact: typing.Optional[bool] = None
+        exact: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.get_by_title
 
@@ -16401,7 +16401,7 @@ def filter(
         has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
-        has_not: typing.Optional["Locator"] = None
+        has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
         """Locator.filter
 
@@ -16605,7 +16605,7 @@ def drag_to(
         timeout: typing.Optional[float] = None,
         trial: typing.Optional[bool] = None,
         source_position: typing.Optional[Position] = None,
-        target_position: typing.Optional[Position] = None
+        target_position: typing.Optional[Position] = None,
     ) -> None:
         """Locator.drag_to
 
@@ -16705,7 +16705,7 @@ def hover(
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
         force: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.hover
 
@@ -17023,7 +17023,7 @@ def press(
         *,
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Locator.press
 
@@ -17096,7 +17096,7 @@ def screenshot(
         scale: typing.Optional[Literal["css", "device"]] = None,
         mask: typing.Optional[typing.Sequence["Locator"]] = None,
         mask_color: typing.Optional[str] = None,
-        style: typing.Optional[str] = None
+        style: typing.Optional[str] = None,
     ) -> bytes:
         """Locator.screenshot
 
@@ -17224,7 +17224,7 @@ def select_option(
         ] = None,
         timeout: typing.Optional[float] = None,
         no_wait_after: typing.Optional[bool] = None,
-        force: typing.Optional[bool] = None
+        force: typing.Optional[bool] = None,
     ) -> typing.List[str]:
         """Locator.select_option
 
@@ -17307,7 +17307,7 @@ def select_text(
         self,
         *,
         force: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """Locator.select_text
 
@@ -17342,7 +17342,7 @@ def set_input_files(
         ],
         *,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Locator.set_input_files
 
@@ -17413,7 +17413,7 @@ def tap(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.tap
 
@@ -17501,7 +17501,7 @@ def type(
         *,
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Locator.type
 
@@ -17540,7 +17540,7 @@ def press_sequentially(
         *,
         delay: typing.Optional[float] = None,
         timeout: typing.Optional[float] = None,
-        no_wait_after: typing.Optional[bool] = None
+        no_wait_after: typing.Optional[bool] = None,
     ) -> None:
         """Locator.press_sequentially
 
@@ -17596,7 +17596,7 @@ def uncheck(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.uncheck
 
@@ -17701,7 +17701,7 @@ def wait_for(
         timeout: typing.Optional[float] = None,
         state: typing.Optional[
             Literal["attached", "detached", "hidden", "visible"]
-        ] = None
+        ] = None,
     ) -> None:
         """Locator.wait_for
 
@@ -17744,7 +17744,7 @@ def set_checked(
         timeout: typing.Optional[float] = None,
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
-        trial: typing.Optional[bool] = None
+        trial: typing.Optional[bool] = None,
     ) -> None:
         """Locator.set_checked
 
@@ -17977,7 +17977,7 @@ def delete(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.delete
 
@@ -18060,7 +18060,7 @@ def head(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.head
 
@@ -18143,7 +18143,7 @@ def get(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.get
 
@@ -18238,7 +18238,7 @@ def patch(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.patch
 
@@ -18321,7 +18321,7 @@ def put(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.put
 
@@ -18404,7 +18404,7 @@ def post(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.post
 
@@ -18519,7 +18519,7 @@ def fetch(
         fail_on_status_code: typing.Optional[bool] = None,
         ignore_https_errors: typing.Optional[bool] = None,
         max_redirects: typing.Optional[int] = None,
-        max_retries: typing.Optional[int] = None
+        max_retries: typing.Optional[int] = None,
     ) -> "APIResponse":
         """APIRequestContext.fetch
 
@@ -18647,7 +18647,7 @@ def new_context(
         storage_state: typing.Optional[
             typing.Union[StorageState, str, pathlib.Path]
         ] = None,
-        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None
+        client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
     ) -> "APIRequestContext":
         """APIRequest.new_context
 
@@ -18728,7 +18728,7 @@ def to_have_title(
         self,
         title_or_reg_exp: typing.Union[typing.Pattern[str], str],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """PageAssertions.to_have_title
 
@@ -18765,7 +18765,7 @@ def not_to_have_title(
         self,
         title_or_reg_exp: typing.Union[typing.Pattern[str], str],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """PageAssertions.not_to_have_title
 
@@ -18793,7 +18793,7 @@ def to_have_url(
         url_or_reg_exp: typing.Union[str, typing.Pattern[str]],
         *,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """PageAssertions.to_have_url
 
@@ -18834,7 +18834,7 @@ def not_to_have_url(
         url_or_reg_exp: typing.Union[typing.Pattern[str], str],
         *,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """PageAssertions.not_to_have_url
 
@@ -18878,7 +18878,7 @@ def to_contain_text(
         *,
         use_inner_text: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.to_contain_text
 
@@ -18972,7 +18972,7 @@ def not_to_contain_text(
         *,
         use_inner_text: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.not_to_contain_text
 
@@ -19009,7 +19009,7 @@ def to_have_attribute(
         value: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_attribute
 
@@ -19052,7 +19052,7 @@ def not_to_have_attribute(
         value: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_attribute
 
@@ -19090,7 +19090,7 @@ def to_have_class(
             str,
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_class
 
@@ -19147,7 +19147,7 @@ def not_to_have_class(
             str,
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_class
 
@@ -19224,7 +19224,7 @@ def to_have_css(
         name: str,
         value: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_css
 
@@ -19261,7 +19261,7 @@ def not_to_have_css(
         name: str,
         value: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_css
 
@@ -19288,7 +19288,7 @@ def to_have_id(
         self,
         id: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_id
 
@@ -19320,7 +19320,7 @@ def not_to_have_id(
         self,
         id: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_id
 
@@ -19405,7 +19405,7 @@ def to_have_value(
         self,
         value: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_value
 
@@ -19439,7 +19439,7 @@ def not_to_have_value(
         self,
         value: typing.Union[str, typing.Pattern[str]],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_value
 
@@ -19466,7 +19466,7 @@ def to_have_values(
             typing.Sequence[typing.Union[typing.Pattern[str], str]],
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_values
 
@@ -19519,7 +19519,7 @@ def not_to_have_values(
             typing.Sequence[typing.Union[typing.Pattern[str], str]],
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_values
 
@@ -19554,7 +19554,7 @@ def to_have_text(
         *,
         use_inner_text: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.to_have_text
 
@@ -19647,7 +19647,7 @@ def not_to_have_text(
         *,
         use_inner_text: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
-        ignore_case: typing.Optional[bool] = None
+        ignore_case: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_text
 
@@ -19682,7 +19682,7 @@ def to_be_attached(
         self,
         *,
         attached: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_be_attached
 
@@ -19713,7 +19713,7 @@ def to_be_checked(
         self,
         *,
         timeout: typing.Optional[float] = None,
-        checked: typing.Optional[bool] = None
+        checked: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.to_be_checked
 
@@ -19744,7 +19744,7 @@ def not_to_be_attached(
         self,
         *,
         attached: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_be_attached
 
@@ -19829,7 +19829,7 @@ def to_be_editable(
         self,
         *,
         editable: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_be_editable
 
@@ -19862,7 +19862,7 @@ def not_to_be_editable(
         self,
         *,
         editable: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_be_editable
 
@@ -19927,7 +19927,7 @@ def to_be_enabled(
         self,
         *,
         enabled: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_be_enabled
 
@@ -19958,7 +19958,7 @@ def not_to_be_enabled(
         self,
         *,
         enabled: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_be_enabled
 
@@ -20024,7 +20024,7 @@ def to_be_visible(
         self,
         *,
         visible: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_be_visible
 
@@ -20065,7 +20065,7 @@ def not_to_be_visible(
         self,
         *,
         visible: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_be_visible
 
@@ -20130,7 +20130,7 @@ def to_be_in_viewport(
         self,
         *,
         ratio: typing.Optional[float] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_be_in_viewport
 
@@ -20169,7 +20169,7 @@ def not_to_be_in_viewport(
         self,
         *,
         ratio: typing.Optional[float] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_be_in_viewport
 
@@ -20194,7 +20194,7 @@ def to_have_accessible_description(
         description: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_accessible_description
 
@@ -20233,7 +20233,7 @@ def not_to_have_accessible_description(
         name: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_accessible_description
 
@@ -20264,7 +20264,7 @@ def to_have_accessible_name(
         name: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_accessible_name
 
@@ -20303,7 +20303,7 @@ def not_to_have_accessible_name(
         name: typing.Union[str, typing.Pattern[str]],
         *,
         ignore_case: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_accessible_name
 
@@ -20416,7 +20416,7 @@ def to_have_role(
             "treeitem",
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.to_have_role
 
@@ -20532,7 +20532,7 @@ def not_to_have_role(
             "treeitem",
         ],
         *,
-        timeout: typing.Optional[float] = None
+        timeout: typing.Optional[float] = None,
     ) -> None:
         """LocatorAssertions.not_to_have_role
 
diff --git a/pyproject.toml b/pyproject.toml
index 8a067f8e2..89ade6d0a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -2,6 +2,54 @@
 requires = ["setuptools==75.4.0", "setuptools-scm==8.1.0", "wheel==0.45.0", "auditwheel==6.1.0"]
 build-backend = "setuptools.build_meta"
 
+[project]
+name = "playwright"
+description = "A high-level API to automate web browsers"
+authors = [
+    {name = "Microsoft Corporation"}
+]
+readme = "README.md"
+license = {text = "Apache-2.0"}
+dynamic = ["version"]
+requires-python = ">=3.9"
+dependencies = [
+    "greenlet==3.1.1",
+    "pyee==12.0.0",
+]
+classifiers = [
+    "Topic :: Software Development :: Testing",
+    "Topic :: Internet :: WWW/HTTP :: Browsers",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+homepage = "https://github.com/Microsoft/playwright-python"
+"Release notes" = "https://github.com/microsoft/playwright-python/releases"
+
+[project.scripts]
+playwright = "playwright.__main__:main"
+
+[project.entry-points.pyinstaller40]
+hook-dirs = "playwright._impl.__pyinstaller:get_hook_dirs"
+
+[tool.setuptools]
+packages = [
+    "playwright",
+    "playwright.async_api",
+    "playwright.sync_api",
+    "playwright._impl",
+    "playwright._impl.__pyinstaller",
+]
+include-package-data = true
+
 [tool.setuptools_scm]
 version_file = "playwright/_repo_version.py"
 
diff --git a/setup.py b/setup.py
index 5fdc27645..ead8dad3d 100644
--- a/setup.py
+++ b/setup.py
@@ -19,18 +19,67 @@
 import subprocess
 import sys
 import zipfile
-from pathlib import Path
-from typing import Dict, List
+from typing import Dict
 
-from setuptools import setup
+driver_version = "1.48.1"
+
+base_wheel_bundles = [
+    {
+        "wheel": "macosx_10_13_x86_64.whl",
+        "machine": "x86_64",
+        "platform": "darwin",
+        "zip_name": "mac",
+    },
+    {
+        "wheel": "macosx_11_0_universal2.whl",
+        "machine": "x86_64",
+        "platform": "darwin",
+        "zip_name": "mac",
+    },
+    {
+        "wheel": "macosx_11_0_arm64.whl",
+        "machine": "arm64",
+        "platform": "darwin",
+        "zip_name": "mac-arm64",
+    },
+    {
+        "wheel": "manylinux1_x86_64.whl",
+        "machine": "x86_64",
+        "platform": "linux",
+        "zip_name": "linux",
+    },
+    {
+        "wheel": "manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
+        "machine": "aarch64",
+        "platform": "linux",
+        "zip_name": "linux-arm64",
+    },
+    {
+        "wheel": "win32.whl",
+        "machine": "i386",
+        "platform": "win32",
+        "zip_name": "win32_x64",
+    },
+    {
+        "wheel": "win_amd64.whl",
+        "machine": "amd64",
+        "platform": "win32",
+        "zip_name": "win32_x64",
+    },
+]
+
+if len(sys.argv) == 2 and sys.argv[1] == "--list-wheels":
+    for bundle in base_wheel_bundles:
+        print(bundle["wheel"])
+    exit(0)
+
+from setuptools import setup  # noqa: E402
 
 try:
     from auditwheel.wheeltools import InWheel
 except ImportError:
     InWheel = None
-from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
-
-driver_version = "1.48.1"
+from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand  # noqa: E402
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None:
@@ -60,124 +109,70 @@ def download_driver(zip_name: str) -> None:
 
 
 class PlaywrightBDistWheelCommand(BDistWheelCommand):
-    user_options = BDistWheelCommand.user_options + [
-        ("all", "a", "create wheels for all platforms")
-    ]
-    boolean_options = BDistWheelCommand.boolean_options + ["all"]
-
-    def initialize_options(self) -> None:
-        super().initialize_options()
-        self.all = False
-
     def run(self) -> None:
-        shutil.rmtree("build", ignore_errors=True)
-        shutil.rmtree("dist", ignore_errors=True)
-        shutil.rmtree("playwright.egg-info", ignore_errors=True)
         super().run()
         os.makedirs("driver", exist_ok=True)
         os.makedirs("playwright/driver", exist_ok=True)
-        base_wheel_bundles: List[Dict[str, str]] = [
-            {
-                "wheel": "macosx_10_13_x86_64.whl",
-                "machine": "x86_64",
-                "platform": "darwin",
-                "zip_name": "mac",
-            },
-            {
-                "wheel": "macosx_11_0_universal2.whl",
-                "machine": "x86_64",
-                "platform": "darwin",
-                "zip_name": "mac",
-            },
-            {
-                "wheel": "macosx_11_0_arm64.whl",
-                "machine": "arm64",
-                "platform": "darwin",
-                "zip_name": "mac-arm64",
-            },
-            {
-                "wheel": "manylinux1_x86_64.whl",
-                "machine": "x86_64",
-                "platform": "linux",
-                "zip_name": "linux",
-            },
-            {
-                "wheel": "manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
-                "machine": "aarch64",
-                "platform": "linux",
-                "zip_name": "linux-arm64",
-            },
-            {
-                "wheel": "win32.whl",
-                "machine": "i386",
-                "platform": "win32",
-                "zip_name": "win32_x64",
-            },
-            {
-                "wheel": "win_amd64.whl",
-                "machine": "amd64",
-                "platform": "win32",
-                "zip_name": "win32_x64",
-            },
-        ]
-        self._download_and_extract_local_driver(base_wheel_bundles)
-
-        wheels = base_wheel_bundles
-        if not self.all:
-            # Limit to 1, since for MacOS e.g. we have multiple wheels for the same platform and architecture and Conda expects 1.
-            wheels = list(
+        self._download_and_extract_local_driver()
+
+        wheel = None
+        if os.getenv("PLAYWRIGHT_TARGET_WHEEL", None):
+            wheel = list(
+                filter(
+                    lambda wheel: wheel["wheel"]
+                    == os.getenv("PLAYWRIGHT_TARGET_WHEEL"),
+                    base_wheel_bundles,
+                )
+            )[0]
+        else:
+            wheel = list(
                 filter(
                     lambda wheel: wheel["platform"] == sys.platform
                     and wheel["machine"] == platform.machine().lower(),
                     base_wheel_bundles,
                 )
-            )[:1]
-        self._build_wheels(wheels)
+            )[0]
+        assert wheel
+        self._build_wheel(wheel)
 
-    def _build_wheels(
+    def _build_wheel(
         self,
-        wheels: List[Dict[str, str]],
+        wheel_bundle: Dict[str, str],
     ) -> None:
+        assert self.dist_dir
         base_wheel_location: str = glob.glob(os.path.join(self.dist_dir, "*.whl"))[0]
         without_platform = base_wheel_location[:-7]
-        for wheel_bundle in wheels:
-            download_driver(wheel_bundle["zip_name"])
-            zip_file = (
-                f"driver/playwright-{driver_version}-{wheel_bundle['zip_name']}.zip"
+        download_driver(wheel_bundle["zip_name"])
+        zip_file = f"driver/playwright-{driver_version}-{wheel_bundle['zip_name']}.zip"
+        with zipfile.ZipFile(zip_file, "r") as zip:
+            extractall(zip, f"driver/{wheel_bundle['zip_name']}")
+        wheel_location = without_platform + wheel_bundle["wheel"]
+        shutil.copy(base_wheel_location, wheel_location)
+        with zipfile.ZipFile(wheel_location, "a") as zip:
+            driver_root = os.path.abspath(f"driver/{wheel_bundle['zip_name']}")
+            for dir_path, _, files in os.walk(driver_root):
+                for file in files:
+                    from_path = os.path.join(dir_path, file)
+                    to_path = os.path.relpath(from_path, driver_root)
+                    zip.write(from_path, f"playwright/driver/{to_path}")
+            zip.writestr(
+                "playwright/driver/README.md",
+                f"{wheel_bundle['wheel']} driver package",
             )
-            with zipfile.ZipFile(zip_file, "r") as zip:
-                extractall(zip, f"driver/{wheel_bundle['zip_name']}")
-            wheel_location = without_platform + wheel_bundle["wheel"]
-            shutil.copy(base_wheel_location, wheel_location)
-            with zipfile.ZipFile(wheel_location, "a") as zip:
-                driver_root = os.path.abspath(f"driver/{wheel_bundle['zip_name']}")
-                for dir_path, _, files in os.walk(driver_root):
-                    for file in files:
-                        from_path = os.path.join(dir_path, file)
-                        to_path = os.path.relpath(from_path, driver_root)
-                        zip.write(from_path, f"playwright/driver/{to_path}")
-                zip.writestr(
-                    "playwright/driver/README.md",
-                    f"{wheel_bundle['wheel']} driver package",
-                )
         os.remove(base_wheel_location)
-        if InWheel:
-            for whlfile in glob.glob(os.path.join(self.dist_dir, "*.whl")):
-                os.makedirs("wheelhouse", exist_ok=True)
+        for whlfile in glob.glob(os.path.join(self.dist_dir, "*.whl")):
+            os.makedirs("wheelhouse", exist_ok=True)
+            if InWheel:
                 with InWheel(
                     in_wheel=whlfile,
                     out_wheel=os.path.join("wheelhouse", os.path.basename(whlfile)),
                 ):
                     print(f"Updating RECORD file of {whlfile}")
-            shutil.rmtree(self.dist_dir)
-            print("Copying new wheels")
-            shutil.move("wheelhouse", self.dist_dir)
-        else:
-            print("auditwheel not installed, not updating RECORD file")
+        print("Copying new wheels")
+        shutil.move("wheelhouse", self.dist_dir)
 
     def _download_and_extract_local_driver(
         self,
-        wheels: List[Dict[str, str]],
     ) -> None:
         zip_names_for_current_system = set(
             map(
@@ -185,7 +180,7 @@ def _download_and_extract_local_driver(
                 filter(
                     lambda wheel: wheel["machine"] == platform.machine().lower()
                     and wheel["platform"] == sys.platform,
-                    wheels,
+                    base_wheel_bundles,
                 ),
             )
         )
@@ -198,50 +193,5 @@ def _download_and_extract_local_driver(
 
 
 setup(
-    name="playwright",
-    author="Microsoft Corporation",
-    author_email="",
-    description="A high-level API to automate web browsers",
-    long_description=Path("README.md").read_text(encoding="utf-8"),
-    long_description_content_type="text/markdown",
-    license="Apache-2.0",
-    url="https://github.com/Microsoft/playwright-python",
-    project_urls={
-        "Release notes": "https://github.com/microsoft/playwright-python/releases",
-    },
-    packages=[
-        "playwright",
-        "playwright.async_api",
-        "playwright.sync_api",
-        "playwright._impl",
-        "playwright._impl.__pyinstaller",
-    ],
-    include_package_data=True,
-    install_requires=[
-        "greenlet==3.1.1",
-        "pyee==12.0.0",
-    ],
-    # TODO: Can be removed once we migrate to pypa/build or pypa/installer.
-    setup_requires=["setuptools-scm==8.1.0", "wheel==0.45.0"],
-    classifiers=[
-        "Topic :: Software Development :: Testing",
-        "Topic :: Internet :: WWW/HTTP :: Browsers",
-        "Intended Audience :: Developers",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-        "Programming Language :: Python :: 3.12",
-        "Programming Language :: Python :: 3.13",
-        "License :: OSI Approved :: Apache Software License",
-        "Operating System :: OS Independent",
-    ],
-    python_requires=">=3.9",
     cmdclass={"bdist_wheel": PlaywrightBDistWheelCommand},
-    entry_points={
-        "console_scripts": [
-            "playwright=playwright.__main__:main",
-        ],
-        "pyinstaller40": ["hook-dirs=playwright._impl.__pyinstaller:get_hook_dirs"],
-    },
 )
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index fb34fb75b..240aee242 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -504,9 +504,10 @@ async def test_wait_for_nav_should_respect_timeout(page: Page, server: Server) -
 async def test_wait_for_nav_should_work_with_both_domcontentloaded_and_load(
     page: Page, server: Server
 ) -> None:
-    async with page.expect_navigation(
-        wait_until="domcontentloaded"
-    ), page.expect_navigation(wait_until="load"):
+    async with (
+        page.expect_navigation(wait_until="domcontentloaded"),
+        page.expect_navigation(wait_until="load"),
+    ):
         await page.goto(server.PREFIX + "/one-style.html")
 
 
diff --git a/tests/async/test_worker.py b/tests/async/test_worker.py
index 996404b6e..94a12ee70 100644
--- a/tests/async/test_worker.py
+++ b/tests/async/test_worker.py
@@ -151,9 +151,10 @@ async def test_workers_should_report_network_activity(
         await page.goto(server.PREFIX + "/worker/worker.html")
     worker = await worker_info.value
     url = server.PREFIX + "/one-style.css"
-    async with page.expect_request(url) as request_info, page.expect_response(
-        url
-    ) as response_info:
+    async with (
+        page.expect_request(url) as request_info,
+        page.expect_response(url) as response_info,
+    ):
         await worker.evaluate(
             "url => fetch(url).then(response => response.text()).then(console.log)", url
         )
@@ -173,9 +174,10 @@ async def test_workers_should_report_network_activity_on_worker_creation(
     # Chromium needs waitForDebugger enabled for this one.
     await page.goto(server.EMPTY_PAGE)
     url = server.PREFIX + "/one-style.css"
-    async with page.expect_request(url) as request_info, page.expect_response(
-        url
-    ) as response_info:
+    async with (
+        page.expect_request(url) as request_info,
+        page.expect_response(url) as response_info,
+    ):
         await page.evaluate(
             """url => new Worker(URL.createObjectURL(new Blob([`
         fetch("${url}").then(response => response.text()).then(console.log);
diff --git a/utils/docker/build.sh b/utils/docker/build.sh
index 1a5c62fb9..98b0b0233 100755
--- a/utils/docker/build.sh
+++ b/utils/docker/build.sh
@@ -23,7 +23,9 @@ trap "cleanup; cd $(pwd -P)" EXIT
 cd "$(dirname "$0")"
 
 pushd ../../
-python setup.py bdist_wheel --all
+for wheel in $(python setup.py --list-wheels); do
+  PLAYWRIGHT_TARGET_WHEEL=$wheel python -m build --wheel
+done
 popd
 mkdir dist/
 cp ../../dist/*-manylinux*.whl dist/

From c2dc66465d79fe680dfa0cf0dda1933a762c9711 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 12 Nov 2024 14:31:35 +0100
Subject: [PATCH 296/438] devops: do not pin pytest-playwright for examples
 (#2647)

---
 examples/todomvc/requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/todomvc/requirements.txt b/examples/todomvc/requirements.txt
index eb6fcbbd0..801cd515b 100644
--- a/examples/todomvc/requirements.txt
+++ b/examples/todomvc/requirements.txt
@@ -1 +1 @@
-pytest-playwright==0.3.0
+pytest-playwright

From 1452881a69cef576002db45417cd95a026d138fd Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 13 Nov 2024 22:40:27 +0100
Subject: [PATCH 297/438] fix(tracing): apiName determination with event
 listeners (#2651)

---
 playwright/_impl/_connection.py |  7 +++++++
 tests/async/test_tracing.py     | 32 +++++++++++++++++++++++++++++++-
 tests/sync/test_tracing.py      | 32 +++++++++++++++++++++++++++++++-
 3 files changed, 69 insertions(+), 2 deletions(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 910693f9e..8433058ae 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -37,6 +37,7 @@
 from pyee.asyncio import AsyncIOEventEmitter
 
 import playwright
+import playwright._impl._impl_to_api_mapping
 from playwright._impl._errors import TargetClosedError, rewrite_error
 from playwright._impl._greenlets import EventGreenlet
 from playwright._impl._helper import Error, ParsedMessagePayload, parse_error
@@ -573,6 +574,12 @@ def _extract_stack_trace_information_from_stack(
     api_name = ""
     parsed_frames: List[StackFrame] = []
     for frame in st:
+        # Sync and Async implementations can have event handlers. When these are sync, they
+        # get evaluated in the context of the event loop, so they contain the stack trace of when
+        # the message was received. _impl_to_api_mapping is glue between the user-code and internal
+        # code to translate impl classes to api classes. We want to ignore these frames.
+        if playwright._impl._impl_to_api_mapping.__file__ == frame.filename:
+            continue
         is_playwright_internal = frame.filename.startswith(playwright_module_path)
 
         method_name = ""
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index 027457586..dae1be6ec 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -12,11 +12,12 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import asyncio
 import re
 from pathlib import Path
 from typing import Dict, List
 
-from playwright.async_api import Browser, BrowserContext, BrowserType, Page
+from playwright.async_api import Browser, BrowserContext, BrowserType, Page, Response
 from tests.server import Server
 from tests.utils import get_trace_actions, parse_trace
 
@@ -145,6 +146,35 @@ async def test_should_collect_trace_with_resources_but_no_js(
     assert script["snapshot"]["response"]["content"].get("_sha1") is None
 
 
+async def test_should_correctly_determine_sync_apiname(
+    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+) -> None:
+    await context.tracing.start(screenshots=True, snapshots=True)
+
+    received_response: "asyncio.Future[None]" = asyncio.Future()
+
+    async def _handle_response(response: Response) -> None:
+        await response.request.all_headers()
+        await response.text()
+        received_response.set_result(None)
+
+    page.once("response", _handle_response)
+    await page.goto(server.PREFIX + "/grid.html")
+    await received_response
+    await page.close()
+    trace_file_path = tmpdir / "trace.zip"
+    await context.tracing.stop(path=trace_file_path)
+
+    (_, events) = parse_trace(trace_file_path)
+    assert events[0]["type"] == "context-options"
+    assert get_trace_actions(events) == [
+        "Page.goto",
+        "Request.all_headers",
+        "Response.text",
+        "Page.close",
+    ]
+
+
 async def test_should_collect_two_traces(
     context: BrowserContext, page: Page, server: Server, tmpdir: Path
 ) -> None:
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index cdf669f4f..98a6f61db 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -13,10 +13,11 @@
 # limitations under the License.
 
 import re
+import threading
 from pathlib import Path
 from typing import Any, Dict, List
 
-from playwright.sync_api import Browser, BrowserContext, BrowserType, Page
+from playwright.sync_api import Browser, BrowserContext, BrowserType, Page, Response
 from tests.server import Server
 from tests.utils import get_trace_actions, parse_trace
 
@@ -138,6 +139,35 @@ def test_should_collect_trace_with_resources_but_no_js(
     assert script["snapshot"]["response"]["content"].get("_sha1") is None
 
 
+def test_should_correctly_determine_sync_apiname(
+    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+) -> None:
+    context.tracing.start(screenshots=True, snapshots=True)
+    received_response = threading.Event()
+
+    def _handle_response(response: Response) -> None:
+        response.request.all_headers()
+        response.text()
+        received_response.set()
+
+    page.once("response", _handle_response)
+    page.goto(server.PREFIX + "/grid.html")
+    received_response.wait()
+
+    page.close()
+    trace_file_path = tmpdir / "trace.zip"
+    context.tracing.stop(path=trace_file_path)
+
+    (_, events) = parse_trace(trace_file_path)
+    assert events[0]["type"] == "context-options"
+    assert get_trace_actions(events) == [
+        "Page.goto",
+        "Request.all_headers",
+        "Response.text",
+        "Page.close",
+    ]
+
+
 def test_should_collect_two_traces(
     context: BrowserContext, page: Page, server: Server, tmpdir: Path
 ) -> None:

From f2ba7673b8fa4cd25318b1b0e323a0511bb668e2 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 19 Nov 2024 23:00:50 +0100
Subject: [PATCH 298/438] devops: update GitHub Action workflows

---
 .github/dependabot.yml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 6a7695c06..84a45f6df 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -4,3 +4,11 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      actions:
+        patterns:
+          - "*" 

From 923da5c536bd679e39267b68c5367c939257c8e4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 19 Nov 2024 23:08:55 +0100
Subject: [PATCH 299/438] build(deps): bump the actions group with 3 updates
 (#2657)

---
 .github/dependabot.yml               |  2 +-
 .github/workflows/ci.yml             | 16 ++++++++--------
 .github/workflows/publish_docker.yml |  6 +++---
 .github/workflows/test_docker.yml    |  4 ++--
 4 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 84a45f6df..33c127127 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -11,4 +11,4 @@ updates:
     groups:
       actions:
         patterns:
-          - "*" 
+          - "*"
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 586ed6cff..624269f05 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -21,9 +21,9 @@ jobs:
     name: Lint
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: "3.10"
     - name: Install dependencies & browsers
@@ -79,7 +79,7 @@ jobs:
           browser: chromium
     runs-on: ${{ matrix.os }}
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
@@ -125,9 +125,9 @@ jobs:
           browser-channel: msedge
     runs-on: ${{ matrix.os }}
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: "3.10"
     - name: Install dependencies & browsers
@@ -160,7 +160,7 @@ jobs:
         os: [ubuntu-22.04, macos-13, windows-2019]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: Get conda
@@ -180,9 +180,9 @@ jobs:
       run:
         working-directory: examples/todomvc/
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: '3.10'
     - name: Install dependencies & browsers
diff --git a/.github/workflows/publish_docker.yml b/.github/workflows/publish_docker.yml
index d0db5543d..99ac96c7f 100644
--- a/.github/workflows/publish_docker.yml
+++ b/.github/workflows/publish_docker.yml
@@ -15,7 +15,7 @@ jobs:
       contents: read    # This is required for actions/checkout to succeed
     environment: Docker
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Azure login
       uses: azure/login@v2
       with:
@@ -25,11 +25,11 @@ jobs:
     - name: Login to ACR via OIDC
       run: az acr login --name playwright
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: "3.10"
     - name: Set up Docker QEMU for arm64 docker builds
-      uses: docker/setup-qemu-action@v2
+      uses: docker/setup-qemu-action@v3
       with:
         platforms: arm64
     - name: Install dependencies & browsers
diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index 40377309b..9d70ae303 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -27,9 +27,9 @@ jobs:
           - jammy
           - noble
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: "3.10"
     - name: Install dependencies

From c4df71cb9cf653622c1aa7b02ed874f2fae3feb1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 20 Nov 2024 13:48:33 +0100
Subject: [PATCH 300/438] build(deps): bump setuptools from 75.4.0 to 75.5.0
 (#2654)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 89ade6d0a..f250731fc 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==75.4.0", "setuptools-scm==8.1.0", "wheel==0.45.0", "auditwheel==6.1.0"]
+requires = ["setuptools==75.5.0", "setuptools-scm==8.1.0", "wheel==0.45.0", "auditwheel==6.1.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 569d7c0e048b17524b921333b280dd629d576066 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 21 Nov 2024 15:54:43 +0100
Subject: [PATCH 301/438] fix(select): handle empty values and labels in select
 options (#2661)

---
 playwright/_impl/_element_handle.py    |  6 ++--
 tests/async/test_page_select_option.py | 41 ++++++++++++++++++++++++++
 tests/sync/test_page_select_option.py  | 41 ++++++++++++++++++++++++++
 3 files changed, 85 insertions(+), 3 deletions(-)

diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 07d055ebc..cb3d672d4 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -392,15 +392,15 @@ def convert_select_option_values(
 
     options: Any = None
     elements: Any = None
-    if value:
+    if value is not None:
         if isinstance(value, str):
             value = [value]
         options = (options or []) + list(map(lambda e: dict(valueOrLabel=e), value))
-    if index:
+    if index is not None:
         if isinstance(index, int):
             index = [index]
         options = (options or []) + list(map(lambda e: dict(index=e), index))
-    if label:
+    if label is not None:
         if isinstance(label, str):
             label = [label]
         options = (options or []) + list(map(lambda e: dict(label=e), label))
diff --git a/tests/async/test_page_select_option.py b/tests/async/test_page_select_option.py
index e59c6a481..c5edf543d 100644
--- a/tests/async/test_page_select_option.py
+++ b/tests/async/test_page_select_option.py
@@ -45,6 +45,22 @@ async def test_select_option_should_select_single_option_by_label(
     assert await page.evaluate("result.onChange") == ["indigo"]
 
 
+async def test_select_option_should_select_single_option_by_empty_label(
+    page: Page, server: Server
+) -> None:
+    await page.set_content(
+        """
+        <select>
+            <option value="indigo">Indigo</option>
+            <option value="violet"></option>
+        </select>
+    """
+    )
+    assert await page.locator("select").input_value() == "indigo"
+    await page.select_option("select", label="")
+    assert await page.locator("select").input_value() == "violet"
+
+
 async def test_select_option_should_select_single_option_by_handle(
     page: Page, server: Server
 ) -> None:
@@ -65,6 +81,14 @@ async def test_select_option_should_select_single_option_by_index(
     assert await page.evaluate("result.onChange") == ["brown"]
 
 
+async def test_select_option_should_select_single_option_by_index_0(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.PREFIX + "/input/select.html")
+    await page.select_option("select", index=0)
+    assert await page.evaluate("result.onInput") == ["black"]
+
+
 async def test_select_option_should_select_only_first_option(
     page: Page, server: Server
 ) -> None:
@@ -112,6 +136,23 @@ async def test_select_option_should_select_multiple_options_with_attributes(
     assert await page.evaluate("result.onChange") == ["blue", "gray", "green"]
 
 
+async def test_select_option_should_select_option_with_empty_value(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.set_content(
+        """
+        <select>
+            <option value="first">First</option>
+            <option value="">Second</option>
+        </select>
+    """
+    )
+    assert await page.locator("select").input_value() == "first"
+    await page.select_option("select", value="")
+    assert await page.locator("select").input_value() == ""
+
+
 async def test_select_option_should_respect_event_bubbling(
     page: Page, server: Server
 ) -> None:
diff --git a/tests/sync/test_page_select_option.py b/tests/sync/test_page_select_option.py
index 3c746dc6c..7bb6ade85 100644
--- a/tests/sync/test_page_select_option.py
+++ b/tests/sync/test_page_select_option.py
@@ -43,6 +43,22 @@ def test_select_option_should_select_single_option_by_label(
     assert page.evaluate("result.onChange") == ["indigo"]
 
 
+def test_select_option_should_select_single_option_by_empty_label(
+    page: Page, server: Server
+) -> None:
+    page.set_content(
+        """
+        <select>
+            <option value="indigo">Indigo</option>
+            <option value="violet"></option>
+        </select>
+    """
+    )
+    assert page.locator("select").input_value() == "indigo"
+    page.select_option("select", label="")
+    assert page.locator("select").input_value() == "violet"
+
+
 def test_select_option_should_select_single_option_by_handle(
     server: Server, page: Page
 ) -> None:
@@ -61,6 +77,14 @@ def test_select_option_should_select_single_option_by_index(
     assert page.evaluate("result.onChange") == ["brown"]
 
 
+def test_select_option_should_select_single_option_by_index_0(
+    page: Page, server: Server
+) -> None:
+    page.goto(server.PREFIX + "/input/select.html")
+    page.select_option("select", index=0)
+    assert page.evaluate("result.onInput") == ["black"]
+
+
 def test_select_option_should_select_only_first_option(
     server: Server, page: Page
 ) -> None:
@@ -108,6 +132,23 @@ def test_select_option_should_select_multiple_options_with_attributes(
     assert page.evaluate("result.onChange") == ["blue", "gray", "green"]
 
 
+def test_select_option_should_select_option_with_empty_value(
+    page: Page, server: Server
+) -> None:
+    page.goto(server.EMPTY_PAGE)
+    page.set_content(
+        """
+        <select>
+            <option value="first">First</option>
+            <option value="">Second</option>
+        </select>
+    """
+    )
+    assert page.locator("select").input_value() == "first"
+    page.select_option("select", value="")
+    assert page.locator("select").input_value() == ""
+
+
 def test_select_option_should_respect_event_bubbling(
     server: Server, page: Page
 ) -> None:

From f45782ef1c982786781261f5f72b47759ffe2882 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 22 Nov 2024 11:47:03 +0100
Subject: [PATCH 302/438] chore: roll to v1.49.0 (#2660)

---
 README.md                              |   6 +-
 playwright/_impl/_api_structures.py    |   6 +
 playwright/_impl/_assertions.py        |  17 ++
 playwright/_impl/_browser_context.py   |  10 +-
 playwright/_impl/_frame.py             |  18 +--
 playwright/_impl/_helper.py            |  59 +++----
 playwright/_impl/_locator.py           |   9 ++
 playwright/_impl/_network.py           |  25 +--
 playwright/_impl/_page.py              |  63 +++-----
 playwright/_impl/_tracing.py           |   7 +
 playwright/async_api/_generated.py     | 204 +++++++++++++++++++++---
 playwright/sync_api/_generated.py      | 207 ++++++++++++++++++++++---
 scripts/generate_api.py                |   2 +-
 setup.py                               |   2 +-
 tests/async/test_browsercontext.py     |  53 +++++--
 tests/async/test_emulation_focus.py    |  24 ---
 tests/async/test_network.py            |   4 +-
 tests/async/test_page_aria_snapshot.py |  93 +++++++++++
 tests/async/test_route_web_socket.py   |  27 ++++
 tests/async/test_tracing.py            |  33 ++++
 tests/async/test_websocket.py          |   4 +-
 tests/conftest.py                      |   8 +
 tests/server.py                        |   4 +
 tests/sync/test_network.py             |   4 +-
 tests/sync/test_page_aria_snapshot.py  |  93 +++++++++++
 tests/sync/test_route_web_socket.py    |  28 +++-
 tests/sync/test_tracing.py             |  33 ++++
 27 files changed, 854 insertions(+), 189 deletions(-)
 create mode 100644 tests/async/test_page_aria_snapshot.py
 create mode 100644 tests/sync/test_page_aria_snapshot.py

diff --git a/README.md b/README.md
index e99460db3..1efcead54 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 -->130.0.6723.31<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| WebKit <!-- GEN:webkit-version -->18.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->131.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->131.0.6778.33<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| WebKit <!-- GEN:webkit-version -->18.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->132.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index 904a590a9..3b639486a 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -291,3 +291,9 @@ class FrameExpectResult(TypedDict):
     "treegrid",
     "treeitem",
 ]
+
+
+class TracingGroupLocation(TypedDict):
+    file: str
+    line: Optional[int]
+    column: Optional[int]
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 13e7ac481..fce405da7 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -783,6 +783,23 @@ async def not_to_have_role(self, role: AriaRole, timeout: float = None) -> None:
         __tracebackhide__ = True
         await self._not.to_have_role(role, timeout)
 
+    async def to_match_aria_snapshot(
+        self, expected: str, timeout: float = None
+    ) -> None:
+        __tracebackhide__ = True
+        await self._expect_impl(
+            "to.match.aria",
+            FrameExpectOptions(expectedValue=expected, timeout=timeout),
+            expected,
+            "Locator expected to match Aria snapshot",
+        )
+
+    async def not_to_match_aria_snapshot(
+        self, expected: str, timeout: float = None
+    ) -> None:
+        __tracebackhide__ = True
+        await self._not.to_match_aria_snapshot(expected, timeout)
+
 
 class APIResponseAssertions:
     def __init__(
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 4645e2415..f415d5900 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -61,7 +61,6 @@
     RouteHandlerCallback,
     TimeoutSettings,
     URLMatch,
-    URLMatcher,
     WebSocketRouteHandlerCallback,
     async_readfile,
     async_writefile,
@@ -416,7 +415,8 @@ async def route(
         self._routes.insert(
             0,
             RouteHandler(
-                URLMatcher(self._options.get("baseURL"), url),
+                self._options.get("baseURL"),
+                url,
                 handler,
                 True if self._dispatcher_fiber else False,
                 times,
@@ -430,7 +430,7 @@ async def unroute(
         removed = []
         remaining = []
         for route in self._routes:
-            if route.matcher.match != url or (handler and route.handler != handler):
+            if route.url != url or (handler and route.handler != handler):
                 remaining.append(route)
             else:
                 removed.append(route)
@@ -453,9 +453,7 @@ async def route_web_socket(
     ) -> None:
         self._web_socket_routes.insert(
             0,
-            WebSocketRouteHandler(
-                URLMatcher(self._options.get("baseURL"), url), handler
-            ),
+            WebSocketRouteHandler(self._options.get("baseURL"), url, handler),
         )
         await self._update_web_socket_interception_patterns()
 
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index 1ce813636..d616046e6 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -45,10 +45,10 @@
     Literal,
     MouseButton,
     URLMatch,
-    URLMatcher,
     async_readfile,
     locals_to_params,
     monotonic_time,
+    url_matches,
 )
 from playwright._impl._js_handle import (
     JSHandle,
@@ -185,18 +185,17 @@ def expect_navigation(
 
         to_url = f' to "{url}"' if url else ""
         waiter.log(f"waiting for navigation{to_url} until '{waitUntil}'")
-        matcher = (
-            URLMatcher(self._page._browser_context._options.get("baseURL"), url)
-            if url
-            else None
-        )
 
         def predicate(event: Any) -> bool:
             # Any failed navigation results in a rejection.
             if event.get("error"):
                 return True
             waiter.log(f'  navigated to "{event["url"]}"')
-            return not matcher or matcher.matches(event["url"])
+            return url_matches(
+                cast("Page", self._page)._browser_context._options.get("baseURL"),
+                event["url"],
+                url,
+            )
 
         waiter.wait_for_event(
             self._event_emitter,
@@ -226,8 +225,9 @@ async def wait_for_url(
         timeout: float = None,
     ) -> None:
         assert self._page
-        matcher = URLMatcher(self._page._browser_context._options.get("baseURL"), url)
-        if matcher.matches(self.url):
+        if url_matches(
+            self._page._browser_context._options.get("baseURL"), self.url, url
+        ):
             await self._wait_for_load_state_impl(state=waitUntil, timeout=timeout)
             return
         async with self.expect_navigation(
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 027b3e1f5..d0737be07 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -142,27 +142,26 @@ class FrameNavigatedEvent(TypedDict):
 Env = Dict[str, Union[str, float, bool]]
 
 
-class URLMatcher:
-    def __init__(self, base_url: Union[str, None], match: URLMatch) -> None:
-        self._callback: Optional[Callable[[str], bool]] = None
-        self._regex_obj: Optional[Pattern[str]] = None
-        if isinstance(match, str):
-            if base_url and not match.startswith("*"):
-                match = urljoin(base_url, match)
-            regex = glob_to_regex(match)
-            self._regex_obj = re.compile(regex)
-        elif isinstance(match, Pattern):
-            self._regex_obj = match
-        else:
-            self._callback = match
-        self.match = match
-
-    def matches(self, url: str) -> bool:
-        if self._callback:
-            return self._callback(url)
-        if self._regex_obj:
-            return cast(bool, self._regex_obj.search(url))
-        return False
+def url_matches(
+    base_url: Optional[str], url_string: str, match: Optional[URLMatch]
+) -> bool:
+    if not match:
+        return True
+    if isinstance(match, str) and match[0] != "*":
+        # Allow http(s) baseURL to match ws(s) urls.
+        if (
+            base_url
+            and re.match(r"^https?://", base_url)
+            and re.match(r"^wss?://", url_string)
+        ):
+            base_url = re.sub(r"^http", "ws", base_url)
+        if base_url:
+            match = urljoin(base_url, match)
+    if isinstance(match, str):
+        match = glob_to_regex(match)
+    if isinstance(match, Pattern):
+        return bool(match.search(url_string))
+    return match(url_string)
 
 
 class HarLookupResult(TypedDict, total=False):
@@ -271,12 +270,14 @@ def __init__(self, complete: "asyncio.Future", route: "Route") -> None:
 class RouteHandler:
     def __init__(
         self,
-        matcher: URLMatcher,
+        base_url: Optional[str],
+        url: URLMatch,
         handler: RouteHandlerCallback,
         is_sync: bool,
         times: Optional[int] = None,
     ):
-        self.matcher = matcher
+        self._base_url = base_url
+        self.url = url
         self.handler = handler
         self._times = times if times else math.inf
         self._handled_count = 0
@@ -285,7 +286,7 @@ def __init__(
         self._active_invocations: Set[RouteHandlerInvocation] = set()
 
     def matches(self, request_url: str) -> bool:
-        return self.matcher.matches(request_url)
+        return url_matches(self._base_url, request_url, self.url)
 
     async def handle(self, route: "Route") -> bool:
         handler_invocation = RouteHandlerInvocation(
@@ -362,13 +363,13 @@ def prepare_interception_patterns(
         patterns = []
         all = False
         for handler in handlers:
-            if isinstance(handler.matcher.match, str):
-                patterns.append({"glob": handler.matcher.match})
-            elif isinstance(handler.matcher._regex_obj, re.Pattern):
+            if isinstance(handler.url, str):
+                patterns.append({"glob": handler.url})
+            elif isinstance(handler.url, re.Pattern):
                 patterns.append(
                     {
-                        "regexSource": handler.matcher._regex_obj.pattern,
-                        "regexFlags": escape_regex_flags(handler.matcher._regex_obj),
+                        "regexSource": handler.url.pattern,
+                        "regexFlags": escape_regex_flags(handler.url),
                     }
                 )
             else:
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 521897978..91ea79064 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -534,6 +534,15 @@ async def screenshot(
             ),
         )
 
+    async def aria_snapshot(self, timeout: float = None) -> str:
+        return await self._frame._channel.send(
+            "ariaSnapshot",
+            {
+                "selector": self._selector,
+                **locals_to_params(locals()),
+            },
+        )
+
     async def scroll_into_view_if_needed(
         self,
         timeout: float = None,
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 53f97a46c..97bb049e3 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -53,10 +53,11 @@
 from playwright._impl._errors import Error
 from playwright._impl._event_context_manager import EventContextManagerImpl
 from playwright._impl._helper import (
-    URLMatcher,
+    URLMatch,
     WebSocketRouteHandlerCallback,
     async_readfile,
     locals_to_params,
+    url_matches,
 )
 from playwright._impl._str_utils import escape_regex_flags
 from playwright._impl._waiter import Waiter
@@ -718,8 +719,14 @@ async def _after_handle(self) -> None:
 
 
 class WebSocketRouteHandler:
-    def __init__(self, matcher: URLMatcher, handler: WebSocketRouteHandlerCallback):
-        self.matcher = matcher
+    def __init__(
+        self,
+        base_url: Optional[str],
+        url: URLMatch,
+        handler: WebSocketRouteHandlerCallback,
+    ):
+        self._base_url = base_url
+        self.url = url
         self.handler = handler
 
     @staticmethod
@@ -729,13 +736,13 @@ def prepare_interception_patterns(
         patterns = []
         all_urls = False
         for handler in handlers:
-            if isinstance(handler.matcher.match, str):
-                patterns.append({"glob": handler.matcher.match})
-            elif isinstance(handler.matcher._regex_obj, re.Pattern):
+            if isinstance(handler.url, str):
+                patterns.append({"glob": handler.url})
+            elif isinstance(handler.url, re.Pattern):
                 patterns.append(
                     {
-                        "regexSource": handler.matcher._regex_obj.pattern,
-                        "regexFlags": escape_regex_flags(handler.matcher._regex_obj),
+                        "regexSource": handler.url.pattern,
+                        "regexFlags": escape_regex_flags(handler.url),
                     }
                 )
             else:
@@ -746,7 +753,7 @@ def prepare_interception_patterns(
         return patterns
 
     def matches(self, ws_url: str) -> bool:
-        return self.matcher.matches(ws_url)
+        return url_matches(self._base_url, ws_url, self.url)
 
     async def handle(self, websocket_route: "WebSocketRoute") -> None:
         coro_or_future = self.handler(websocket_route)
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 15195b28b..62fec2a3f 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -71,7 +71,6 @@
     RouteHandlerCallback,
     TimeoutSettings,
     URLMatch,
-    URLMatcher,
     URLMatchRequest,
     URLMatchResponse,
     WebSocketRouteHandlerCallback,
@@ -80,6 +79,7 @@
     locals_to_params,
     make_dirs_for_file,
     serialize_error,
+    url_matches,
 )
 from playwright._impl._input import Keyboard, Mouse, Touchscreen
 from playwright._impl._js_handle import (
@@ -380,16 +380,14 @@ def main_frame(self) -> Frame:
         return self._main_frame
 
     def frame(self, name: str = None, url: URLMatch = None) -> Optional[Frame]:
-        matcher = (
-            URLMatcher(self._browser_context._options.get("baseURL"), url)
-            if url
-            else None
-        )
         for frame in self._frames:
             if name and frame.name == name:
                 return frame
-            if url and matcher and matcher.matches(frame.url):
+            if url and url_matches(
+                self._browser_context._options.get("baseURL"), frame.url, url
+            ):
                 return frame
+
         return None
 
     @property
@@ -656,7 +654,8 @@ async def route(
         self._routes.insert(
             0,
             RouteHandler(
-                URLMatcher(self._browser_context._options.get("baseURL"), url),
+                self._browser_context._options.get("baseURL"),
+                url,
                 handler,
                 True if self._dispatcher_fiber else False,
                 times,
@@ -670,7 +669,7 @@ async def unroute(
         removed = []
         remaining = []
         for route in self._routes:
-            if route.matcher.match != url or (handler and route.handler != handler):
+            if route.url != url or (handler and route.handler != handler):
                 remaining.append(route)
             else:
                 removed.append(route)
@@ -699,7 +698,7 @@ async def route_web_socket(
         self._web_socket_routes.insert(
             0,
             WebSocketRouteHandler(
-                URLMatcher(self._browser_context._options.get("baseURL"), url), handler
+                self._browser_context._options.get("baseURL"), url, handler
             ),
         )
         await self._update_web_socket_interception_patterns()
@@ -1235,21 +1234,14 @@ def expect_request(
         urlOrPredicate: URLMatchRequest,
         timeout: float = None,
     ) -> EventContextManagerImpl[Request]:
-        matcher = (
-            None
-            if callable(urlOrPredicate)
-            else URLMatcher(
-                self._browser_context._options.get("baseURL"), urlOrPredicate
-            )
-        )
-        predicate = urlOrPredicate if callable(urlOrPredicate) else None
-
         def my_predicate(request: Request) -> bool:
-            if matcher:
-                return matcher.matches(request.url)
-            if predicate:
-                return predicate(request)
-            return True
+            if not callable(urlOrPredicate):
+                return url_matches(
+                    self._browser_context._options.get("baseURL"),
+                    request.url,
+                    urlOrPredicate,
+                )
+            return urlOrPredicate(request)
 
         trimmed_url = trim_url(urlOrPredicate)
         log_line = f"waiting for request {trimmed_url}" if trimmed_url else None
@@ -1274,21 +1266,14 @@ def expect_response(
         urlOrPredicate: URLMatchResponse,
         timeout: float = None,
     ) -> EventContextManagerImpl[Response]:
-        matcher = (
-            None
-            if callable(urlOrPredicate)
-            else URLMatcher(
-                self._browser_context._options.get("baseURL"), urlOrPredicate
-            )
-        )
-        predicate = urlOrPredicate if callable(urlOrPredicate) else None
-
-        def my_predicate(response: Response) -> bool:
-            if matcher:
-                return matcher.matches(response.url)
-            if predicate:
-                return predicate(response)
-            return True
+        def my_predicate(request: Response) -> bool:
+            if not callable(urlOrPredicate):
+                return url_matches(
+                    self._browser_context._options.get("baseURL"),
+                    request.url,
+                    urlOrPredicate,
+                )
+            return urlOrPredicate(request)
 
         trimmed_url = trim_url(urlOrPredicate)
         log_line = f"waiting for response {trimmed_url}" if trimmed_url else None
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index d645e41da..a68b53bf7 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -15,6 +15,7 @@
 import pathlib
 from typing import Dict, Optional, Union, cast
 
+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._helper import locals_to_params
@@ -131,3 +132,9 @@ def _reset_stack_counter(self) -> None:
         if self._is_tracing:
             self._is_tracing = False
             self._connection.set_is_tracing(False)
+
+    async def group(self, name: str, location: TracingGroupLocation = None) -> None:
+        await self._channel.send("tracingGroup", locals_to_params(locals()))
+
+    async def group_end(self) -> None:
+        await self._channel.send("tracingGroupEnd")
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index c01b23fc2..e1480f5bf 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -37,6 +37,7 @@
     SetCookieParam,
     SourceLocation,
     StorageState,
+    TracingGroupLocation,
     ViewportSize,
 )
 from playwright._impl._assertions import (
@@ -922,9 +923,8 @@ async def handle(route, request):
 
         **Details**
 
-        Note that any overrides such as `url` or `headers` only apply to the request being routed. If this request results
-        in a redirect, overrides will not be applied to the new redirected request. If you want to propagate a header
-        through redirects, use the combination of `route.fetch()` and `route.fulfill()` instead.
+        The `headers` option applies to both the routed request and any redirects it initiates. However, `url`, `method`,
+        and `postData` only apply to the original request and are not carried over to redirected requests.
 
         `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.
@@ -6923,6 +6923,9 @@ async def set_fixed_time(
 
         Makes `Date.now` and `new Date()` return fixed fake time at all times, keeps all the timers running.
 
+        Use this method for simple scenarios where you only need to test with a predefined time. For more advanced
+        scenarios, use `clock.install()` instead. Read docs on [clock emulation](https://playwright.dev/python/docs/clock) to learn more.
+
         **Usage**
 
         ```py
@@ -6944,7 +6947,8 @@ async def set_system_time(
     ) -> None:
         """Clock.set_system_time
 
-        Sets current system time but does not trigger any timers.
+        Sets system time, but does not trigger any timers. Use this to test how the web page reacts to a time shift, for
+        example switching from summer to winter time, or changing time zones.
 
         **Usage**
 
@@ -9294,8 +9298,6 @@ async def emulate_media(
         # → True
         await page.evaluate(\"matchMedia('(prefers-color-scheme: light)').matches\")
         # → False
-        await page.evaluate(\"matchMedia('(prefers-color-scheme: no-preference)').matches\")
-        # → False
         ```
 
         Parameters
@@ -9304,8 +9306,9 @@ async def emulate_media(
             Changes the CSS media type of the page. The only allowed values are `'Screen'`, `'Print'` and `'Null'`. Passing
             `'Null'` disables CSS media emulation.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
-            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`.
-            Passing `'Null'` disables color scheme emulation.
+            Emulates [prefers-colors-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme)
+            media feature, supported values are `'light'` and `'dark'`. Passing `'Null'` disables color scheme emulation.
+            `'no-preference'` is deprecated.
         reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. Passing
             `null` disables reduced motion emulation.
@@ -13804,9 +13807,9 @@ async def new_context(
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
-            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
-            `'light'`.
+            Emulates [prefers-colors-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme)
+            media feature, supported values are `'light'` and `'dark'`. See `page.emulate_media()` for more details.
+            Passing `'null'` resets emulation to system defaults. Defaults to `'light'`.
         reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -14029,9 +14032,9 @@ async def new_page(
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
-            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
-            `'light'`.
+            Emulates [prefers-colors-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme)
+            media feature, supported values are `'light'` and `'dark'`. See `page.emulate_media()` for more details.
+            Passing `'null'` resets emulation to system defaults. Defaults to `'light'`.
         forced_colors : Union["active", "none", "null", None]
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -14341,9 +14344,12 @@ async def launch(
             resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
             Firefox or WebKit, use at your own risk.
         channel : Union[str, None]
-            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
-            "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
-            [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
+            Browser distribution channel.
+
+            Use "chromium" to [opt in to new headless mode](../browsers.md#opt-in-to-new-headless-mode).
+
+            Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
+            "msedge-canary" to use branded [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
         args : Union[Sequence[str], None]
             **NOTE** Use custom browser args at your own risk, as some of them may break Playwright functionality.
 
@@ -14496,9 +14502,12 @@ async def launch_persistent_context(
             user data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty
             string to use a temporary directory instead.
         channel : Union[str, None]
-            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
-            "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
-            [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
+            Browser distribution channel.
+
+            Use "chromium" to [opt in to new headless mode](../browsers.md#opt-in-to-new-headless-mode).
+
+            Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
+            "msedge-canary" to use branded [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
         executable_path : Union[pathlib.Path, str, None]
             Path to a browser executable to run instead of the bundled one. If `executablePath` is a relative path, then it is
             resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
@@ -14588,9 +14597,9 @@ async def launch_persistent_context(
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
-            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
-            `'light'`.
+            Emulates [prefers-colors-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme)
+            media feature, supported values are `'light'` and `'dark'`. See `page.emulate_media()` for more details.
+            Passing `'null'` resets emulation to system defaults. Defaults to `'light'`.
         reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -15084,6 +15093,48 @@ async def stop(
 
         return mapping.from_maybe_impl(await self._impl_obj.stop(path=path))
 
+    async def group(
+        self, name: str, *, location: typing.Optional[TracingGroupLocation] = None
+    ) -> None:
+        """Tracing.group
+
+        **NOTE** Use `test.step` instead when available.
+
+        Creates a new group within the trace, assigning any subsequent API calls to this group, until
+        `tracing.group_end()` is called. Groups can be nested and will be visible in the trace viewer.
+
+        **Usage**
+
+        ```py
+        # All actions between group and group_end
+        # will be shown in the trace viewer as a group.
+        page.context.tracing.group(\"Open Playwright.dev > API\")
+        page.goto(\"https://playwright.dev/\")
+        page.get_by_role(\"link\", name=\"API\").click()
+        page.context.tracing.group_end()
+        ```
+
+        Parameters
+        ----------
+        name : str
+            Group name shown in the trace viewer.
+        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.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.group(name=name, location=location)
+        )
+
+    async def group_end(self) -> None:
+        """Tracing.group_end
+
+        Closes the last group created by `tracing.group()`.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.group_end())
+
 
 mapping.register(TracingImpl, Tracing)
 
@@ -17101,6 +17152,61 @@ async def screenshot(
             )
         )
 
+    async def aria_snapshot(self, *, timeout: typing.Optional[float] = 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
+        `locator_assertions.to_match_aria_snapshot()` for the corresponding assertion.
+
+        **Usage**
+
+        ```py
+        await page.get_by_role(\"link\").aria_snapshot()
+        ```
+
+        **Details**
+
+        This method captures the aria snapshot of the given element. The snapshot is a string that represents the state of
+        the element and its children. The snapshot can be used to assert the state of the element in the test, or to
+        compare it to state in the future.
+
+        The ARIA snapshot is represented using [YAML](https://yaml.org/spec/1.2.2/) markup language:
+        - The keys of the objects are the roles and optional accessible names of the elements.
+        - The values are either text content or an array of child elements.
+        - Generic static text can be represented with the `text` key.
+
+        Below is the HTML markup and the respective ARIA snapshot:
+
+        ```html
+        <ul aria-label=\"Links\">
+          <li><a href=\"/\">Home</a></li>
+          <li><a href=\"/about\">About</a></li>
+        <ul>
+        ```
+
+        ```yml
+        - list \"Links\":
+          - listitem:
+            - link \"Home\"
+          - listitem:
+            - link \"About\"
+        ```
+
+        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.
+
+        Returns
+        -------
+        str
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.aria_snapshot(timeout=timeout)
+        )
+
     async def scroll_into_view_if_needed(
         self, *, timeout: typing.Optional[float] = None
     ) -> None:
@@ -20373,6 +20479,58 @@ async def not_to_have_role(
             await self._impl_obj.not_to_have_role(role=role, timeout=timeout)
         )
 
+    async def to_match_aria_snapshot(
+        self, expected: str, *, timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_match_aria_snapshot
+
+        Asserts that the target element matches the given [accessibility snapshot](https://playwright.dev/python/docs/aria-snapshots).
+
+        **Usage**
+
+        ```py
+        await page.goto(\"https://demo.playwright.dev/todomvc/\")
+        await expect(page.locator('body')).to_match_aria_snapshot('''
+          - heading \"todos\"
+          - textbox \"What needs to be done?\"
+        ''')
+        ```
+
+        Parameters
+        ----------
+        expected : str
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.to_match_aria_snapshot(
+                expected=expected, timeout=timeout
+            )
+        )
+
+    async def not_to_match_aria_snapshot(
+        self, expected: str, *, timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_match_aria_snapshot
+
+        The opposite of `locator_assertions.to_match_aria_snapshot()`.
+
+        Parameters
+        ----------
+        expected : str
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.not_to_match_aria_snapshot(
+                expected=expected, timeout=timeout
+            )
+        )
+
 
 mapping.register(LocatorAssertionsImpl, LocatorAssertions)
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 23aebc560..42401bc64 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -37,6 +37,7 @@
     SetCookieParam,
     SourceLocation,
     StorageState,
+    TracingGroupLocation,
     ViewportSize,
 )
 from playwright._impl._assertions import (
@@ -936,9 +937,8 @@ def handle(route, request):
 
         **Details**
 
-        Note that any overrides such as `url` or `headers` only apply to the request being routed. If this request results
-        in a redirect, overrides will not be applied to the new redirected request. If you want to propagate a header
-        through redirects, use the combination of `route.fetch()` and `route.fulfill()` instead.
+        The `headers` option applies to both the routed request and any redirects it initiates. However, `url`, `method`,
+        and `postData` only apply to the original request and are not carried over to redirected requests.
 
         `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.
@@ -7033,6 +7033,9 @@ def set_fixed_time(self, time: typing.Union[float, str, datetime.datetime]) -> N
 
         Makes `Date.now` and `new Date()` return fixed fake time at all times, keeps all the timers running.
 
+        Use this method for simple scenarios where you only need to test with a predefined time. For more advanced
+        scenarios, use `clock.install()` instead. Read docs on [clock emulation](https://playwright.dev/python/docs/clock) to learn more.
+
         **Usage**
 
         ```py
@@ -7056,7 +7059,8 @@ def set_system_time(
     ) -> None:
         """Clock.set_system_time
 
-        Sets current system time but does not trigger any timers.
+        Sets system time, but does not trigger any timers. Use this to test how the web page reacts to a time shift, for
+        example switching from summer to winter time, or changing time zones.
 
         **Usage**
 
@@ -9335,7 +9339,6 @@ def emulate_media(
         # → True
         page.evaluate(\"matchMedia('(prefers-color-scheme: light)').matches\")
         # → False
-        page.evaluate(\"matchMedia('(prefers-color-scheme: no-preference)').matches\")
         ```
 
         Parameters
@@ -9344,8 +9347,9 @@ def emulate_media(
             Changes the CSS media type of the page. The only allowed values are `'Screen'`, `'Print'` and `'Null'`. Passing
             `'Null'` disables CSS media emulation.
         color_scheme : Union["dark", "light", "no-preference", "null", None]
-            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`.
-            Passing `'Null'` disables color scheme emulation.
+            Emulates [prefers-colors-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme)
+            media feature, supported values are `'light'` and `'dark'`. Passing `'Null'` disables color scheme emulation.
+            `'no-preference'` is deprecated.
         reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. Passing
             `null` disables reduced motion emulation.
@@ -13840,9 +13844,9 @@ def new_context(
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
-            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
-            `'light'`.
+            Emulates [prefers-colors-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme)
+            media feature, supported values are `'light'` and `'dark'`. See `page.emulate_media()` for more details.
+            Passing `'null'` resets emulation to system defaults. Defaults to `'light'`.
         reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -14067,9 +14071,9 @@ def new_page(
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
-            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
-            `'light'`.
+            Emulates [prefers-colors-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme)
+            media feature, supported values are `'light'` and `'dark'`. See `page.emulate_media()` for more details.
+            Passing `'null'` resets emulation to system defaults. Defaults to `'light'`.
         forced_colors : Union["active", "none", "null", None]
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -14383,9 +14387,12 @@ def launch(
             resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
             Firefox or WebKit, use at your own risk.
         channel : Union[str, None]
-            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
-            "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
-            [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
+            Browser distribution channel.
+
+            Use "chromium" to [opt in to new headless mode](../browsers.md#opt-in-to-new-headless-mode).
+
+            Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
+            "msedge-canary" to use branded [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
         args : Union[Sequence[str], None]
             **NOTE** Use custom browser args at your own risk, as some of them may break Playwright functionality.
 
@@ -14540,9 +14547,12 @@ def launch_persistent_context(
             user data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty
             string to use a temporary directory instead.
         channel : Union[str, None]
-            Browser distribution channel.  Supported values are "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
-            "msedge", "msedge-beta", "msedge-dev", "msedge-canary". Read more about using
-            [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
+            Browser distribution channel.
+
+            Use "chromium" to [opt in to new headless mode](../browsers.md#opt-in-to-new-headless-mode).
+
+            Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
+            "msedge-canary" to use branded [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
         executable_path : Union[pathlib.Path, str, None]
             Path to a browser executable to run instead of the bundled one. If `executablePath` is a relative path, then it is
             resolved relative to the current working directory. Note that Playwright only works with the bundled Chromium,
@@ -14632,9 +14642,9 @@ def launch_persistent_context(
             Specifies if viewport supports touch events. Defaults to false. Learn more about
             [mobile emulation](../emulation.md#devices).
         color_scheme : Union["dark", "light", "no-preference", "null", None]
-            Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. See
-            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
-            `'light'`.
+            Emulates [prefers-colors-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme)
+            media feature, supported values are `'light'` and `'dark'`. See `page.emulate_media()` for more details.
+            Passing `'null'` resets emulation to system defaults. Defaults to `'light'`.
         reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -15133,6 +15143,48 @@ def stop(
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.stop(path=path)))
 
+    def group(
+        self, name: str, *, location: typing.Optional[TracingGroupLocation] = None
+    ) -> None:
+        """Tracing.group
+
+        **NOTE** Use `test.step` instead when available.
+
+        Creates a new group within the trace, assigning any subsequent API calls to this group, until
+        `tracing.group_end()` is called. Groups can be nested and will be visible in the trace viewer.
+
+        **Usage**
+
+        ```py
+        # All actions between group and group_end
+        # will be shown in the trace viewer as a group.
+        await page.context.tracing.group(\"Open Playwright.dev > API\")
+        await page.goto(\"https://playwright.dev/\")
+        await page.get_by_role(\"link\", name=\"API\").click()
+        await page.context.tracing.group_end()
+        ```
+
+        Parameters
+        ----------
+        name : str
+            Group name shown in the trace viewer.
+        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.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.group(name=name, location=location))
+        )
+
+    def group_end(self) -> None:
+        """Tracing.group_end
+
+        Closes the last group created by `tracing.group()`.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.group_end()))
+
 
 mapping.register(TracingImpl, Tracing)
 
@@ -17191,6 +17243,61 @@ def screenshot(
             )
         )
 
+    def aria_snapshot(self, *, timeout: typing.Optional[float] = 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
+        `locator_assertions.to_match_aria_snapshot()` for the corresponding assertion.
+
+        **Usage**
+
+        ```py
+        page.get_by_role(\"link\").aria_snapshot()
+        ```
+
+        **Details**
+
+        This method captures the aria snapshot of the given element. The snapshot is a string that represents the state of
+        the element and its children. The snapshot can be used to assert the state of the element in the test, or to
+        compare it to state in the future.
+
+        The ARIA snapshot is represented using [YAML](https://yaml.org/spec/1.2.2/) markup language:
+        - The keys of the objects are the roles and optional accessible names of the elements.
+        - The values are either text content or an array of child elements.
+        - Generic static text can be represented with the `text` key.
+
+        Below is the HTML markup and the respective ARIA snapshot:
+
+        ```html
+        <ul aria-label=\"Links\">
+          <li><a href=\"/\">Home</a></li>
+          <li><a href=\"/about\">About</a></li>
+        <ul>
+        ```
+
+        ```yml
+        - list \"Links\":
+          - listitem:
+            - link \"Home\"
+          - listitem:
+            - link \"About\"
+        ```
+
+        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.
+
+        Returns
+        -------
+        str
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.aria_snapshot(timeout=timeout))
+        )
+
     def scroll_into_view_if_needed(
         self, *, timeout: typing.Optional[float] = None
     ) -> None:
@@ -20551,6 +20658,62 @@ def not_to_have_role(
             self._sync(self._impl_obj.not_to_have_role(role=role, timeout=timeout))
         )
 
+    def to_match_aria_snapshot(
+        self, expected: str, *, timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.to_match_aria_snapshot
+
+        Asserts that the target element matches the given [accessibility snapshot](https://playwright.dev/python/docs/aria-snapshots).
+
+        **Usage**
+
+        ```py
+        page.goto(\"https://demo.playwright.dev/todomvc/\")
+        expect(page.locator('body')).to_match_aria_snapshot('''
+          - heading \"todos\"
+          - textbox \"What needs to be done?\"
+        ''')
+        ```
+
+        Parameters
+        ----------
+        expected : str
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.to_match_aria_snapshot(
+                    expected=expected, timeout=timeout
+                )
+            )
+        )
+
+    def not_to_match_aria_snapshot(
+        self, expected: str, *, timeout: typing.Optional[float] = None
+    ) -> None:
+        """LocatorAssertions.not_to_match_aria_snapshot
+
+        The opposite of `locator_assertions.to_match_aria_snapshot()`.
+
+        Parameters
+        ----------
+        expected : str
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.not_to_match_aria_snapshot(
+                    expected=expected, timeout=timeout
+                )
+            )
+        )
+
 
 mapping.register(LocatorAssertionsImpl, LocatorAssertions)
 
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index e609dae73..01f8f525a 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -225,7 +225,7 @@ def return_value(value: Any) -> List[str]:
 
 
 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
+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
 from playwright._impl._browser_type import BrowserType as BrowserTypeImpl
diff --git a/setup.py b/setup.py
index ead8dad3d..b4576c6a1 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.48.1"
+driver_version = "1.49.0-beta-1732210972000"
 
 base_wheel_bundles = [
     {
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index af4516f87..b89ebd7f2 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -32,6 +32,11 @@
 from .utils import Utils
 
 
+@pytest.fixture(scope="session")
+def fails_on_401(browser_name: str, is_headless_shell: bool) -> bool:
+    return browser_name == "chromium" and not is_headless_shell
+
+
 async def test_page_event_should_create_new_context(browser: Browser) -> None:
     assert len(browser.contexts) == 0
     context = await browser.new_context()
@@ -472,13 +477,17 @@ def logme(t: JSHandle) -> int:
 
 
 async def test_auth_should_fail_without_credentials(
-    context: BrowserContext, server: Server
+    context: BrowserContext, server: Server, fails_on_401: bool
 ) -> None:
     server.set_auth("/empty.html", "user", "pass")
     page = await context.new_page()
-    response = await page.goto(server.EMPTY_PAGE)
-    assert response
-    assert response.status == 401
+    try:
+        response = await page.goto(server.EMPTY_PAGE)
+        assert response
+        assert response.status == 401
+    except Error as exc:
+        assert fails_on_401
+        assert "net::ERR_INVALID_AUTH_CREDENTIALS" in exc.message
 
 
 async def test_auth_should_work_with_correct_credentials(
@@ -562,7 +571,7 @@ async def test_should_work_with_correct_credentials_and_matching_origin_case_ins
 
 
 async def test_should_fail_with_correct_credentials_and_mismatching_scheme(
-    browser: Browser, server: Server
+    browser: Browser, server: Server, fails_on_401: bool
 ) -> None:
     server.set_auth("/empty.html", "user", "pass")
     context = await browser.new_context(
@@ -573,14 +582,18 @@ async def test_should_fail_with_correct_credentials_and_mismatching_scheme(
         }
     )
     page = await context.new_page()
-    response = await page.goto(server.EMPTY_PAGE)
-    assert response
-    assert response.status == 401
+    try:
+        response = await page.goto(server.EMPTY_PAGE)
+        assert response
+        assert response.status == 401
+    except Error as exc:
+        assert fails_on_401
+        assert "net::ERR_INVALID_AUTH_CREDENTIALS" in exc.message
     await context.close()
 
 
 async def test_should_fail_with_correct_credentials_and_mismatching_hostname(
-    browser: Browser, server: Server
+    browser: Browser, server: Server, fails_on_401: bool
 ) -> None:
     server.set_auth("/empty.html", "user", "pass")
     hostname = urlparse(server.PREFIX).hostname
@@ -590,14 +603,18 @@ async def test_should_fail_with_correct_credentials_and_mismatching_hostname(
         http_credentials={"username": "user", "password": "pass", "origin": origin}
     )
     page = await context.new_page()
-    response = await page.goto(server.EMPTY_PAGE)
-    assert response
-    assert response.status == 401
+    try:
+        response = await page.goto(server.EMPTY_PAGE)
+        assert response
+        assert response.status == 401
+    except Error as exc:
+        assert fails_on_401
+        assert "net::ERR_INVALID_AUTH_CREDENTIALS" in exc.message
     await context.close()
 
 
 async def test_should_fail_with_correct_credentials_and_mismatching_port(
-    browser: Browser, server: Server
+    browser: Browser, server: Server, fails_on_401: bool
 ) -> None:
     server.set_auth("/empty.html", "user", "pass")
     origin = server.PREFIX.replace(str(server.PORT), str(server.PORT + 1))
@@ -605,9 +622,13 @@ async def test_should_fail_with_correct_credentials_and_mismatching_port(
         http_credentials={"username": "user", "password": "pass", "origin": origin}
     )
     page = await context.new_page()
-    response = await page.goto(server.EMPTY_PAGE)
-    assert response
-    assert response.status == 401
+    try:
+        response = await page.goto(server.EMPTY_PAGE)
+        assert response
+        assert response.status == 401
+    except Error as exc:
+        assert fails_on_401
+        assert "net::ERR_INVALID_AUTH_CREDENTIALS" in exc.message
     await context.close()
 
 
diff --git a/tests/async/test_emulation_focus.py b/tests/async/test_emulation_focus.py
index a59d549f4..8f298f9ca 100644
--- a/tests/async/test_emulation_focus.py
+++ b/tests/async/test_emulation_focus.py
@@ -12,7 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 import asyncio
-from typing import Callable
 
 from playwright.async_api import Page
 from tests.server import Server
@@ -106,29 +105,6 @@ async def test_should_change_document_activeElement(page: Page, server: Server)
     assert active == ["INPUT", "TEXTAREA"]
 
 
-async def test_should_not_affect_screenshots(
-    page: Page, server: Server, assert_to_be_golden: Callable[[bytes, str], None]
-) -> None:
-    # Firefox headed produces a different image.
-    page2 = await page.context.new_page()
-    await asyncio.gather(
-        page.set_viewport_size({"width": 500, "height": 500}),
-        page.goto(server.PREFIX + "/grid.html"),
-        page2.set_viewport_size({"width": 50, "height": 50}),
-        page2.goto(server.PREFIX + "/grid.html"),
-    )
-    await asyncio.gather(
-        page.focus("body"),
-        page2.focus("body"),
-    )
-    screenshots = await asyncio.gather(
-        page.screenshot(),
-        page2.screenshot(),
-    )
-    assert_to_be_golden(screenshots[0], "screenshot-sanity.png")
-    assert_to_be_golden(screenshots[1], "grid-cell-0.png")
-
-
 async def test_should_change_focused_iframe(
     page: Page, server: Server, utils: Utils
 ) -> None:
diff --git a/tests/async/test_network.py b/tests/async/test_network.py
index 0725516bd..cbeead601 100644
--- a/tests/async/test_network.py
+++ b/tests/async/test_network.py
@@ -855,12 +855,12 @@ async def test_set_extra_http_headers_should_throw_for_non_string_header_values(
 
 
 async def test_response_server_addr(page: Page, server: Server) -> None:
-    response = await page.goto(f"http://127.0.0.1:{server.PORT}")
+    response = await page.goto(server.EMPTY_PAGE)
     assert response
     server_addr = await response.server_addr()
     assert server_addr
     assert server_addr["port"] == server.PORT
-    assert server_addr["ipAddress"] in ["127.0.0.1", "::1"]
+    assert server_addr["ipAddress"] in ["127.0.0.1", "[::1]"]
 
 
 async def test_response_security_details(
diff --git a/tests/async/test_page_aria_snapshot.py b/tests/async/test_page_aria_snapshot.py
new file mode 100644
index 000000000..f84440ca4
--- /dev/null
+++ b/tests/async/test_page_aria_snapshot.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 re
+
+from playwright.async_api import Locator, Page, expect
+
+
+def _unshift(snapshot: str) -> str:
+    lines = snapshot.split("\n")
+    whitespace_prefix_length = 100
+    for line in lines:
+        if not line.strip():
+            continue
+        match = re.match(r"^(\s*)", line)
+        if match and len(match[1]) < whitespace_prefix_length:
+            whitespace_prefix_length = len(match[1])
+    return "\n".join(
+        [line[whitespace_prefix_length:] for line in lines if line.strip()]
+    )
+
+
+async def check_and_match_snapshot(locator: Locator, snapshot: str) -> None:
+    assert await locator.aria_snapshot() == _unshift(snapshot)
+    await expect(locator).to_match_aria_snapshot(snapshot)
+
+
+async def test_should_snapshot(page: Page) -> None:
+    await page.set_content("<h1>title</h1>")
+    await check_and_match_snapshot(
+        page.locator("body"),
+        """
+      - heading "title" [level=1]
+    """,
+    )
+
+
+async def test_should_snapshot_list(page: Page) -> None:
+    await page.set_content("<h1>title</h1><h1>title 2</h1>")
+    await check_and_match_snapshot(
+        page.locator("body"),
+        """
+      - heading "title" [level=1]
+      - heading "title 2" [level=1]
+    """,
+    )
+
+
+async def test_should_snapshot_list_with_list(page: Page) -> None:
+    await page.set_content("<ul><li>one</li><li>two</li></ul>")
+    await check_and_match_snapshot(
+        page.locator("body"),
+        """
+      - list:
+        - listitem: one
+        - listitem: two
+    """,
+    )
+
+
+async def test_should_snapshot_list_with_accessible_name(page: Page) -> None:
+    await page.set_content('<ul aria-label="my list"><li>one</li><li>two</li></ul>')
+    await check_and_match_snapshot(
+        page.locator("body"),
+        """
+      - list "my list":
+        - listitem: one
+        - listitem: two
+    """,
+    )
+
+
+async def test_should_snapshot_complex(page: Page) -> None:
+    await page.set_content('<ul><li><a href="about:blank">link</a></li></ul>')
+    await check_and_match_snapshot(
+        page.locator("body"),
+        """
+      - list:
+        - listitem:
+          - link "link"
+    """,
+    )
diff --git a/tests/async/test_route_web_socket.py b/tests/async/test_route_web_socket.py
index 4996aff60..2ebda4b9e 100644
--- a/tests/async/test_route_web_socket.py
+++ b/tests/async/test_route_web_socket.py
@@ -17,6 +17,7 @@
 from typing import Any, Awaitable, Callable, Literal, Tuple, Union
 
 from playwright.async_api import Frame, Page, WebSocketRoute
+from playwright.async_api._generated import Browser
 from tests.server import Server, WebSocketProtocol
 
 
@@ -319,3 +320,29 @@ def _ws_on_message(message: Union[str, bytes]) -> None:
             "close code=3008 reason=oops wasClean=true",
         ],
     )
+
+
+async def test_should_work_with_base_url(browser: Browser, server: Server) -> None:
+    context = await browser.new_context(base_url=f"http://localhost:{server.PORT}")
+    page = await context.new_page()
+
+    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 page.evaluate(
+        """async () => {
+        await window.wsOpened;
+        window.ws.send('echo');
+    }"""
+    )
+
+    await assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=echo origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index dae1be6ec..88db1577e 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -312,3 +312,36 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
         "trace.stacks",
         "trace.trace",
     ]
+
+
+async def test_should_show_tracing_group_in_action_list(
+    context: BrowserContext, tmp_path: Path
+) -> None:
+    await context.tracing.start()
+    page = await context.new_page()
+
+    await context.tracing.group("outer group")
+    await page.goto("data:text/html,<!DOCTYPE html><body><div>Hello world</div></body>")
+    await context.tracing.group("inner group 1")
+    await page.locator("body").click()
+    await context.tracing.group_end()
+    await context.tracing.group("inner group 2")
+    await page.get_by_text("Hello").is_visible()
+    await context.tracing.group_end()
+    await context.tracing.group_end()
+
+    trace_path = tmp_path / "trace.zip"
+    await context.tracing.stop(path=trace_path)
+
+    (resources, events) = parse_trace(trace_path)
+    actions = get_trace_actions(events)
+
+    assert actions == [
+        "BrowserContext.new_page",
+        "outer group",
+        "Page.goto",
+        "inner group 1",
+        "Locator.click",
+        "inner group 2",
+        "Locator.is_visible",
+    ]
diff --git a/tests/async/test_websocket.py b/tests/async/test_websocket.py
index 9b006f15d..696311a6b 100644
--- a/tests/async/test_websocket.py
+++ b/tests/async/test_websocket.py
@@ -172,7 +172,7 @@ async def test_should_reject_wait_for_event_on_close_and_error(
 
 
 async def test_should_emit_error_event(
-    page: Page, server: Server, browser_name: str
+    page: Page, server: Server, browser_name: str, browser_channel: str
 ) -> None:
     future: "asyncio.Future[str]" = asyncio.Future()
 
@@ -194,4 +194,4 @@ def _on_websocket(websocket: WebSocket) -> None:
     if browser_name == "firefox":
         assert err == "CLOSE_ABNORMAL"
     else:
-        assert ": 404" in err
+        assert ("" if browser_channel == "msedge" else ": 404") in err
diff --git a/tests/conftest.py b/tests/conftest.py
index 968f10b2b..d4909bcf5 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -91,6 +91,14 @@ def browser_channel(pytestconfig: pytest.Config) -> Optional[str]:
     return cast(Optional[str], pytestconfig.getoption("--browser-channel"))
 
 
+@pytest.fixture(scope="session")
+def is_headless_shell(browser_name: str, browser_channel: str, headless: bool) -> bool:
+    return browser_name == "chromium" and (
+        browser_channel == "chromium-headless-shell"
+        or (not browser_channel and headless)
+    )
+
+
 @pytest.fixture(scope="session")
 def is_webkit(browser_name: str) -> bool:
     return browser_name == "webkit"
diff --git a/tests/server.py b/tests/server.py
index 89048b0ba..cc8145317 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -110,6 +110,7 @@ def process(self) -> None:
             if not creds_correct:
                 self.setHeader(b"www-authenticate", 'Basic realm="Secure Area"')
                 self.setResponseCode(HTTPStatus.UNAUTHORIZED)
+                self.write(b"HTTP Error 401 Unauthorized: Access is denied")
                 self.finish()
                 return
         if server.csp.get(path):
@@ -133,7 +134,10 @@ def process(self) -> None:
                 self.write(file_content)
             self.setResponseCode(HTTPStatus.OK)
         except (FileNotFoundError, IsADirectoryError, PermissionError):
+            self.setHeader(b"Content-Type", "text/plain")
             self.setResponseCode(HTTPStatus.NOT_FOUND)
+            if self.method != "HEAD":
+                self.write(f"File not found: {path}".encode())
         self.finish()
 
 
diff --git a/tests/sync/test_network.py b/tests/sync/test_network.py
index 2ec6d7da9..9ba91c431 100644
--- a/tests/sync/test_network.py
+++ b/tests/sync/test_network.py
@@ -19,12 +19,12 @@
 
 
 def test_response_server_addr(page: Page, server: Server) -> None:
-    response = page.goto(f"http://127.0.0.1:{server.PORT}")
+    response = page.goto(server.EMPTY_PAGE)
     assert response
     server_addr = response.server_addr()
     assert server_addr
     assert server_addr["port"] == server.PORT
-    assert server_addr["ipAddress"] in ["127.0.0.1", "::1"]
+    assert server_addr["ipAddress"] in ["127.0.0.1", "[::1]"]
 
 
 def test_response_security_details(
diff --git a/tests/sync/test_page_aria_snapshot.py b/tests/sync/test_page_aria_snapshot.py
new file mode 100644
index 000000000..481b2bf7a
--- /dev/null
+++ b/tests/sync/test_page_aria_snapshot.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 re
+
+from playwright.sync_api import Locator, Page, expect
+
+
+def _unshift(snapshot: str) -> str:
+    lines = snapshot.split("\n")
+    whitespace_prefix_length = 100
+    for line in lines:
+        if not line.strip():
+            continue
+        match = re.match(r"^(\s*)", line)
+        if match and len(match[1]) < whitespace_prefix_length:
+            whitespace_prefix_length = len(match[1])
+    return "\n".join(
+        [line[whitespace_prefix_length:] for line in lines if line.strip()]
+    )
+
+
+def check_and_match_snapshot(locator: Locator, snapshot: str) -> None:
+    assert locator.aria_snapshot() == _unshift(snapshot)
+    expect(locator).to_match_aria_snapshot(snapshot)
+
+
+def test_should_snapshot(page: Page) -> None:
+    page.set_content("<h1>title</h1>")
+    check_and_match_snapshot(
+        page.locator("body"),
+        """
+      - heading "title" [level=1]
+    """,
+    )
+
+
+def test_should_snapshot_list(page: Page) -> None:
+    page.set_content("<h1>title</h1><h1>title 2</h1>")
+    check_and_match_snapshot(
+        page.locator("body"),
+        """
+      - heading "title" [level=1]
+      - heading "title 2" [level=1]
+    """,
+    )
+
+
+def test_should_snapshot_list_with_list(page: Page) -> None:
+    page.set_content("<ul><li>one</li><li>two</li></ul>")
+    check_and_match_snapshot(
+        page.locator("body"),
+        """
+      - list:
+        - listitem: one
+        - listitem: two
+    """,
+    )
+
+
+def test_should_snapshot_list_with_accessible_name(page: Page) -> None:
+    page.set_content('<ul aria-label="my list"><li>one</li><li>two</li></ul>')
+    check_and_match_snapshot(
+        page.locator("body"),
+        """
+      - list "my list":
+        - listitem: one
+        - listitem: two
+    """,
+    )
+
+
+def test_should_snapshot_complex(page: Page) -> None:
+    page.set_content('<ul><li><a href="about:blank">link</a></li></ul>')
+    check_and_match_snapshot(
+        page.locator("body"),
+        """
+      - list:
+        - listitem:
+          - link "link"
+    """,
+    )
diff --git a/tests/sync/test_route_web_socket.py b/tests/sync/test_route_web_socket.py
index 11e509cee..a22a6e883 100644
--- a/tests/sync/test_route_web_socket.py
+++ b/tests/sync/test_route_web_socket.py
@@ -16,7 +16,7 @@
 import time
 from typing import Any, Awaitable, Callable, Literal, Optional, Union
 
-from playwright.sync_api import Frame, Page, WebSocketRoute
+from playwright.sync_api import Browser, Frame, Page, WebSocketRoute
 from tests.server import Server, WebSocketProtocol
 
 
@@ -314,3 +314,29 @@ def _ws_on_message(message: Union[str, bytes]) -> None:
             "close code=3008 reason=oops wasClean=true",
         ],
     )
+
+
+def test_should_work_with_base_url(browser: Browser, server: Server) -> None:
+    context = browser.new_context(base_url=f"http://localhost:{server.PORT}")
+    page = context.new_page()
+
+    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")
+
+    page.evaluate(
+        """async () => {
+        await window.wsOpened;
+        window.ws.send('echo');
+    }"""
+    )
+
+    assert_equal(
+        lambda: page.evaluate("window.log"),
+        [
+            "open",
+            f"message: data=echo origin=ws://localhost:{server.PORT} lastEventId=",
+        ],
+    )
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index 98a6f61db..882521b3f 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -305,3 +305,36 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
         "trace.stacks",
         "trace.trace",
     ]
+
+
+def test_should_show_tracing_group_in_action_list(
+    context: BrowserContext, tmp_path: Path
+) -> None:
+    context.tracing.start()
+    page = context.new_page()
+
+    context.tracing.group("outer group")
+    page.goto("data:text/html,<!DOCTYPE html><body><div>Hello world</div></body>")
+    context.tracing.group("inner group 1")
+    page.locator("body").click()
+    context.tracing.group_end()
+    context.tracing.group("inner group 2")
+    page.get_by_text("Hello").is_visible()
+    context.tracing.group_end()
+    context.tracing.group_end()
+
+    trace_path = tmp_path / "trace.zip"
+    context.tracing.stop(path=trace_path)
+
+    (resources, events) = parse_trace(trace_path)
+    actions = get_trace_actions(events)
+
+    assert actions == [
+        "BrowserContext.new_page",
+        "outer group",
+        "Page.goto",
+        "inner group 1",
+        "Locator.click",
+        "inner group 2",
+        "Locator.is_visible",
+    ]

From ebf26a62384e7312823d36e6ac6245e8d5708cd4 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 22 Nov 2024 13:17:38 +0100
Subject: [PATCH 303/438] devops: make wheels smaller (use deflate zip
 compression) (#2662)

---
 setup.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index b4576c6a1..b4212cb9d 100644
--- a/setup.py
+++ b/setup.py
@@ -148,7 +148,9 @@ def _build_wheel(
             extractall(zip, f"driver/{wheel_bundle['zip_name']}")
         wheel_location = without_platform + wheel_bundle["wheel"]
         shutil.copy(base_wheel_location, wheel_location)
-        with zipfile.ZipFile(wheel_location, "a") as zip:
+        with zipfile.ZipFile(
+            wheel_location, mode="a", compression=zipfile.ZIP_DEFLATED
+        ) as zip:
             driver_root = os.path.abspath(f"driver/{wheel_bundle['zip_name']}")
             for dir_path, _, files in os.walk(driver_root):
                 for file in files:

From 1cde2afdd64ad024dea758c9fb2bea41f6a8593b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 23 Nov 2024 21:08:52 +0100
Subject: [PATCH 304/438] build(deps): bump pyee from 12.0.0 to 12.1.1 (#2655)

---
 meta.yaml                     | 2 +-
 playwright/_impl/_artifact.py | 2 +-
 pyproject.toml                | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/meta.yaml b/meta.yaml
index cb2da8460..f9fc9d5ba 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -27,7 +27,7 @@ requirements:
   run:
     - python >=3.9
     - greenlet ==3.1.1
-    - pyee ==12.0.0
+    - pyee ==12.1.1
 
 test: # [build_platform == target_platform]
   requires:
diff --git a/playwright/_impl/_artifact.py b/playwright/_impl/_artifact.py
index d619c35e2..a5af44573 100644
--- a/playwright/_impl/_artifact.py
+++ b/playwright/_impl/_artifact.py
@@ -55,5 +55,5 @@ async def read_info_buffer(self) -> bytes:
         buffer = await stream.read_all()
         return buffer
 
-    async def cancel(self) -> None:
+    async def cancel(self) -> None:  # pyright: ignore[reportIncompatibleMethodOverride]
         await self._channel.send("cancel")
diff --git a/pyproject.toml b/pyproject.toml
index f250731fc..963a75a41 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -14,7 +14,7 @@ dynamic = ["version"]
 requires-python = ">=3.9"
 dependencies = [
     "greenlet==3.1.1",
-    "pyee==12.0.0",
+    "pyee==12.1.1",
 ]
 classifiers = [
     "Topic :: Software Development :: Testing",

From 3f0439633d8e80a09c25be664df1fc2ac53a846c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 25 Nov 2024 19:31:22 +0100
Subject: [PATCH 305/438] build(deps): bump setuptools from 75.5.0 to 75.6.0
 (#2668)

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 963a75a41..06681d51d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==75.5.0", "setuptools-scm==8.1.0", "wheel==0.45.0", "auditwheel==6.1.0"]
+requires = ["setuptools==75.6.0", "setuptools-scm==8.1.0", "wheel==0.45.0", "auditwheel==6.1.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From c5acc36f1f7cc3d61b9ef70f722f894a6e588793 Mon Sep 17 00:00:00 2001
From: Daniel Nordio <15243341+ttm56p@users.noreply.github.com>
Date: Wed, 27 Nov 2024 11:42:23 +0200
Subject: [PATCH 306/438] devops: fix build process producing wheels with
 incorrect RECORD (#2671)

---
 setup.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/setup.py b/setup.py
index b4212cb9d..f3e9690f2 100644
--- a/setup.py
+++ b/setup.py
@@ -165,13 +165,12 @@ def _build_wheel(
         for whlfile in glob.glob(os.path.join(self.dist_dir, "*.whl")):
             os.makedirs("wheelhouse", exist_ok=True)
             if InWheel:
-                with InWheel(
-                    in_wheel=whlfile,
-                    out_wheel=os.path.join("wheelhouse", os.path.basename(whlfile)),
-                ):
+                wheelhouse_whl = os.path.join("wheelhouse", os.path.basename(whlfile))
+                shutil.move(whlfile, wheelhouse_whl)
+                with InWheel(in_wheel=wheelhouse_whl, out_wheel=whlfile):
                     print(f"Updating RECORD file of {whlfile}")
         print("Copying new wheels")
-        shutil.move("wheelhouse", self.dist_dir)
+        shutil.rmtree("wheelhouse")
 
     def _download_and_extract_local_driver(
         self,

From 445f80a0d9864898d8f1cd0518c147b24850b873 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 27 Nov 2024 10:52:14 +0100
Subject: [PATCH 307/438] build(deps): bump wheel from 0.45.0 to 0.45.1 (#2667)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 06681d51d..b4de55327 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==75.6.0", "setuptools-scm==8.1.0", "wheel==0.45.0", "auditwheel==6.1.0"]
+requires = ["setuptools==75.6.0", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.1.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 1909d207ba7fc4ce4b0b39c5f5b7e4666c4d33a1 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 10 Dec 2024 09:22:35 -0800
Subject: [PATCH 308/438] chore: roll Playwright to v1.49.1 (#2684)

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

diff --git a/setup.py b/setup.py
index f3e9690f2..f4c93dc3c 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.49.0-beta-1732210972000"
+driver_version = "1.49.1"
 
 base_wheel_bundles = [
     {

From c686e25b82a77106fdc4fc2fa44c018cf14e0dd1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 10 Dec 2024 16:04:08 -0800
Subject: [PATCH 309/438] build(deps): bump pyopenssl from 24.2.1 to 24.3.0
 (#2676)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 3a1791441..cad04f4d0 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -8,7 +8,7 @@ objgraph==3.6.2
 Pillow==10.4.0
 pixelmatch==0.3.0
 pre-commit==3.5.0
-pyOpenSSL==24.2.1
+pyOpenSSL==24.3.0
 pytest==8.3.3
 pytest-asyncio==0.24.0
 pytest-cov==6.0.0

From 8429cf083ae3a61cbeaf90e99a5d352e619979e4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 10 Dec 2024 16:05:43 -0800
Subject: [PATCH 310/438] build(deps): bump pytest from 8.3.3 to 8.3.4 (#2678)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index cad04f4d0..3e01db05e 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,7 +9,7 @@ Pillow==10.4.0
 pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==24.3.0
-pytest==8.3.3
+pytest==8.3.4
 pytest-asyncio==0.24.0
 pytest-cov==6.0.0
 pytest-repeat==0.9.3

From 4f2cdde7af89a85d53ac3ea6e00823b7fd72ef25 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 10 Dec 2024 16:06:37 -0800
Subject: [PATCH 311/438] build(deps): bump twisted from 24.10.0 to 24.11.0
 (#2677)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 3e01db05e..5aa0b0fc4 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,6 +17,6 @@ pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.2.0
-twisted==24.10.0
+twisted==24.11.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20241016

From 00fbc3c6a6ca104c4d016b2341e42d7637ff171b Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 12 Dec 2024 15:38:07 -0800
Subject: [PATCH 312/438] fix(webSocketRoute): allow no trailing slash in route
 matching (#2687)

---
 playwright/_impl/_helper.py          |  6 ++++-
 tests/async/test_route_web_socket.py | 33 ++++++++++++++++++++++++++++
 tests/sync/test_route_web_socket.py  | 31 ++++++++++++++++++++++++++
 3 files changed, 69 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index d0737be07..538d5533a 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -34,7 +34,7 @@
     Union,
     cast,
 )
-from urllib.parse import urljoin
+from urllib.parse import urljoin, urlparse
 
 from playwright._impl._api_structures import NameValue
 from playwright._impl._errors import (
@@ -157,6 +157,10 @@ def url_matches(
             base_url = re.sub(r"^http", "ws", base_url)
         if base_url:
             match = urljoin(base_url, match)
+        parsed = urlparse(match)
+        if parsed.path == "":
+            parsed = parsed._replace(path="/")
+            match = parsed.geturl()
     if isinstance(match, str):
         match = glob_to_regex(match)
     if isinstance(match, Pattern):
diff --git a/tests/async/test_route_web_socket.py b/tests/async/test_route_web_socket.py
index 2ebda4b9e..465832adf 100644
--- a/tests/async/test_route_web_socket.py
+++ b/tests/async/test_route_web_socket.py
@@ -346,3 +346,36 @@ async def _handle_ws(ws: WebSocketRoute) -> None:
             f"message: data=echo origin=ws://localhost:{server.PORT} lastEventId=",
         ],
     )
+
+
+async def test_should_work_with_no_trailing_slash(page: Page, server: Server) -> None:
+    log: list[str] = []
+
+    async def handle_ws(ws: WebSocketRoute) -> None:
+        def on_message(message: Union[str, bytes]) -> None:
+            assert isinstance(message, str)
+            log.append(message)
+            ws.send("response")
+
+        ws.on_message(on_message)
+
+    # 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.evaluate(
+        """({ port }) => {
+            window.log = [];
+            // No trailing slash in WebSocket URL
+            window.ws = new WebSocket('ws://localhost:' + port);
+            window.ws.addEventListener('message', event => window.log.push(event.data));
+        }""",
+        {"port": server.PORT},
+    )
+
+    await assert_equal(
+        lambda: page.evaluate("window.ws.readyState"), 1  # WebSocket.OPEN
+    )
+    await page.evaluate("window.ws.send('query')")
+    await assert_equal(lambda: log, ["query"])
+    await assert_equal(lambda: page.evaluate("window.log"), ["response"])
diff --git a/tests/sync/test_route_web_socket.py b/tests/sync/test_route_web_socket.py
index a22a6e883..2e97ebd8d 100644
--- a/tests/sync/test_route_web_socket.py
+++ b/tests/sync/test_route_web_socket.py
@@ -340,3 +340,34 @@ def _handle_ws(ws: WebSocketRoute) -> None:
             f"message: data=echo origin=ws://localhost:{server.PORT} lastEventId=",
         ],
     )
+
+
+def test_should_work_with_no_trailing_slash(page: Page, server: Server) -> None:
+    log: list[str] = []
+
+    async def handle_ws(ws: WebSocketRoute) -> None:
+        def on_message(message: Union[str, bytes]) -> None:
+            assert isinstance(message, str)
+            log.append(message)
+            ws.send("response")
+
+        ws.on_message(on_message)
+
+    # No trailing slash in the route pattern
+    page.route_web_socket(f"ws://localhost:{server.PORT}", handle_ws)
+
+    page.goto("about:blank")
+    page.evaluate(
+        """({ port }) => {
+            window.log = [];
+            // No trailing slash in WebSocket URL
+            window.ws = new WebSocket('ws://localhost:' + port);
+            window.ws.addEventListener('message', event => window.log.push(event.data));
+        }""",
+        {"port": server.PORT},
+    )
+
+    assert_equal(lambda: page.evaluate("window.ws.readyState"), 1)  # WebSocket.OPEN
+    page.evaluate("window.ws.send('query')")
+    assert_equal(lambda: log, ["query"])
+    assert_equal(lambda: page.evaluate("window.log"), ["response"])

From 70c5031cc78439ae6ca6d03984a7de0d0eac7290 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 17 Dec 2024 14:03:29 +0100
Subject: [PATCH 313/438] build(deps): bump pytest-asyncio from 0.24.0 to
 0.25.0 (#2690)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 5aa0b0fc4..10dbe6eee 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -10,7 +10,7 @@ pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==24.3.0
 pytest==8.3.4
-pytest-asyncio==0.24.0
+pytest-asyncio==0.25.0
 pytest-cov==6.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1

From 6d777fedc2926452978d52ba3af3fe8328c4d2bf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 30 Dec 2024 11:45:43 +0100
Subject: [PATCH 314/438] build(deps): bump mypy from 1.13.0 to 1.14.0 (#2695)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 10dbe6eee..4f458d4a5 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ black==24.8.0
 build==1.2.2.post1
 flake8==7.1.1
 flaky==3.8.1
-mypy==1.13.0
+mypy==1.14.0
 objgraph==3.6.2
 Pillow==10.4.0
 pixelmatch==0.3.0

From 4ae12bd37016d7fe927076befdd974137fd69704 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 7 Jan 2025 15:26:59 +0300
Subject: [PATCH 315/438] build(deps): bump pytest-asyncio from 0.25.0 to
 0.25.1 (#2711)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 4f458d4a5..043bd5a31 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -10,7 +10,7 @@ pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==24.3.0
 pytest==8.3.4
-pytest-asyncio==0.25.0
+pytest-asyncio==0.25.1
 pytest-cov==6.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1

From dffa098606633b6ca4573c4ab12ba7808337ae07 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 22 Jan 2025 16:34:49 +0100
Subject: [PATCH 316/438] fix(webError): fix WebError when using sync API
 (#2721)

---
 playwright/_impl/_browser_context.py      |  5 ++++-
 playwright/_impl/_web_error.py            |  9 +++++++--
 playwright/async_api/__init__.py          |  2 ++
 playwright/sync_api/__init__.py           |  2 ++
 tests/async/test_browsercontext_events.py | 10 +++++++++-
 tests/sync/test_browsercontext_events.py  | 10 +++++++++-
 6 files changed, 33 insertions(+), 5 deletions(-)

diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index f415d5900..e5a9b14fd 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -692,7 +692,10 @@ def _on_dialog(self, dialog: Dialog) -> None:
                 asyncio.create_task(dialog.dismiss())
 
     def _on_page_error(self, error: Error, page: Optional[Page]) -> None:
-        self.emit(BrowserContext.Events.WebError, WebError(self._loop, page, error))
+        self.emit(
+            BrowserContext.Events.WebError,
+            WebError(self._loop, self._dispatcher_fiber, page, error),
+        )
         if page:
             page.emit(Page.Events.PageError, error)
 
diff --git a/playwright/_impl/_web_error.py b/playwright/_impl/_web_error.py
index eb1b51948..345f95b8f 100644
--- a/playwright/_impl/_web_error.py
+++ b/playwright/_impl/_web_error.py
@@ -13,7 +13,7 @@
 # limitations under the License.
 
 from asyncio import AbstractEventLoop
-from typing import Optional
+from typing import Any, Optional
 
 from playwright._impl._helper import Error
 from playwright._impl._page import Page
@@ -21,9 +21,14 @@
 
 class WebError:
     def __init__(
-        self, loop: AbstractEventLoop, page: Optional[Page], error: Error
+        self,
+        loop: AbstractEventLoop,
+        dispatcher_fiber: Any,
+        page: Optional[Page],
+        error: Error,
     ) -> None:
         self._loop = loop
+        self._dispatcher_fiber = dispatcher_fiber
         self._page = page
         self._error = error
 
diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index a64a066c2..be918f53c 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.py
@@ -60,6 +60,7 @@
     Selectors,
     Touchscreen,
     Video,
+    WebError,
     WebSocket,
     WebSocketRoute,
     Worker,
@@ -190,6 +191,7 @@ def __call__(
     "Touchscreen",
     "Video",
     "ViewportSize",
+    "WebError",
     "WebSocket",
     "WebSocketRoute",
     "Worker",
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index 80eaf71db..136433982 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -60,6 +60,7 @@
     Selectors,
     Touchscreen,
     Video,
+    WebError,
     WebSocket,
     WebSocketRoute,
     Worker,
@@ -190,6 +191,7 @@ def __call__(
     "Touchscreen",
     "Video",
     "ViewportSize",
+    "WebError",
     "WebSocket",
     "WebSocketRoute",
     "Worker",
diff --git a/tests/async/test_browsercontext_events.py b/tests/async/test_browsercontext_events.py
index a0a3b90eb..8ae14def6 100644
--- a/tests/async/test_browsercontext_events.py
+++ b/tests/async/test_browsercontext_events.py
@@ -17,7 +17,7 @@
 
 import pytest
 
-from playwright.async_api import Page
+from playwright.async_api import BrowserContext, Page
 from tests.utils import must
 
 from ..server import Server, TestServerRequest
@@ -198,3 +198,11 @@ async def test_page_error_event_should_work(page: Page) -> None:
     page_error = await page_error_info.value
     assert page_error.page == page
     assert "boom" in page_error.error.stack
+
+
+async def test_weberror_event_should_work(context: BrowserContext, page: Page) -> None:
+    async with context.expect_event("weberror") as error_info:
+        await page.goto('data:text/html,<script>throw new Error("Test")</script>')
+    error = await error_info.value
+    assert error.page == page
+    assert error.error.message == "Test"
diff --git a/tests/sync/test_browsercontext_events.py b/tests/sync/test_browsercontext_events.py
index 315fff0dc..6e44b76d5 100644
--- a/tests/sync/test_browsercontext_events.py
+++ b/tests/sync/test_browsercontext_events.py
@@ -16,7 +16,7 @@
 
 import pytest
 
-from playwright.sync_api import Dialog, Page
+from playwright.sync_api import BrowserContext, Dialog, Page
 
 from ..server import Server, TestServerRequest
 
@@ -198,3 +198,11 @@ def test_console_event_should_work_with_context_manager(page: Page) -> None:
     message = cm_info.value
     assert message.text == "hello"
     assert message.page == page
+
+
+def test_weberror_event_should_work(context: BrowserContext, page: Page) -> None:
+    with context.expect_event("weberror") as error_info:
+        page.goto('data:text/html,<script>throw new Error("Test")</script>')
+    error = error_info.value
+    assert error.page == page
+    assert error.error.message == "Test"

From b74a3dc17472aa9562d998a50cc3d36dc90af198 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Jan 2025 07:58:00 +0100
Subject: [PATCH 317/438] build(deps): bump mypy from 1.14.0 to 1.14.1 (#2703)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 043bd5a31..d0fc629c9 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ black==24.8.0
 build==1.2.2.post1
 flake8==7.1.1
 flaky==3.8.1
-mypy==1.14.0
+mypy==1.14.1
 objgraph==3.6.2
 Pillow==10.4.0
 pixelmatch==0.3.0

From 84e7e156e0acedf04120081aecf90b97e5d4a122 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Jan 2025 07:58:07 +0100
Subject: [PATCH 318/438] build(deps): bump auditwheel from 6.1.0 to 6.2.0
 (#2709)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index b4de55327..74484b0ca 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==75.6.0", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.1.0"]
+requires = ["setuptools==75.6.0", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 9010889cd6e2292e9bb6bdf1d75cf443d52c4edf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Jan 2025 07:58:22 +0100
Subject: [PATCH 319/438] build(deps): bump pillow from 10.4.0 to 11.1.0
 (#2710)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index d0fc629c9..2610edb4f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -5,7 +5,7 @@ flake8==7.1.1
 flaky==3.8.1
 mypy==1.14.1
 objgraph==3.6.2
-Pillow==10.4.0
+Pillow==11.1.0
 pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==24.3.0

From 4ecf61e18bec0de89d1eb540ad2ae1edb4ceffcc Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 27 Jan 2025 09:39:55 +0100
Subject: [PATCH 320/438] fix(assertions): allow tuple as valid input type for
 expected text values (#2723)

---
 playwright/_impl/_assertions.py | 2 +-
 tests/async/test_assertions.py  | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index fce405da7..b226e241f 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -874,7 +874,7 @@ def to_expected_text_values(
     ignoreCase: Optional[bool] = None,
 ) -> Sequence[ExpectedTextValue]:
     out: List[ExpectedTextValue] = []
-    assert isinstance(items, list)
+    assert isinstance(items, (list, tuple))
     for item in items:
         if isinstance(item, str):
             o = ExpectedTextValue(
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 88b9c1b4f..dc0a1e615 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -274,6 +274,10 @@ async def test_assertions_locator_to_have_text(page: Page, server: Server) -> No
     await expect(page.locator("div")).to_have_text(
         ["Text  1", re.compile(r"Text   \d+a")]
     )
+    # Should work with a tuple
+    await expect(page.locator("div")).to_have_text(
+        ("Text  1", re.compile(r"Text   \d+a"))
+    )
 
 
 @pytest.mark.parametrize(

From 9ab78abb3c72c6182051bcb9bcad543a71e0c08c Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 27 Jan 2025 16:18:56 +0100
Subject: [PATCH 321/438] chore: relax dependency versions (#2698)

---
 .azure-pipelines/publish.yml         | 1 +
 .github/workflows/ci.yml             | 3 +++
 .github/workflows/publish_docker.yml | 1 +
 .github/workflows/test_docker.yml    | 2 ++
 meta.yaml                            | 5 +++--
 pyproject.toml                       | 7 +++++--
 requirements.txt                     | 8 ++++++++
 7 files changed, 23 insertions(+), 4 deletions(-)
 create mode 100644 requirements.txt

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index 6674eaae2..0076089ab 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -38,6 +38,7 @@ extends:
         - script: |
             python -m pip install --upgrade pip
             pip install -r local-requirements.txt
+            pip install -r requirements.txt
             pip install -e .
             for wheel in $(python setup.py --list-wheels); do
               PLAYWRIGHT_TARGET_WHEEL=$wheel python -m build --wheel
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 624269f05..929b05b8b 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -30,6 +30,7 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r local-requirements.txt
+        pip install -r requirements.txt
         pip install -e .
         python -m build --wheel
         python -m playwright install --with-deps
@@ -88,6 +89,7 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r local-requirements.txt
+        pip install -r requirements.txt
         pip install -e .
         python -m build --wheel
         python -m playwright install --with-deps ${{ matrix.browser }}
@@ -134,6 +136,7 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r local-requirements.txt
+        pip install -r requirements.txt
         pip install -e .
         python -m build --wheel
         python -m playwright install ${{ matrix.browser-channel }} --with-deps
diff --git a/.github/workflows/publish_docker.yml b/.github/workflows/publish_docker.yml
index 99ac96c7f..7d83136bc 100644
--- a/.github/workflows/publish_docker.yml
+++ b/.github/workflows/publish_docker.yml
@@ -36,5 +36,6 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r local-requirements.txt
+        pip install -r requirements.txt
         pip install -e .
     - run: ./utils/docker/publish_docker.sh stable
diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index 9d70ae303..573370f13 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -36,6 +36,7 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r local-requirements.txt
+        pip install -r requirements.txt
         pip install -e .
     - name: Build Docker image
       run: bash utils/docker/build.sh --amd64 ${{ matrix.docker-image-variant }} playwright-python:localbuild-${{ matrix.docker-image-variant }}
@@ -45,6 +46,7 @@ jobs:
         # Fix permissions for Git inside the container
         docker exec "${CONTAINER_ID}" chown -R root:root /root/playwright
         docker exec "${CONTAINER_ID}" pip install -r local-requirements.txt
+        docker exec "${CONTAINER_ID}" pip install -r requirements.txt
         docker exec "${CONTAINER_ID}" pip install -e .
         docker exec "${CONTAINER_ID}" python -m build --wheel
         docker exec "${CONTAINER_ID}" xvfb-run pytest -vv tests/sync/
diff --git a/meta.yaml b/meta.yaml
index f9fc9d5ba..f78f0e90f 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -26,8 +26,9 @@ requirements:
     - setuptools_scm
   run:
     - python >=3.9
-    - greenlet ==3.1.1
-    - pyee ==12.1.1
+    # This should be the same as the dependencies in pyproject.toml
+    - greenlet>=3.1.1,<4.0.0
+    - pyee>=12,<13
 
 test: # [build_platform == target_platform]
   requires:
diff --git a/pyproject.toml b/pyproject.toml
index 74484b0ca..8c66a788a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -12,9 +12,12 @@ readme = "README.md"
 license = {text = "Apache-2.0"}
 dynamic = ["version"]
 requires-python = ">=3.9"
+# Please when changing dependencies run the following commands to update requirements.txt:
+# - pip install uv==0.5.4
+# - uv pip compile pyproject.toml -o requirements.txt
 dependencies = [
-    "greenlet==3.1.1",
-    "pyee==12.1.1",
+    "pyee>=12,<13",
+    "greenlet>=3.1.1,<4.0.0"
 ]
 classifiers = [
     "Topic :: Software Development :: Testing",
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 000000000..eaa753330
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,8 @@
+# This file was autogenerated by uv via the following command:
+#    uv pip compile pyproject.toml -o requirements.txt
+greenlet==3.1.1
+    # via playwright (pyproject.toml)
+pyee==12.1.1
+    # via playwright (pyproject.toml)
+typing-extensions==4.12.2
+    # via pyee

From 4712d3f4cebf8096d2b1c8125067ad99595996ad Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 27 Jan 2025 18:58:45 +0100
Subject: [PATCH 322/438] build(deps): bump pytest-asyncio from 0.25.1 to
 0.25.2 (#2724)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 2610edb4f..7134a315e 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -10,7 +10,7 @@ pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==24.3.0
 pytest==8.3.4
-pytest-asyncio==0.25.1
+pytest-asyncio==0.25.2
 pytest-cov==6.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1

From fb271bd2e919fba429fec35c0ee2cfe1136a5111 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 30 Jan 2025 14:06:41 +0100
Subject: [PATCH 323/438] chore(roll): roll Playwright to v1.50 (#2726)

---
 README.md                          |   4 +-
 playwright/_impl/_assertions.py    |  54 +++++++++--
 playwright/_impl/_network.py       |   2 +
 playwright/async_api/_generated.py | 141 ++++++++++++++++++++++-----
 playwright/sync_api/_generated.py  | 147 ++++++++++++++++++++++++-----
 setup.py                           |   2 +-
 tests/async/test_assertions.py     |  83 +++++++++++++++-
 tests/async/test_locators.py       |  18 +++-
 tests/async/test_tracing.py        |   2 -
 tests/sync/test_assertions.py      | 139 ++++++++++++++++++++++++++-
 tests/sync/test_locators.py        |  18 +++-
 tests/sync/test_tracing.py         |   2 -
 12 files changed, 538 insertions(+), 74 deletions(-)

diff --git a/README.md b/README.md
index 1efcead54..9a5529b13 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 -->131.0.6778.33<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->133.0.6943.16<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->18.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->132.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->134.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index b226e241f..8ec657531 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -525,14 +525,22 @@ async def to_be_checked(
         self,
         timeout: float = None,
         checked: bool = None,
+        indeterminate: bool = None,
     ) -> None:
         __tracebackhide__ = True
-        if checked is None:
-            checked = True
-        checked_string = "checked" if checked else "unchecked"
+        expected_value = {}
+        if indeterminate is not None:
+            expected_value["indeterminate"] = indeterminate
+        if checked is not None:
+            expected_value["checked"] = checked
+        checked_string: str
+        if indeterminate:
+            checked_string = "indeterminate"
+        else:
+            checked_string = "unchecked" if checked is False else "checked"
         await self._expect_impl(
-            ("to.be.checked" if checked else "to.be.unchecked"),
-            FrameExpectOptions(timeout=timeout),
+            "to.be.checked",
+            FrameExpectOptions(timeout=timeout, expectedValue=expected_value),
             None,
             f"Locator expected to be {checked_string}",
         )
@@ -726,7 +734,9 @@ async def to_have_accessible_description(
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
-        expected_values = to_expected_text_values([description], ignoreCase=ignoreCase)
+        expected_values = to_expected_text_values(
+            [description], ignoreCase=ignoreCase, normalize_white_space=True
+        )
         await self._expect_impl(
             "to.have.accessible.description",
             FrameExpectOptions(expectedText=expected_values, timeout=timeout),
@@ -750,7 +760,9 @@ async def to_have_accessible_name(
         timeout: float = None,
     ) -> None:
         __tracebackhide__ = True
-        expected_values = to_expected_text_values([name], ignoreCase=ignoreCase)
+        expected_values = to_expected_text_values(
+            [name], ignoreCase=ignoreCase, normalize_white_space=True
+        )
         await self._expect_impl(
             "to.have.accessible.name",
             FrameExpectOptions(expectedText=expected_values, timeout=timeout),
@@ -779,6 +791,34 @@ async def to_have_role(self, role: AriaRole, timeout: float = None) -> None:
             "Locator expected to have accessible role",
         )
 
+    async def to_have_accessible_error_message(
+        self,
+        errorMessage: Union[str, Pattern[str]],
+        ignoreCase: bool = None,
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        expected_values = to_expected_text_values(
+            [errorMessage], ignoreCase=ignoreCase, normalize_white_space=True
+        )
+        await self._expect_impl(
+            "to.have.accessible.error.message",
+            FrameExpectOptions(expectedText=expected_values, timeout=timeout),
+            None,
+            "Locator expected to have accessible error message",
+        )
+
+    async def not_to_have_accessible_error_message(
+        self,
+        errorMessage: Union[str, Pattern[str]],
+        ignoreCase: bool = None,
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        await self._not.to_have_accessible_error_message(
+            errorMessage=errorMessage, ignoreCase=ignoreCase, timeout=timeout
+        )
+
     async def not_to_have_role(self, role: AriaRole, timeout: float = None) -> None:
         __tracebackhide__ = True
         await self._not.to_have_role(role, timeout)
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 97bb049e3..4b15531af 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -131,6 +131,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        self._channel.mark_as_internal_type()
         self._redirected_from: Optional["Request"] = from_nullable_channel(
             initializer.get("redirectedFrom")
         )
@@ -767,6 +768,7 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        self._channel.mark_as_internal_type()
         self._request: Request = from_channel(self._initializer["request"])
         timing = self._initializer["timing"]
         self._request._timing["startTime"] = timing["startTime"]
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index e1480f5bf..7b92fbafb 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -6879,6 +6879,18 @@ async def pause_at(self, time: typing.Union[float, str, datetime.datetime]) -> N
         await page.clock.pause_at(\"2020-02-02\")
         ```
 
+        For best results, install the clock before navigating the page and set it to a time slightly before the intended
+        test time. This ensures that all timers run normally during page loading, preventing the page from getting stuck.
+        Once the page has fully loaded, you can safely use `clock.pause_at()` to pause the clock.
+
+        ```py
+        # Initialize clock with some time before the test time and let the page load
+        # naturally. `Date.now` will progress as the timers fire.
+        await page.clock.install(time=datetime.datetime(2024, 12, 10, 8, 0, 0))
+        await page.goto(\"http://localhost:3333\")
+        await page.clock.pause_at(datetime.datetime(2024, 12, 10, 10, 0, 0))
+        ```
+
         Parameters
         ----------
         time : Union[datetime.datetime, float, str]
@@ -8036,7 +8048,7 @@ def set_default_timeout(self, timeout: float) -> None:
         Parameters
         ----------
         timeout : float
-            Maximum time in milliseconds
+            Maximum time in milliseconds. Pass `0` to disable timeout.
         """
 
         return mapping.from_maybe_impl(
@@ -11497,8 +11509,6 @@ async def pdf(
 
         Returns the PDF buffer.
 
-        **NOTE** Generating a pdf is currently only supported in Chromium headless.
-
         `page.pdf()` generates a pdf of the page with `print` css media. To generate a pdf with `screen` media, call
         `page.emulate_media()` before calling `page.pdf()`:
 
@@ -12750,7 +12760,7 @@ def set_default_timeout(self, timeout: float) -> None:
         Parameters
         ----------
         timeout : float
-            Maximum time in milliseconds
+            Maximum time in milliseconds. Pass `0` to disable timeout.
         """
 
         return mapping.from_maybe_impl(
@@ -12858,9 +12868,13 @@ async def grant_permissions(
         Parameters
         ----------
         permissions : Sequence[str]
-            A permission or an array of permissions to grant. Permissions can be one of the following values:
+            A list of permissions to grant.
+
+            **NOTE** Supported permissions differ between browsers, and even between different versions of the same browser.
+            Any permission may stop working after an update.
+
+            Here are some permissions that may be supported by some browsers:
             - `'accelerometer'`
-            - `'accessibility-events'`
             - `'ambient-light-sensor'`
             - `'background-sync'`
             - `'camera'`
@@ -14161,9 +14175,9 @@ async def close(self, *, reason: typing.Optional[str] = None) -> None:
         In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from
         the browser server.
 
-        **NOTE** This is similar to force quitting the browser. Therefore, you should call `browser_context.close()`
-        on any `BrowserContext`'s you explicitly created earlier with `browser.new_context()` **before** calling
-        `browser.close()`.
+        **NOTE** This is similar to force-quitting the browser. To close pages gracefully and ensure you receive page close
+        events, call `browser_context.close()` on any `BrowserContext` instances you explicitly created earlier
+        using `browser.new_context()` **before** calling `browser.close()`.
 
         The `Browser` object itself is considered to be disposed and cannot be used anymore.
 
@@ -14346,7 +14360,7 @@ async def launch(
         channel : Union[str, None]
             Browser distribution channel.
 
-            Use "chromium" to [opt in to new headless mode](../browsers.md#opt-in-to-new-headless-mode).
+            Use "chromium" to [opt in to new headless mode](../browsers.md#chromium-new-headless-mode).
 
             Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
             "msedge-canary" to use branded [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
@@ -14504,7 +14518,7 @@ async def launch_persistent_context(
         channel : Union[str, None]
             Browser distribution channel.
 
-            Use "chromium" to [opt in to new headless mode](../browsers.md#opt-in-to-new-headless-mode).
+            Use "chromium" to [opt in to new headless mode](../browsers.md#chromium-new-headless-mode).
 
             Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
             "msedge-canary" to use branded [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
@@ -15522,7 +15536,6 @@ async def dispatch_event(
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
         ```py
-        # note you can only create data_transfer in chromium and firefox
         data_transfer = await page.evaluate_handle(\"new DataTransfer()\")
         await locator.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
         ```
@@ -16445,18 +16458,22 @@ def or_(self, locator: "Locator") -> "Locator":
 
         Creates a locator matching all elements that match one or both of the two locators.
 
-        Note that when both locators match something, the resulting locator will have multiple matches and violate
-        [locator strictness](https://playwright.dev/python/docs/locators#strictness) guidelines.
+        Note that when both locators match something, the resulting locator will have multiple matches, potentially causing
+        a [locator strictness](https://playwright.dev/python/docs/locators#strictness) violation.
 
         **Usage**
 
         Consider a scenario where you'd like to click on a \"New email\" button, but sometimes a security settings dialog
         shows up instead. In this case, you can wait for either a \"New email\" button, or a dialog and act accordingly.
 
+        **NOTE** If both \"New email\" button and security dialog appear on screen, the \"or\" locator will match both of them,
+        possibly throwing the [\"strict mode violation\" error](https://playwright.dev/python/docs/locators#strictness). In this case, you can use
+        `locator.first()` to only match one of them.
+
         ```py
         new_email = page.get_by_role(\"button\", name=\"New\")
         dialog = page.get_by_text(\"Confirm security settings\")
-        await expect(new_email.or_(dialog)).to_be_visible()
+        await expect(new_email.or_(dialog).first).to_be_visible()
         if (await dialog.is_visible()):
           await page.get_by_role(\"button\", name=\"Dismiss\").click()
         await new_email.click()
@@ -16877,7 +16894,9 @@ async def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
     async def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
         """Locator.is_editable
 
-        Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable).
+        Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable). If the target element is not an `<input>`,
+        `<textarea>`, `<select>`, `[contenteditable]` and does not have a role allowing `[aria-readonly]`, this method
+        throws an error.
 
         **NOTE** If you need to assert that an element is editable, prefer `locator_assertions.to_be_editable()` to
         avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
@@ -19056,24 +19075,26 @@ async def to_have_class(
     ) -> None:
         """LocatorAssertions.to_have_class
 
-        Ensures the `Locator` points to an element with given CSS classes. This needs to be a full match or using a relaxed
-        regular expression.
+        Ensures the `Locator` points to an element with given CSS classes. When a string is provided, it must fully match
+        the element's `class` attribute. To match individual classes or perform partial matches, use a regular expression:
 
         **Usage**
 
         ```html
-        <div class='selected row' id='component'></div>
+        <div class='middle selected row' id='component'></div>
         ```
 
         ```py
         from playwright.async_api import expect
 
         locator = page.locator(\"#component\")
-        await expect(locator).to_have_class(re.compile(r\"selected\"))
-        await expect(locator).to_have_class(\"selected row\")
+        await expect(locator).to_have_class(re.compile(r\"(^|\\\\s)selected(\\\\s|$)\"))
+        await expect(locator).to_have_class(\"middle selected row\")
         ```
 
-        Note that if array is passed as an expected value, entire lists of elements can be asserted:
+        When an array is passed, the method asserts that the list of elements located matches the corresponding list of
+        expected class values. Each element's class attribute is matched against the corresponding string or regular
+        expression in the array:
 
         ```py
         from playwright.async_api import expect
@@ -19656,6 +19677,7 @@ async def to_be_checked(
         *,
         timeout: typing.Optional[float] = None,
         checked: typing.Optional[bool] = None,
+        indeterminate: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.to_be_checked
 
@@ -19675,11 +19697,18 @@ async def to_be_checked(
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
         checked : Union[bool, None]
+            Provides state to assert for. Asserts for input to be checked by default. This option can't be used when
+            `indeterminate` is set to true.
+        indeterminate : Union[bool, None]
+            Asserts that the element is in the indeterminate (mixed) state. Only supported for checkboxes and radio buttons.
+            This option can't be true when `checked` is provided.
         """
         __tracebackhide__ = True
 
         return mapping.from_maybe_impl(
-            await self._impl_obj.to_be_checked(timeout=timeout, checked=checked)
+            await self._impl_obj.to_be_checked(
+                timeout=timeout, checked=checked, indeterminate=indeterminate
+            )
         )
 
     async def not_to_be_attached(
@@ -20373,6 +20402,72 @@ async def to_have_role(
             await self._impl_obj.to_have_role(role=role, timeout=timeout)
         )
 
+    async def to_have_accessible_error_message(
+        self,
+        error_message: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None,
+    ) -> None:
+        """LocatorAssertions.to_have_accessible_error_message
+
+        Ensures the `Locator` points to an element with a given
+        [aria errormessage](https://w3c.github.io/aria/#aria-errormessage).
+
+        **Usage**
+
+        ```py
+        locator = page.get_by_test_id(\"username-input\")
+        await expect(locator).to_have_accessible_error_message(\"Username is required.\")
+        ```
+
+        Parameters
+        ----------
+        error_message : Union[Pattern[str], str]
+            Expected accessible error message.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.to_have_accessible_error_message(
+                errorMessage=error_message, ignoreCase=ignore_case, timeout=timeout
+            )
+        )
+
+    async def not_to_have_accessible_error_message(
+        self,
+        error_message: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None,
+    ) -> None:
+        """LocatorAssertions.not_to_have_accessible_error_message
+
+        The opposite of `locator_assertions.to_have_accessible_error_message()`.
+
+        Parameters
+        ----------
+        error_message : Union[Pattern[str], str]
+            Expected accessible error message.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.not_to_have_accessible_error_message(
+                errorMessage=error_message, ignoreCase=ignore_case, timeout=timeout
+            )
+        )
+
     async def not_to_have_role(
         self,
         role: Literal[
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 42401bc64..04a0f10fc 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -6991,6 +6991,18 @@ def pause_at(self, time: typing.Union[float, str, datetime.datetime]) -> None:
         page.clock.pause_at(\"2020-02-02\")
         ```
 
+        For best results, install the clock before navigating the page and set it to a time slightly before the intended
+        test time. This ensures that all timers run normally during page loading, preventing the page from getting stuck.
+        Once the page has fully loaded, you can safely use `clock.pause_at()` to pause the clock.
+
+        ```py
+        # Initialize clock with some time before the test time and let the page load
+        # naturally. `Date.now` will progress as the timers fire.
+        page.clock.install(time=datetime.datetime(2024, 12, 10, 8, 0, 0))
+        page.goto(\"http://localhost:3333\")
+        page.clock.pause_at(datetime.datetime(2024, 12, 10, 10, 0, 0))
+        ```
+
         Parameters
         ----------
         time : Union[datetime.datetime, float, str]
@@ -8046,7 +8058,7 @@ def set_default_timeout(self, timeout: float) -> None:
         Parameters
         ----------
         timeout : float
-            Maximum time in milliseconds
+            Maximum time in milliseconds. Pass `0` to disable timeout.
         """
 
         return mapping.from_maybe_impl(
@@ -11585,8 +11597,6 @@ def pdf(
 
         Returns the PDF buffer.
 
-        **NOTE** Generating a pdf is currently only supported in Chromium headless.
-
         `page.pdf()` generates a pdf of the page with `print` css media. To generate a pdf with `screen` media, call
         `page.emulate_media()` before calling `page.pdf()`:
 
@@ -12778,7 +12788,7 @@ def set_default_timeout(self, timeout: float) -> None:
         Parameters
         ----------
         timeout : float
-            Maximum time in milliseconds
+            Maximum time in milliseconds. Pass `0` to disable timeout.
         """
 
         return mapping.from_maybe_impl(
@@ -12888,9 +12898,13 @@ def grant_permissions(
         Parameters
         ----------
         permissions : Sequence[str]
-            A permission or an array of permissions to grant. Permissions can be one of the following values:
+            A list of permissions to grant.
+
+            **NOTE** Supported permissions differ between browsers, and even between different versions of the same browser.
+            Any permission may stop working after an update.
+
+            Here are some permissions that may be supported by some browsers:
             - `'accelerometer'`
-            - `'accessibility-events'`
             - `'ambient-light-sensor'`
             - `'background-sync'`
             - `'camera'`
@@ -14202,9 +14216,9 @@ def close(self, *, reason: typing.Optional[str] = None) -> None:
         In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from
         the browser server.
 
-        **NOTE** This is similar to force quitting the browser. Therefore, you should call `browser_context.close()`
-        on any `BrowserContext`'s you explicitly created earlier with `browser.new_context()` **before** calling
-        `browser.close()`.
+        **NOTE** This is similar to force-quitting the browser. To close pages gracefully and ensure you receive page close
+        events, call `browser_context.close()` on any `BrowserContext` instances you explicitly created earlier
+        using `browser.new_context()` **before** calling `browser.close()`.
 
         The `Browser` object itself is considered to be disposed and cannot be used anymore.
 
@@ -14389,7 +14403,7 @@ def launch(
         channel : Union[str, None]
             Browser distribution channel.
 
-            Use "chromium" to [opt in to new headless mode](../browsers.md#opt-in-to-new-headless-mode).
+            Use "chromium" to [opt in to new headless mode](../browsers.md#chromium-new-headless-mode).
 
             Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
             "msedge-canary" to use branded [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
@@ -14549,7 +14563,7 @@ def launch_persistent_context(
         channel : Union[str, None]
             Browser distribution channel.
 
-            Use "chromium" to [opt in to new headless mode](../browsers.md#opt-in-to-new-headless-mode).
+            Use "chromium" to [opt in to new headless mode](../browsers.md#chromium-new-headless-mode).
 
             Use "chrome", "chrome-beta", "chrome-dev", "chrome-canary", "msedge", "msedge-beta", "msedge-dev", or
             "msedge-canary" to use branded [Google Chrome and Microsoft Edge](../browsers.md#google-chrome--microsoft-edge).
@@ -15578,7 +15592,6 @@ def dispatch_event(
         You can also specify `JSHandle` as the property value if you want live objects to be passed into the event:
 
         ```py
-        # note you can only create data_transfer in chromium and firefox
         data_transfer = page.evaluate_handle(\"new DataTransfer()\")
         locator.dispatch_event(\"#source\", \"dragstart\", {\"dataTransfer\": data_transfer})
         ```
@@ -16514,18 +16527,22 @@ def or_(self, locator: "Locator") -> "Locator":
 
         Creates a locator matching all elements that match one or both of the two locators.
 
-        Note that when both locators match something, the resulting locator will have multiple matches and violate
-        [locator strictness](https://playwright.dev/python/docs/locators#strictness) guidelines.
+        Note that when both locators match something, the resulting locator will have multiple matches, potentially causing
+        a [locator strictness](https://playwright.dev/python/docs/locators#strictness) violation.
 
         **Usage**
 
         Consider a scenario where you'd like to click on a \"New email\" button, but sometimes a security settings dialog
         shows up instead. In this case, you can wait for either a \"New email\" button, or a dialog and act accordingly.
 
+        **NOTE** If both \"New email\" button and security dialog appear on screen, the \"or\" locator will match both of them,
+        possibly throwing the [\"strict mode violation\" error](https://playwright.dev/python/docs/locators#strictness). In this case, you can use
+        `locator.first()` to only match one of them.
+
         ```py
         new_email = page.get_by_role(\"button\", name=\"New\")
         dialog = page.get_by_text(\"Confirm security settings\")
-        expect(new_email.or_(dialog)).to_be_visible()
+        expect(new_email.or_(dialog).first).to_be_visible()
         if (dialog.is_visible()):
           page.get_by_role(\"button\", name=\"Dismiss\").click()
         new_email.click()
@@ -16958,7 +16975,9 @@ def is_disabled(self, *, timeout: typing.Optional[float] = None) -> bool:
     def is_editable(self, *, timeout: typing.Optional[float] = None) -> bool:
         """Locator.is_editable
 
-        Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable).
+        Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable). If the target element is not an `<input>`,
+        `<textarea>`, `<select>`, `[contenteditable]` and does not have a role allowing `[aria-readonly]`, this method
+        throws an error.
 
         **NOTE** If you need to assert that an element is editable, prefer `locator_assertions.to_be_editable()` to
         avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
@@ -19201,24 +19220,26 @@ def to_have_class(
     ) -> None:
         """LocatorAssertions.to_have_class
 
-        Ensures the `Locator` points to an element with given CSS classes. This needs to be a full match or using a relaxed
-        regular expression.
+        Ensures the `Locator` points to an element with given CSS classes. When a string is provided, it must fully match
+        the element's `class` attribute. To match individual classes or perform partial matches, use a regular expression:
 
         **Usage**
 
         ```html
-        <div class='selected row' id='component'></div>
+        <div class='middle selected row' id='component'></div>
         ```
 
         ```py
         from playwright.sync_api import expect
 
         locator = page.locator(\"#component\")
-        expect(locator).to_have_class(re.compile(r\"selected\"))
-        expect(locator).to_have_class(\"selected row\")
+        expect(locator).to_have_class(re.compile(r\"(^|\\\\s)selected(\\\\s|$)\"))
+        expect(locator).to_have_class(\"middle selected row\")
         ```
 
-        Note that if array is passed as an expected value, entire lists of elements can be asserted:
+        When an array is passed, the method asserts that the list of elements located matches the corresponding list of
+        expected class values. Each element's class attribute is matched against the corresponding string or regular
+        expression in the array:
 
         ```py
         from playwright.sync_api import expect
@@ -19821,6 +19842,7 @@ def to_be_checked(
         *,
         timeout: typing.Optional[float] = None,
         checked: typing.Optional[bool] = None,
+        indeterminate: typing.Optional[bool] = None,
     ) -> None:
         """LocatorAssertions.to_be_checked
 
@@ -19840,11 +19862,20 @@ def to_be_checked(
         timeout : Union[float, None]
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
         checked : Union[bool, None]
+            Provides state to assert for. Asserts for input to be checked by default. This option can't be used when
+            `indeterminate` is set to true.
+        indeterminate : Union[bool, None]
+            Asserts that the element is in the indeterminate (mixed) state. Only supported for checkboxes and radio buttons.
+            This option can't be true when `checked` is provided.
         """
         __tracebackhide__ = True
 
         return mapping.from_maybe_impl(
-            self._sync(self._impl_obj.to_be_checked(timeout=timeout, checked=checked))
+            self._sync(
+                self._impl_obj.to_be_checked(
+                    timeout=timeout, checked=checked, indeterminate=indeterminate
+                )
+            )
         )
 
     def not_to_be_attached(
@@ -20552,6 +20583,76 @@ def to_have_role(
             self._sync(self._impl_obj.to_have_role(role=role, timeout=timeout))
         )
 
+    def to_have_accessible_error_message(
+        self,
+        error_message: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None,
+    ) -> None:
+        """LocatorAssertions.to_have_accessible_error_message
+
+        Ensures the `Locator` points to an element with a given
+        [aria errormessage](https://w3c.github.io/aria/#aria-errormessage).
+
+        **Usage**
+
+        ```py
+        locator = page.get_by_test_id(\"username-input\")
+        expect(locator).to_have_accessible_error_message(\"Username is required.\")
+        ```
+
+        Parameters
+        ----------
+        error_message : Union[Pattern[str], str]
+            Expected accessible error message.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.to_have_accessible_error_message(
+                    errorMessage=error_message, ignoreCase=ignore_case, timeout=timeout
+                )
+            )
+        )
+
+    def not_to_have_accessible_error_message(
+        self,
+        error_message: typing.Union[str, typing.Pattern[str]],
+        *,
+        ignore_case: typing.Optional[bool] = None,
+        timeout: typing.Optional[float] = None,
+    ) -> None:
+        """LocatorAssertions.not_to_have_accessible_error_message
+
+        The opposite of `locator_assertions.to_have_accessible_error_message()`.
+
+        Parameters
+        ----------
+        error_message : Union[Pattern[str], str]
+            Expected accessible error message.
+        ignore_case : Union[bool, None]
+            Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
+            expression flag if specified.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.not_to_have_accessible_error_message(
+                    errorMessage=error_message, ignoreCase=ignore_case, timeout=timeout
+                )
+            )
+        )
+
     def not_to_have_role(
         self,
         role: Literal[
diff --git a/setup.py b/setup.py
index f4c93dc3c..fc3933d79 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.49.1"
+driver_version = "1.50.0-beta-1738235262000"
 
 base_wheel_bundles = [
     {
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index dc0a1e615..06292aa9b 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -593,11 +593,20 @@ async def test_assertions_locator_to_be_enabled_eventually_with_not(page: Page)
 
 async def test_assertions_locator_to_be_editable(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
-    await page.set_content("<input></input><button disabled>Text</button>")
-    await expect(page.locator("button")).not_to_be_editable()
+    await page.set_content("<input></input>")
     await expect(page.locator("input")).to_be_editable()
-    with pytest.raises(AssertionError, match="Locator expected to be editable"):
-        await expect(page.locator("button")).to_be_editable(timeout=100)
+
+
+async def test_assertions_locator_to_be_editable_throws(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.set_content("<button disabled>Text</button>")
+    with pytest.raises(
+        Error,
+        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
+    ):
+        await expect(page.locator("button")).not_to_be_editable()
 
 
 async def test_assertions_locator_to_be_editable_with_true(page: Page) -> None:
@@ -983,6 +992,64 @@ async def test_to_have_accessible_name(page: Page) -> None:
         re.compile(r"hello"), ignore_case=True
     )
 
+    await page.set_content("<button>foo&nbsp;bar\nbaz</button>")
+    await expect(page.locator("button")).to_have_accessible_name("foo bar baz")
+
+
+async def test_to_have_accessible_error_message(page: Page) -> None:
+    await page.set_content(
+        """
+      <form>
+        <input role="textbox" aria-invalid="true" aria-errormessage="error-message" />
+        <div id="error-message">Hello</div>
+        <div id="irrelevant-error">This should not be considered.</div>
+      </form>
+    """
+    )
+
+    locator = page.locator('input[role="textbox"]')
+    await expect(locator).to_have_accessible_error_message("Hello")
+    await expect(locator).not_to_have_accessible_error_message("hello")
+    await expect(locator).to_have_accessible_error_message("hello", ignore_case=True)
+    await expect(locator).to_have_accessible_error_message(re.compile(r"ell\w"))
+    await expect(locator).not_to_have_accessible_error_message(re.compile(r"hello"))
+    await expect(locator).to_have_accessible_error_message(
+        re.compile(r"hello"), ignore_case=True
+    )
+    await expect(locator).not_to_have_accessible_error_message(
+        "This should not be considered."
+    )
+
+
+async def test_to_have_accessible_error_message_should_handle_multiple_aria_error_message_references(
+    page: Page,
+) -> None:
+    await page.set_content(
+        """
+      <form>
+        <input role="textbox" aria-invalid="true" aria-errormessage="error1 error2" />
+        <div id="error1">First error message.</div>
+        <div id="error2">Second error message.</div>
+        <div id="irrelevant-error">This should not be considered.</div>
+      </form>
+    """
+    )
+
+    locator = page.locator('input[role="textbox"]')
+
+    await expect(locator).to_have_accessible_error_message(
+        "First error message. Second error message."
+    )
+    await expect(locator).to_have_accessible_error_message(
+        re.compile(r"first error message.", re.IGNORECASE)
+    )
+    await expect(locator).to_have_accessible_error_message(
+        re.compile(r"second error message.", re.IGNORECASE)
+    )
+    await expect(locator).not_to_have_accessible_error_message(
+        re.compile(r"This should not be considered.", re.IGNORECASE)
+    )
+
 
 async def test_to_have_accessible_description(page: Page) -> None:
     await page.set_content('<div role="button" aria-description="Hello"></div>')
@@ -996,6 +1063,14 @@ async def test_to_have_accessible_description(page: Page) -> None:
         re.compile(r"hello"), ignore_case=True
     )
 
+    await page.set_content(
+        """
+        <div role="button" aria-describedby="desc"></div>
+        <span id="desc">foo&nbsp;bar\nbaz</span>
+    """
+    )
+    await expect(page.locator("div")).to_have_accessible_description("foo bar baz")
+
 
 async def test_to_have_role(page: Page) -> None:
     await page.set_content('<div role="button">Button!</div>')
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index b12a25a56..385538461 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -128,15 +128,27 @@ async def test_locators_is_enabled_and_is_disabled_should_work(page: Page) -> No
     )
 
     div = page.locator("div")
-    assert await div.is_enabled() is True
+    with pytest.raises(
+        Error,
+        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
+    ):
+        assert await div.is_enabled()
     assert await div.is_disabled() is False
 
     button1 = page.locator(':text("button1")')
-    assert await button1.is_enabled() is False
+    with pytest.raises(
+        Error,
+        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
+    ):
+        assert await button1.is_enabled()
     assert await button1.is_disabled() is True
 
     button1 = page.locator(':text("button2")')
-    assert await button1.is_enabled() is True
+    with pytest.raises(
+        Error,
+        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
+    ):
+        assert await button1.is_enabled()
     assert await button1.is_disabled() is False
 
 
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index 88db1577e..bb39f96f4 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -169,8 +169,6 @@ async def _handle_response(response: Response) -> None:
     assert events[0]["type"] == "context-options"
     assert get_trace_actions(events) == [
         "Page.goto",
-        "Request.all_headers",
-        "Response.text",
         "Page.close",
     ]
 
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 6f27e0a25..6aaffd49b 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -502,6 +502,31 @@ def test_assertions_locator_to_be_checked(page: Page, server: Server) -> None:
     expect(my_checkbox).to_be_checked()
 
 
+def test_assertions_boolean_checked_with_intermediate_true(page: Page) -> None:
+    page.set_content("<input type=checkbox></input>")
+    page.locator("input").evaluate("e => e.indeterminate = true")
+    expect(page.locator("input")).to_be_checked(indeterminate=True)
+
+
+def test_assertions_boolean_checked_with_intermediate_true_and_checked(
+    page: Page,
+) -> None:
+    page.set_content("<input type=checkbox></input>")
+    page.locator("input").evaluate("e => e.indeterminate = true")
+    with pytest.raises(
+        Error, match="Can't assert indeterminate and checked at the same time"
+    ):
+        expect(page.locator("input")).to_be_checked(checked=False, indeterminate=True)
+
+
+def test_assertions_boolean_fail_with_indeterminate_true(page: Page) -> None:
+    page.set_content("<input type=checkbox></input>")
+    with pytest.raises(
+        AssertionError, match="LocatorAssertions.to_be_checked with timeout 1000ms"
+    ):
+        expect(page.locator("input")).to_be_checked(indeterminate=True, timeout=1000)
+
+
 def test_assertions_locator_to_be_disabled_enabled(page: Page, server: Server) -> None:
     page.goto(server.EMPTY_PAGE)
     page.set_content("<input type=checkbox>")
@@ -567,11 +592,18 @@ def test_assertions_locator_to_be_enabled_eventually_with_not(page: Page) -> Non
 
 def test_assertions_locator_to_be_editable(page: Page, server: Server) -> None:
     page.goto(server.EMPTY_PAGE)
-    page.set_content("<input></input><button disabled>Text</button>")
-    expect(page.locator("button")).not_to_be_editable()
+    page.set_content("<input></input>")
     expect(page.locator("input")).to_be_editable()
-    with pytest.raises(AssertionError, match="Locator expected to be editable"):
-        expect(page.locator("button")).to_be_editable(timeout=100)
+
+
+def test_assertions_locator_to_be_editable_throws(page: Page, server: Server) -> None:
+    page.goto(server.EMPTY_PAGE)
+    page.set_content("<button disabled>Text</button>")
+    with pytest.raises(
+        Error,
+        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
+    ):
+        expect(page.locator("button")).not_to_be_editable()
 
 
 def test_assertions_locator_to_be_editable_with_true(page: Page) -> None:
@@ -912,3 +944,102 @@ def test_should_be_able_to_set_custom_global_timeout(page: Page) -> None:
         )
     finally:
         expect.set_options(timeout=5_000)
+
+
+def test_to_have_accessible_name(page: Page) -> None:
+    page.set_content('<div role="button" aria-label="Hello"></div>')
+    locator = page.locator("div")
+    expect(locator).to_have_accessible_name("Hello")
+    expect(locator).not_to_have_accessible_name("hello")
+    expect(locator).to_have_accessible_name("hello", ignore_case=True)
+    expect(locator).to_have_accessible_name(re.compile(r"ell\w"))
+    expect(locator).not_to_have_accessible_name(re.compile(r"hello"))
+    expect(locator).to_have_accessible_name(re.compile(r"hello"), ignore_case=True)
+
+    page.set_content("<button>foo&nbsp;bar\nbaz</button>")
+    expect(page.locator("button")).to_have_accessible_name("foo bar baz")
+
+
+def test_to_have_accessible_error_message(page: Page) -> None:
+    page.set_content(
+        """
+      <form>
+        <input role="textbox" aria-invalid="true" aria-errormessage="error-message" />
+        <div id="error-message">Hello</div>
+        <div id="irrelevant-error">This should not be considered.</div>
+      </form>
+    """
+    )
+
+    locator = page.locator('input[role="textbox"]')
+    expect(locator).to_have_accessible_error_message("Hello")
+    expect(locator).not_to_have_accessible_error_message("hello")
+    expect(locator).to_have_accessible_error_message("hello", ignore_case=True)
+    expect(locator).to_have_accessible_error_message(re.compile(r"ell\w"))
+    expect(locator).not_to_have_accessible_error_message(re.compile(r"hello"))
+    expect(locator).to_have_accessible_error_message(
+        re.compile(r"hello"), ignore_case=True
+    )
+    expect(locator).not_to_have_accessible_error_message(
+        "This should not be considered."
+    )
+
+
+def test_to_have_accessible_error_message_should_handle_multiple_aria_error_message_references(
+    page: Page,
+) -> None:
+    page.set_content(
+        """
+      <form>
+        <input role="textbox" aria-invalid="true" aria-errormessage="error1 error2" />
+        <div id="error1">First error message.</div>
+        <div id="error2">Second error message.</div>
+        <div id="irrelevant-error">This should not be considered.</div>
+      </form>
+    """
+    )
+
+    locator = page.locator('input[role="textbox"]')
+
+    expect(locator).to_have_accessible_error_message(
+        "First error message. Second error message."
+    )
+    expect(locator).to_have_accessible_error_message(
+        re.compile(r"first error message.", re.IGNORECASE)
+    )
+    expect(locator).to_have_accessible_error_message(
+        re.compile(r"second error message.", re.IGNORECASE)
+    )
+    expect(locator).not_to_have_accessible_error_message(
+        re.compile(r"This should not be considered.", re.IGNORECASE)
+    )
+
+
+def test_to_have_accessible_description(page: Page) -> None:
+    page.set_content('<div role="button" aria-description="Hello"></div>')
+    locator = page.locator("div")
+    expect(locator).to_have_accessible_description("Hello")
+    expect(locator).not_to_have_accessible_description("hello")
+    expect(locator).to_have_accessible_description("hello", ignore_case=True)
+    expect(locator).to_have_accessible_description(re.compile(r"ell\w"))
+    expect(locator).not_to_have_accessible_description(re.compile(r"hello"))
+    expect(locator).to_have_accessible_description(
+        re.compile(r"hello"), ignore_case=True
+    )
+
+    page.set_content(
+        """
+        <div role="button" aria-describedby="desc"></div>
+        <span id="desc">foo&nbsp;bar\nbaz</span>
+    """
+    )
+    expect(page.locator("div")).to_have_accessible_description("foo bar baz")
+
+
+def test_to_have_role(page: Page) -> None:
+    page.set_content('<div role="button">Button!</div>')
+    expect(page.locator("div")).to_have_role("button")
+    expect(page.locator("div")).not_to_have_role("checkbox")
+    with pytest.raises(Error) as excinfo:
+        expect(page.locator("div")).to_have_role(re.compile(r"button|checkbox"))  # type: ignore
+    assert '"role" argument in to_have_role must be a string' in str(excinfo.value)
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 4ed1b578a..f3a1e7496 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -126,15 +126,27 @@ def test_locators_is_enabled_and_is_disabled_should_work(page: Page) -> None:
     )
 
     div = page.locator("div")
-    assert div.is_enabled() is True
+    with pytest.raises(
+        Error,
+        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
+    ):
+        div.is_enabled()
     assert div.is_disabled() is False
 
     button1 = page.locator(':text("button1")')
-    assert button1.is_enabled() is False
+    with pytest.raises(
+        Error,
+        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
+    ):
+        assert button1.is_enabled()
     assert button1.is_disabled() is True
 
     button1 = page.locator(':text("button2")')
-    assert button1.is_enabled() is True
+    with pytest.raises(
+        Error,
+        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
+    ):
+        assert button1.is_enabled()
     assert button1.is_disabled() is False
 
 
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index 882521b3f..9308d5d0a 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -162,8 +162,6 @@ def _handle_response(response: Response) -> None:
     assert events[0]["type"] == "context-options"
     assert get_trace_actions(events) == [
         "Page.goto",
-        "Request.all_headers",
-        "Response.text",
         "Page.close",
     ]
 

From 058a3353b80be0310d8a9a127b3db4a7906f1e68 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 3 Feb 2025 15:34:24 +0100
Subject: [PATCH 324/438] chore(roll): roll Playwright to v1.50.1 (#2727)

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

diff --git a/setup.py b/setup.py
index fc3933d79..6168e595e 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.50.0-beta-1738235262000"
+driver_version = "1.50.1-beta-1738589118000"
 
 base_wheel_bundles = [
     {

From a4eabe49acb57572eae0e284707b250b6378a488 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 3 Feb 2025 23:49:55 +0100
Subject: [PATCH 325/438] build(deps): bump black from 24.8.0 to 25.1.0 (#2729)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 7134a315e..ac33a871c 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,5 +1,5 @@
 autobahn==23.1.2
-black==24.8.0
+black==25.1.0
 build==1.2.2.post1
 flake8==7.1.1
 flaky==3.8.1

From ab02bb04d2c8d775ec03ad4b6d5d623ac24d9978 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 3 Feb 2025 23:50:04 +0100
Subject: [PATCH 326/438] build(deps): bump pytest-asyncio from 0.25.2 to
 0.25.3 (#2728)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index ac33a871c..a81932b5e 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -10,7 +10,7 @@ pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==24.3.0
 pytest==8.3.4
-pytest-asyncio==0.25.2
+pytest-asyncio==0.25.3
 pytest-cov==6.0.0
 pytest-repeat==0.9.3
 pytest-timeout==2.3.1

From c88f12a6d6f292bacf3571dc15700df1f8d2e6d6 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 5 Feb 2025 12:39:15 +0100
Subject: [PATCH 327/438] fix(locator): fix is_enabled method (#2732)

---
 playwright/_impl/_locator.py |  2 +-
 tests/async/test_fill.py     |  9 ++++++++-
 tests/async/test_locators.py | 18 +++---------------
 tests/sync/test_locators.py  | 18 +++---------------
 4 files changed, 15 insertions(+), 32 deletions(-)

diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 91ea79064..1ad18f999 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -481,7 +481,7 @@ async def is_editable(self, timeout: float = None) -> bool:
 
     async def is_enabled(self, timeout: float = None) -> bool:
         params = locals_to_params(locals())
-        return await self._frame.is_editable(
+        return await self._frame.is_enabled(
             self._selector,
             strict=True,
             **params,
diff --git a/tests/async/test_fill.py b/tests/async/test_fill.py
index 4dd6db321..c5f0a55be 100644
--- a/tests/async/test_fill.py
+++ b/tests/async/test_fill.py
@@ -22,7 +22,14 @@ async def test_fill_textarea(page: Page, server: Server) -> None:
     assert await page.evaluate("result") == "some value"
 
 
-#
+async def test_is_enabled_for_non_editable_button(page: Page) -> None:
+    await page.set_content(
+        """
+        <button>button</button>
+    """
+    )
+    button = page.locator("button")
+    assert await button.is_enabled() is True
 
 
 async def test_fill_input(page: Page, server: Server) -> None:
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 385538461..aceb39991 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -128,27 +128,15 @@ async def test_locators_is_enabled_and_is_disabled_should_work(page: Page) -> No
     )
 
     div = page.locator("div")
-    with pytest.raises(
-        Error,
-        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
-    ):
-        assert await div.is_enabled()
+    assert await div.is_enabled()
     assert await div.is_disabled() is False
 
     button1 = page.locator(':text("button1")')
-    with pytest.raises(
-        Error,
-        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
-    ):
-        assert await button1.is_enabled()
+    assert await button1.is_enabled() is False
     assert await button1.is_disabled() is True
 
     button1 = page.locator(':text("button2")')
-    with pytest.raises(
-        Error,
-        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
-    ):
-        assert await button1.is_enabled()
+    assert await button1.is_enabled()
     assert await button1.is_disabled() is False
 
 
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index f3a1e7496..f373abdaa 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -126,27 +126,15 @@ def test_locators_is_enabled_and_is_disabled_should_work(page: Page) -> None:
     )
 
     div = page.locator("div")
-    with pytest.raises(
-        Error,
-        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
-    ):
-        div.is_enabled()
+    assert div.is_enabled()
     assert div.is_disabled() is False
 
     button1 = page.locator(':text("button1")')
-    with pytest.raises(
-        Error,
-        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
-    ):
-        assert button1.is_enabled()
+    assert button1.is_enabled() is False
     assert button1.is_disabled() is True
 
     button1 = page.locator(':text("button2")')
-    with pytest.raises(
-        Error,
-        match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
-    ):
-        assert button1.is_enabled()
+    assert button1.is_enabled()
     assert button1.is_disabled() is False
 
 

From ca0cf3efdaaa5f9eb3b49a0331eb84b1908620ac Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 7 Feb 2025 10:36:35 +0100
Subject: [PATCH 328/438] devops: use separate Release job for publishing
 (#2733)

---
 .azure-pipelines/publish.yml | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index 0076089ab..1b2a51894 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -29,7 +29,12 @@ extends:
     stages:
     - stage: Stage
       jobs:
-      - job: HostJob
+      - job: Build
+        templateContext:
+          outputs:
+          - output: pipelineArtifact
+            path: $(Build.ArtifactStagingDirectory)/esrp-build
+            artifact: esrp-build
         steps:
         - task: UsePythonVersion@0
           inputs:
@@ -41,9 +46,20 @@ extends:
             pip install -r requirements.txt
             pip install -e .
             for wheel in $(python setup.py --list-wheels); do
-              PLAYWRIGHT_TARGET_WHEEL=$wheel python -m build --wheel
+              PLAYWRIGHT_TARGET_WHEEL=$wheel python -m build --wheel --outdir $(Build.ArtifactStagingDirectory)/esrp-build
             done
           displayName: 'Install & Build'
+    - job: Publish
+      dependsOn: Build
+      templateContext:
+        type: releaseJob
+        isProduction: true
+        inputs:
+        - input: pipelineArtifact
+          artifactName: esrp-build
+          targetPath: $(Build.ArtifactStagingDirectory)/esrp-build
+      steps:
+        - checkout: none
         - task: EsrpRelease@7
           inputs:
             connectedservicename: 'Playwright-ESRP-Azure'
@@ -56,7 +72,7 @@ extends:
             # Keeping it commented out as a workaround for:
             # https://portal.microsofticm.com/imp/v3/incidents/incident/499972482/summary
             # contentsource: 'folder'
-            folderlocation: './dist/'
+            folderlocation: '$(Build.ArtifactStagingDirectory)/esrp-build'
             waitforreleasecompletion: true
             owners: 'maxschmitt@microsoft.com'
             approvers: 'maxschmitt@microsoft.com'

From d3aacbb7dccbd39b37965013070d95a043ed0f3e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 11 Feb 2025 12:35:51 +0100
Subject: [PATCH 329/438] build(deps): bump mypy from 1.14.1 to 1.15.0 (#2737)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index a81932b5e..b26fd5c4c 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -3,7 +3,7 @@ black==25.1.0
 build==1.2.2.post1
 flake8==7.1.1
 flaky==3.8.1
-mypy==1.14.1
+mypy==1.15.0
 objgraph==3.6.2
 Pillow==11.1.0
 pixelmatch==0.3.0

From 03e124b6bd526aab8151485c2ddce8d19cd416ac Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Fri, 14 Feb 2025 10:24:44 +0100
Subject: [PATCH 330/438] devops: add noarch support to meta.yaml (#2741)

---
 .github/workflows/ci.yml | 3 ++-
 meta.yaml                | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 929b05b8b..80dd92245 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -169,8 +169,9 @@ 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
       - name: Build
diff --git a/meta.yaml b/meta.yaml
index f78f0e90f..803565ac6 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -6,6 +6,7 @@ source:
   path: .
 
 build:
+  noarch: python
   number: 0
   script: "{{ PYTHON }} -m pip install . --no-deps -vv"
   binary_relocation: False

From 57cab90d1397140321fa7f95429028d78cfb2113 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 17 Feb 2025 11:05:17 +0100
Subject: [PATCH 331/438] build(deps): bump pyopenssl from 24.3.0 to 25.0.0
 (#2714)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index b26fd5c4c..e927f383e 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -8,7 +8,7 @@ objgraph==3.6.2
 Pillow==11.1.0
 pixelmatch==0.3.0
 pre-commit==3.5.0
-pyOpenSSL==24.3.0
+pyOpenSSL==25.0.0
 pytest==8.3.4
 pytest-asyncio==0.25.3
 pytest-cov==6.0.0

From 91eb1e90aacca0f6c0749a1ec8e0fe9c42321006 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 17 Feb 2025 11:05:30 +0100
Subject: [PATCH 332/438] build(deps): bump setuptools from 75.6.0 to 75.8.0
 (#2713)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 8c66a788a..07b6f8cd7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==75.6.0", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==75.8.0", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 4e98d68fb0a350d41a8e65c62f27e93db8d0808c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 17 Feb 2025 19:11:20 +0100
Subject: [PATCH 333/438] build(deps): bump flake8 from 7.1.1 to 7.1.2 (#2748)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index e927f383e..8912aca6e 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,7 +1,7 @@
 autobahn==23.1.2
 black==25.1.0
 build==1.2.2.post1
-flake8==7.1.1
+flake8==7.1.2
 flaky==3.8.1
 mypy==1.15.0
 objgraph==3.6.2

From 738f98ddb0043b51dde014927156c6249921bcd8 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 3 Mar 2025 16:52:55 +0100
Subject: [PATCH 334/438] devops: use ESRP PME for publishing (#2760)

---
 .azure-pipelines/publish.yml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index 1b2a51894..2fc90faa2 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -60,11 +60,11 @@ extends:
           targetPath: $(Build.ArtifactStagingDirectory)/esrp-build
       steps:
         - checkout: none
-        - task: EsrpRelease@7
+        - task: EsrpRelease@9
           inputs:
-            connectedservicename: 'Playwright-ESRP-Azure'
-            keyvaultname: 'pw-publishing-secrets'
-            authcertname: 'ESRP-Release-Auth'
+            connectedservicename: 'Playwright-ESRP-PME'
+            usemanagedidentity: true
+            keyvaultname: 'playwright-esrp-pme'
             signcertname: 'ESRP-Release-Sign'
             clientid: '13434a40-7de4-4c23-81a3-d843dc81c2c5'
             intent: 'PackageDistribution'
@@ -78,5 +78,5 @@ extends:
             approvers: 'maxschmitt@microsoft.com'
             serviceendpointurl: 'https://api.esrp.microsoft.com'
             mainpublisher: 'Playwright'
-            domaintenantid: '72f988bf-86f1-41af-91ab-2d7cd011db47'
+            domaintenantid: '975f013f-7f24-47e8-a7d3-abc4752bf346'
           displayName: 'ESRP Release to PIP'

From 3e61c3f0a1a019e322820543710fc0eddd0a8421 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 4 Mar 2025 16:31:49 +0100
Subject: [PATCH 335/438] build(deps): bump types-requests from 2.32.0.20241016
 to 2.32.0.20250301 (#2761)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 8912aca6e..8f1c2c6a8 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,4 +19,4 @@ requests==2.32.3
 service_identity==24.2.0
 twisted==24.11.0
 types-pyOpenSSL==24.1.0.20240722
-types-requests==2.32.0.20241016
+types-requests==2.32.0.20250301

From 23f1532023f395449f5e2e2228b5e25e0038bf4e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 4 Mar 2025 16:31:59 +0100
Subject: [PATCH 336/438] build(deps): bump pytest from 8.3.4 to 8.3.5 (#2762)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 8f1c2c6a8..7e6b1439a 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,7 +9,7 @@ Pillow==11.1.0
 pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==25.0.0
-pytest==8.3.4
+pytest==8.3.5
 pytest-asyncio==0.25.3
 pytest-cov==6.0.0
 pytest-repeat==0.9.3

From 85339738c6bb51feb98148d30bc950329d73fa24 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 4 Mar 2025 16:32:09 +0100
Subject: [PATCH 337/438] build(deps): bump setuptools from 75.8.0 to 75.8.2
 (#2763)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 07b6f8cd7..a25577ddb 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==75.8.0", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==75.8.2", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 55725d50e3705b7a16e1050b9bace2a64fb0c7fd Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 6 Mar 2025 14:21:14 +0100
Subject: [PATCH 338/438] test: unflake tests (#2768)

---
 tests/async/test_defaultbrowsercontext.py | 18 ++++++++++++++++--
 tests/async/test_selector_generator.py    |  2 +-
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/tests/async/test_defaultbrowsercontext.py b/tests/async/test_defaultbrowsercontext.py
index ff3b32489..805deddfe 100644
--- a/tests/async/test_defaultbrowsercontext.py
+++ b/tests/async/test_defaultbrowsercontext.py
@@ -21,6 +21,7 @@
     Awaitable,
     Callable,
     Dict,
+    List,
     Literal,
     Optional,
     Tuple,
@@ -28,7 +29,14 @@
 
 import pytest
 
-from playwright.async_api import BrowserContext, BrowserType, Error, Page, expect
+from playwright.async_api import (
+    BrowserContext,
+    BrowserType,
+    Cookie,
+    Error,
+    Page,
+    expect,
+)
 from tests.server import Server
 from tests.utils import must
 
@@ -116,6 +124,12 @@ async def test_context_add_cookies_should_work(
     ]
 
 
+def _filter_cookies(cookies: List[Cookie]) -> List[Cookie]:
+    return list(
+        filter(lambda cookie: cookie["domain"] != "copilot.microsoft.com", cookies)
+    )
+
+
 async def test_context_clear_cookies_should_work(
     server: Server,
     launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
@@ -131,7 +145,7 @@ async def test_context_clear_cookies_should_work(
     assert await page.evaluate("document.cookie") == "cookie1=1; cookie2=2"
     await page.context.clear_cookies()
     await page.reload()
-    assert await page.context.cookies([]) == []
+    assert _filter_cookies(await page.context.cookies([])) == []
     assert await page.evaluate("document.cookie") == ""
 
 
diff --git a/tests/async/test_selector_generator.py b/tests/async/test_selector_generator.py
index 1239973a5..6668020da 100644
--- a/tests/async/test_selector_generator.py
+++ b/tests/async/test_selector_generator.py
@@ -40,7 +40,7 @@ async def test_should_use_data_test_id_in_strict_errors(
         """
         )
         with pytest.raises(Error) as exc_info:
-            await page.locator(".foo").hover(timeout=200)
+            await page.locator(".foo").hover()
         assert "strict mode violation" in exc_info.value.message
         assert '<div class="foo bar:0' in exc_info.value.message
         assert '<div class="foo bar:1' in exc_info.value.message

From 1b95464568894d6e63370614e41971e6dd74792d Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 10 Mar 2025 10:15:15 +0100
Subject: [PATCH 339/438] chore(roll): roll Playwright to
 1.51.0-beta-1741166263000 (#2767)

---
 README.md                                     |   6 +-
 playwright/_impl/_browser.py                  |   5 +
 playwright/_impl/_browser_context.py          |   8 +-
 playwright/_impl/_browser_type.py             |  11 +-
 playwright/_impl/_fetch.py                    |  22 ++--
 playwright/_impl/_helper.py                   |   1 +
 playwright/_impl/_locator.py                  |   6 ++
 playwright/_impl/_page.py                     |   6 ++
 playwright/async_api/_generated.py            | 101 ++++++++++++++----
 playwright/sync_api/_generated.py             | 101 ++++++++++++++----
 scripts/documentation_provider.py             |   2 +-
 setup.py                                      |   2 +-
 tests/async/test_browsercontext.py            |   1 -
 .../test_browsercontext_storage_state.py      |  92 ++++++++++++++--
 tests/async/test_defaultbrowsercontext.py     |  10 ++
 tests/async/test_fetch_global.py              |  38 +++++++
 tests/async/test_locators.py                  |  22 ++++
 tests/async/test_page.py                      |  21 +++-
 .../sync/test_browsercontext_storage_state.py |  93 ++++++++++++++--
 tests/sync/test_fetch_global.py               |  38 +++++++
 tests/sync/test_locators.py                   |  22 ++++
 21 files changed, 531 insertions(+), 77 deletions(-)

diff --git a/README.md b/README.md
index 9a5529b13..b203c6dab 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 -->133.0.6943.16<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| WebKit <!-- GEN:webkit-version -->18.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->134.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->134.0.6998.35<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| WebKit <!-- GEN:webkit-version -->18.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->135.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index c5a9022a3..aa56d8244 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -32,6 +32,7 @@
 from playwright._impl._errors import is_target_closed_error
 from playwright._impl._helper import (
     ColorScheme,
+    Contrast,
     ForcedColors,
     HarContentPolicy,
     HarMode,
@@ -107,6 +108,7 @@ async def new_context(
         colorScheme: ColorScheme = None,
         reducedMotion: ReducedMotion = None,
         forcedColors: ForcedColors = None,
+        contrast: Contrast = None,
         acceptDownloads: bool = None,
         defaultBrowserType: str = None,
         proxy: ProxySettings = None,
@@ -152,6 +154,7 @@ async def new_page(
         hasTouch: bool = None,
         colorScheme: ColorScheme = None,
         forcedColors: ForcedColors = None,
+        contrast: Contrast = None,
         reducedMotion: ReducedMotion = None,
         acceptDownloads: bool = None,
         defaultBrowserType: str = None,
@@ -254,6 +257,8 @@ async def prepare_browser_context_params(params: Dict) -> None:
         params["reducedMotion"] = "no-override"
     if params.get("forcedColors", None) == "null":
         params["forcedColors"] = "no-override"
+    if params.get("contrast", None) == "null":
+        params["contrast"] = "no-override"
     if "acceptDownloads" in params:
         params["acceptDownloads"] = "accept" if params["acceptDownloads"] else "deny"
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index e5a9b14fd..22da4375d 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -599,8 +599,12 @@ async def _inner_close() -> None:
         await self._channel.send("close", {"reason": reason})
         await self._closed_future
 
-    async def storage_state(self, path: Union[str, Path] = None) -> StorageState:
-        result = await self._channel.send_return_as_dict("storageState")
+    async def storage_state(
+        self, path: Union[str, Path] = None, indexedDB: bool = None
+    ) -> StorageState:
+        result = await self._channel.send_return_as_dict(
+            "storageState", {"indexedDB": indexedDB}
+        )
         if path:
             await async_writefile(path, json.dumps(result))
         return result
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 1c9303c7f..ec8c988d5 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -35,6 +35,7 @@
 from playwright._impl._errors import Error
 from playwright._impl._helper import (
     ColorScheme,
+    Contrast,
     Env,
     ForcedColors,
     HarContentPolicy,
@@ -134,6 +135,7 @@ async def launch_persistent_context(
         colorScheme: ColorScheme = None,
         reducedMotion: ReducedMotion = None,
         forcedColors: ForcedColors = None,
+        contrast: Contrast = None,
         acceptDownloads: bool = None,
         tracesDir: Union[pathlib.Path, str] = None,
         chromiumSandbox: bool = None,
@@ -150,7 +152,7 @@ async def launch_persistent_context(
         recordHarContent: HarContentPolicy = None,
         clientCertificates: List[ClientCertificate] = None,
     ) -> BrowserContext:
-        userDataDir = str(Path(userDataDir)) if userDataDir else ""
+        userDataDir = self._user_data_dir(userDataDir)
         params = locals_to_params(locals())
         await prepare_browser_context_params(params)
         normalize_launch_params(params)
@@ -161,6 +163,13 @@ async def launch_persistent_context(
         self._did_create_context(context, params, params)
         return context
 
+    def _user_data_dir(self, userDataDir: Optional[Union[str, Path]]) -> str:
+        if not userDataDir:
+            return ""
+        if not Path(userDataDir).is_absolute():
+            return str(Path(userDataDir).resolve())
+        return str(Path(userDataDir))
+
     async def connect_over_cdp(
         self,
         endpointURL: str,
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index 93144ac55..b53e4e629 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -73,6 +73,7 @@ async def new_context(
         timeout: float = None,
         storageState: Union[StorageState, str, Path] = None,
         clientCertificates: List[ClientCertificate] = None,
+        failOnStatusCode: bool = None,
     ) -> "APIRequestContext":
         params = locals_to_params(locals())
         if "storageState" in params:
@@ -422,9 +423,13 @@ async def _inner_fetch(
         return APIResponse(self, response)
 
     async def storage_state(
-        self, path: Union[pathlib.Path, str] = None
+        self,
+        path: Union[pathlib.Path, str] = None,
+        indexedDB: bool = None,
     ) -> StorageState:
-        result = await self._channel.send_return_as_dict("storageState")
+        result = await self._channel.send_return_as_dict(
+            "storageState", {"indexedDB": indexedDB}
+        )
         if path:
             await async_writefile(path, json.dumps(result))
         return result
@@ -475,11 +480,14 @@ def headers_array(self) -> network.HeadersArray:
 
     async def body(self) -> bytes:
         try:
-            result = await self._request._channel.send_return_as_dict(
-                "fetchResponseBody",
-                {
-                    "fetchUid": self._fetch_uid,
-                },
+            result = await self._request._connection.wrap_api_call(
+                lambda: self._request._channel.send_return_as_dict(
+                    "fetchResponseBody",
+                    {
+                        "fetchUid": self._fetch_uid,
+                    },
+                ),
+                True,
             )
             if result is None:
                 raise Error("Response has been disposed")
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 538d5533a..2f7ab57b0 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -62,6 +62,7 @@
 
 ColorScheme = Literal["dark", "light", "no-preference", "null"]
 ForcedColors = Literal["active", "none", "null"]
+Contrast = Literal["more", "no-preference", "null"]
 ReducedMotion = Literal["no-preference", "null", "reduce"]
 DocumentLoadState = Literal["commit", "domcontentloaded", "load", "networkidle"]
 KeyboardModifier = Literal["Alt", "Control", "ControlOrMeta", "Meta", "Shift"]
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 1ad18f999..37b1f9441 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -70,6 +70,7 @@ def __init__(
         has_not_text: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
         has_not: "Locator" = None,
+        visible: bool = None,
     ) -> None:
         self._frame = frame
         self._selector = selector
@@ -95,6 +96,9 @@ def __init__(
                 raise Error('Inner "has_not" locator must belong to the same frame.')
             self._selector += " >> internal:has-not=" + json.dumps(locator._selector)
 
+        if visible is not None:
+            self._selector += f" >> visible={bool_to_js_bool(visible)}"
+
     def __repr__(self) -> str:
         return f"<Locator frame={self._frame!r} selector={self._selector!r}>"
 
@@ -338,6 +342,7 @@ def filter(
         hasNotText: Union[str, Pattern[str]] = None,
         has: "Locator" = None,
         hasNot: "Locator" = None,
+        visible: bool = None,
     ) -> "Locator":
         return Locator(
             self._frame,
@@ -346,6 +351,7 @@ def filter(
             has_not_text=hasNotText,
             has=has,
             has_not=hasNot,
+            visible=visible,
         )
 
     def or_(self, locator: "Locator") -> "Locator":
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 62fec2a3f..6327cce70 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -60,6 +60,7 @@
 from playwright._impl._har_router import HarRouter
 from playwright._impl._helper import (
     ColorScheme,
+    Contrast,
     DocumentLoadState,
     ForcedColors,
     HarMode,
@@ -608,6 +609,7 @@ async def emulate_media(
         colorScheme: ColorScheme = None,
         reducedMotion: ReducedMotion = None,
         forcedColors: ForcedColors = None,
+        contrast: Contrast = None,
     ) -> None:
         params = locals_to_params(locals())
         if "media" in params:
@@ -624,6 +626,10 @@ async def emulate_media(
             params["forcedColors"] = (
                 "no-override" if params["forcedColors"] == "null" else forcedColors
             )
+        if "contrast" in params:
+            params["contrast"] = (
+                "no-override" if params["contrast"] == "null" else contrast
+            )
         await self._channel.send("emulateMedia", params)
 
     async def set_viewport_size(self, viewportSize: ViewportSize) -> None:
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 7b92fbafb..d2f93dbb6 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -2821,7 +2821,9 @@ async def screenshot(
             Defaults to `"device"`.
         mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box. The mask is also applied to
+            invisible elements, see [Matching only visible elements](../locators.md#matching-only-visible-elements) to disable
+            that.
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
@@ -9277,6 +9279,7 @@ async def emulate_media(
             Literal["no-preference", "null", "reduce"]
         ] = None,
         forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
+        contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
     ) -> None:
         """Page.emulate_media
 
@@ -9325,6 +9328,7 @@ async def emulate_media(
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. Passing
             `null` disables reduced motion emulation.
         forced_colors : Union["active", "none", "null", None]
+        contrast : Union["more", "no-preference", "null", None]
         """
 
         return mapping.from_maybe_impl(
@@ -9333,6 +9337,7 @@ async def emulate_media(
                 colorScheme=color_scheme,
                 reducedMotion=reduced_motion,
                 forcedColors=forced_colors,
+                contrast=contrast,
             )
         )
 
@@ -9709,7 +9714,9 @@ async def screenshot(
             Defaults to `"device"`.
         mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box. The mask is also applied to
+            invisible elements, see [Matching only visible elements](../locators.md#matching-only-visible-elements) to disable
+            that.
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
@@ -13437,24 +13444,37 @@ async def close(self, *, reason: typing.Optional[str] = None) -> None:
         return mapping.from_maybe_impl(await self._impl_obj.close(reason=reason))
 
     async def storage_state(
-        self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        self,
+        *,
+        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        indexed_db: typing.Optional[bool] = None,
     ) -> StorageState:
         """BrowserContext.storage_state
 
-        Returns storage state for this browser context, contains current cookies and local storage snapshot.
+        Returns storage state for this browser context, contains current cookies, local storage snapshot and IndexedDB
+        snapshot.
 
         Parameters
         ----------
         path : Union[pathlib.Path, str, None]
             The file path to save the storage state to. If `path` is a relative path, then it is resolved relative to current
             working directory. If no path is provided, storage state is still returned, but won't be saved to the disk.
+        indexed_db : Union[bool, None]
+            Set to `true` to include [IndexedDB](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API) in the storage
+            state snapshot. If your application uses IndexedDB to store authentication tokens, like Firebase Authentication,
+            enable this.
+
+            **NOTE** IndexedDBs with typed arrays are currently not supported.
+
 
         Returns
         -------
         {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}
         """
 
-        return mapping.from_impl(await self._impl_obj.storage_state(path=path))
+        return mapping.from_impl(
+            await self._impl_obj.storage_state(path=path, indexedDB=indexed_db)
+        )
 
     async def wait_for_event(
         self,
@@ -13727,6 +13747,7 @@ async def new_context(
             Literal["no-preference", "null", "reduce"]
         ] = None,
         forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
+        contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
         default_browser_type: typing.Optional[str] = None,
         proxy: typing.Optional[ProxySettings] = None,
@@ -13832,6 +13853,10 @@ async def new_context(
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'none'`.
+        contrast : Union["more", "no-preference", "null", None]
+            Emulates `'prefers-contrast'` media feature, supported values are `'no-preference'`, `'more'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
@@ -13923,6 +13948,7 @@ async def new_context(
                 colorScheme=color_scheme,
                 reducedMotion=reduced_motion,
                 forcedColors=forced_colors,
+                contrast=contrast,
                 acceptDownloads=accept_downloads,
                 defaultBrowserType=default_browser_type,
                 proxy=proxy,
@@ -13965,6 +13991,7 @@ async def new_page(
             Literal["dark", "light", "no-preference", "null"]
         ] = None,
         forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
+        contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
         reduced_motion: typing.Optional[
             Literal["no-preference", "null", "reduce"]
         ] = None,
@@ -14053,6 +14080,10 @@ async def new_page(
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'none'`.
+        contrast : Union["more", "no-preference", "null", None]
+            Emulates `'prefers-contrast'` media feature, supported values are `'no-preference'`, `'more'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
         reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -14147,6 +14178,7 @@ async def new_page(
                 hasTouch=has_touch,
                 colorScheme=color_scheme,
                 forcedColors=forced_colors,
+                contrast=contrast,
                 reducedMotion=reduced_motion,
                 acceptDownloads=accept_downloads,
                 defaultBrowserType=default_browser_type,
@@ -14480,6 +14512,7 @@ async def launch_persistent_context(
             Literal["no-preference", "null", "reduce"]
         ] = None,
         forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
+        contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
         traces_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         chromium_sandbox: typing.Optional[bool] = None,
@@ -14622,6 +14655,10 @@ async def launch_persistent_context(
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'none'`.
+        contrast : Union["more", "no-preference", "null", None]
+            Emulates `'prefers-contrast'` media feature, supported values are `'no-preference'`, `'more'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         traces_dir : Union[pathlib.Path, str, None]
@@ -14728,6 +14765,7 @@ async def launch_persistent_context(
                 colorScheme=color_scheme,
                 reducedMotion=reduced_motion,
                 forcedColors=forced_colors,
+                contrast=contrast,
                 acceptDownloads=accept_downloads,
                 tracesDir=traces_dir,
                 chromiumSandbox=chromium_sandbox,
@@ -14762,6 +14800,10 @@ async def connect_over_cdp(
 
         **NOTE** Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
 
+        **NOTE** This connection is significantly lower fidelity than the Playwright protocol connection via
+        `browser_type.connect()`. If you are experiencing issues or attempting to use advanced functionality, you
+        probably want to use `browser_type.connect()`.
+
         **Usage**
 
         ```py
@@ -14809,14 +14851,15 @@ async def connect(
     ) -> "Browser":
         """BrowserType.connect
 
-        This method attaches Playwright to an existing browser instance. When connecting to another browser launched via
-        `BrowserType.launchServer` in Node.js, the major and minor version needs to match the client version (1.2.3 → is
-        compatible with 1.2.x).
+        This method attaches Playwright to an existing browser instance created via `BrowserType.launchServer` in Node.js.
+
+        **NOTE** The major and minor version of the Playwright instance that connects needs to match the version of
+        Playwright that launches the browser (1.2.3 → is compatible with 1.2.x).
 
         Parameters
         ----------
         ws_endpoint : str
-            A browser websocket endpoint to connect to.
+            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).
         slow_mo : Union[float, None]
@@ -15579,11 +15622,6 @@ async def evaluate(
 
         **Usage**
 
-        ```py
-        tweets = page.locator(\".tweet .retweets\")
-        assert await tweets.evaluate(\"node => node.innerText\") == \"10 retweets\"
-        ```
-
         Parameters
         ----------
         expression : str
@@ -16397,6 +16435,7 @@ def filter(
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
+        visible: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.filter
 
@@ -16438,6 +16477,8 @@ def filter(
             outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        visible : Union[bool, None]
+            Only matches visible or invisible elements.
 
         Returns
         -------
@@ -16450,6 +16491,7 @@ def filter(
                 hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
                 hasNot=has_not._impl_obj if has_not else None,
+                visible=visible,
             )
         )
 
@@ -17141,7 +17183,9 @@ async def screenshot(
             Defaults to `"device"`.
         mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box. The mask is also applied to
+            invisible elements, see [Matching only visible elements](../locators.md#matching-only-visible-elements) to disable
+            that.
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
@@ -17283,9 +17327,9 @@ async def select_option(
 
         ```html
         <select multiple>
-          <option value=\"red\">Red</div>
-          <option value=\"green\">Green</div>
-          <option value=\"blue\">Blue</div>
+          <option value=\"red\">Red</option>
+          <option value=\"green\">Green</option>
+          <option value=\"blue\">Blue</option>
         </select>
         ```
 
@@ -17446,7 +17490,8 @@ async def tap(
     ) -> None:
         """Locator.tap
 
-        Perform a tap gesture on the element matching the locator.
+        Perform a tap gesture on the element matching the locator. For examples of emulating other gestures by manually
+        dispatching touch events, see the [emulating legacy touch events](https://playwright.dev/python/docs/touch-events) page.
 
         **Details**
 
@@ -18607,7 +18652,10 @@ async def fetch(
         )
 
     async def storage_state(
-        self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        self,
+        *,
+        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        indexed_db: typing.Optional[bool] = None,
     ) -> StorageState:
         """APIRequestContext.storage_state
 
@@ -18619,13 +18667,17 @@ async def storage_state(
         path : Union[pathlib.Path, str, None]
             The file path to save the storage state to. If `path` is a relative path, then it is resolved relative to current
             working directory. If no path is provided, storage state is still returned, but won't be saved to the disk.
+        indexed_db : Union[bool, None]
+            Set to `true` to include IndexedDB in the storage state snapshot.
 
         Returns
         -------
         {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}
         """
 
-        return mapping.from_impl(await self._impl_obj.storage_state(path=path))
+        return mapping.from_impl(
+            await self._impl_obj.storage_state(path=path, indexedDB=indexed_db)
+        )
 
 
 mapping.register(APIRequestContextImpl, APIRequestContext)
@@ -18647,6 +18699,7 @@ async def new_context(
             typing.Union[StorageState, str, pathlib.Path]
         ] = None,
         client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
+        fail_on_status_code: typing.Optional[bool] = None,
     ) -> "APIRequestContext":
         """APIRequest.new_context
 
@@ -18695,6 +18748,9 @@ async def new_context(
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
+        fail_on_status_code : Union[bool, None]
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
 
         Returns
         -------
@@ -18712,6 +18768,7 @@ async def new_context(
                 timeout=timeout,
                 storageState=storage_state,
                 clientCertificates=client_certificates,
+                failOnStatusCode=fail_on_status_code,
             )
         )
 
@@ -18810,7 +18867,7 @@ async def to_have_url(
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
         ignore_case : Union[bool, None]
             Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
-            expression flag if specified.
+            expression parameter if specified. A provided predicate ignores this flag.
         """
         __tracebackhide__ = True
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 04a0f10fc..619319910 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -2855,7 +2855,9 @@ def screenshot(
             Defaults to `"device"`.
         mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box. The mask is also applied to
+            invisible elements, see [Matching only visible elements](../locators.md#matching-only-visible-elements) to disable
+            that.
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
@@ -9318,6 +9320,7 @@ def emulate_media(
             Literal["no-preference", "null", "reduce"]
         ] = None,
         forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
+        contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
     ) -> None:
         """Page.emulate_media
 
@@ -9366,6 +9369,7 @@ def emulate_media(
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. Passing
             `null` disables reduced motion emulation.
         forced_colors : Union["active", "none", "null", None]
+        contrast : Union["more", "no-preference", "null", None]
         """
 
         return mapping.from_maybe_impl(
@@ -9375,6 +9379,7 @@ def emulate_media(
                     colorScheme=color_scheme,
                     reducedMotion=reduced_motion,
                     forcedColors=forced_colors,
+                    contrast=contrast,
                 )
             )
         )
@@ -9760,7 +9765,9 @@ def screenshot(
             Defaults to `"device"`.
         mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box. The mask is also applied to
+            invisible elements, see [Matching only visible elements](../locators.md#matching-only-visible-elements) to disable
+            that.
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
@@ -13474,24 +13481,37 @@ def close(self, *, reason: typing.Optional[str] = None) -> None:
         return mapping.from_maybe_impl(self._sync(self._impl_obj.close(reason=reason)))
 
     def storage_state(
-        self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        self,
+        *,
+        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        indexed_db: typing.Optional[bool] = None,
     ) -> StorageState:
         """BrowserContext.storage_state
 
-        Returns storage state for this browser context, contains current cookies and local storage snapshot.
+        Returns storage state for this browser context, contains current cookies, local storage snapshot and IndexedDB
+        snapshot.
 
         Parameters
         ----------
         path : Union[pathlib.Path, str, None]
             The file path to save the storage state to. If `path` is a relative path, then it is resolved relative to current
             working directory. If no path is provided, storage state is still returned, but won't be saved to the disk.
+        indexed_db : Union[bool, None]
+            Set to `true` to include [IndexedDB](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API) in the storage
+            state snapshot. If your application uses IndexedDB to store authentication tokens, like Firebase Authentication,
+            enable this.
+
+            **NOTE** IndexedDBs with typed arrays are currently not supported.
+
 
         Returns
         -------
         {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}
         """
 
-        return mapping.from_impl(self._sync(self._impl_obj.storage_state(path=path)))
+        return mapping.from_impl(
+            self._sync(self._impl_obj.storage_state(path=path, indexedDB=indexed_db))
+        )
 
     def wait_for_event(
         self,
@@ -13764,6 +13784,7 @@ def new_context(
             Literal["no-preference", "null", "reduce"]
         ] = None,
         forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
+        contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
         default_browser_type: typing.Optional[str] = None,
         proxy: typing.Optional[ProxySettings] = None,
@@ -13869,6 +13890,10 @@ def new_context(
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'none'`.
+        contrast : Union["more", "no-preference", "null", None]
+            Emulates `'prefers-contrast'` media feature, supported values are `'no-preference'`, `'more'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
@@ -13961,6 +13986,7 @@ def new_context(
                     colorScheme=color_scheme,
                     reducedMotion=reduced_motion,
                     forcedColors=forced_colors,
+                    contrast=contrast,
                     acceptDownloads=accept_downloads,
                     defaultBrowserType=default_browser_type,
                     proxy=proxy,
@@ -14004,6 +14030,7 @@ def new_page(
             Literal["dark", "light", "no-preference", "null"]
         ] = None,
         forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
+        contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
         reduced_motion: typing.Optional[
             Literal["no-preference", "null", "reduce"]
         ] = None,
@@ -14092,6 +14119,10 @@ def new_page(
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'none'`.
+        contrast : Union["more", "no-preference", "null", None]
+            Emulates `'prefers-contrast'` media feature, supported values are `'no-preference'`, `'more'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
         reduced_motion : Union["no-preference", "null", "reduce", None]
             Emulates `'prefers-reduced-motion'` media feature, supported values are `'reduce'`, `'no-preference'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
@@ -14187,6 +14218,7 @@ def new_page(
                     hasTouch=has_touch,
                     colorScheme=color_scheme,
                     forcedColors=forced_colors,
+                    contrast=contrast,
                     reducedMotion=reduced_motion,
                     acceptDownloads=accept_downloads,
                     defaultBrowserType=default_browser_type,
@@ -14525,6 +14557,7 @@ def launch_persistent_context(
             Literal["no-preference", "null", "reduce"]
         ] = None,
         forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
+        contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
         traces_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
         chromium_sandbox: typing.Optional[bool] = None,
@@ -14667,6 +14700,10 @@ def launch_persistent_context(
             Emulates `'forced-colors'` media feature, supported values are `'active'`, `'none'`. See
             `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
             `'none'`.
+        contrast : Union["more", "no-preference", "null", None]
+            Emulates `'prefers-contrast'` media feature, supported values are `'no-preference'`, `'more'`. See
+            `page.emulate_media()` for more details. Passing `'null'` resets emulation to system defaults. Defaults to
+            `'no-preference'`.
         accept_downloads : Union[bool, None]
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         traces_dir : Union[pathlib.Path, str, None]
@@ -14774,6 +14811,7 @@ def launch_persistent_context(
                     colorScheme=color_scheme,
                     reducedMotion=reduced_motion,
                     forcedColors=forced_colors,
+                    contrast=contrast,
                     acceptDownloads=accept_downloads,
                     tracesDir=traces_dir,
                     chromiumSandbox=chromium_sandbox,
@@ -14809,6 +14847,10 @@ def connect_over_cdp(
 
         **NOTE** Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
 
+        **NOTE** This connection is significantly lower fidelity than the Playwright protocol connection via
+        `browser_type.connect()`. If you are experiencing issues or attempting to use advanced functionality, you
+        probably want to use `browser_type.connect()`.
+
         **Usage**
 
         ```py
@@ -14858,14 +14900,15 @@ def connect(
     ) -> "Browser":
         """BrowserType.connect
 
-        This method attaches Playwright to an existing browser instance. When connecting to another browser launched via
-        `BrowserType.launchServer` in Node.js, the major and minor version needs to match the client version (1.2.3 → is
-        compatible with 1.2.x).
+        This method attaches Playwright to an existing browser instance created via `BrowserType.launchServer` in Node.js.
+
+        **NOTE** The major and minor version of the Playwright instance that connects needs to match the version of
+        Playwright that launches the browser (1.2.3 → is compatible with 1.2.x).
 
         Parameters
         ----------
         ws_endpoint : str
-            A browser websocket endpoint to connect to.
+            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).
         slow_mo : Union[float, None]
@@ -15637,11 +15680,6 @@ def evaluate(
 
         **Usage**
 
-        ```py
-        tweets = page.locator(\".tweet .retweets\")
-        assert tweets.evaluate(\"node => node.innerText\") == \"10 retweets\"
-        ```
-
         Parameters
         ----------
         expression : str
@@ -16467,6 +16505,7 @@ def filter(
         has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
+        visible: typing.Optional[bool] = None,
     ) -> "Locator":
         """Locator.filter
 
@@ -16507,6 +16546,8 @@ def filter(
             outer one. For example, `article` that does not have `div` matches `<article><span>Playwright</span></article>`.
 
             Note that outer and inner locators must belong to the same frame. Inner locator must not contain `FrameLocator`s.
+        visible : Union[bool, None]
+            Only matches visible or invisible elements.
 
         Returns
         -------
@@ -16519,6 +16560,7 @@ def filter(
                 hasNotText=has_not_text,
                 has=has._impl_obj if has else None,
                 hasNot=has_not._impl_obj if has_not else None,
+                visible=visible,
             )
         )
 
@@ -17230,7 +17272,9 @@ def screenshot(
             Defaults to `"device"`.
         mask : Union[Sequence[Locator], None]
             Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink
-            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box.
+            box `#FF00FF` (customized by `maskColor`) that completely covers its bounding box. The mask is also applied to
+            invisible elements, see [Matching only visible elements](../locators.md#matching-only-visible-elements) to disable
+            that.
         mask_color : Union[str, None]
             Specify the color of the overlay box for masked elements, in
             [CSS color format](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value). Default color is pink `#FF00FF`.
@@ -17374,9 +17418,9 @@ def select_option(
 
         ```html
         <select multiple>
-          <option value=\"red\">Red</div>
-          <option value=\"green\">Green</div>
-          <option value=\"blue\">Blue</div>
+          <option value=\"red\">Red</option>
+          <option value=\"green\">Green</option>
+          <option value=\"blue\">Blue</option>
         </select>
         ```
 
@@ -17543,7 +17587,8 @@ def tap(
     ) -> None:
         """Locator.tap
 
-        Perform a tap gesture on the element matching the locator.
+        Perform a tap gesture on the element matching the locator. For examples of emulating other gestures by manually
+        dispatching touch events, see the [emulating legacy touch events](https://playwright.dev/python/docs/touch-events) page.
 
         **Details**
 
@@ -18734,7 +18779,10 @@ def fetch(
         )
 
     def storage_state(
-        self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        self,
+        *,
+        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        indexed_db: typing.Optional[bool] = None,
     ) -> StorageState:
         """APIRequestContext.storage_state
 
@@ -18746,13 +18794,17 @@ def storage_state(
         path : Union[pathlib.Path, str, None]
             The file path to save the storage state to. If `path` is a relative path, then it is resolved relative to current
             working directory. If no path is provided, storage state is still returned, but won't be saved to the disk.
+        indexed_db : Union[bool, None]
+            Set to `true` to include IndexedDB in the storage state snapshot.
 
         Returns
         -------
         {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}
         """
 
-        return mapping.from_impl(self._sync(self._impl_obj.storage_state(path=path)))
+        return mapping.from_impl(
+            self._sync(self._impl_obj.storage_state(path=path, indexedDB=indexed_db))
+        )
 
 
 mapping.register(APIRequestContextImpl, APIRequestContext)
@@ -18774,6 +18826,7 @@ def new_context(
             typing.Union[StorageState, str, pathlib.Path]
         ] = None,
         client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
+        fail_on_status_code: typing.Optional[bool] = None,
     ) -> "APIRequestContext":
         """APIRequest.new_context
 
@@ -18822,6 +18875,9 @@ def new_context(
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
+        fail_on_status_code : Union[bool, None]
+            Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
+            codes.
 
         Returns
         -------
@@ -18840,6 +18896,7 @@ def new_context(
                     timeout=timeout,
                     storageState=storage_state,
                     clientCertificates=client_certificates,
+                    failOnStatusCode=fail_on_status_code,
                 )
             )
         )
@@ -18943,7 +19000,7 @@ def to_have_url(
             Time to retry the assertion for in milliseconds. Defaults to `5000`.
         ignore_case : Union[bool, None]
             Whether to perform case-insensitive match. `ignoreCase` option takes precedence over the corresponding regular
-            expression flag if specified.
+            expression parameter if specified. A provided predicate ignores this flag.
         """
         __tracebackhide__ = True
 
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 608c4319d..6ea931fac 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -489,7 +489,7 @@ def inner_serialize_doc_type(self, type: Any, direction: str) -> str:
             return "int"
         if type_name.lower() == "string":
             return "str"
-        if type_name == "any" or type_name == "Serializable":
+        if type_name == "any" or type_name == "unknown" or type_name == "Serializable":
             return "Any"
         if type_name == "Object":
             return "Dict"
diff --git a/setup.py b/setup.py
index 6168e595e..5403790f2 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.50.1-beta-1738589118000"
+driver_version = "1.51.0-beta-1741261385000"
 
 base_wheel_bundles = [
     {
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index b89ebd7f2..37c812f57 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -825,7 +825,6 @@ async def test_strict_selectors_on_context(browser: Browser, server: Server) ->
     await context.close()
 
 
-@pytest.mark.skip_browser("webkit")  # https://bugs.webkit.org/show_bug.cgi?id=225281
 async def test_should_support_forced_colors(browser: Browser) -> None:
     context = await browser.new_context(forced_colors="active")
     page = await context.new_page()
diff --git a/tests/async/test_browsercontext_storage_state.py b/tests/async/test_browsercontext_storage_state.py
index f11aa8281..a7e853391 100644
--- a/tests/async/test_browsercontext_storage_state.py
+++ b/tests/async/test_browsercontext_storage_state.py
@@ -16,7 +16,7 @@
 import json
 from pathlib import Path
 
-from playwright.async_api import Browser, BrowserContext, Page
+from playwright.async_api import Browser, BrowserContext, Page, StorageState
 from tests.server import Server
 
 
@@ -44,16 +44,30 @@ async def test_should_capture_local_storage(context: BrowserContext) -> None:
 
 
 async def test_should_set_local_storage(browser: Browser) -> None:
-    context = await browser.new_context(
-        storage_state={
-            "origins": [
+    storage_state: StorageState = {
+        "origins": [
+            {
+                "origin": "https://www.example.com",
+                "localStorage": [{"name": "name1", "value": "value1"}],
+            }
+        ]
+    }
+    # We intentionally hide the indexed_db part in our API for now
+    storage_state["origins"][0]["indexedDB"] = [  # type: ignore
+        {
+            "name": "db",
+            "version": 42,
+            "stores": [
                 {
-                    "origin": "https://www.example.com",
-                    "localStorage": [{"name": "name1", "value": "value1"}],
+                    "name": "store",
+                    "autoIncrement": False,
+                    "records": [{"key": "bar", "value": "foo"}],
+                    "indexes": [],
                 }
-            ]
+            ],
         }
-    )
+    ]
+    context = await browser.new_context(storage_state=storage_state)
 
     page = await context.new_page()
     await page.route(
@@ -62,6 +76,23 @@ async def test_should_set_local_storage(browser: Browser) -> None:
     await page.goto("https://www.example.com")
     local_storage = await page.evaluate("window.localStorage")
     assert local_storage == {"name1": "value1"}
+
+    indexed_db = await page.evaluate(
+        """async () => {
+        return new Promise((resolve, reject) => {
+            const openRequest = indexedDB.open('db', 42);
+            openRequest.addEventListener('success', () => {
+                const db = openRequest.result;
+                const transaction = db.transaction('store', 'readonly');
+                const getRequest = transaction.objectStore('store').get('bar');
+                getRequest.addEventListener('success', () => resolve(getRequest.result));
+                getRequest.addEventListener('error', () => reject(getRequest.error));
+            });
+            openRequest.addEventListener('error', () => reject(openRequest.error));
+        });
+    }"""
+    )
+    assert indexed_db == "foo"
     await context.close()
 
 
@@ -112,3 +143,48 @@ async def test_should_serialiser_storage_state_with_lone_surrogates(
     storage_state = await context.storage_state()
     # 65533 is the Unicode replacement character
     assert storage_state["origins"][0]["localStorage"][0]["value"] == chr(65533)
+
+
+async def test_should_serialise_indexed_db(page: Page, server: Server) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.evaluate(
+        """async () => {
+            await new Promise((resolve, reject) => {
+                const openRequest = indexedDB.open('db', 42);
+                openRequest.onupgradeneeded = () => {
+                openRequest.result.createObjectStore('store');
+                };
+                openRequest.onsuccess = () => {
+                const request = openRequest.result.transaction('store', 'readwrite')
+                    .objectStore('store')
+                    .put('foo', 'bar');
+                request.addEventListener('success', resolve);
+                request.addEventListener('error', reject);
+                };
+            });
+        }"""
+    )
+    assert await page.context.storage_state() == {"cookies": [], "origins": []}
+    assert await page.context.storage_state(indexed_db=True) == {
+        "cookies": [],
+        "origins": [
+            {
+                "origin": f"http://localhost:{server.PORT}",
+                "localStorage": [],
+                "indexedDB": [
+                    {
+                        "name": "db",
+                        "version": 42,
+                        "stores": [
+                            {
+                                "name": "store",
+                                "autoIncrement": False,
+                                "records": [{"key": "bar", "value": "foo"}],
+                                "indexes": [],
+                            }
+                        ],
+                    }
+                ],
+            }
+        ],
+    }
diff --git a/tests/async/test_defaultbrowsercontext.py b/tests/async/test_defaultbrowsercontext.py
index 805deddfe..60f8d83fd 100644
--- a/tests/async/test_defaultbrowsercontext.py
+++ b/tests/async/test_defaultbrowsercontext.py
@@ -317,6 +317,16 @@ async def test_should_support_timezone_id_option(
     )
 
 
+async def test_should_support_contrast_option(
+    launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
+) -> None:
+    (page, _) = await launch_persistent(contrast="more")
+    assert await page.evaluate('() => matchMedia("(prefers-contrast: more)").matches')
+    assert not await page.evaluate(
+        '() => matchMedia("(prefers-contrast: no-preference)").matches'
+    )
+
+
 async def test_should_support_locale_option(
     launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
 ) -> None:
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index 838e56c7d..d37697322 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -486,3 +486,41 @@ def _handle_request(req: TestServerRequest) -> None:
     assert await response.text() == "Hello!"
     assert request_count == 4
     await request.dispose()
+
+
+async def test_should_throw_when_fail_on_status_code_is_true(
+    playwright: Playwright, server: Server
+) -> None:
+    server.set_route(
+        "/empty.html",
+        lambda req: (
+            req.setResponseCode(404),
+            req.setHeader("Content-Length", "10"),
+            req.setHeader("Content-Type", "text/plain"),
+            req.write(b"Not found."),
+            req.finish(),
+        ),
+    )
+    request = await playwright.request.new_context(fail_on_status_code=True)
+    with pytest.raises(Error, match="404 Not Found"):
+        await request.fetch(server.EMPTY_PAGE)
+    await request.dispose()
+
+
+async def test_should_not_throw_when_fail_on_status_code_is_false(
+    playwright: Playwright, server: Server
+) -> None:
+    server.set_route(
+        "/empty.html",
+        lambda req: (
+            req.setResponseCode(404),
+            req.setHeader("Content-Length", "10"),
+            req.setHeader("Content-Type", "text/plain"),
+            req.write(b"Not found."),
+            req.finish(),
+        ),
+    )
+    request = await playwright.request.new_context(fail_on_status_code=False)
+    response = await request.fetch(server.EMPTY_PAGE)
+    assert response.status == 404
+    await request.dispose()
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index aceb39991..a5891f558 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -532,6 +532,28 @@ async def test_should_combine_visible_with_other_selectors(page: Page) -> None:
     )
 
 
+async def test_should_support_filter_visible(page: Page) -> None:
+    await page.set_content(
+        """<div>
+    <div class="item" style="display: none">Hidden data0</div>
+    <div class="item">visible data1</div>
+    <div class="item" style="display: none">Hidden data1</div>
+    <div class="item">visible data2</div>
+    <div class="item" style="display: none">Hidden data2</div>
+    <div class="item">visible data3</div>
+    </div>
+    """
+    )
+    locator = page.locator(".item").filter(visible=True).nth(1)
+    await expect(locator).to_have_text("visible data2")
+    await expect(
+        page.locator(".item").filter(visible=True).get_by_text("data3")
+    ).to_have_text("visible data3")
+    await expect(
+        page.locator(".item").filter(visible=False).get_by_text("data1")
+    ).to_have_text("Hidden data1")
+
+
 async def test_locator_count_should_work_with_deleted_map_in_main_world(
     page: Page,
 ) -> None:
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 376df8376..962a11e59 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -1350,7 +1350,6 @@ async def test_should_set_bodysize_to_0(page: Page, server: Server) -> None:
     assert sizes["requestHeadersSize"] >= 200
 
 
-@pytest.mark.skip_browser("webkit")  # https://bugs.webkit.org/show_bug.cgi?id=225281
 async def test_should_emulate_forced_colors(page: Page) -> None:
     assert await page.evaluate("matchMedia('(forced-colors: none)').matches")
     await page.emulate_media(forced_colors="none")
@@ -1361,6 +1360,26 @@ async def test_should_emulate_forced_colors(page: Page) -> None:
     assert not await page.evaluate("matchMedia('(forced-colors: none)').matches")
 
 
+async def test_should_emulate_contrast(page: Page) -> None:
+    assert await page.evaluate(
+        "matchMedia('(prefers-contrast: no-preference)').matches"
+    )
+    await page.emulate_media(contrast="no-preference")
+    assert await page.evaluate(
+        "matchMedia('(prefers-contrast: no-preference)').matches"
+    )
+    assert not await page.evaluate("matchMedia('(prefers-contrast: more)').matches")
+    await page.emulate_media(contrast="more")
+    assert not await page.evaluate(
+        "matchMedia('(prefers-contrast: no-preference)').matches"
+    )
+    assert await page.evaluate("matchMedia('(prefers-contrast: more)').matches")
+    await page.emulate_media(contrast="null")
+    assert await page.evaluate(
+        "matchMedia('(prefers-contrast: no-preference)').matches"
+    )
+
+
 async def test_should_not_throw_when_continuing_while_page_is_closing(
     page: Page, server: Server
 ) -> None:
diff --git a/tests/sync/test_browsercontext_storage_state.py b/tests/sync/test_browsercontext_storage_state.py
index c785b1479..f7db067d4 100644
--- a/tests/sync/test_browsercontext_storage_state.py
+++ b/tests/sync/test_browsercontext_storage_state.py
@@ -15,7 +15,8 @@
 import json
 from pathlib import Path
 
-from playwright.sync_api import Browser, BrowserContext
+from playwright.sync_api import Browser, BrowserContext, Page, StorageState
+from tests.server import Server
 
 
 def test_should_capture_local_storage(context: BrowserContext) -> None:
@@ -41,22 +42,53 @@ def test_should_capture_local_storage(context: BrowserContext) -> None:
 
 
 def test_should_set_local_storage(browser: Browser) -> None:
-    context = browser.new_context(
-        storage_state={
-            "origins": [
+    storage_state: StorageState = {
+        "origins": [
+            {
+                "origin": "https://www.example.com",
+                "localStorage": [{"name": "name1", "value": "value1"}],
+            }
+        ]
+    }
+    # We intentionally hide the indexed_db part in our API for now
+    storage_state["origins"][0]["indexedDB"] = [  # type: ignore
+        {
+            "name": "db",
+            "version": 42,
+            "stores": [
                 {
-                    "origin": "https://www.example.com",
-                    "localStorage": [{"name": "name1", "value": "value1"}],
+                    "name": "store",
+                    "autoIncrement": False,
+                    "records": [{"key": "bar", "value": "foo"}],
+                    "indexes": [],
                 }
-            ]
+            ],
         }
-    )
+    ]
+    context = browser.new_context(storage_state=storage_state)
 
     page = context.new_page()
     page.route("**/*", lambda route: route.fulfill(body="<html></html>"))
     page.goto("https://www.example.com")
     local_storage = page.evaluate("window.localStorage")
     assert local_storage == {"name1": "value1"}
+
+    indexed_db = page.evaluate(
+        """async () => {
+        return new Promise((resolve, reject) => {
+            const openRequest = indexedDB.open('db', 42);
+            openRequest.addEventListener('success', () => {
+                const db = openRequest.result;
+                const transaction = db.transaction('store', 'readonly');
+                const getRequest = transaction.objectStore('store').get('bar');
+                getRequest.addEventListener('success', () => resolve(getRequest.result));
+                getRequest.addEventListener('error', () => reject(getRequest.error));
+            });
+            openRequest.addEventListener('error', () => reject(openRequest.error));
+        });
+    }"""
+    )
+    assert indexed_db == "foo"
     context.close()
 
 
@@ -95,3 +127,48 @@ def test_should_round_trip_through_the_file(
     cookie = page2.evaluate("document.cookie")
     assert cookie == "username=John Doe"
     context2.close()
+
+
+def test_should_serialise_indexed_db(page: Page, server: Server) -> None:
+    page.goto(server.EMPTY_PAGE)
+    page.evaluate(
+        """async () => {
+            await new Promise((resolve, reject) => {
+                const openRequest = indexedDB.open('db', 42);
+                openRequest.onupgradeneeded = () => {
+                openRequest.result.createObjectStore('store');
+                };
+                openRequest.onsuccess = () => {
+                const request = openRequest.result.transaction('store', 'readwrite')
+                    .objectStore('store')
+                    .put('foo', 'bar');
+                request.addEventListener('success', resolve);
+                request.addEventListener('error', reject);
+                };
+            });
+        }"""
+    )
+    assert page.context.storage_state() == {"cookies": [], "origins": []}
+    assert page.context.storage_state(indexed_db=True) == {
+        "cookies": [],
+        "origins": [
+            {
+                "origin": f"http://localhost:{server.PORT}",
+                "localStorage": [],
+                "indexedDB": [
+                    {
+                        "name": "db",
+                        "version": 42,
+                        "stores": [
+                            {
+                                "name": "store",
+                                "autoIncrement": False,
+                                "records": [{"key": "bar", "value": "foo"}],
+                                "indexes": [],
+                            }
+                        ],
+                    }
+                ],
+            }
+        ],
+    }
diff --git a/tests/sync/test_fetch_global.py b/tests/sync/test_fetch_global.py
index 5c25d4059..b7420253b 100644
--- a/tests/sync/test_fetch_global.py
+++ b/tests/sync/test_fetch_global.py
@@ -323,3 +323,41 @@ def test_should_serialize_null_values_in_json(
     assert response.status == 200
     assert response.text() == '{"foo": null}'
     request.dispose()
+
+
+def test_should_throw_when_fail_on_status_code_is_true(
+    playwright: Playwright, server: Server
+) -> None:
+    server.set_route(
+        "/empty.html",
+        lambda req: (
+            req.setResponseCode(404),
+            req.setHeader("Content-Length", "10"),
+            req.setHeader("Content-Type", "text/plain"),
+            req.write(b"Not found."),
+            req.finish(),
+        ),
+    )
+    request = playwright.request.new_context(fail_on_status_code=True)
+    with pytest.raises(Error, match="404 Not Found"):
+        request.fetch(server.EMPTY_PAGE)
+    request.dispose()
+
+
+def test_should_not_throw_when_fail_on_status_code_is_false(
+    playwright: Playwright, server: Server
+) -> None:
+    server.set_route(
+        "/empty.html",
+        lambda req: (
+            req.setResponseCode(404),
+            req.setHeader("Content-Length", "10"),
+            req.setHeader("Content-Type", "text/plain"),
+            req.write(b"Not found."),
+            req.finish(),
+        ),
+    )
+    request = playwright.request.new_context(fail_on_status_code=False)
+    response = request.fetch(server.EMPTY_PAGE)
+    assert response.status == 404
+    request.dispose()
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index f373abdaa..31d7b174b 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -493,6 +493,28 @@ def test_should_combine_visible_with_other_selectors(page: Page) -> None:
     )
 
 
+def test_should_support_filter_visible(page: Page) -> None:
+    page.set_content(
+        """<div>
+    <div class="item" style="display: none">Hidden data0</div>
+    <div class="item">visible data1</div>
+    <div class="item" style="display: none">Hidden data1</div>
+    <div class="item">visible data2</div>
+    <div class="item" style="display: none">Hidden data2</div>
+    <div class="item">visible data3</div>
+    </div>
+    """
+    )
+    locator = page.locator(".item").filter(visible=True).nth(1)
+    expect(locator).to_have_text("visible data2")
+    expect(
+        page.locator(".item").filter(visible=True).get_by_text("data3")
+    ).to_have_text("visible data3")
+    expect(
+        page.locator(".item").filter(visible=False).get_by_text("data1")
+    ).to_have_text("Hidden data1")
+
+
 def test_locator_count_should_work_with_deleted_map_in_main_world(page: Page) -> None:
     page.evaluate("Map = 1")
     page.locator("#searchResultTableDiv .x-grid3-row").count()

From 25fb05dd18012e2ed42d3c8470d954581c1674ad Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 10 Mar 2025 18:48:13 +0100
Subject: [PATCH 340/438] test: migrate flaky plugin to rerunfailures (#2772)

---
 .github/workflows/test_docker.yml        | 4 ++--
 local-requirements.txt                   | 2 +-
 tests/async/test_browsercontext_proxy.py | 3 ---
 tests/async/test_browsertype_connect.py  | 2 --
 tests/async/test_input.py                | 3 ---
 tests/async/test_network.py              | 2 --
 tests/async/test_resource_timing.py      | 3 ---
 tests/async/test_websocket.py            | 2 --
 tests/async/test_worker.py               | 3 ---
 tests/conftest.py                        | 5 +++++
 tests/sync/test_resource_timing.py       | 3 ---
 11 files changed, 8 insertions(+), 24 deletions(-)

diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index 573370f13..7f0ca3088 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -49,5 +49,5 @@ jobs:
         docker exec "${CONTAINER_ID}" pip install -r requirements.txt
         docker exec "${CONTAINER_ID}" pip install -e .
         docker exec "${CONTAINER_ID}" python -m build --wheel
-        docker exec "${CONTAINER_ID}" xvfb-run pytest -vv tests/sync/
-        docker exec "${CONTAINER_ID}" xvfb-run pytest -vv tests/async/
+        docker exec "${CONTAINER_ID}" xvfb-run pytest tests/sync/
+        docker exec "${CONTAINER_ID}" xvfb-run pytest tests/async/
diff --git a/local-requirements.txt b/local-requirements.txt
index 7e6b1439a..eb836c426 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -2,7 +2,6 @@ autobahn==23.1.2
 black==25.1.0
 build==1.2.2.post1
 flake8==7.1.2
-flaky==3.8.1
 mypy==1.15.0
 objgraph==3.6.2
 Pillow==11.1.0
@@ -13,6 +12,7 @@ pytest==8.3.5
 pytest-asyncio==0.25.3
 pytest-cov==6.0.0
 pytest-repeat==0.9.3
+pytest-rerunfailures==15.0
 pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3
diff --git a/tests/async/test_browsercontext_proxy.py b/tests/async/test_browsercontext_proxy.py
index b5fbdbcb4..f511a0bee 100644
--- a/tests/async/test_browsercontext_proxy.py
+++ b/tests/async/test_browsercontext_proxy.py
@@ -17,7 +17,6 @@
 from typing import AsyncGenerator, Awaitable, Callable
 
 import pytest
-from flaky import flaky
 
 from playwright.async_api import Browser, BrowserContext
 from tests.server import Server, TestServerRequest
@@ -108,7 +107,6 @@ async def test_should_work_with_ip_port_notion(
     assert await page.title() == "Served by the proxy"
 
 
-@flaky  # Upstream flaky
 async def test_should_authenticate(
     context_factory: "Callable[..., Awaitable[BrowserContext]]", server: Server
 ) -> None:
@@ -139,7 +137,6 @@ def handler(req: TestServerRequest) -> None:
     )
 
 
-@flaky  # Upstream flaky
 async def test_should_authenticate_with_empty_password(
     context_factory: "Callable[..., Awaitable[BrowserContext]]", server: Server
 ) -> None:
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index f58fd2981..c2d8471d9 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -19,7 +19,6 @@
 from typing import Callable
 
 import pytest
-from flaky import flaky
 
 from playwright.async_api import BrowserType, Error, Playwright, Route
 from tests.conftest import RemoteServer
@@ -266,7 +265,6 @@ async def handle_request(route: Route) -> None:
     remote.kill()
 
 
-@flaky
 async def test_should_upload_large_file(
     browser_type: BrowserType,
     launch_server: Callable[[], RemoteServer],
diff --git a/tests/async/test_input.py b/tests/async/test_input.py
index f9c487867..b7bd3d799 100644
--- a/tests/async/test_input.py
+++ b/tests/async/test_input.py
@@ -21,7 +21,6 @@
 from typing import Any
 
 import pytest
-from flaky import flaky
 
 from playwright._impl._path_utils import get_file_dirname
 from playwright.async_api import Error, FilePayload, Page
@@ -316,7 +315,6 @@ async def _listen_for_wheel_events(page: Page, selector: str) -> None:
     )
 
 
-@flaky
 async def test_should_upload_large_file(
     page: Page, server: Server, tmp_path: Path
 ) -> None:
@@ -383,7 +381,6 @@ async def test_set_input_files_should_preserve_last_modified_timestamp(
         assert abs(timestamps[i] - expected_timestamps[i]) < 1000
 
 
-@flaky
 async def test_should_upload_multiple_large_file(
     page: Page, server: Server, tmp_path: Path
 ) -> None:
diff --git a/tests/async/test_network.py b/tests/async/test_network.py
index cbeead601..8747956ab 100644
--- a/tests/async/test_network.py
+++ b/tests/async/test_network.py
@@ -19,7 +19,6 @@
 from typing import Dict, List, Optional, Union
 
 import pytest
-from flaky import flaky
 from twisted.web import http
 
 from playwright.async_api import Browser, Error, Page, Request, Response, Route
@@ -819,7 +818,6 @@ async def test_set_extra_http_headers_should_work_with_extra_headers_from_browse
     assert request.getHeader("foo") == "bar"
 
 
-@flaky  # Flaky upstream https://devops.aslushnikov.com/flakiness2.html#filter_spec=should+override+extra+headers+from+browser+context&test_parameter_filters=%5B%5B%22browserName%22%2C%5B%5B%22webkit%22%2C%22include%22%5D%5D%5D%2C%5B%22video%22%2C%5B%5Btrue%2C%22exclude%22%5D%5D%5D%2C%5B%22platform%22%2C%5B%5B%22Windows%22%2C%22include%22%5D%5D%5D%5D
 async def test_set_extra_http_headers_should_override_extra_headers_from_browser_context(
     browser: Browser, server: Server
 ) -> None:
diff --git a/tests/async/test_resource_timing.py b/tests/async/test_resource_timing.py
index 2a14414df..a8481b8c8 100644
--- a/tests/async/test_resource_timing.py
+++ b/tests/async/test_resource_timing.py
@@ -15,7 +15,6 @@
 from typing import Dict
 
 import pytest
-from flaky import flaky
 
 from playwright.async_api import Browser, Page
 from tests.server import Server
@@ -33,7 +32,6 @@ async def test_should_work(page: Page, server: Server) -> None:
     assert timing["responseEnd"] < 10000
 
 
-@flaky
 async def test_should_work_for_subresource(
     page: Page, server: Server, is_win: bool, is_mac: bool, is_webkit: bool
 ) -> None:
@@ -51,7 +49,6 @@ async def test_should_work_for_subresource(
     assert timing["responseEnd"] < 10000
 
 
-@flaky  # Upstream flaky
 async def test_should_work_for_ssl(browser: Browser, https_server: Server) -> None:
     page = await browser.new_page(ignore_https_errors=True)
     async with page.expect_event("requestfinished") as request_info:
diff --git a/tests/async/test_websocket.py b/tests/async/test_websocket.py
index 696311a6b..c4729a4a5 100644
--- a/tests/async/test_websocket.py
+++ b/tests/async/test_websocket.py
@@ -16,7 +16,6 @@
 from typing import Union
 
 import pytest
-from flaky import flaky
 
 from playwright.async_api import Error, Page, WebSocket
 from tests.server import Server, WebSocketProtocol
@@ -151,7 +150,6 @@ def on_web_socket(ws: WebSocket) -> None:
     assert received == ["incoming", b"\x04\x02"]
 
 
-@flaky
 async def test_should_reject_wait_for_event_on_close_and_error(
     page: Page, server: Server
 ) -> None:
diff --git a/tests/async/test_worker.py b/tests/async/test_worker.py
index 94a12ee70..de1a858e8 100644
--- a/tests/async/test_worker.py
+++ b/tests/async/test_worker.py
@@ -16,7 +16,6 @@
 from asyncio.futures import Future
 
 import pytest
-from flaky import flaky
 
 from playwright.async_api import Browser, ConsoleMessage, Error, Page, Worker
 from tests.server import Server
@@ -107,7 +106,6 @@ async def test_workers_should_report_errors(page: Page) -> None:
     assert "this is my error" in error_log.message
 
 
-@flaky  # Upstream flaky
 async def test_workers_should_clear_upon_navigation(server: Server, page: Page) -> None:
     await page.goto(server.EMPTY_PAGE)
     async with page.expect_event("worker") as event_info:
@@ -123,7 +121,6 @@ async def test_workers_should_clear_upon_navigation(server: Server, page: Page)
     assert len(page.workers) == 0
 
 
-@flaky  # Upstream flaky
 async def test_workers_should_clear_upon_cross_process_navigation(
     server: Server, page: Page
 ) -> None:
diff --git a/tests/conftest.py b/tests/conftest.py
index d4909bcf5..15505c30c 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -34,6 +34,11 @@
 _dirname = get_file_dirname()
 
 
+def pytest_configure(config: pytest.Config) -> None:
+    if os.environ.get("CI"):
+        config.option.reruns = 3
+
+
 def pytest_generate_tests(metafunc: pytest.Metafunc) -> None:
     if "browser_name" in metafunc.fixturenames:
         browsers = metafunc.config.option.browser or ["chromium", "firefox", "webkit"]
diff --git a/tests/sync/test_resource_timing.py b/tests/sync/test_resource_timing.py
index dcfcc48df..a5bd8dd8a 100644
--- a/tests/sync/test_resource_timing.py
+++ b/tests/sync/test_resource_timing.py
@@ -15,7 +15,6 @@
 from typing import Dict
 
 import pytest
-from flaky import flaky
 
 from playwright.sync_api import Browser, Page
 from tests.server import Server
@@ -33,7 +32,6 @@ def test_should_work(page: Page, server: Server) -> None:
     assert timing["responseEnd"] < 10000
 
 
-@flaky
 def test_should_work_for_subresource(
     page: Page, server: Server, is_win: bool, is_mac: bool, is_webkit: bool
 ) -> None:
@@ -51,7 +49,6 @@ def test_should_work_for_subresource(
     assert timing["responseEnd"] < 10000
 
 
-@flaky  # Upstream flaky
 def test_should_work_for_ssl(
     browser: Browser, https_server: Server, is_mac: bool, is_webkit: bool
 ) -> None:

From 3f97c8a67b5f94d62ece03714265ed3ba8992dcd Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 18 Mar 2025 09:56:10 +0100
Subject: [PATCH 341/438] chore(roll): roll Playwright to 1.51.1 (#2786)

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

diff --git a/setup.py b/setup.py
index 5403790f2..7b32878dd 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.51.0-beta-1741261385000"
+driver_version = "1.51.1"
 
 base_wheel_bundles = [
     {

From 256635b08bbeaaba8f60e56fa6ac275d980e4e04 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 18 Mar 2025 10:07:28 +0100
Subject: [PATCH 342/438] devops: fix ESRP publishing

---
 .azure-pipelines/publish.yml | 60 ++++++++++++++++++------------------
 1 file changed, 30 insertions(+), 30 deletions(-)

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index 2fc90faa2..d0d308342 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -49,34 +49,34 @@ extends:
               PLAYWRIGHT_TARGET_WHEEL=$wheel python -m build --wheel --outdir $(Build.ArtifactStagingDirectory)/esrp-build
             done
           displayName: 'Install & Build'
-    - job: Publish
-      dependsOn: Build
-      templateContext:
-        type: releaseJob
-        isProduction: true
-        inputs:
-        - input: pipelineArtifact
-          artifactName: esrp-build
-          targetPath: $(Build.ArtifactStagingDirectory)/esrp-build
-      steps:
-        - checkout: none
-        - task: EsrpRelease@9
+      - job: Publish
+        dependsOn: Build
+        templateContext:
+          type: releaseJob
+          isProduction: true
           inputs:
-            connectedservicename: 'Playwright-ESRP-PME'
-            usemanagedidentity: true
-            keyvaultname: 'playwright-esrp-pme'
-            signcertname: 'ESRP-Release-Sign'
-            clientid: '13434a40-7de4-4c23-81a3-d843dc81c2c5'
-            intent: 'PackageDistribution'
-            contenttype: 'PyPi'
-            # Keeping it commented out as a workaround for:
-            # https://portal.microsofticm.com/imp/v3/incidents/incident/499972482/summary
-            # contentsource: 'folder'
-            folderlocation: '$(Build.ArtifactStagingDirectory)/esrp-build'
-            waitforreleasecompletion: true
-            owners: 'maxschmitt@microsoft.com'
-            approvers: 'maxschmitt@microsoft.com'
-            serviceendpointurl: 'https://api.esrp.microsoft.com'
-            mainpublisher: 'Playwright'
-            domaintenantid: '975f013f-7f24-47e8-a7d3-abc4752bf346'
-          displayName: 'ESRP Release to PIP'
+          - input: pipelineArtifact
+            artifactName: esrp-build
+            targetPath: $(Build.ArtifactStagingDirectory)/esrp-build
+        steps:
+          - checkout: none
+          - task: EsrpRelease@9
+            inputs:
+              connectedservicename: 'Playwright-ESRP-PME'
+              usemanagedidentity: true
+              keyvaultname: 'playwright-esrp-pme'
+              signcertname: 'ESRP-Release-Sign'
+              clientid: '13434a40-7de4-4c23-81a3-d843dc81c2c5'
+              intent: 'PackageDistribution'
+              contenttype: 'PyPi'
+              # Keeping it commented out as a workaround for:
+              # https://portal.microsofticm.com/imp/v3/incidents/incident/499972482/summary
+              # contentsource: 'folder'
+              folderlocation: '$(Build.ArtifactStagingDirectory)/esrp-build'
+              waitforreleasecompletion: true
+              owners: 'maxschmitt@microsoft.com'
+              approvers: 'maxschmitt@microsoft.com'
+              serviceendpointurl: 'https://api.esrp.microsoft.com'
+              mainpublisher: 'Playwright'
+              domaintenantid: '975f013f-7f24-47e8-a7d3-abc4752bf346'
+            displayName: 'ESRP Release to PIP'

From c9b30dd3f39703535c37f3da77a33b680a1c77c4 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 19 Mar 2025 14:24:25 +0100
Subject: [PATCH 343/438] devops: migrate to GitHub App for automation (#2795)

---
 .github/workflows/trigger_internal_tests.yml | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/trigger_internal_tests.yml b/.github/workflows/trigger_internal_tests.yml
index 04288d1b0..b301a7b6e 100644
--- a/.github/workflows/trigger_internal_tests.yml
+++ b/.github/workflows/trigger_internal_tests.yml
@@ -11,11 +11,17 @@ jobs:
     name: "trigger"
     runs-on: ubuntu-24.04
     steps:
+    - uses: actions/create-github-app-token@v1
+      id: app-token
+      with:
+        app-id: ${{ vars.PLAYWRIGHT_APP_ID }}
+        private-key: ${{ secrets.PLAYWRIGHT_PRIVATE_KEY }}
+        repositories: playwright-browsers
     - run: |
-        curl -X POST \
+        curl -X POST --fail \
           -H "Accept: application/vnd.github.v3+json" \
           -H "Authorization: token ${GH_TOKEN}" \
           --data "{\"event_type\": \"playwright_tests_python\", \"client_payload\": {\"ref\": \"${GITHUB_SHA}\"}}" \
           https://api.github.com/repos/microsoft/playwright-browsers/dispatches
       env:
-        GH_TOKEN: ${{ secrets.REPOSITORY_DISPATCH_PERSONAL_ACCESS_TOKEN }}
+        GH_TOKEN: ${{ steps.app-token.outputs.token }}

From 379b3e53d9e45fd0792341c88a98cdb77c53928e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 20 Mar 2025 18:04:42 +0100
Subject: [PATCH 344/438] build(deps): bump setuptools from 75.8.2 to 76.0.0
 (#2774)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index a25577ddb..b83958761 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==75.8.2", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==76.0.0", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 46286096027d39901591e391fefd719be4bfdada Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 20 Mar 2025 18:04:53 +0100
Subject: [PATCH 345/438] build(deps): bump types-requests from 2.32.0.20250301
 to 2.32.0.20250306 (#2773)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index eb836c426..e2be3b722 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,4 +19,4 @@ requests==2.32.3
 service_identity==24.2.0
 twisted==24.11.0
 types-pyOpenSSL==24.1.0.20240722
-types-requests==2.32.0.20250301
+types-requests==2.32.0.20250306

From 8870edb59bba620c5bcba8166ba48b19f56f8c96 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 25 Mar 2025 12:14:52 +0100
Subject: [PATCH 346/438] chore: update pytest-asyncio (#2783)

---
 local-requirements.txt  |  2 +-
 pyproject.toml          |  1 +
 tests/async/conftest.py | 11 +----------
 3 files changed, 3 insertions(+), 11 deletions(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index e2be3b722..928d092b6 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,7 +9,7 @@ pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==25.0.0
 pytest==8.3.5
-pytest-asyncio==0.25.3
+pytest-asyncio==0.26.0
 pytest-cov==6.0.0
 pytest-repeat==0.9.3
 pytest-rerunfailures==15.0
diff --git a/pyproject.toml b/pyproject.toml
index b83958761..5dcdd49ff 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -67,6 +67,7 @@ markers = [
 junit_family = "xunit2"
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"
 
 [tool.mypy]
 ignore_missing_imports = true
diff --git a/tests/async/conftest.py b/tests/async/conftest.py
index c568067e5..65a963507 100644
--- a/tests/async/conftest.py
+++ b/tests/async/conftest.py
@@ -13,10 +13,9 @@
 # limitations under the License.
 
 import asyncio
-from typing import Any, AsyncGenerator, Awaitable, Callable, Dict, Generator, List
+from typing import Any, AsyncGenerator, Awaitable, Callable, Dict, Generator
 
 import pytest
-from pytest_asyncio import is_async_test
 
 from playwright.async_api import (
     Browser,
@@ -37,14 +36,6 @@ def utils() -> Generator[Utils, None, None]:
     yield utils_object
 
 
-# Will mark all the tests as async
-def pytest_collection_modifyitems(items: List[pytest.Item]) -> None:
-    pytest_asyncio_tests = (item for item in items if is_async_test(item))
-    session_scope_marker = pytest.mark.asyncio(loop_scope="session")
-    for async_test in pytest_asyncio_tests:
-        async_test.add_marker(session_scope_marker, append=False)
-
-
 @pytest.fixture(scope="session")
 async def playwright() -> AsyncGenerator[Playwright, None]:
     async with async_playwright() as playwright_object:

From 8f330bcc31577f99f16576332488602ca3946b26 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 25 Mar 2025 12:17:05 +0100
Subject: [PATCH 347/438] fix: "" userDataDir on Windows with Python 3.9
 (#2801)

---
 playwright/_impl/_browser_type.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index ec8c988d5..b34d224d6 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -14,6 +14,7 @@
 
 import asyncio
 import pathlib
+import sys
 from pathlib import Path
 from typing import TYPE_CHECKING, Dict, List, Optional, Pattern, Sequence, Union, cast
 
@@ -167,6 +168,10 @@ def _user_data_dir(self, userDataDir: Optional[Union[str, Path]]) -> str:
         if not userDataDir:
             return ""
         if not Path(userDataDir).is_absolute():
+            # Can be dropped once we drop Python 3.9 support (10/2025):
+            # https://github.com/python/cpython/issues/82852
+            if sys.platform == "win32" and sys.version_info[:2] < (3, 10):
+                return pathlib.Path.cwd() / userDataDir
             return str(Path(userDataDir).resolve())
         return str(Path(userDataDir))
 

From 0a6cd774b6119a889eb9583ae90c65f8207eac31 Mon Sep 17 00:00:00 2001
From: Martin Stolle <121817095+stollero@users.noreply.github.com>
Date: Mon, 31 Mar 2025 13:16:03 +0200
Subject: [PATCH 348/438] build(deps): bump pyee from 12.x to 13.x (#2802)

---
 meta.yaml        | 2 +-
 pyproject.toml   | 2 +-
 requirements.txt | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/meta.yaml b/meta.yaml
index 803565ac6..3bffe9812 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -29,7 +29,7 @@ requirements:
     - python >=3.9
     # This should be the same as the dependencies in pyproject.toml
     - greenlet>=3.1.1,<4.0.0
-    - pyee>=12,<13
+    - pyee>=13,<14
 
 test: # [build_platform == target_platform]
   requires:
diff --git a/pyproject.toml b/pyproject.toml
index 5dcdd49ff..8c157345d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -16,7 +16,7 @@ requires-python = ">=3.9"
 # - pip install uv==0.5.4
 # - uv pip compile pyproject.toml -o requirements.txt
 dependencies = [
-    "pyee>=12,<13",
+    "pyee>=13,<14",
     "greenlet>=3.1.1,<4.0.0"
 ]
 classifiers = [
diff --git a/requirements.txt b/requirements.txt
index eaa753330..5298f1ff4 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -2,7 +2,7 @@
 #    uv pip compile pyproject.toml -o requirements.txt
 greenlet==3.1.1
     # via playwright (pyproject.toml)
-pyee==12.1.1
+pyee==13.0.0
     # via playwright (pyproject.toml)
 typing-extensions==4.12.2
     # via pyee

From 5cf543b9f8945cda0fc93e8caf9a1f9614e413e3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 31 Mar 2025 13:16:26 +0200
Subject: [PATCH 349/438] build(deps): bump setuptools from 76.0.0 to 78.0.1
 (#2799)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 8c157345d..168b964f2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==76.0.0", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==78.0.1", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From a3dd8abd701c6a3a1f001123c5cf929376cfe0b5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 31 Mar 2025 13:45:44 +0200
Subject: [PATCH 350/438] build(deps): bump setuptools-scm from 8.1.0 to 8.2.0
 (#2764)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 168b964f2..2e0a1acc0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==78.0.1", "setuptools-scm==8.1.0", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==78.0.1", "setuptools-scm==8.2.0", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 70a3765893bfaf4e6523d9870000e7d9c253f31d Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 31 Mar 2025 13:05:07 +0100
Subject: [PATCH 351/438] chore: fix double call log formatting (#2805)

---
 playwright/_impl/_connection.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 8433058ae..027daf69d 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -619,4 +619,4 @@ def format_call_log(log: Optional[List[str]]) -> str:
         return ""
     if len(list(filter(lambda x: x.strip(), log))) == 0:
         return ""
-    return "\nCall log:\n" + "\n  - ".join(log) + "\n"
+    return "\nCall log:\n" + "\n".join(log) + "\n"

From 2da90039ce20b33e3f8f8d18af1f8ad4e7662026 Mon Sep 17 00:00:00 2001
From: Charles Stern <62192187+cisaacstern@users.noreply.github.com>
Date: Mon, 31 Mar 2025 16:07:37 -0400
Subject: [PATCH 352/438] fix(conda): revert noarch and add playwright install
 test (#2792)

---
 .github/workflows/ci.yml      |  2 +-
 .github/workflows/publish.yml |  2 +-
 meta.yaml                     |  7 ++++++-
 scripts/example_async.py      | 30 ++++++++++++++++++++++++++++++
 scripts/example_sync.py       | 28 ++++++++++++++++++++++++++++
 5 files changed, 66 insertions(+), 3 deletions(-)
 create mode 100644 scripts/example_async.py
 create mode 100644 scripts/example_sync.py

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 80dd92245..0a6d8fcd5 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -169,7 +169,7 @@ jobs:
       - name: Get conda
         uses: conda-incubator/setup-miniconda@v3
         with:
-          python-version: 3.12
+          python-version: 3.9
           channels: conda-forge
           miniconda-version: latest
       - name: Prepare
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 54c7ab80e..b682372fd 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -31,7 +31,7 @@ jobs:
       - name: Get conda
         uses: conda-incubator/setup-miniconda@v3
         with:
-          python-version: 3.12
+          python-version: 3.9
           channels: conda-forge
           miniconda-version: latest
       - name: Prepare
diff --git a/meta.yaml b/meta.yaml
index 3bffe9812..343f9b568 100644
--- a/meta.yaml
+++ b/meta.yaml
@@ -6,7 +6,6 @@ source:
   path: .
 
 build:
-  noarch: python
   number: 0
   script: "{{ PYTHON }} -m pip install . --no-deps -vv"
   binary_relocation: False
@@ -32,6 +31,9 @@ requirements:
     - pyee>=13,<14
 
 test: # [build_platform == target_platform]
+  files:
+    - scripts/example_sync.py
+    - scripts/example_async.py
   requires:
     - pip
   imports:
@@ -40,6 +42,9 @@ test: # [build_platform == target_platform]
     - playwright.async_api
   commands:
     - playwright --help
+    - playwright install --with-deps
+    - python scripts/example_sync.py
+    - python scripts/example_async.py
 
 about:
   home: https://github.com/microsoft/playwright-python
diff --git a/scripts/example_async.py b/scripts/example_async.py
new file mode 100644
index 000000000..9fe5b6b11
--- /dev/null
+++ b/scripts/example_async.py
@@ -0,0 +1,30 @@
+# 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 async_playwright
+
+
+async def main() -> None:
+    async with async_playwright() as p:
+        for browser_type in [p.chromium, p.firefox, p.webkit]:
+            browser = await browser_type.launch()
+            page = await browser.new_page()
+            assert await page.evaluate("() => 11 * 11") == 121
+            await browser.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
diff --git a/scripts/example_sync.py b/scripts/example_sync.py
new file mode 100644
index 000000000..0c65a5f07
--- /dev/null
+++ b/scripts/example_sync.py
@@ -0,0 +1,28 @@
+# 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 sync_playwright
+
+
+def main() -> None:
+    with sync_playwright() as p:
+        for browser_type in [p.chromium, p.firefox, p.webkit]:
+            browser = browser_type.launch()
+            page = browser.new_page()
+            assert page.evaluate("() => 11 * 11") == 121
+            browser.close()
+
+
+if __name__ == "__main__":
+    main()

From 1b6f89dce9a5f8d50f34f572fbb5dca62c96d02f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 31 Mar 2025 22:16:31 +0200
Subject: [PATCH 353/438] build(deps): bump setuptools from 78.0.1 to 78.1.0
 (#2808)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 2e0a1acc0..52ed67370 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==78.0.1", "setuptools-scm==8.2.0", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==78.1.0", "setuptools-scm==8.2.0", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 68d96cb65da874e2e6248d8c62dc622e763ca29c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 31 Mar 2025 22:16:39 +0200
Subject: [PATCH 354/438] build(deps): bump flake8 from 7.1.2 to 7.2.0 (#2806)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 928d092b6..f0afc5355 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,7 +1,7 @@
 autobahn==23.1.2
 black==25.1.0
 build==1.2.2.post1
-flake8==7.1.2
+flake8==7.2.0
 mypy==1.15.0
 objgraph==3.6.2
 Pillow==11.1.0

From 74e217770e62de63bdc16f1c383d850ba2e6dd28 Mon Sep 17 00:00:00 2001
From: Adam Gastineau <adam@agg.im>
Date: Mon, 28 Apr 2025 05:41:15 -0700
Subject: [PATCH 355/438] chore(roll): roll Playwright to 1.52.0 (omitting glob
 changes) (#2823)

---
 README.md                              |   4 +-
 playwright/_impl/_assertions.py        |  39 +++++++
 playwright/_impl/_fetch.py             |   1 +
 playwright/_impl/_js_handle.py         |  52 +++++++++
 playwright/_impl/_locator.py           |   2 +-
 playwright/async_api/_generated.py     | 147 ++++++++++++++++++++----
 playwright/sync_api/_generated.py      | 151 +++++++++++++++++++++----
 setup.py                               |   2 +-
 tests/async/test_accessibility.py      |  14 +--
 tests/async/test_assertions.py         |  26 +++++
 tests/async/test_fetch_global.py       |  20 ++++
 tests/async/test_page_aria_snapshot.py | 128 ++++++++++++++++++++-
 tests/async/test_page_clock.py         |   1 -
 tests/async/test_page_evaluate.py      |  23 ++++
 tests/sync/test_accessibility.py       |   4 +-
 tests/sync/test_assertions.py          |  26 +++++
 tests/sync/test_fetch_global.py        |  20 +++-
 tests/sync/test_page_aria_snapshot.py  | 126 ++++++++++++++++++++-
 tests/sync/test_page_clock.py          |   1 -
 19 files changed, 724 insertions(+), 63 deletions(-)

diff --git a/README.md b/README.md
index b203c6dab..b450b87f2 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 -->134.0.6998.35<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->136.0.7103.25<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->18.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->135.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->137.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 8ec657531..2a3beb756 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -300,6 +300,45 @@ async def not_to_have_class(
         __tracebackhide__ = True
         await self._not.to_have_class(expected, timeout)
 
+    async def to_contain_class(
+        self,
+        expected: Union[
+            Sequence[str],
+            str,
+        ],
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        if isinstance(expected, collections.abc.Sequence) and not isinstance(
+            expected, str
+        ):
+            expected_text = to_expected_text_values(expected)
+            await self._expect_impl(
+                "to.contain.class.array",
+                FrameExpectOptions(expectedText=expected_text, timeout=timeout),
+                expected,
+                "Locator expected to contain class names",
+            )
+        else:
+            expected_text = to_expected_text_values([expected])
+            await self._expect_impl(
+                "to.contain.class",
+                FrameExpectOptions(expectedText=expected_text, timeout=timeout),
+                expected,
+                "Locator expected to contain class",
+            )
+
+    async def not_to_contain_class(
+        self,
+        expected: Union[
+            Sequence[str],
+            str,
+        ],
+        timeout: float = None,
+    ) -> None:
+        __tracebackhide__ = True
+        await self._not.to_contain_class(expected, timeout)
+
     async def to_have_count(
         self,
         count: int,
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index b53e4e629..88f5810ee 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -74,6 +74,7 @@ async def new_context(
         storageState: Union[StorageState, str, Path] = None,
         clientCertificates: List[ClientCertificate] = None,
         failOnStatusCode: bool = None,
+        maxRedirects: int = None,
     ) -> "APIRequestContext":
         params = locals_to_params(locals())
         if "storageState" in params:
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 572d4975e..0d0d7e2ef 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -12,9 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import base64
 import collections.abc
 import datetime
 import math
+import struct
 import traceback
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union
@@ -260,6 +262,56 @@ def parse_value(value: Any, refs: Optional[Dict[int, Any]] = None) -> Any:
 
         if "b" in value:
             return value["b"]
+
+        if "ta" in value:
+            encoded_bytes = value["ta"]["b"]
+            decoded_bytes = base64.b64decode(encoded_bytes)
+            array_type = value["ta"]["k"]
+            if array_type == "i8":
+                word_size = 1
+                fmt = "b"
+            elif array_type == "ui8" or array_type == "ui8c":
+                word_size = 1
+                fmt = "B"
+            elif array_type == "i16":
+                word_size = 2
+                fmt = "h"
+            elif array_type == "ui16":
+                word_size = 2
+                fmt = "H"
+            elif array_type == "i32":
+                word_size = 4
+                fmt = "i"
+            elif array_type == "ui32":
+                word_size = 4
+                fmt = "I"
+            elif array_type == "f32":
+                word_size = 4
+                fmt = "f"
+            elif array_type == "f64":
+                word_size = 8
+                fmt = "d"
+            elif array_type == "bi64":
+                word_size = 8
+                fmt = "q"
+            elif array_type == "bui64":
+                word_size = 8
+                fmt = "Q"
+            else:
+                raise ValueError(f"Unsupported array type: {array_type}")
+
+            byte_len = len(decoded_bytes)
+            if byte_len % word_size != 0:
+                raise ValueError(
+                    f"Decoded bytes length {byte_len} is not a multiple of word size {word_size}"
+                )
+
+            if byte_len == 0:
+                return []
+            array_len = byte_len // word_size
+            # "<" denotes little-endian
+            format_string = f"<{array_len}{fmt}"
+            return list(struct.unpack(format_string, decoded_bytes))
     return value
 
 
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 37b1f9441..189485f47 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -540,7 +540,7 @@ async def screenshot(
             ),
         )
 
-    async def aria_snapshot(self, timeout: float = None) -> str:
+    async def aria_snapshot(self, timeout: float = None, ref: bool = None) -> str:
         return await self._frame._channel.send(
             "ariaSnapshot",
             {
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index d2f93dbb6..b622ab858 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -929,6 +929,10 @@ 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()`.
+
         Parameters
         ----------
         url : Union[str, None]
@@ -9486,8 +9490,8 @@ async def handle_route(route: Route):
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while routing. When a `baseURL` via the context
-            options was provided and the passed URL is a path, it gets merged via the
+            A glob pattern, regex pattern, or predicate that receives a [URL] to match during routing. If `baseURL` is set in
+            the context options and the provided URL is a string that does not start with `*`, it is resolved using the
             [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor.
         handler : Union[Callable[[Route, Request], Any], Callable[[Route], Any]]
             handler function to route the request.
@@ -13216,8 +13220,8 @@ async def handle_route(route: Route):
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while routing. When a `baseURL` via the context
-            options was provided and the passed URL is a path, it gets merged via the
+            A glob pattern, regex pattern, or predicate that receives a [URL] to match during routing. If `baseURL` is set in
+            the context options and the provided URL is a string that does not start with `*`, it is resolved using the
             [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor.
         handler : Union[Callable[[Route, Request], Any], Callable[[Route], Any]]
             handler function to route the request.
@@ -13464,9 +13468,6 @@ async def storage_state(
             state snapshot. If your application uses IndexedDB to store authentication tokens, like Firebase Authentication,
             enable this.
 
-            **NOTE** IndexedDBs with typed arrays are currently not supported.
-
-
         Returns
         -------
         {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}
@@ -14418,7 +14419,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://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the
+            [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
@@ -14543,11 +14544,15 @@ async def launch_persistent_context(
         Parameters
         ----------
         user_data_dir : Union[pathlib.Path, str]
-            Path to a User Data Directory, which stores browser session data like cookies and local storage. More details for
+            Path to a User Data Directory, which stores browser session data like cookies and local storage. Pass an empty
+            string to create a temporary directory.
+
+            More details for
             [Chromium](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md#introduction) and
-            [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile). Note that Chromium's
-            user data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty
-            string to use a temporary directory instead.
+            [Firefox](https://wiki.mozilla.org/Firefox/CommandLineOptions#User_profile). Chromium's user data directory is the
+            **parent** directory of the "Profile Path" seen at `chrome://version`.
+
+            Note that browsers do not allow launching multiple instances with the same User Data Directory.
         channel : Union[str, None]
             Browser distribution channel.
 
@@ -14581,7 +14586,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://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the
+            [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
@@ -15630,8 +15635,8 @@ async def evaluate(
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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.
+            Maximum time in milliseconds to wait for the locator before evaluating. Note that after locator is resolved,
+            evaluation itself is not limited by the timeout. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
 
         Returns
         -------
@@ -15720,8 +15725,8 @@ async def evaluate_handle(
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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.
+            Maximum time in milliseconds to wait for the locator before evaluating. Note that after locator is resolved,
+            evaluation itself is not limited by the timeout. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
 
         Returns
         -------
@@ -17215,7 +17220,12 @@ async def screenshot(
             )
         )
 
-    async def aria_snapshot(self, *, timeout: typing.Optional[float] = None) -> str:
+    async def aria_snapshot(
+        self,
+        *,
+        timeout: typing.Optional[float] = None,
+        ref: typing.Optional[bool] = 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
@@ -17260,6 +17270,9 @@ async def aria_snapshot(self, *, timeout: typing.Optional[float] = None) -> str:
         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.
+        ref : Union[bool, None]
+            Generate symbolic reference for each element. One can use `aria-ref=<ref>` locator immediately after capturing the
+            snapshot to perform actions on the element.
 
         Returns
         -------
@@ -17267,7 +17280,7 @@ 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, ref=ref)
         )
 
     async def scroll_into_view_if_needed(
@@ -18700,6 +18713,7 @@ async def new_context(
         ] = None,
         client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
         fail_on_status_code: typing.Optional[bool] = None,
+        max_redirects: typing.Optional[int] = None,
     ) -> "APIRequestContext":
         """APIRequest.new_context
 
@@ -18751,6 +18765,10 @@ async def new_context(
         fail_on_status_code : Union[bool, None]
             Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
             codes.
+        max_redirects : Union[int, None]
+            Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
+            exceeded. Defaults to `20`. Pass `0` to not follow redirects. This can be overwritten for each request
+            individually.
 
         Returns
         -------
@@ -18769,6 +18787,7 @@ async def new_context(
                 storageState=storage_state,
                 clientCertificates=client_certificates,
                 failOnStatusCode=fail_on_status_code,
+                maxRedirects=max_redirects,
             )
         )
 
@@ -19133,7 +19152,7 @@ async def to_have_class(
         """LocatorAssertions.to_have_class
 
         Ensures the `Locator` points to an element with given CSS classes. When a string is provided, it must fully match
-        the element's `class` attribute. To match individual classes or perform partial matches, use a regular expression:
+        the element's `class` attribute. To match individual classes use `locator_assertions.to_contain_class()`.
 
         **Usage**
 
@@ -19145,8 +19164,8 @@ async def to_have_class(
         from playwright.async_api import expect
 
         locator = page.locator(\"#component\")
-        await expect(locator).to_have_class(re.compile(r\"(^|\\\\s)selected(\\\\s|$)\"))
         await expect(locator).to_have_class(\"middle selected row\")
+        await expect(locator).to_have_class(re.compile(r\"(^|\\\\s)selected(\\\\s|$)\"))
         ```
 
         When an array is passed, the method asserts that the list of elements located matches the corresponding list of
@@ -19206,6 +19225,92 @@ async def not_to_have_class(
             )
         )
 
+    async def to_contain_class(
+        self,
+        expected: typing.Union[typing.Sequence[str], str],
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> None:
+        """LocatorAssertions.to_contain_class
+
+        Ensures the `Locator` points to an element with given CSS classes. All classes from the asserted value, separated
+        by spaces, must be present in the
+        [Element.classList](https://developer.mozilla.org/en-US/docs/Web/API/Element/classList) in any order.
+
+        **Usage**
+
+        ```html
+        <div class='middle selected row' id='component'></div>
+        ```
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator(\"#component\")
+        await expect(locator).to_contain_class(\"middle selected row\")
+        await expect(locator).to_contain_class(\"selected\")
+        await expect(locator).to_contain_class(\"row middle\")
+        ```
+
+        When an array is passed, the method asserts that the list of elements located matches the corresponding list of
+        expected class lists. Each element's class attribute is matched against the corresponding class in the array:
+
+        ```html
+        <div class='list'></div>
+          <div class='component inactive'></div>
+          <div class='component active'></div>
+          <div class='component inactive'></div>
+        </div>
+        ```
+
+        ```py
+        from playwright.async_api import expect
+
+        locator = page.locator(\"list > .component\")
+        await expect(locator).to_contain_class([\"inactive\", \"active\", \"inactive\"])
+        ```
+
+        Parameters
+        ----------
+        expected : Union[Sequence[str], str]
+            A string containing expected class names, separated by spaces, or a list of such strings to assert multiple
+            elements.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.to_contain_class(
+                expected=mapping.to_impl(expected), timeout=timeout
+            )
+        )
+
+    async def not_to_contain_class(
+        self,
+        expected: typing.Union[typing.Sequence[str], str],
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> None:
+        """LocatorAssertions.not_to_contain_class
+
+        The opposite of `locator_assertions.to_contain_class()`.
+
+        Parameters
+        ----------
+        expected : Union[Sequence[str], str]
+            Expected class or RegExp or a list of those.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.not_to_contain_class(
+                expected=mapping.to_impl(expected), timeout=timeout
+            )
+        )
+
     async def to_have_count(
         self, count: int, *, timeout: typing.Optional[float] = None
     ) -> None:
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 619319910..828636efe 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -943,6 +943,10 @@ 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()`.
+
         Parameters
         ----------
         url : Union[str, None]
@@ -9529,8 +9533,8 @@ def handle_route(route: Route):
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while routing. When a `baseURL` via the context
-            options was provided and the passed URL is a path, it gets merged via the
+            A glob pattern, regex pattern, or predicate that receives a [URL] to match during routing. If `baseURL` is set in
+            the context options and the provided URL is a string that does not start with `*`, it is resolved using the
             [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor.
         handler : Union[Callable[[Route, Request], Any], Callable[[Route], Any]]
             handler function to route the request.
@@ -13245,8 +13249,8 @@ def handle_route(route: Route):
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while routing. When a `baseURL` via the context
-            options was provided and the passed URL is a path, it gets merged via the
+            A glob pattern, regex pattern, or predicate that receives a [URL] to match during routing. If `baseURL` is set in
+            the context options and the provided URL is a string that does not start with `*`, it is resolved using the
             [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor.
         handler : Union[Callable[[Route, Request], Any], Callable[[Route], Any]]
             handler function to route the request.
@@ -13501,9 +13505,6 @@ def storage_state(
             state snapshot. If your application uses IndexedDB to store authentication tokens, like Firebase Authentication,
             enable this.
 
-            **NOTE** IndexedDBs with typed arrays are currently not supported.
-
-
         Returns
         -------
         {cookies: List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: List[{origin: str, localStorage: List[{name: str, value: str}]}]}
@@ -14461,7 +14462,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://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the
+            [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
@@ -14588,11 +14589,15 @@ def launch_persistent_context(
         Parameters
         ----------
         user_data_dir : Union[pathlib.Path, str]
-            Path to a User Data Directory, which stores browser session data like cookies and local storage. More details for
+            Path to a User Data Directory, which stores browser session data like cookies and local storage. Pass an empty
+            string to create a temporary directory.
+
+            More details for
             [Chromium](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md#introduction) and
-            [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile). Note that Chromium's
-            user data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty
-            string to use a temporary directory instead.
+            [Firefox](https://wiki.mozilla.org/Firefox/CommandLineOptions#User_profile). Chromium's user data directory is the
+            **parent** directory of the "Profile Path" seen at `chrome://version`.
+
+            Note that browsers do not allow launching multiple instances with the same User Data Directory.
         channel : Union[str, None]
             Browser distribution channel.
 
@@ -14626,7 +14631,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://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the
+            [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
@@ -15688,8 +15693,8 @@ def evaluate(
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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.
+            Maximum time in milliseconds to wait for the locator before evaluating. Note that after locator is resolved,
+            evaluation itself is not limited by the timeout. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
 
         Returns
         -------
@@ -15782,8 +15787,8 @@ def evaluate_handle(
         arg : Union[Any, None]
             Optional argument to pass to `expression`.
         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.
+            Maximum time in milliseconds to wait for the locator before evaluating. Note that after locator is resolved,
+            evaluation itself is not limited by the timeout. Defaults to `30000` (30 seconds). Pass `0` to disable timeout.
 
         Returns
         -------
@@ -17306,7 +17311,12 @@ def screenshot(
             )
         )
 
-    def aria_snapshot(self, *, timeout: typing.Optional[float] = None) -> str:
+    def aria_snapshot(
+        self,
+        *,
+        timeout: typing.Optional[float] = None,
+        ref: typing.Optional[bool] = 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
@@ -17351,6 +17361,9 @@ def aria_snapshot(self, *, timeout: typing.Optional[float] = None) -> str:
         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.
+        ref : Union[bool, None]
+            Generate symbolic reference for each element. One can use `aria-ref=<ref>` locator immediately after capturing the
+            snapshot to perform actions on the element.
 
         Returns
         -------
@@ -17358,7 +17371,7 @@ 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, ref=ref))
         )
 
     def scroll_into_view_if_needed(
@@ -18827,6 +18840,7 @@ def new_context(
         ] = None,
         client_certificates: typing.Optional[typing.List[ClientCertificate]] = None,
         fail_on_status_code: typing.Optional[bool] = None,
+        max_redirects: typing.Optional[int] = None,
     ) -> "APIRequestContext":
         """APIRequest.new_context
 
@@ -18878,6 +18892,10 @@ def new_context(
         fail_on_status_code : Union[bool, None]
             Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status
             codes.
+        max_redirects : Union[int, None]
+            Maximum number of request redirects that will be followed automatically. An error will be thrown if the number is
+            exceeded. Defaults to `20`. Pass `0` to not follow redirects. This can be overwritten for each request
+            individually.
 
         Returns
         -------
@@ -18897,6 +18915,7 @@ def new_context(
                     storageState=storage_state,
                     clientCertificates=client_certificates,
                     failOnStatusCode=fail_on_status_code,
+                    maxRedirects=max_redirects,
                 )
             )
         )
@@ -19278,7 +19297,7 @@ def to_have_class(
         """LocatorAssertions.to_have_class
 
         Ensures the `Locator` points to an element with given CSS classes. When a string is provided, it must fully match
-        the element's `class` attribute. To match individual classes or perform partial matches, use a regular expression:
+        the element's `class` attribute. To match individual classes use `locator_assertions.to_contain_class()`.
 
         **Usage**
 
@@ -19290,8 +19309,8 @@ def to_have_class(
         from playwright.sync_api import expect
 
         locator = page.locator(\"#component\")
-        expect(locator).to_have_class(re.compile(r\"(^|\\\\s)selected(\\\\s|$)\"))
         expect(locator).to_have_class(\"middle selected row\")
+        expect(locator).to_have_class(re.compile(r\"(^|\\\\s)selected(\\\\s|$)\"))
         ```
 
         When an array is passed, the method asserts that the list of elements located matches the corresponding list of
@@ -19355,6 +19374,96 @@ def not_to_have_class(
             )
         )
 
+    def to_contain_class(
+        self,
+        expected: typing.Union[typing.Sequence[str], str],
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> None:
+        """LocatorAssertions.to_contain_class
+
+        Ensures the `Locator` points to an element with given CSS classes. All classes from the asserted value, separated
+        by spaces, must be present in the
+        [Element.classList](https://developer.mozilla.org/en-US/docs/Web/API/Element/classList) in any order.
+
+        **Usage**
+
+        ```html
+        <div class='middle selected row' id='component'></div>
+        ```
+
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"#component\")
+        expect(locator).to_contain_class(\"middle selected row\")
+        expect(locator).to_contain_class(\"selected\")
+        expect(locator).to_contain_class(\"row middle\")
+        ```
+
+        When an array is passed, the method asserts that the list of elements located matches the corresponding list of
+        expected class lists. Each element's class attribute is matched against the corresponding class in the array:
+
+        ```html
+        <div class='list'></div>
+          <div class='component inactive'></div>
+          <div class='component active'></div>
+          <div class='component inactive'></div>
+        </div>
+        ```
+
+        ```py
+        from playwright.sync_api import expect
+
+        locator = page.locator(\"list > .component\")
+        await expect(locator).to_contain_class([\"inactive\", \"active\", \"inactive\"])
+        ```
+
+        Parameters
+        ----------
+        expected : Union[Sequence[str], str]
+            A string containing expected class names, separated by spaces, or a list of such strings to assert multiple
+            elements.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.to_contain_class(
+                    expected=mapping.to_impl(expected), timeout=timeout
+                )
+            )
+        )
+
+    def not_to_contain_class(
+        self,
+        expected: typing.Union[typing.Sequence[str], str],
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> None:
+        """LocatorAssertions.not_to_contain_class
+
+        The opposite of `locator_assertions.to_contain_class()`.
+
+        Parameters
+        ----------
+        expected : Union[Sequence[str], str]
+            Expected class or RegExp or a list of those.
+        timeout : Union[float, None]
+            Time to retry the assertion for in milliseconds. Defaults to `5000`.
+        """
+        __tracebackhide__ = True
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.not_to_contain_class(
+                    expected=mapping.to_impl(expected), timeout=timeout
+                )
+            )
+        )
+
     def to_have_count(
         self, count: int, *, timeout: typing.Optional[float] = None
     ) -> None:
diff --git a/setup.py b/setup.py
index 7b32878dd..6f9c7332d 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.51.1"
+driver_version = "1.52.0"
 
 base_wheel_bundles = [
     {
diff --git a/tests/async/test_accessibility.py b/tests/async/test_accessibility.py
index ec7b42190..41fe599c2 100644
--- a/tests/async/test_accessibility.py
+++ b/tests/async/test_accessibility.py
@@ -12,7 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import os
 import sys
 
 import pytest
@@ -21,8 +20,10 @@
 
 
 async def test_accessibility_should_work(
-    page: Page, is_firefox: bool, is_chromium: bool
+    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>
@@ -100,14 +101,7 @@ async def test_accessibility_should_work(
                 {"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!"
-                    ),
+                    "name": "This is a description!",
                     "value": "and a value",
                 },  # webkit uses the description over placeholder for the name
             ],
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 06292aa9b..58f4ea5f5 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -145,6 +145,32 @@ async def test_assertions_locator_to_have_class(page: Page, server: Server) -> N
         await expect(page.locator("div.foobar")).to_have_class("oh-no", timeout=100)
 
 
+async def test_assertions_locator_to_contain_class(page: Page, server: Server) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.set_content("<div class='foo bar baz'></div>")
+    locator = page.locator("div")
+    await expect(locator).to_contain_class("")
+    await expect(locator).to_contain_class("bar")
+    await expect(locator).to_contain_class("baz bar")
+    await expect(locator).to_contain_class("  bar   foo ")
+    await expect(locator).not_to_contain_class(
+        "  baz   not-matching "
+    )  # Strip whitespace and match individual classes
+    with pytest.raises(AssertionError) as excinfo:
+        await expect(locator).to_contain_class("does-not-exist", timeout=100)
+
+    assert excinfo.match("Locator expected to contain class 'does-not-exist'")
+    assert excinfo.match("Actual value: foo bar baz")
+    assert excinfo.match("LocatorAssertions.to_contain_class with timeout 100ms")
+
+    await page.set_content(
+        '<div class="foo"></div><div class="hello bar"></div><div class="baz"></div>'
+    )
+    await expect(locator).to_contain_class(["foo", "hello", "baz"])
+    await expect(locator).not_to_contain_class(["not-there", "hello", "baz"])
+    await expect(locator).not_to_contain_class(["foo", "hello"])
+
+
 async def test_assertions_locator_to_have_count(page: Page, server: Server) -> None:
     await page.goto(server.EMPTY_PAGE)
     await page.set_content("<div class=foobar>kek</div><div class=foobar>kek</div>")
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index d37697322..ae394755b 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -524,3 +524,23 @@ async def test_should_not_throw_when_fail_on_status_code_is_false(
     response = await request.fetch(server.EMPTY_PAGE)
     assert response.status == 404
     await request.dispose()
+
+
+async def test_should_follow_max_redirects(
+    playwright: Playwright, server: Server
+) -> None:
+    redirect_count = 0
+
+    def _handle_request(req: TestServerRequest) -> None:
+        nonlocal redirect_count
+        redirect_count += 1
+        req.setResponseCode(301)
+        req.setHeader("Location", server.EMPTY_PAGE)
+        req.finish()
+
+    server.set_route("/empty.html", _handle_request)
+    request = await playwright.request.new_context(max_redirects=1)
+    with pytest.raises(Error, match="Max redirect count exceeded"):
+        await request.fetch(server.EMPTY_PAGE)
+    assert redirect_count == 2
+    await request.dispose()
diff --git a/tests/async/test_page_aria_snapshot.py b/tests/async/test_page_aria_snapshot.py
index f84440ca4..007d1f56c 100644
--- a/tests/async/test_page_aria_snapshot.py
+++ b/tests/async/test_page_aria_snapshot.py
@@ -14,6 +14,8 @@
 
 import re
 
+import pytest
+
 from playwright.async_api import Locator, Page, expect
 
 
@@ -33,7 +35,7 @@ def _unshift(snapshot: str) -> str:
 
 async def check_and_match_snapshot(locator: Locator, snapshot: str) -> None:
     assert await locator.aria_snapshot() == _unshift(snapshot)
-    await expect(locator).to_match_aria_snapshot(snapshot)
+    await expect(locator).to_match_aria_snapshot(snapshot, timeout=1000)
 
 
 async def test_should_snapshot(page: Page) -> None:
@@ -88,6 +90,128 @@ async def test_should_snapshot_complex(page: Page) -> None:
         """
       - list:
         - listitem:
-          - link "link"
+          - link "link":
+            - /url: about:blank
     """,
     )
+
+
+async def test_should_snapshot_with_ref(page: Page) -> None:
+    await page.set_content('<ul><li><a href="about:blank">link</a></li></ul>')
+    expected = """
+      - list [ref=s1e3]:
+        - listitem [ref=s1e4]:
+          - link "link" [ref=s1e5]:
+            - /url: about:blank
+    """
+    assert await page.locator("body").aria_snapshot(ref=True) == _unshift(expected)
+
+
+async def test_should_snapshot_with_unexpected_children_equal(page: Page) -> None:
+    await page.set_content(
+        """
+      <ul>
+        <li>One</li>
+        <li>Two</li>
+        <li>Three</li>
+      </ul>
+    """
+    )
+    await expect(page.locator("body")).to_match_aria_snapshot(
+        """
+      - list:
+        - listitem: One
+        - listitem: Three
+    """,
+    )
+    with pytest.raises(AssertionError):
+        await expect(page.locator("body")).to_match_aria_snapshot(
+            """
+        - list:
+          - /children: equal
+          - listitem: One
+          - listitem: Three
+      """,
+            timeout=1000,
+        )
+
+
+async def test_should_snapshot_with_unexpected_children_deep_equal(page: Page) -> None:
+    await page.set_content(
+        """
+      <ul>
+        <li>
+          <ul>
+            <li>1.1</li>
+            <li>1.2</li>
+          </ul>
+        </li>
+      </ul>
+    """
+    )
+    await expect(page.locator("body")).to_match_aria_snapshot(
+        """
+      - list:
+        - listitem:
+          - list:
+            - listitem: 1.1
+    """,
+    )
+    await expect(page.locator("body")).to_match_aria_snapshot(
+        """
+        - list:
+          - /children: equal
+          - listitem:
+            - list:
+              - listitem: 1.1
+      """,
+    )
+    with pytest.raises(AssertionError):
+        await expect(page.locator("body")).to_match_aria_snapshot(
+            """
+          - list:
+            - /children: deep-equal
+            - listitem:
+              - list:
+                - listitem: 1.1
+        """,
+            timeout=1000,
+        )
+
+
+async def test_should_snapshot_with_restored_contain_mode_inside_deep_equal(
+    page: Page,
+) -> None:
+    await page.set_content(
+        """
+      <ul>
+        <li>
+          <ul>
+            <li>1.1</li>
+            <li>1.2</li>
+          </ul>
+        </li>
+      </ul>
+    """
+    )
+    with pytest.raises(AssertionError):
+        await expect(page.locator("body")).to_match_aria_snapshot(
+            """
+        - list:
+          - /children: deep-equal
+          - listitem:
+            - list:
+              - listitem: 1.1
+      """,
+            timeout=1000,
+        )
+    await expect(page.locator("body")).to_match_aria_snapshot(
+        """
+        - list:
+          - /children: deep-equal
+          - listitem:
+            - list:
+              - /children: contain
+              - listitem: 1.1
+      """,
+    )
diff --git a/tests/async/test_page_clock.py b/tests/async/test_page_clock.py
index 0676ee581..cbe7740ea 100644
--- a/tests/async/test_page_clock.py
+++ b/tests/async/test_page_clock.py
@@ -409,7 +409,6 @@ async def test_should_pause(self, page: Page) -> None:
         await page.goto("data:text/html,")
         await page.clock.pause_at(1)
         await page.wait_for_timeout(1000)
-        await page.clock.resume()
         now = await page.evaluate("Date.now()")
         assert 0 <= now <= 1000
 
diff --git a/tests/async/test_page_evaluate.py b/tests/async/test_page_evaluate.py
index 9b7712906..058263b18 100644
--- a/tests/async/test_page_evaluate.py
+++ b/tests/async/test_page_evaluate.py
@@ -65,6 +65,29 @@ async def test_evaluate_transfer_arrays(page: Page) -> None:
     assert result == [1, 2, 3]
 
 
+async def test_evaluate_transfer_typed_arrays(page: Page) -> None:
+    async def test_typed_array(
+        typed_array: str, expected: list[float], value_suffix: Optional[str]
+    ) -> None:
+        value_suffix = "" if value_suffix is None else value_suffix
+        result = await page.evaluate(
+            f"() => new {typed_array}([1{value_suffix}, 2{value_suffix}, 3{value_suffix}])"
+        )
+        assert result == expected
+
+    await test_typed_array("Int8Array", [1, 2, 3], None)
+    await test_typed_array("Uint8Array", [1, 2, 3], None)
+    await test_typed_array("Uint8ClampedArray", [1, 2, 3], None)
+    await test_typed_array("Int16Array", [1, 2, 3], None)
+    await test_typed_array("Uint16Array", [1, 2, 3], None)
+    await test_typed_array("Int32Array", [1, 2, 3], None)
+    await test_typed_array("Uint32Array", [1, 2, 3], None)
+    await test_typed_array("Float32Array", [1.5, 2.5, 3.5], ".5")
+    await test_typed_array("Float64Array", [1.5, 2.5, 3.5], ".5")
+    await test_typed_array("BigInt64Array", [1, 2, 3], "n")
+    await test_typed_array("BigUint64Array", [1, 2, 3], "n")
+
+
 async def test_evaluate_transfer_bigint(page: Page) -> None:
     assert await page.evaluate("() => 42n") == 42
     assert await page.evaluate("a => a", 17) == 17
diff --git a/tests/sync/test_accessibility.py b/tests/sync/test_accessibility.py
index 625a46999..10ec5d1b2 100644
--- a/tests/sync/test_accessibility.py
+++ b/tests/sync/test_accessibility.py
@@ -21,8 +21,10 @@
 
 
 def test_accessibility_should_work(
-    page: Page, is_firefox: bool, is_chromium: bool
+    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>
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 6aaffd49b..0dce717d3 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -124,6 +124,32 @@ def test_assertions_locator_to_have_class(page: Page, server: Server) -> None:
         expect(page.locator("div.foobar")).to_have_class("oh-no", timeout=100)
 
 
+def test_assertions_locator_to_contain_class(page: Page, server: Server) -> None:
+    page.goto(server.EMPTY_PAGE)
+    page.set_content("<div class='foo bar baz'></div>")
+    locator = page.locator("div")
+    expect(locator).to_contain_class("")
+    expect(locator).to_contain_class("bar")
+    expect(locator).to_contain_class("baz bar")
+    expect(locator).to_contain_class("  bar   foo ")
+    expect(locator).not_to_contain_class(
+        "  baz   not-matching "
+    )  # Strip whitespace and match individual classes
+    with pytest.raises(AssertionError) as excinfo:
+        expect(locator).to_contain_class("does-not-exist", timeout=100)
+
+    assert excinfo.match("Locator expected to contain class 'does-not-exist'")
+    assert excinfo.match("Actual value: foo bar baz")
+    assert excinfo.match("LocatorAssertions.to_contain_class with timeout 100ms")
+
+    page.set_content(
+        '<div class="foo"></div><div class="hello bar"></div><div class="baz"></div>'
+    )
+    expect(locator).to_contain_class(["foo", "hello", "baz"])
+    expect(locator).not_to_contain_class(["not-there", "hello", "baz"])
+    expect(locator).not_to_contain_class(["foo", "hello"])
+
+
 def test_assertions_locator_to_have_count(page: Page, server: Server) -> None:
     page.goto(server.EMPTY_PAGE)
     page.set_content("<div class=foobar>kek</div><div class=foobar>kek</div>")
diff --git a/tests/sync/test_fetch_global.py b/tests/sync/test_fetch_global.py
index b7420253b..9efc6e93b 100644
--- a/tests/sync/test_fetch_global.py
+++ b/tests/sync/test_fetch_global.py
@@ -19,7 +19,7 @@
 import pytest
 
 from playwright.sync_api import APIResponse, Error, Playwright, StorageState
-from tests.server import Server
+from tests.server import Server, TestServerRequest
 
 
 @pytest.mark.parametrize(
@@ -361,3 +361,21 @@ def test_should_not_throw_when_fail_on_status_code_is_false(
     response = request.fetch(server.EMPTY_PAGE)
     assert response.status == 404
     request.dispose()
+
+
+def test_should_follow_max_redirects(playwright: Playwright, server: Server) -> None:
+    redirect_count = 0
+
+    def _handle_request(req: TestServerRequest) -> None:
+        nonlocal redirect_count
+        redirect_count += 1
+        req.setResponseCode(301)
+        req.setHeader("Location", server.EMPTY_PAGE)
+        req.finish()
+
+    server.set_route("/empty.html", _handle_request)
+    request = playwright.request.new_context(max_redirects=1)
+    with pytest.raises(Error, match="Max redirect count exceeded"):
+        request.fetch(server.EMPTY_PAGE)
+    assert redirect_count == 2
+    request.dispose()
diff --git a/tests/sync/test_page_aria_snapshot.py b/tests/sync/test_page_aria_snapshot.py
index 481b2bf7a..ca1c48393 100644
--- a/tests/sync/test_page_aria_snapshot.py
+++ b/tests/sync/test_page_aria_snapshot.py
@@ -14,6 +14,8 @@
 
 import re
 
+import pytest
+
 from playwright.sync_api import Locator, Page, expect
 
 
@@ -88,6 +90,128 @@ def test_should_snapshot_complex(page: Page) -> None:
         """
       - list:
         - listitem:
-          - link "link"
+          - link "link":
+            - /url: about:blank
     """,
     )
+
+
+def test_should_snapshot_with_ref(page: Page) -> None:
+    page.set_content('<ul><li><a href="about:blank">link</a></li></ul>')
+    expected = """
+      - list [ref=s1e3]:
+        - listitem [ref=s1e4]:
+          - link "link" [ref=s1e5]:
+            - /url: about:blank
+    """
+    assert page.locator("body").aria_snapshot(ref=True) == _unshift(expected)
+
+
+def test_should_snapshot_with_unexpected_children_equal(page: Page) -> None:
+    page.set_content(
+        """
+      <ul>
+        <li>One</li>
+        <li>Two</li>
+        <li>Three</li>
+      </ul>
+    """
+    )
+    expect(page.locator("body")).to_match_aria_snapshot(
+        """
+      - list:
+        - listitem: One
+        - listitem: Three
+    """,
+    )
+    with pytest.raises(AssertionError):
+        expect(page.locator("body")).to_match_aria_snapshot(
+            """
+        - list:
+          - /children: equal
+          - listitem: One
+          - listitem: Three
+      """,
+            timeout=1000,
+        )
+
+
+def test_should_snapshot_with_unexpected_children_deep_equal(page: Page) -> None:
+    page.set_content(
+        """
+      <ul>
+        <li>
+          <ul>
+            <li>1.1</li>
+            <li>1.2</li>
+          </ul>
+        </li>
+      </ul>
+    """
+    )
+    expect(page.locator("body")).to_match_aria_snapshot(
+        """
+      - list:
+        - listitem:
+          - list:
+            - listitem: 1.1
+    """,
+    )
+    expect(page.locator("body")).to_match_aria_snapshot(
+        """
+        - list:
+          - /children: equal
+          - listitem:
+            - list:
+              - listitem: 1.1
+      """,
+    )
+    with pytest.raises(AssertionError):
+        expect(page.locator("body")).to_match_aria_snapshot(
+            """
+          - list:
+            - /children: deep-equal
+            - listitem:
+              - list:
+                - listitem: 1.1
+        """,
+            timeout=1000,
+        )
+
+
+def test_should_snapshot_with_restored_contain_mode_inside_deep_equal(
+    page: Page,
+) -> None:
+    page.set_content(
+        """
+      <ul>
+        <li>
+          <ul>
+            <li>1.1</li>
+            <li>1.2</li>
+          </ul>
+        </li>
+      </ul>
+    """
+    )
+    with pytest.raises(AssertionError):
+        expect(page.locator("body")).to_match_aria_snapshot(
+            """
+        - list:
+          - /children: deep-equal
+          - listitem:
+            - list:
+              - listitem: 1.1
+      """,
+            timeout=1000,
+        )
+    expect(page.locator("body")).to_match_aria_snapshot(
+        """
+        - list:
+          - /children: deep-equal
+          - listitem:
+            - list:
+              - /children: contain
+              - listitem: 1.1
+      """,
+    )
diff --git a/tests/sync/test_page_clock.py b/tests/sync/test_page_clock.py
index 025133b57..72d5e5a3e 100644
--- a/tests/sync/test_page_clock.py
+++ b/tests/sync/test_page_clock.py
@@ -392,7 +392,6 @@ def test_should_pause(self, page: Page) -> None:
         page.goto("data:text/html,")
         page.clock.pause_at(1)
         page.wait_for_timeout(1000)
-        page.clock.resume()
         now = page.evaluate("Date.now()")
         assert 0 <= now <= 1000
 

From 353c9d5f00e24be30726d37bdbdb0a2aca2ecbb8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 28 Apr 2025 15:05:49 +0200
Subject: [PATCH 356/438] build(deps): bump pytest-cov from 6.0.0 to 6.1.1
 (#2811)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index f0afc5355..36a5a8512 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -10,7 +10,7 @@ pre-commit==3.5.0
 pyOpenSSL==25.0.0
 pytest==8.3.5
 pytest-asyncio==0.26.0
-pytest-cov==6.0.0
+pytest-cov==6.1.1
 pytest-repeat==0.9.3
 pytest-rerunfailures==15.0
 pytest-timeout==2.3.1

From 10e9ea3d5ff72df99fcd6ac5a1b3af1e069962fc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 28 Apr 2025 15:06:15 +0200
Subject: [PATCH 357/438] build(deps): bump typing-extensions from 4.12.2 to
 4.13.2 (#2817)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 5298f1ff4..850fc18c9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -4,5 +4,5 @@ greenlet==3.1.1
     # via playwright (pyproject.toml)
 pyee==13.0.0
     # via playwright (pyproject.toml)
-typing-extensions==4.12.2
+typing-extensions==4.13.2
     # via pyee

From 805147f896c476889046b3d0836382465cfb572d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 28 Apr 2025 15:06:29 +0200
Subject: [PATCH 358/438] build(deps): bump actions/create-github-app-token
 from 1 to 2 in the actions group (#2809)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/trigger_internal_tests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/trigger_internal_tests.yml b/.github/workflows/trigger_internal_tests.yml
index b301a7b6e..2bbdeb565 100644
--- a/.github/workflows/trigger_internal_tests.yml
+++ b/.github/workflows/trigger_internal_tests.yml
@@ -11,7 +11,7 @@ jobs:
     name: "trigger"
     runs-on: ubuntu-24.04
     steps:
-    - uses: actions/create-github-app-token@v1
+    - uses: actions/create-github-app-token@v2
       id: app-token
       with:
         app-id: ${{ vars.PLAYWRIGHT_APP_ID }}

From dc525e708f644589eacd26cbfaeb14d97593d95a Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 28 Apr 2025 15:54:45 +0200
Subject: [PATCH 359/438] chore: adjust license metadata in pyproject.toml
 (#2828)

---
 pyproject.toml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 52ed67370..3c90282a0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -9,7 +9,7 @@ authors = [
     {name = "Microsoft Corporation"}
 ]
 readme = "README.md"
-license = {text = "Apache-2.0"}
+license = "Apache-2.0"
 dynamic = ["version"]
 requires-python = ">=3.9"
 # Please when changing dependencies run the following commands to update requirements.txt:
@@ -29,7 +29,6 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
-    "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent",
 ]
 

From 0e23e33a4199923be40f02c3067c67cbcb3cfac5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 28 Apr 2025 16:18:10 +0200
Subject: [PATCH 360/438] build(deps): bump pytest-repeat from 0.9.3 to 0.9.4
 (#2812)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 36a5a8512..0506bd86d 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -11,7 +11,7 @@ pyOpenSSL==25.0.0
 pytest==8.3.5
 pytest-asyncio==0.26.0
 pytest-cov==6.1.1
-pytest-repeat==0.9.3
+pytest-repeat==0.9.4
 pytest-rerunfailures==15.0
 pytest-timeout==2.3.1
 pytest-xdist==3.6.1

From ec92f20d56e4f5a4acfb3be26bc20a5dafa8d068 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 28 Apr 2025 16:18:32 +0200
Subject: [PATCH 361/438] build(deps): bump types-requests from 2.32.0.20250306
 to 2.32.0.20250328 (#2807)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 0506bd86d..c7dac72c7 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,4 +19,4 @@ requests==2.32.3
 service_identity==24.2.0
 twisted==24.11.0
 types-pyOpenSSL==24.1.0.20240722
-types-requests==2.32.0.20250306
+types-requests==2.32.0.20250328

From f5857df8a3bfdab8182e4261476f557a531a5fb4 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 28 Apr 2025 16:25:16 +0200
Subject: [PATCH 362/438] chore: publish win32-arm64 wheel (#2800)

---
 setup.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/setup.py b/setup.py
index 6f9c7332d..ed46af1aa 100644
--- a/setup.py
+++ b/setup.py
@@ -66,6 +66,12 @@
         "platform": "win32",
         "zip_name": "win32_x64",
     },
+    {
+        "wheel": "win_arm64.whl",
+        "machine": "arm64",
+        "platform": "win32",
+        "zip_name": "win32_arm64",
+    },
 ]
 
 if len(sys.argv) == 2 and sys.argv[1] == "--list-wheels":

From eec856f5d1f3e0f25565b5573c6596558ed94418 Mon Sep 17 00:00:00 2001
From: Adam Gastineau <adam@agg.im>
Date: Mon, 28 Apr 2025 08:43:20 -0700
Subject: [PATCH 363/438] chore(roll): roll glob changes from Playwright 1.52.0
 (#2824)

---
 playwright/_impl/_glob.py             |  20 ++--
 playwright/_impl/_helper.py           | 106 ++++++++++++++++----
 playwright/_impl/_network.py          |   2 +-
 tests/async/test_page_route.py        | 136 +++++++++++++++++++++++---
 tests/async/test_request_intercept.py |  14 +++
 tests/sync/test_request_intercept.py  |  14 +++
 6 files changed, 248 insertions(+), 44 deletions(-)

diff --git a/playwright/_impl/_glob.py b/playwright/_impl/_glob.py
index 2d899a789..08b7ce466 100644
--- a/playwright/_impl/_glob.py
+++ b/playwright/_impl/_glob.py
@@ -11,13 +11,12 @@
 # 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 re
 
 #  https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions#escaping
 escaped_chars = {"$", "^", "+", ".", "*", "(", ")", "|", "\\", "?", "{", "}", "[", "]"}
 
 
-def glob_to_regex(glob: str) -> "re.Pattern[str]":
+def glob_to_regex_pattern(glob: str) -> str:
     tokens = ["^"]
     in_group = False
 
@@ -46,23 +45,20 @@ def glob_to_regex(glob: str) -> "re.Pattern[str]":
             else:
                 tokens.append("([^/]*)")
         else:
-            if c == "?":
-                tokens.append(".")
-            elif c == "[":
-                tokens.append("[")
-            elif c == "]":
-                tokens.append("]")
-            elif c == "{":
+            if c == "{":
                 in_group = True
                 tokens.append("(")
             elif c == "}":
                 in_group = False
                 tokens.append(")")
-            elif c == "," and in_group:
-                tokens.append("|")
+            elif c == ",":
+                if in_group:
+                    tokens.append("|")
+                else:
+                    tokens.append("\\" + c)
             else:
                 tokens.append("\\" + c if c in escaped_chars else c)
         i += 1
 
     tokens.append("$")
-    return re.compile("".join(tokens))
+    return "".join(tokens)
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 2f7ab57b0..96acb8857 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -44,7 +44,7 @@
     is_target_closed_error,
     rewrite_error,
 )
-from playwright._impl._glob import glob_to_regex
+from playwright._impl._glob import glob_to_regex_pattern
 from playwright._impl._greenlets import RouteGreenlet
 from playwright._impl._str_utils import escape_regex_flags
 
@@ -144,31 +144,103 @@ class FrameNavigatedEvent(TypedDict):
 
 
 def url_matches(
-    base_url: Optional[str], url_string: str, match: Optional[URLMatch]
+    base_url: Optional[str],
+    url_string: str,
+    match: Optional[URLMatch],
+    websocket_url: bool = None,
 ) -> bool:
     if not match:
         return True
-    if isinstance(match, str) and match[0] != "*":
-        # Allow http(s) baseURL to match ws(s) urls.
-        if (
-            base_url
-            and re.match(r"^https?://", base_url)
-            and re.match(r"^wss?://", url_string)
-        ):
-            base_url = re.sub(r"^http", "ws", base_url)
-        if base_url:
-            match = urljoin(base_url, match)
-        parsed = urlparse(match)
-        if parsed.path == "":
-            parsed = parsed._replace(path="/")
-            match = parsed.geturl()
     if isinstance(match, str):
-        match = glob_to_regex(match)
+        match = re.compile(
+            resolve_glob_to_regex_pattern(base_url, match, websocket_url)
+        )
     if isinstance(match, Pattern):
         return bool(match.search(url_string))
     return match(url_string)
 
 
+def resolve_glob_to_regex_pattern(
+    base_url: Optional[str], glob: str, websocket_url: bool = None
+) -> str:
+    if websocket_url:
+        base_url = to_websocket_base_url(base_url)
+    glob = resolve_glob_base(base_url, glob)
+    return glob_to_regex_pattern(glob)
+
+
+def to_websocket_base_url(base_url: Optional[str]) -> Optional[str]:
+    if base_url is not None and re.match(r"^https?://", base_url):
+        base_url = re.sub(r"^http", "ws", base_url)
+    return base_url
+
+
+def resolve_glob_base(base_url: Optional[str], match: str) -> str:
+    if match[0] == "*":
+        return match
+
+    token_map: Dict[str, str] = {}
+
+    def map_token(original: str, replacement: str) -> str:
+        if len(original) == 0:
+            return ""
+        token_map[replacement] = original
+        return replacement
+
+    # Escaped `\\?` behaves the same as `?` in our glob patterns.
+    match = match.replace(r"\\?", "?")
+    # Glob symbols may be escaped in the URL and some of them such as ? affect resolution,
+    # so we replace them with safe components first.
+    processed_parts = []
+    for index, token in enumerate(match.split("/")):
+        if token in (".", "..", ""):
+            processed_parts.append(token)
+            continue
+        # 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:"))
+            continue
+        question_index = token.find("?")
+        if question_index == -1:
+            processed_parts.append(map_token(token, f"$_{index}_$"))
+        else:
+            new_prefix = map_token(token[:question_index], f"$_{index}_$")
+            new_suffix = map_token(token[question_index:], f"?$_{index}_$")
+            processed_parts.append(new_prefix + new_suffix)
+
+    relative_path = "/".join(processed_parts)
+    resolved_url = urljoin(base_url if base_url is not None else "", relative_path)
+
+    for replacement, original in token_map.items():
+        resolved_url = resolved_url.replace(replacement, original, 1)
+
+    return ensure_trailing_slash(resolved_url)
+
+
+# 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
+
+
 class HarLookupResult(TypedDict, total=False):
     action: Literal["error", "redirect", "fulfill", "noentry"]
     message: Optional[str]
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 4b15531af..6492c4311 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -754,7 +754,7 @@ def prepare_interception_patterns(
         return patterns
 
     def matches(self, ws_url: str) -> bool:
-        return url_matches(self._base_url, ws_url, self.url)
+        return url_matches(self._base_url, ws_url, self.url, True)
 
     async def handle(self, websocket_route: "WebSocketRoute") -> None:
         coro_or_future = self.handler(websocket_route)
diff --git a/tests/async/test_page_route.py b/tests/async/test_page_route.py
index 017bdac9a..b04f96145 100644
--- a/tests/async/test_page_route.py
+++ b/tests/async/test_page_route.py
@@ -20,7 +20,8 @@
 
 import pytest
 
-from playwright._impl._glob import glob_to_regex
+from playwright._impl._glob import glob_to_regex_pattern
+from playwright._impl._helper import url_matches
 from playwright.async_api import (
     Browser,
     BrowserContext,
@@ -29,6 +30,7 @@
     Playwright,
     Request,
     Route,
+    expect,
 )
 from tests.server import Server, TestServerRequest
 from tests.utils import must
@@ -1051,17 +1053,19 @@ async def handle_request(route: Route) -> None:
     assert await response.json() == {"foo": "bar"}
 
 
-async def test_glob_to_regex() -> None:
+async def test_should_work_with_glob() -> None:
+    def glob_to_regex(pattern: str) -> re.Pattern:
+        return re.compile(glob_to_regex_pattern(pattern))
+
     assert glob_to_regex("**/*.js").match("https://localhost:8080/foo.js")
     assert not glob_to_regex("**/*.css").match("https://localhost:8080/foo.js")
-    assert not glob_to_regex("*.js").match("https://localhost:8080/foo.js")
+    assert not glob_to_regex("*.js").match(
+        "https://localhost:8080/foo.js"
+    )  # Doesn"t match path separator
     assert glob_to_regex("https://**/*.js").match("https://localhost:8080/foo.js")
     assert glob_to_regex("http://localhost:8080/simple/path.js").match(
         "http://localhost:8080/simple/path.js"
     )
-    assert glob_to_regex("http://localhost:8080/?imple/path.js").match(
-        "http://localhost:8080/Simple/path.js"
-    )
     assert glob_to_regex("**/{a,b}.js").match("https://localhost:8080/a.js")
     assert glob_to_regex("**/{a,b}.js").match("https://localhost:8080/b.js")
     assert not glob_to_regex("**/{a,b}.js").match("https://localhost:8080/c.js")
@@ -1081,15 +1085,119 @@ async def test_glob_to_regex() -> None:
         "http://localhost:3000/signin-oidcnice"
     )
 
-    assert glob_to_regex("**/three-columns/settings.html?**id=[a-z]**").match(
+    # 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(
+        "http://example.com/api/version"
+    )
+    assert not glob_to_regex("**/api/v[0-9]").fullmatch(
+        "http://example.com/api/v1"
+    )  # Should not match if [] is literal
+
+    # query params
+    assert glob_to_regex("**/api\\?param").match("http://example.com/api?param")
+    assert not glob_to_regex("**/api\\?param").match("http://example.com/api-param")
+
+    assert glob_to_regex("**/three-columns/settings.html\\?**id=settings-**").match(
         "http://mydomain:8080/blah/blah/three-columns/settings.html?id=settings-e3c58efe-02e9-44b0-97ac-dd138100cf7c&blah"
     )
 
-    assert glob_to_regex("\\?") == re.compile(r"^\?$")
-    assert glob_to_regex("\\") == re.compile(r"^\\$")
-    assert glob_to_regex("\\\\") == re.compile(r"^\\$")
-    assert glob_to_regex("\\[") == re.compile(r"^\[$")
-    assert glob_to_regex("[a-z]") == re.compile(r"^[a-z]$")
-    assert glob_to_regex("$^+.\\*()|\\?\\{\\}\\[\\]") == re.compile(
-        r"^\$\^\+\.\*\(\)\|\?\{\}\[\]$"
+    assert glob_to_regex("\\?").pattern == r"^\?$"
+    assert glob_to_regex("\\").pattern == r"^\\$"
+    assert glob_to_regex("\\\\").pattern == r"^\\$"
+    assert glob_to_regex("\\[").pattern == r"^\[$"
+    assert glob_to_regex("[a-z]").pattern == r"^\[a-z\]$"
+    assert (
+        glob_to_regex("$^+.\\*()|\\?\\{\\}\\[\\]").pattern
+        == r"^\$\^\+\.\*\(\)\|\?\{\}\[\]$"
+    )
+
+    # --- url_matches tests ---
+    # Basic exact and wildcard matching
+    assert url_matches(None, "http://playwright.dev/", "http://playwright.dev")
+    assert url_matches(None, "http://playwright.dev/?a=b", "http://playwright.dev?a=b")
+    assert url_matches(None, "http://playwright.dev/", "h*://playwright.dev")
+    assert url_matches(
+        None, "http://api.playwright.dev/?x=y", "http://*.playwright.dev?x=y"
+    )
+    assert url_matches(None, "http://playwright.dev/foo/bar", "**/foo/**")
+
+    # Relative path matching with base URL
+    assert url_matches("http://playwright.dev", "http://playwright.dev/?x=y", "?x=y")
+    assert url_matches(
+        "http://playwright.dev/foo/", "http://playwright.dev/foo/bar?x=y", "./bar?x=y"
+    )
+
+    # This is not supported, we treat ? as a query separator.
+    assert not url_matches(
+        None,
+        "http://localhost:8080/Simple/path.js",
+        "http://localhost:8080/?imple/path.js",
+    )
+    assert not url_matches(None, "http://playwright.dev/", "http://playwright.?ev")
+    assert url_matches(None, "http://playwright./?ev", "http://playwright.?ev")
+    assert not url_matches(
+        None, "http://playwright.dev/foo", "http://playwright.dev/f??"
+    )
+    assert url_matches(None, "http://playwright.dev/f??", "http://playwright.dev/f??")
+    assert url_matches(
+        None, "http://playwright.dev/?x=y", r"http://playwright.dev\?x=y"
+    )
+    assert url_matches(
+        None, "http://playwright.dev/?x=y", r"http://playwright.dev/\?x=y"
+    )
+    assert url_matches(
+        "http://playwright.dev/foo", "http://playwright.dev/foo?bar", "?bar"
+    )
+    assert url_matches(
+        "http://playwright.dev/foo", "http://playwright.dev/foo?bar", r"\\?bar"
+    )
+    assert url_matches("http://first.host/", "http://second.host/foo", "**/foo")
+    assert url_matches("http://playwright.dev/", "http://localhost/", "*//localhost/")
+
+    # Added for Python implementation
+    assert url_matches(
+        None,
+        "custom://example.com/foo/bar?id=123",
+        "{custom,another}://example.com/foo/bar?id=123",
+    )
+    assert not url_matches(
+        None, "custom://example.com/foo/bar?id=123", "**example.com/foo/bar?id=123"
     )
+
+
+async def test_should_not_support_question_in_glob_pattern(
+    page: Page, playwright: Playwright, server: Server
+) -> None:
+    server.set_route("/index", lambda req: (req.write(b"index-no-hello"), req.finish()))
+    server.set_route(
+        "/index123hello", lambda req: (req.write(b"index123hello"), req.finish())
+    )
+    server.set_route(
+        "/index?hello", lambda req: (req.write(b"index?hello"), req.finish())
+    )
+    server.set_route(
+        "/index1hello", lambda req: (req.write(b"index1hello"), req.finish())
+    )
+
+    async def handle_any_char(route: Route) -> None:
+        await route.fulfill(body="intercepted any character")
+
+    await page.route("**/index?hello", handle_any_char)
+
+    async def handle_question_mark(route: Route) -> None:
+        await route.fulfill(body="intercepted question mark")
+
+    await page.route(r"**/index\?hello", handle_question_mark)
+
+    await page.goto(server.PREFIX + "/index?hello")
+    await expect(page.locator("body")).to_have_text("intercepted question mark")
+
+    await page.goto(server.PREFIX + "/index")
+    await expect(page.locator("body")).to_have_text("index-no-hello")
+
+    await page.goto(server.PREFIX + "/index1hello")
+    await expect(page.locator("body")).to_have_text("index1hello")
+
+    await page.goto(server.PREFIX + "/index123hello")
+    await expect(page.locator("body")).to_have_text("index123hello")
diff --git a/tests/async/test_request_intercept.py b/tests/async/test_request_intercept.py
index 316e0b102..75746bbca 100644
--- a/tests/async/test_request_intercept.py
+++ b/tests/async/test_request_intercept.py
@@ -175,3 +175,17 @@ async def test_should_give_access_to_the_intercepted_response_body(
         route.fulfill(response=response),
         eval_task,
     )
+
+
+async def test_should_intercept_by_glob(page: Page, server: Server) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.route(
+        "http://localhos**?*oo",
+        lambda route: route.fulfill(body="intercepted", status=200),
+    )
+
+    result = await page.evaluate(
+        "url => fetch(url).then(r => r.text())", server.PREFIX + "/?foo"
+    )
+
+    assert result == "intercepted"
diff --git a/tests/sync/test_request_intercept.py b/tests/sync/test_request_intercept.py
index 8df41c0c2..a54c0ad71 100644
--- a/tests/sync/test_request_intercept.py
+++ b/tests/sync/test_request_intercept.py
@@ -131,3 +131,17 @@ def handle_route(route: Route) -> None:
     assert request.uri.decode() == "/title.html"
     original = (assetdir / "title.html").read_text()
     assert response.text() == original
+
+
+def test_should_intercept_by_glob(page: Page, server: Server) -> None:
+    page.goto(server.EMPTY_PAGE)
+    page.route(
+        "http://localhos**?*oo",
+        lambda route: route.fulfill(body="intercepted", status=200),
+    )
+
+    result = page.evaluate(
+        "url => fetch(url).then(r => r.text())", server.PREFIX + "/?foo"
+    )
+
+    assert result == "intercepted"

From 02187b2c9140aeb14ff39a4d74cdde008cac2e30 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 30 Apr 2025 11:30:21 +0200
Subject: [PATCH 364/438] build(deps): bump greenlet from 3.1.1 to 3.2.1
 (#2832)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 850fc18c9..6c5b7b1c9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,6 @@
 # This file was autogenerated by uv via the following command:
 #    uv pip compile pyproject.toml -o requirements.txt
-greenlet==3.1.1
+greenlet==3.2.1
     # via playwright (pyproject.toml)
 pyee==13.0.0
     # via playwright (pyproject.toml)

From 6eda6337776954dfb32f22970414cab513fa0abe Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 30 Apr 2025 11:30:35 +0200
Subject: [PATCH 365/438] build(deps): bump pillow from 11.1.0 to 11.2.1
 (#2833)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index c7dac72c7..b11ba7896 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -4,7 +4,7 @@ build==1.2.2.post1
 flake8==7.2.0
 mypy==1.15.0
 objgraph==3.6.2
-Pillow==11.1.0
+Pillow==11.2.1
 pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==25.0.0

From ecd6af8e94be41fb9d880dd087d37221c27e32a4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 30 Apr 2025 11:30:52 +0200
Subject: [PATCH 366/438] build(deps): bump setuptools-scm from 8.2.0 to 8.3.1
 (#2831)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 3c90282a0..42278b93e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==78.1.0", "setuptools-scm==8.2.0", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==78.1.0", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 7f5db36853c225a9ea670dce94f73018b1f0a660 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 30 Apr 2025 12:52:01 +0200
Subject: [PATCH 367/438] build(deps): bump setuptools from 78.1.0 to 80.0.0
 (#2830)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 42278b93e..1b76f8759 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==78.1.0", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==80.0.1", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From fe886f72a316040faf69aa22c5caf899398293f6 Mon Sep 17 00:00:00 2001
From: Eli Black <eliblack3@hotmail.com>
Date: Wed, 30 Apr 2025 20:55:56 +0800
Subject: [PATCH 368/438] chore(perf): don't request inspect context when
 inspecting stack (#2835)

---
 playwright/_impl/_connection.py | 16 ++++++++--------
 tests/async/test_asyncio.py     | 12 ++++++++++++
 tests/sync/test_sync.py         | 12 ++++++++++++
 3 files changed, 32 insertions(+), 8 deletions(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 027daf69d..2d1dad933 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -362,12 +362,7 @@ def _send_message_to_server(
             "params": self._replace_channels_with_guids(params),
             "metadata": metadata,
         }
-        if (
-            self._tracing_count > 0
-            and frames
-            and frames
-            and object._guid != "localUtils"
-        ):
+        if self._tracing_count > 0 and frames and object._guid != "localUtils":
             self.local_utils.add_stack_to_tracing_no_reply(id, frames)
 
         self._transport.send(message)
@@ -519,7 +514,10 @@ async def wrap_api_call(
         if self._api_zone.get():
             return await cb()
         task = asyncio.current_task(self._loop)
-        st: List[inspect.FrameInfo] = getattr(task, "__pw_stack__", inspect.stack())
+        st: List[inspect.FrameInfo] = getattr(
+            task, "__pw_stack__", None
+        ) or inspect.stack(0)
+
         parsed_st = _extract_stack_trace_information_from_stack(st, is_internal)
         self._api_zone.set(parsed_st)
         try:
@@ -535,7 +533,9 @@ def wrap_api_call_sync(
         if self._api_zone.get():
             return cb()
         task = asyncio.current_task(self._loop)
-        st: List[inspect.FrameInfo] = getattr(task, "__pw_stack__", inspect.stack())
+        st: List[inspect.FrameInfo] = getattr(
+            task, "__pw_stack__", None
+        ) or inspect.stack(0)
         parsed_st = _extract_stack_trace_information_from_stack(st, is_internal)
         self._api_zone.set(parsed_st)
         try:
diff --git a/tests/async/test_asyncio.py b/tests/async/test_asyncio.py
index 33edc71ce..971c65473 100644
--- a/tests/async/test_asyncio.py
+++ b/tests/async/test_asyncio.py
@@ -87,3 +87,15 @@ async def raise_exception() -> None:
     assert "Something went wrong" in str(exc_info.value.exceptions[0])
     assert isinstance(exc_info.value.exceptions[0], ValueError)
     assert await page.evaluate("() => 11 * 11") == 121
+
+
+async def test_should_return_proper_api_name_on_error(page: Page) -> None:
+    try:
+        await page.evaluate("does_not_exist")
+
+        assert (
+            False
+        ), "Accessing undefined JavaScript variable should have thrown exception"
+    except Exception as error:
+        # Each browser returns slightly different error messages, but they should all start with "Page.evaluate:", because that was the Playwright method where the error originated
+        assert str(error).startswith("Page.evaluate:")
diff --git a/tests/sync/test_sync.py b/tests/sync/test_sync.py
index 64eace1e9..92d40c19a 100644
--- a/tests/sync/test_sync.py
+++ b/tests/sync/test_sync.py
@@ -346,3 +346,15 @@ def test_call_sync_method_after_playwright_close_with_own_loop(
     p.start()
     p.join()
     assert p.exitcode == 0
+
+
+def test_should_return_proper_api_name_on_error(page: Page) -> None:
+    try:
+        page.evaluate("does_not_exist")
+
+        assert (
+            False
+        ), "Accessing undefined JavaScript variable should have thrown exception"
+    except Exception as error:
+        # Each browser returns slightly different error messages, but they should all start with "Page.evaluate:", because that was the Playwright method where the error originated
+        assert str(error).startswith("Page.evaluate:")

From e6c5ba4fe2342e73ec85f2cdf8ef80681bbdcc01 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 1 May 2025 19:22:12 +0200
Subject: [PATCH 369/438] devops: add linux-arm64 Docker tests (#2837)

---
 .github/workflows/test_docker.yml            | 11 +++++---
 .github/workflows/trigger_internal_tests.yml | 27 --------------------
 2 files changed, 8 insertions(+), 30 deletions(-)
 delete mode 100644 .github/workflows/trigger_internal_tests.yml

diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index 7f0ca3088..c1f2be3de 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -19,13 +19,16 @@ on:
 jobs:
   build:
     timeout-minutes: 120
-    runs-on: ubuntu-24.04
+    runs-on: ${{ matrix.runs-on }}
     strategy:
       fail-fast: false
       matrix:
         docker-image-variant:
           - jammy
           - noble
+        runs-on:
+          - ubuntu-24.04
+          - ubuntu-24.04-arm
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python
@@ -39,10 +42,12 @@ jobs:
         pip install -r requirements.txt
         pip install -e .
     - name: Build Docker image
-      run: bash utils/docker/build.sh --amd64 ${{ matrix.docker-image-variant }} playwright-python:localbuild-${{ matrix.docker-image-variant }}
+      run: |
+        ARCH="${{ matrix.runs-on == 'ubuntu-24.04-arm' && 'arm64' || 'amd64' }}"
+        bash utils/docker/build.sh --$ARCH ${{ matrix.docker-image-variant }} playwright-python:localbuild-${{ matrix.docker-image-variant }}
     - name: Test
       run: |
-        CONTAINER_ID="$(docker run --rm -v $(pwd):/root/playwright --name playwright-docker-test --workdir /root/playwright/ -d -t playwright-python:localbuild-${{ matrix.docker-image-variant }} /bin/bash)"
+        CONTAINER_ID="$(docker run --rm -e CI -v $(pwd):/root/playwright --name playwright-docker-test --workdir /root/playwright/ -d -t playwright-python:localbuild-${{ matrix.docker-image-variant }} /bin/bash)"
         # Fix permissions for Git inside the container
         docker exec "${CONTAINER_ID}" chown -R root:root /root/playwright
         docker exec "${CONTAINER_ID}" pip install -r local-requirements.txt
diff --git a/.github/workflows/trigger_internal_tests.yml b/.github/workflows/trigger_internal_tests.yml
deleted file mode 100644
index 2bbdeb565..000000000
--- a/.github/workflows/trigger_internal_tests.yml
+++ /dev/null
@@ -1,27 +0,0 @@
-name: "Internal Tests"
-
-on:
-  push:
-    branches:
-      - main
-      - release-*
-
-jobs:
-  trigger:
-    name: "trigger"
-    runs-on: ubuntu-24.04
-    steps:
-    - uses: actions/create-github-app-token@v2
-      id: app-token
-      with:
-        app-id: ${{ vars.PLAYWRIGHT_APP_ID }}
-        private-key: ${{ secrets.PLAYWRIGHT_PRIVATE_KEY }}
-        repositories: playwright-browsers
-    - run: |
-        curl -X POST --fail \
-          -H "Accept: application/vnd.github.v3+json" \
-          -H "Authorization: token ${GH_TOKEN}" \
-          --data "{\"event_type\": \"playwright_tests_python\", \"client_payload\": {\"ref\": \"${GITHUB_SHA}\"}}" \
-          https://api.github.com/repos/microsoft/playwright-browsers/dispatches
-      env:
-        GH_TOKEN: ${{ steps.app-token.outputs.token }}

From 85a57cdf54c7c843d27256980cf2f3a9ad4d5bc4 Mon Sep 17 00:00:00 2001
From: Eli Black <eliblack3@hotmail.com>
Date: Fri, 2 May 2025 23:34:32 +0800
Subject: [PATCH 370/438] chore: use tmp file when downloading driver (#2838)

---
 setup.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index ed46af1aa..abe2fd6e2 100644
--- a/setup.py
+++ b/setup.py
@@ -99,7 +99,8 @@ def extractall(zip: zipfile.ZipFile, path: str) -> None:
 
 def download_driver(zip_name: str) -> None:
     zip_file = f"playwright-{driver_version}-{zip_name}.zip"
-    if os.path.exists("driver/" + zip_file):
+    destination_path = "driver/" + zip_file
+    if os.path.exists(destination_path):
         return
     url = "https://playwright.azureedge.net/builds/driver/"
     if (
@@ -109,9 +110,11 @@ def download_driver(zip_name: str) -> None:
     ):
         url = url + "next/"
     url = url + zip_file
+    temp_destination_path = destination_path + ".tmp"
     print(f"Fetching {url}")
     # Don't replace this with urllib - Python won't have certificates to do SSL on all platforms.
-    subprocess.check_call(["curl", url, "-o", "driver/" + zip_file])
+    subprocess.check_call(["curl", url, "-o", temp_destination_path])
+    os.rename(temp_destination_path, destination_path)
 
 
 class PlaywrightBDistWheelCommand(BDistWheelCommand):

From 9ab4db2df90af654b4762c3c37ddc73f70e62a61 Mon Sep 17 00:00:00 2001
From: Eli Black <eliblack3@hotmail.com>
Date: Sun, 4 May 2025 12:19:28 +0800
Subject: [PATCH 371/438] chore: fix type warnings on windows (#2840)

---
 playwright/_impl/_browser_type.py |  2 +-
 tests/common/test_signals.py      | 12 ++++++++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index b34d224d6..bedc5ea73 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -171,7 +171,7 @@ def _user_data_dir(self, userDataDir: Optional[Union[str, Path]]) -> str:
             # Can be dropped once we drop Python 3.9 support (10/2025):
             # https://github.com/python/cpython/issues/82852
             if sys.platform == "win32" and sys.version_info[:2] < (3, 10):
-                return pathlib.Path.cwd() / userDataDir
+                return str(pathlib.Path.cwd() / userDataDir)
             return str(Path(userDataDir).resolve())
         return str(Path(userDataDir))
 
diff --git a/tests/common/test_signals.py b/tests/common/test_signals.py
index 472e74042..174eaf6f2 100644
--- a/tests/common/test_signals.py
+++ b/tests/common/test_signals.py
@@ -27,6 +27,10 @@
 def _test_signals_async(
     browser_name: str, launch_arguments: Dict, wait_queue: "multiprocessing.Queue[str]"
 ) -> None:
+    # On Windows, hint to mypy and pyright that they shouldn't check this function
+    if sys.platform == "win32":
+        return
+
     os.setpgrp()
     sigint_received = False
 
@@ -67,6 +71,10 @@ async def main() -> None:
 def _test_signals_sync(
     browser_name: str, launch_arguments: Dict, wait_queue: "multiprocessing.Queue[str]"
 ) -> None:
+    # On Windows, hint to mypy and pyright that they shouldn't check this function
+    if sys.platform == "win32":
+        return
+
     os.setpgrp()
     sigint_received = False
 
@@ -103,6 +111,10 @@ def my_sig_handler(signum: int, frame: Any) -> None:
 def _create_signals_test(
     target: Any, browser_name: str, launch_arguments: Dict
 ) -> None:
+    # On Windows, hint to mypy and pyright that they shouldn't check this function
+    if sys.platform == "win32":
+        return
+
     wait_queue: "multiprocessing.Queue[str]" = multiprocessing.Queue()
     process = multiprocessing.Process(
         target=target, args=[browser_name, launch_arguments, wait_queue]

From 2ca8764621f4a68a9fab0875ee8513f03c708094 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 9 May 2025 13:46:12 +0200
Subject: [PATCH 372/438] build(deps): bump setuptools from 80.0.1 to 80.3.1
 (#2843)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 1b76f8759..2dc0a7133 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==80.0.1", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==80.3.1", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 871149c7532a495f8bd6c2648c45f42a4e1e980d Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Mon, 12 May 2025 16:02:04 +0200
Subject: [PATCH 373/438] test: unflake test_context_cookies_should_work test
 in Edge (#2847)

---
 tests/async/test_defaultbrowsercontext.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/async/test_defaultbrowsercontext.py b/tests/async/test_defaultbrowsercontext.py
index 60f8d83fd..cc42a9c33 100644
--- a/tests/async/test_defaultbrowsercontext.py
+++ b/tests/async/test_defaultbrowsercontext.py
@@ -78,7 +78,7 @@ async def test_context_cookies_should_work(
     )
 
     assert document_cookie == "username=John Doe"
-    assert await page.context.cookies() == [
+    assert _filter_cookies(await page.context.cookies()) == [
         {
             "name": "username",
             "value": "John Doe",

From 55b28001dff23c148c68c9f8d9fdc68326a52c4a Mon Sep 17 00:00:00 2001
From: Eli Black <eliblack3@hotmail.com>
Date: Tue, 13 May 2025 01:55:03 +0800
Subject: [PATCH 374/438] chore: more stack-related performance improvements
 (#2844)

---
 playwright/_impl/_connection.py | 6 ++----
 playwright/_impl/_network.py    | 2 +-
 playwright/_impl/_path_utils.py | 6 ++++--
 playwright/_impl/_sync_base.py  | 4 ++--
 4 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 2d1dad933..1328e7c97 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -333,7 +333,7 @@ def _send_message_to_server(
         task = asyncio.current_task(self._loop)
         callback.stack_trace = cast(
             traceback.StackSummary,
-            getattr(task, "__pw_stack_trace__", traceback.extract_stack()),
+            getattr(task, "__pw_stack_trace__", traceback.extract_stack(limit=10)),
         )
         callback.no_reply = no_reply
         self._callbacks[id] = callback
@@ -387,9 +387,7 @@ def dispatch(self, msg: ParsedMessagePayload) -> None:
                 parsed_error = parse_error(
                     error["error"], format_call_log(msg.get("log"))  # type: ignore
                 )
-                parsed_error._stack = "".join(
-                    traceback.format_list(callback.stack_trace)[-10:]
-                )
+                parsed_error._stack = "".join(callback.stack_trace.format())
                 callback.future.set_exception(parsed_error)
             else:
                 result = self._replace_guids_with_channels(msg.get("result"))
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 6492c4311..768c22f0c 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -530,7 +530,7 @@ async def _race_with_page_close(self, future: Coroutine) -> None:
         setattr(
             fut,
             "__pw_stack__",
-            getattr(asyncio.current_task(self._loop), "__pw_stack__", inspect.stack()),
+            getattr(asyncio.current_task(self._loop), "__pw_stack__", inspect.stack(0)),
         )
         target_closed_future = self.request._target_closed_future()
         await asyncio.wait(
diff --git a/playwright/_impl/_path_utils.py b/playwright/_impl/_path_utils.py
index 267a82ab0..b405a0675 100644
--- a/playwright/_impl/_path_utils.py
+++ b/playwright/_impl/_path_utils.py
@@ -14,12 +14,14 @@
 
 import inspect
 from pathlib import Path
+from types import FrameType
+from typing import cast
 
 
 def get_file_dirname() -> Path:
     """Returns the callee (`__file__`) directory name"""
-    frame = inspect.stack()[1]
-    module = inspect.getmodule(frame[0])
+    frame = cast(FrameType, inspect.currentframe()).f_back
+    module = inspect.getmodule(frame)
     assert module
     assert module.__file__
     return Path(module.__file__).parent.absolute()
diff --git a/playwright/_impl/_sync_base.py b/playwright/_impl/_sync_base.py
index b50c7479d..e6fac9750 100644
--- a/playwright/_impl/_sync_base.py
+++ b/playwright/_impl/_sync_base.py
@@ -105,8 +105,8 @@ def _sync(
 
         g_self = greenlet.getcurrent()
         task: asyncio.tasks.Task[Any] = self._loop.create_task(coro)
-        setattr(task, "__pw_stack__", inspect.stack())
-        setattr(task, "__pw_stack_trace__", traceback.extract_stack())
+        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():

From 919701b6628048400ec9c612a6f19a90e8b601bb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 14 May 2025 10:25:07 +0200
Subject: [PATCH 375/438] build(deps): bump pytest-rerunfailures from 15.0 to
 15.1 (#2851)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index b11ba7896..b3ed62a96 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -12,7 +12,7 @@ pytest==8.3.5
 pytest-asyncio==0.26.0
 pytest-cov==6.1.1
 pytest-repeat==0.9.4
-pytest-rerunfailures==15.0
+pytest-rerunfailures==15.1
 pytest-timeout==2.3.1
 pytest-xdist==3.6.1
 requests==2.32.3

From fc0081acbf004106b504efecd95782f50ea9a029 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 14 May 2025 10:25:52 +0200
Subject: [PATCH 376/438] build(deps): bump setuptools from 80.3.1 to 80.4.0
 (#2849)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 2dc0a7133..cad4d18e5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==80.3.1", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==80.4.0", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From bd4fa2a25c79d77857b9e37172311196a54d0c04 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 14 May 2025 10:25:57 +0200
Subject: [PATCH 377/438] build(deps): bump greenlet from 3.2.1 to 3.2.2
 (#2848)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 6c5b7b1c9..28863d0dd 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,6 @@
 # This file was autogenerated by uv via the following command:
 #    uv pip compile pyproject.toml -o requirements.txt
-greenlet==3.2.1
+greenlet==3.2.2
     # via playwright (pyproject.toml)
 pyee==13.0.0
     # via playwright (pyproject.toml)

From 1a6ab165c5e0e7d936f6ddb8ec161d4273d6ce80 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 14 May 2025 12:59:02 +0200
Subject: [PATCH 378/438] build(deps): bump pytest-timeout from 2.3.1 to 2.4.0
 (#2850)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index b3ed62a96..bb834e828 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -13,7 +13,7 @@ pytest-asyncio==0.26.0
 pytest-cov==6.1.1
 pytest-repeat==0.9.4
 pytest-rerunfailures==15.1
-pytest-timeout==2.3.1
+pytest-timeout==2.4.0
 pytest-xdist==3.6.1
 requests==2.32.3
 service_identity==24.2.0

From 05a45601e9917618ba22f75d0395e9695d98a12a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 20 May 2025 11:48:27 -0700
Subject: [PATCH 379/438] build(deps): bump pyopenssl from 25.0.0 to 25.1.0
 (#2862)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index bb834e828..6d6bcd552 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -7,7 +7,7 @@ objgraph==3.6.2
 Pillow==11.2.1
 pixelmatch==0.3.0
 pre-commit==3.5.0
-pyOpenSSL==25.0.0
+pyOpenSSL==25.1.0
 pytest==8.3.5
 pytest-asyncio==0.26.0
 pytest-cov==6.1.1

From fc0e73de37c53036c429e432deed15606bda88ef Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 20 May 2025 11:48:41 -0700
Subject: [PATCH 380/438] build(deps): bump types-requests from 2.32.0.20250328
 to 2.32.0.20250515 (#2861)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 6d6bcd552..2fc05a12c 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,4 +19,4 @@ requests==2.32.3
 service_identity==24.2.0
 twisted==24.11.0
 types-pyOpenSSL==24.1.0.20240722
-types-requests==2.32.0.20250328
+types-requests==2.32.0.20250515

From a2f9320a0c7173d336c272a8f45e4c51ebd535eb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 20 May 2025 11:48:55 -0700
Subject: [PATCH 381/438] build(deps): bump setuptools from 80.4.0 to 80.7.1
 (#2860)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index cad4d18e5..0b26f3944 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==80.4.0", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==80.7.1", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From 3222ef88122b8157c0510c3e51102e3cd6942f71 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 26 May 2025 12:10:30 -0700
Subject: [PATCH 382/438] build(deps): bump setuptools from 80.7.1 to 80.8.0
 (#2866)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 0b26f3944..7d72d4778 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==80.7.1", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==80.8.0", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From b98dd6c0a733d9600888b664d9da320d75a00d0c Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 27 May 2025 11:11:27 -0700
Subject: [PATCH 383/438] chore: bump pytest-asyncio to v1.0.0 (#2868)

---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 2fc05a12c..2e8ddd874 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,7 +9,7 @@ pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==25.1.0
 pytest==8.3.5
-pytest-asyncio==0.26.0
+pytest-asyncio==1.0.0
 pytest-cov==6.1.1
 pytest-repeat==0.9.4
 pytest-rerunfailures==15.1

From 398b0bc08a9ac72fdfe24a4eff60dddb9322956b Mon Sep 17 00:00:00 2001
From: campersau <buchholz.bastian@googlemail.com>
Date: Fri, 30 May 2025 17:13:49 +0200
Subject: [PATCH 384/438] fix(docker): set default shell encoding
 (#2871)

---
 utils/docker/Dockerfile.jammy | 3 +++
 utils/docker/Dockerfile.noble | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/utils/docker/Dockerfile.jammy b/utils/docker/Dockerfile.jammy
index 8dab1e1d1..7692ad7c5 100644
--- a/utils/docker/Dockerfile.jammy
+++ b/utils/docker/Dockerfile.jammy
@@ -4,6 +4,9 @@ ARG DEBIAN_FRONTEND=noninteractive
 ARG TZ=America/Los_Angeles
 ARG DOCKER_IMAGE_NAME_TEMPLATE="mcr.microsoft.com/playwright/python:v%version%-jammy"
 
+ENV LANG=C.UTF-8
+ENV LC_ALL=C.UTF-8
+
 # === INSTALL Python ===
 
 RUN apt-get update && \
diff --git a/utils/docker/Dockerfile.noble b/utils/docker/Dockerfile.noble
index 8262bf6a9..2458236a3 100644
--- a/utils/docker/Dockerfile.noble
+++ b/utils/docker/Dockerfile.noble
@@ -4,6 +4,9 @@ ARG DEBIAN_FRONTEND=noninteractive
 ARG TZ=America/Los_Angeles
 ARG DOCKER_IMAGE_NAME_TEMPLATE="mcr.microsoft.com/playwright/python:v%version%-noble"
 
+ENV LANG=C.UTF-8
+ENV LC_ALL=C.UTF-8
+
 # === INSTALL Python ===
 
 RUN apt-get update && \

From 3909baf88efa1830ab8a47ab64124e71558cf691 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 3 Jun 2025 08:40:08 +0100
Subject: [PATCH 385/438] build(deps): bump mypy from 1.15.0 to 1.16.0 (#2874)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 2e8ddd874..5183c951e 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -2,7 +2,7 @@ autobahn==23.1.2
 black==25.1.0
 build==1.2.2.post1
 flake8==7.2.0
-mypy==1.15.0
+mypy==1.16.0
 objgraph==3.6.2
 Pillow==11.2.1
 pixelmatch==0.3.0

From 3d964961e9abddd980339bbf6ace7ff0aa34a0e8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 3 Jun 2025 08:40:22 +0100
Subject: [PATCH 386/438] build(deps): bump setuptools from 80.8.0 to 80.9.0
 (#2873)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 7d72d4778..1ff674eab 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools==80.8.0", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
+requires = ["setuptools==80.9.0", "setuptools-scm==8.3.1", "wheel==0.45.1", "auditwheel==6.2.0"]
 build-backend = "setuptools.build_meta"
 
 [project]

From e3270574c697118a148ecad7eae7e15beb6b8255 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 3 Jun 2025 08:40:56 +0100
Subject: [PATCH 387/438] build(deps): bump pytest from 8.3.5 to 8.4.0 (#2872)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 5183c951e..ab142cd16 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -8,7 +8,7 @@ Pillow==11.2.1
 pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==25.1.0
-pytest==8.3.5
+pytest==8.4.0
 pytest-asyncio==1.0.0
 pytest-cov==6.1.1
 pytest-repeat==0.9.4

From e87e340fae92cb52f98dacdd80bb55c04e9bc4e3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 4 Jun 2025 08:53:38 +0100
Subject: [PATCH 388/438] build(deps): bump types-requests from 2.32.0.20250515
 to 2.32.0.20250602 (#2875)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index ab142cd16..56b7edd22 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,4 +19,4 @@ requests==2.32.3
 service_identity==24.2.0
 twisted==24.11.0
 types-pyOpenSSL==24.1.0.20240722
-types-requests==2.32.0.20250515
+types-requests==2.32.0.20250602

From 54765828e1fd58a21052674e6945cbc1f03858b3 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 10 Jun 2025 16:52:54 +0200
Subject: [PATCH 389/438] test: use tmp_path instead of tmpdir fixture (#2884)

---
 .../test_browsercontext_storage_state.py      |  4 +-
 tests/async/test_browsertype_connect.py       |  4 +-
 tests/async/test_chromium_tracing.py          | 22 ++---
 tests/async/test_defaultbrowsercontext.py     | 14 ++--
 tests/async/test_download.py                  | 34 ++++----
 tests/async/test_fetch_global.py              |  4 +-
 tests/async/test_har.py                       | 80 +++++++++----------
 tests/async/test_headful.py                   |  8 +-
 tests/async/test_launcher.py                  |  4 +-
 tests/async/test_page_base_url.py             |  4 +-
 tests/async/test_pdf.py                       | 10 +--
 tests/async/test_tracing.py                   | 34 ++++----
 tests/async/test_video.py                     | 28 +++----
 .../sync/test_browsercontext_storage_state.py |  4 +-
 tests/sync/test_fetch_global.py               |  4 +-
 tests/sync/test_har.py                        | 78 +++++++++---------
 tests/sync/test_launcher.py                   |  4 +-
 tests/sync/test_pdf.py                        |  4 +-
 tests/sync/test_tracing.py                    | 34 ++++----
 tests/sync/test_video.py                      | 36 ++++-----
 20 files changed, 210 insertions(+), 204 deletions(-)

diff --git a/tests/async/test_browsercontext_storage_state.py b/tests/async/test_browsercontext_storage_state.py
index a7e853391..5004844ff 100644
--- a/tests/async/test_browsercontext_storage_state.py
+++ b/tests/async/test_browsercontext_storage_state.py
@@ -97,7 +97,7 @@ async def test_should_set_local_storage(browser: Browser) -> None:
 
 
 async def test_should_round_trip_through_the_file(
-    browser: Browser, context: BrowserContext, tmpdir: Path
+    browser: Browser, context: BrowserContext, tmp_path: Path
 ) -> None:
     page1 = await context.new_page()
     await page1.route(
@@ -113,7 +113,7 @@ async def test_should_round_trip_through_the_file(
         }"""
     )
 
-    path = tmpdir / "storage-state.json"
+    path = tmp_path / "storage-state.json"
     state = await context.storage_state(path=path)
     with open(path, "r") as f:
         written = json.load(f)
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index c2d8471d9..8295a6960 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -208,12 +208,12 @@ def handle_download(request: TestServerRequest) -> None:
 async def test_prevent_getting_video_path(
     browser_type: BrowserType,
     launch_server: Callable[[], RemoteServer],
-    tmpdir: Path,
+    tmp_path: Path,
     server: Server,
 ) -> None:
     remote_server = launch_server()
     browser = await browser_type.connect(remote_server.ws_endpoint)
-    page = await browser.new_page(record_video_dir=tmpdir)
+    page = await browser.new_page(record_video_dir=tmp_path)
     await page.goto(server.PREFIX + "/grid.html")
     await browser.close()
     assert page.video
diff --git a/tests/async/test_chromium_tracing.py b/tests/async/test_chromium_tracing.py
index 4cbd77a21..23608e009 100644
--- a/tests/async/test_chromium_tracing.py
+++ b/tests/async/test_chromium_tracing.py
@@ -24,9 +24,9 @@
 
 @pytest.mark.only_browser("chromium")
 async def test_should_output_a_trace(
-    browser: Browser, page: Page, server: Server, tmpdir: Path
+    browser: Browser, page: Page, server: Server, tmp_path: Path
 ) -> None:
-    output_file = tmpdir / "trace.json"
+    output_file = tmp_path / "trace.json"
     await browser.start_tracing(page=page, screenshots=True, path=output_file)
     await page.goto(server.PREFIX + "/grid.html")
     await browser.stop_tracing()
@@ -35,9 +35,9 @@ async def test_should_output_a_trace(
 
 @pytest.mark.only_browser("chromium")
 async def test_should_create_directories_as_needed(
-    browser: Browser, page: Page, server: Server, tmpdir: Path
+    browser: Browser, page: Page, server: Server, tmp_path: Path
 ) -> None:
-    output_file = tmpdir / "these" / "are" / "directories" / "trace.json"
+    output_file = tmp_path / "these" / "are" / "directories" / "trace.json"
     await browser.start_tracing(page=page, screenshots=True, path=output_file)
     await page.goto(server.PREFIX + "/grid.html")
     await browser.stop_tracing()
@@ -46,9 +46,9 @@ async def test_should_create_directories_as_needed(
 
 @pytest.mark.only_browser("chromium")
 async def test_should_run_with_custom_categories_if_provided(
-    browser: Browser, page: Page, tmpdir: Path
+    browser: Browser, page: Page, tmp_path: Path
 ) -> None:
-    output_file = tmpdir / "trace.json"
+    output_file = tmp_path / "trace.json"
     await browser.start_tracing(
         page=page,
         screenshots=True,
@@ -66,11 +66,11 @@ async def test_should_run_with_custom_categories_if_provided(
 
 @pytest.mark.only_browser("chromium")
 async def test_should_throw_if_tracing_on_two_pages(
-    browser: Browser, page: Page, tmpdir: Path
+    browser: Browser, page: Page, tmp_path: Path
 ) -> None:
-    output_file_1 = tmpdir / "trace1.json"
+    output_file_1 = tmp_path / "trace1.json"
     await browser.start_tracing(page=page, screenshots=True, path=output_file_1)
-    output_file_2 = tmpdir / "trace2.json"
+    output_file_2 = tmp_path / "trace2.json"
     with pytest.raises(Exception):
         await browser.start_tracing(page=page, screenshots=True, path=output_file_2)
     await browser.stop_tracing()
@@ -78,9 +78,9 @@ async def test_should_throw_if_tracing_on_two_pages(
 
 @pytest.mark.only_browser("chromium")
 async def test_should_return_a_buffer(
-    browser: Browser, page: Page, server: Server, tmpdir: Path
+    browser: Browser, page: Page, server: Server, tmp_path: Path
 ) -> None:
-    output_file = tmpdir / "trace.json"
+    output_file = tmp_path / "trace.json"
     await browser.start_tracing(page=page, path=output_file, screenshots=True)
     await page.goto(server.PREFIX + "/grid.html")
     value = await browser.stop_tracing()
diff --git a/tests/async/test_defaultbrowsercontext.py b/tests/async/test_defaultbrowsercontext.py
index cc42a9c33..67de51702 100644
--- a/tests/async/test_defaultbrowsercontext.py
+++ b/tests/async/test_defaultbrowsercontext.py
@@ -45,7 +45,7 @@
 
 @pytest.fixture()
 async def launch_persistent(
-    tmpdir: Path, launch_arguments: Dict, browser_type: BrowserType
+    tmp_path: Path, launch_arguments: Dict, browser_type: BrowserType
 ) -> AsyncGenerator[Callable[..., Awaitable[Tuple[Page, BrowserContext]]], None]:
     context: Optional[BrowserContext] = None
 
@@ -54,7 +54,7 @@ async def _launch(**options: Any) -> Tuple[Page, BrowserContext]:
         if context:
             raise ValueError("can only launch one persistent context")
         context = await browser_type.launch_persistent_context(
-            str(tmpdir), **{**launch_arguments, **options}
+            str(tmp_path), **{**launch_arguments, **options}
         )
         assert context
         return (context.pages[0], context)
@@ -373,14 +373,14 @@ async def test_should_support_extra_http_headers_option(
 
 
 async def test_should_accept_user_data_dir(
-    tmpdir: Path,
+    tmp_path: Path,
     launch_persistent: "Callable[..., asyncio.Future[Tuple[Page, BrowserContext]]]",
 ) -> None:
     (page, context) = await launch_persistent()
     # Note: we need an open page to make sure its functional.
-    assert len(os.listdir(tmpdir)) > 0
+    assert len(os.listdir(tmp_path)) > 0
     await context.close()
-    assert len(os.listdir(tmpdir)) > 0
+    assert len(os.listdir(tmp_path)) > 0
 
 
 async def test_should_restore_state_from_userDataDir(
@@ -426,11 +426,11 @@ async def test_should_have_default_url_when_launching_browser(
 
 @pytest.mark.skip_browser("firefox")
 async def test_should_throw_if_page_argument_is_passed(
-    browser_type: BrowserType, server: Server, tmpdir: Path, launch_arguments: Dict
+    browser_type: BrowserType, server: Server, tmp_path: Path, launch_arguments: Dict
 ) -> None:
     options = {**launch_arguments, "args": [server.EMPTY_PAGE]}
     with pytest.raises(Error) as exc:
-        await browser_type.launch_persistent_context(tmpdir, **options)
+        await browser_type.launch_persistent_context(tmp_path, **options)
     assert "can not specify page" in exc.value.message
 
 
diff --git a/tests/async/test_download.py b/tests/async/test_download.py
index 082fcac26..6b0d6be1a 100644
--- a/tests/async/test_download.py
+++ b/tests/async/test_download.py
@@ -83,14 +83,14 @@ async def test_should_report_downloads_with_accept_downloads_true(
 
 
 async def test_should_save_to_user_specified_path(
-    tmpdir: Path, browser: Browser, server: Server
+    tmp_path: Path, browser: Browser, server: Server
 ) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
         await page.click("a")
     download = await download_info.value
-    user_path = tmpdir / "download.txt"
+    user_path = tmp_path / "download.txt"
     await download.save_as(user_path)
     assert user_path.exists()
     assert user_path.read_text("utf-8") == "Hello world"
@@ -98,14 +98,14 @@ async def test_should_save_to_user_specified_path(
 
 
 async def test_should_save_to_user_specified_path_without_updating_original_path(
-    tmpdir: Path, browser: Browser, server: Server
+    tmp_path: Path, browser: Browser, server: Server
 ) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
         await page.click("a")
     download = await download_info.value
-    user_path = tmpdir / "download.txt"
+    user_path = tmp_path / "download.txt"
     await download.save_as(user_path)
     assert user_path.exists()
     assert user_path.read_text("utf-8") == "Hello world"
@@ -117,19 +117,19 @@ async def test_should_save_to_user_specified_path_without_updating_original_path
 
 
 async def test_should_save_to_two_different_paths_with_multiple_save_as_calls(
-    tmpdir: Path, browser: Browser, server: Server
+    tmp_path: Path, browser: Browser, server: Server
 ) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
         await page.click("a")
     download = await download_info.value
-    user_path = tmpdir / "download.txt"
+    user_path = tmp_path / "download.txt"
     await download.save_as(user_path)
     assert user_path.exists()
     assert user_path.read_text("utf-8") == "Hello world"
 
-    anotheruser_path = tmpdir / "download (2).txt"
+    anotheruser_path = tmp_path / "download (2).txt"
     await download.save_as(anotheruser_path)
     assert anotheruser_path.exists()
     assert anotheruser_path.read_text("utf-8") == "Hello world"
@@ -137,32 +137,32 @@ async def test_should_save_to_two_different_paths_with_multiple_save_as_calls(
 
 
 async def test_should_save_to_overwritten_filepath(
-    tmpdir: Path, browser: Browser, server: Server
+    tmp_path: Path, browser: Browser, server: Server
 ) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
         await page.click("a")
     download = await download_info.value
-    user_path = tmpdir / "download.txt"
+    user_path = tmp_path / "download.txt"
     await download.save_as(user_path)
-    assert len(list(Path(tmpdir).glob("*.*"))) == 1
+    assert len(list(tmp_path.glob("*.*"))) == 1
     await download.save_as(user_path)
-    assert len(list(Path(tmpdir).glob("*.*"))) == 1
+    assert len(list(tmp_path.glob("*.*"))) == 1
     assert user_path.exists()
     assert user_path.read_text("utf-8") == "Hello world"
     await page.close()
 
 
 async def test_should_create_subdirectories_when_saving_to_non_existent_user_specified_path(
-    tmpdir: Path, browser: Browser, server: Server
+    tmp_path: Path, browser: Browser, server: Server
 ) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
         await page.click("a")
     download = await download_info.value
-    nested_path = tmpdir / "these" / "are" / "directories" / "download.txt"
+    nested_path = tmp_path / "these" / "are" / "directories" / "download.txt"
     await download.save_as(nested_path)
     assert nested_path.exists()
     assert nested_path.read_text("utf-8") == "Hello world"
@@ -170,14 +170,14 @@ async def test_should_create_subdirectories_when_saving_to_non_existent_user_spe
 
 
 async def test_should_error_when_saving_with_downloads_disabled(
-    tmpdir: Path, browser: Browser, server: Server
+    tmp_path: Path, browser: Browser, server: Server
 ) -> None:
     page = await browser.new_page(accept_downloads=False)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
         await page.click("a")
     download = await download_info.value
-    user_path = tmpdir / "download.txt"
+    user_path = tmp_path / "download.txt"
     with pytest.raises(Error) as exc:
         await download.save_as(user_path)
     assert (
@@ -192,14 +192,14 @@ async def test_should_error_when_saving_with_downloads_disabled(
 
 
 async def test_should_error_when_saving_after_deletion(
-    tmpdir: Path, browser: Browser, server: Server
+    tmp_path: Path, browser: Browser, server: Server
 ) -> None:
     page = await browser.new_page(accept_downloads=True)
     await page.set_content(f'<a href="{server.PREFIX}/download">download</a>')
     async with page.expect_download() as download_info:
         await page.click("a")
     download = await download_info.value
-    user_path = tmpdir / "download.txt"
+    user_path = tmp_path / "download.txt"
     await download.delete()
     with pytest.raises(Error) as exc:
         await download.save_as(user_path)
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index ae394755b..6b74208e2 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -289,7 +289,7 @@ async def test_should_return_empty_body(playwright: Playwright, server: Server)
 
 
 async def test_storage_state_should_round_trip_through_file(
-    playwright: Playwright, tmpdir: Path
+    playwright: Playwright, tmp_path: Path
 ) -> None:
     expected: StorageState = {
         "cookies": [
@@ -307,7 +307,7 @@ async def test_storage_state_should_round_trip_through_file(
         "origins": [],
     }
     request = await playwright.request.new_context(storage_state=expected)
-    path = tmpdir / "storage-state.json"
+    path = tmp_path / "storage-state.json"
     actual = await request.storage_state(path=path)
     assert actual == expected
 
diff --git a/tests/async/test_har.py b/tests/async/test_har.py
index b7875ea35..0ea5ee054 100644
--- a/tests/async/test_har.py
+++ b/tests/async/test_har.py
@@ -27,8 +27,8 @@
 from tests.utils import must
 
 
-async def test_should_work(browser: Browser, server: Server, tmpdir: Path) -> None:
-    path = os.path.join(tmpdir, "log.har")
+async def test_should_work(browser: Browser, server: Server, tmp_path: Path) -> None:
+    path = os.path.join(tmp_path, "log.har")
     context = await browser.new_context(record_har_path=path)
     page = await context.new_page()
     await page.goto(server.EMPTY_PAGE)
@@ -39,9 +39,9 @@ async def test_should_work(browser: Browser, server: Server, tmpdir: Path) -> No
 
 
 async def test_should_omit_content(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = await browser.new_context(
         record_har_path=path,
         record_har_content="omit",
@@ -59,9 +59,9 @@ async def test_should_omit_content(
 
 
 async def test_should_omit_content_legacy(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = await browser.new_context(
         record_har_path=path, record_har_omit_content=True
     )
@@ -78,9 +78,9 @@ async def test_should_omit_content_legacy(
 
 
 async def test_should_attach_content(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    path = os.path.join(tmpdir, "log.har.zip")
+    path = os.path.join(tmp_path, "log.har.zip")
     context = await browser.new_context(
         record_har_path=path,
         record_har_content="attach",
@@ -137,9 +137,9 @@ async def test_should_attach_content(
 
 
 async def test_should_not_omit_content(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = await browser.new_context(
         record_har_path=path, record_har_omit_content=False
     )
@@ -153,9 +153,9 @@ async def test_should_not_omit_content(
 
 
 async def test_should_include_content(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = await browser.new_context(record_har_path=path)
     page = await context.new_page()
     await page.goto(server.PREFIX + "/har.html")
@@ -171,9 +171,9 @@ async def test_should_include_content(
 
 
 async def test_should_default_to_full_mode(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = await browser.new_context(
         record_har_path=path,
     )
@@ -188,9 +188,9 @@ async def test_should_default_to_full_mode(
 
 
 async def test_should_support_minimal_mode(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = await browser.new_context(
         record_har_path=path,
         record_har_mode="minimal",
@@ -206,9 +206,9 @@ async def test_should_support_minimal_mode(
 
 
 async def test_should_filter_by_glob(
-    browser: Browser, server: Server, tmpdir: str
+    browser: Browser, server: Server, tmp_path: str
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = await browser.new_context(
         base_url=server.PREFIX,
         record_har_path=path,
@@ -227,9 +227,9 @@ async def test_should_filter_by_glob(
 
 
 async def test_should_filter_by_regexp(
-    browser: Browser, server: Server, tmpdir: str
+    browser: Browser, server: Server, tmp_path: str
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = await browser.new_context(
         base_url=server.PREFIX,
         record_har_path=path,
@@ -303,9 +303,9 @@ async def test_by_default_should_abort_requests_not_found_in_har(
 
 
 async def test_fallback_continue_should_continue_requests_on_bad_har(
-    context: BrowserContext, server: Server, tmpdir: Path
+    context: BrowserContext, server: Server, tmp_path: Path
 ) -> None:
-    path_to_invalid_har = tmpdir / "invalid.har"
+    path_to_invalid_har = tmp_path / "invalid.har"
     with path_to_invalid_har.open("w") as f:
         json.dump({"log": {}}, f)
     await context.route_from_har(har=path_to_invalid_har, not_found="fallback")
@@ -500,9 +500,9 @@ async def test_should_fulfill_from_har_with_content_in_a_file(
 
 
 async def test_should_round_trip_har_zip(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, assetdir: Path, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context_1 = await browser.new_context(
         record_har_mode="minimal", record_har_path=har_path
     )
@@ -521,7 +521,7 @@ async def test_should_round_trip_har_zip(
 
 
 async def test_should_round_trip_har_with_post_data(
-    browser: Browser, server: Server, assetdir: Path, tmpdir: Path
+    browser: Browser, server: Server, assetdir: Path, tmp_path: Path
 ) -> None:
     server.set_route("/echo", lambda req: (req.write(req.post_body), req.finish()))
     fetch_function = """
@@ -530,7 +530,7 @@ async def test_should_round_trip_har_with_post_data(
             return await response.text();
         };
     """
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context_1 = await browser.new_context(
         record_har_mode="minimal", record_har_path=har_path
     )
@@ -554,7 +554,7 @@ async def test_should_round_trip_har_with_post_data(
 
 
 async def test_should_disambiguate_by_header(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
     server.set_route(
         "/echo",
@@ -574,7 +574,7 @@ async def test_should_disambiguate_by_header(
             return await response.text();
         };
     """
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context_1 = await browser.new_context(
         record_har_mode="minimal", record_har_path=har_path
     )
@@ -597,9 +597,9 @@ async def test_should_disambiguate_by_header(
 
 
 async def test_should_produce_extracted_zip(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.har"
+    har_path = tmp_path / "har.har"
     context = await browser.new_context(
         record_har_mode="minimal", record_har_path=har_path, record_har_content="attach"
     )
@@ -624,9 +624,9 @@ async def test_should_produce_extracted_zip(
 
 
 async def test_should_update_har_zip_for_context(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context = await browser.new_context()
     await context.route_from_har(har_path, update=True)
     page_1 = await context.new_page()
@@ -684,9 +684,9 @@ async def test_context_unroute_call_should_stop_context_route_from_har(
 
 
 async def test_should_update_har_zip_for_page(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context = await browser.new_context()
     page_1 = await context.new_page()
     await page_1.route_from_har(har_path, update=True)
@@ -706,9 +706,9 @@ async def test_should_update_har_zip_for_page(
 
 
 async def test_should_update_har_zip_for_page_with_different_options(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context1 = await browser.new_context()
     page1 = await context1.new_page()
     await page1.route_from_har(
@@ -729,9 +729,9 @@ async def test_should_update_har_zip_for_page_with_different_options(
 
 
 async def test_should_update_extracted_har_zip_for_page(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.har"
+    har_path = tmp_path / "har.har"
     context = await browser.new_context()
     page_1 = await context.new_page()
     await page_1.route_from_har(har_path, update=True)
@@ -757,9 +757,9 @@ async def test_should_update_extracted_har_zip_for_page(
 async def test_should_ignore_aborted_requests(
     context_factory: Callable[[], Awaitable[BrowserContext]],
     server: Server,
-    tmpdir: Path,
+    tmp_path: Path,
 ) -> None:
-    path = tmpdir / "test.har"
+    path = tmp_path / "test.har"
     server.set_route("/x", lambda request: request.loseConnection())
     context1 = await context_factory()
     await context1.route_from_har(har=path, update=True)
diff --git a/tests/async/test_headful.py b/tests/async/test_headful.py
index 2e0dd026f..2b0b64c8e 100644
--- a/tests/async/test_headful.py
+++ b/tests/async/test_headful.py
@@ -23,10 +23,10 @@
 
 
 async def test_should_have_default_url_when_launching_browser(
-    browser_type: BrowserType, launch_arguments: Dict, tmpdir: Path
+    browser_type: BrowserType, launch_arguments: Dict, tmp_path: Path
 ) -> None:
     browser_context = await browser_type.launch_persistent_context(
-        tmpdir, **{**launch_arguments, "headless": False}
+        tmp_path, **{**launch_arguments, "headless": False}
     )
     urls = [page.url for page in browser_context.pages]
     assert urls == ["about:blank"]
@@ -34,10 +34,10 @@ async def test_should_have_default_url_when_launching_browser(
 
 
 async def test_should_close_browser_with_beforeunload_page(
-    browser_type: BrowserType, launch_arguments: Dict, server: Server, tmpdir: Path
+    browser_type: BrowserType, launch_arguments: Dict, server: Server, tmp_path: Path
 ) -> None:
     browser_context = await browser_type.launch_persistent_context(
-        tmpdir, **{**launch_arguments, "headless": False}
+        tmp_path, **{**launch_arguments, "headless": False}
     )
     page = await browser_context.new_page()
     await page.goto(server.PREFIX + "/beforeunload.html")
diff --git a/tests/async/test_launcher.py b/tests/async/test_launcher.py
index d29b20989..1b974725b 100644
--- a/tests/async/test_launcher.py
+++ b/tests/async/test_launcher.py
@@ -112,7 +112,7 @@ async def test_browser_close_should_be_callable_twice(
 @pytest.mark.only_browser("chromium")
 async def test_browser_launch_should_return_background_pages(
     browser_type: BrowserType,
-    tmpdir: Path,
+    tmp_path: Path,
     browser_channel: Optional[str],
     assetdir: Path,
     launch_arguments: Dict,
@@ -122,7 +122,7 @@ async def test_browser_launch_should_return_background_pages(
 
     extension_path = str(assetdir / "simple-extension")
     context = await browser_type.launch_persistent_context(
-        str(tmpdir),
+        str(tmp_path),
         **{
             **launch_arguments,
             "headless": False,
diff --git a/tests/async/test_page_base_url.py b/tests/async/test_page_base_url.py
index ab917b248..3f0599e01 100644
--- a/tests/async/test_page_base_url.py
+++ b/tests/async/test_page_base_url.py
@@ -38,10 +38,10 @@ async def test_should_construct_a_new_url_when_a_base_url_in_browser_new_page_is
 
 
 async def test_should_construct_a_new_url_when_a_base_url_in_browser_new_persistent_context_is_passed(
-    browser_type: BrowserType, tmpdir: Path, server: Server, launch_arguments: Dict
+    browser_type: BrowserType, tmp_path: Path, server: Server, launch_arguments: Dict
 ) -> None:
     context = await browser_type.launch_persistent_context(
-        tmpdir, **launch_arguments, base_url=server.PREFIX
+        tmp_path, **launch_arguments, base_url=server.PREFIX
     )
     page = await context.new_page()
     assert (must(await page.goto("/empty.html"))).url == server.EMPTY_PAGE
diff --git a/tests/async/test_pdf.py b/tests/async/test_pdf.py
index 7e916dc11..93d1fcf8a 100644
--- a/tests/async/test_pdf.py
+++ b/tests/async/test_pdf.py
@@ -23,8 +23,8 @@
 pytestmark = pytest.mark.only_browser("chromium")
 
 
-async def test_should_be_able_to_save_pdf_file(page: Page, tmpdir: Path) -> None:
-    output_file = tmpdir / "foo.png"
+async def test_should_be_able_to_save_pdf_file(page: Page, tmp_path: Path) -> None:
+    output_file = tmp_path / "foo.png"
     await page.pdf(path=str(output_file))
     assert os.path.getsize(output_file) > 0
 
@@ -35,11 +35,11 @@ async def test_should_be_able_capture_pdf_without_path(page: Page) -> None:
 
 
 async def test_should_be_able_to_generate_outline(
-    page: Page, server: Server, tmpdir: Path
+    page: Page, server: Server, tmp_path: Path
 ) -> None:
     await page.goto(server.PREFIX + "/headings.html")
-    output_file_no_outline = tmpdir / "outputNoOutline.pdf"
-    output_file_outline = tmpdir / "outputOutline.pdf"
+    output_file_no_outline = tmp_path / "outputNoOutline.pdf"
+    output_file_outline = tmp_path / "outputOutline.pdf"
     await page.pdf(path=output_file_no_outline)
     await page.pdf(path=output_file_outline, tagged=True, outline=True)
     assert os.path.getsize(output_file_outline) > os.path.getsize(
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index bb39f96f4..6b0c557f2 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -87,7 +87,7 @@ async def test_should_collect_sources(
 
 
 async def test_should_collect_trace_with_resources_but_no_js(
-    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+    context: BrowserContext, page: Page, server: Server, tmp_path: Path
 ) -> None:
     await context.tracing.start(screenshots=True, snapshots=True)
     await page.goto(server.PREFIX + "/frames/frame.html")
@@ -105,7 +105,7 @@ async def test_should_collect_trace_with_resources_but_no_js(
         server.PREFIX + "/one-style.html"
     )  # should not produce a route.continue_ entry since we continue all routes if no match.
     await page.close()
-    trace_file_path = tmpdir / "trace.zip"
+    trace_file_path = tmp_path / "trace.zip"
     await context.tracing.stop(path=trace_file_path)
 
     (_, events) = parse_trace(trace_file_path)
@@ -147,7 +147,7 @@ async def test_should_collect_trace_with_resources_but_no_js(
 
 
 async def test_should_correctly_determine_sync_apiname(
-    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+    context: BrowserContext, page: Page, server: Server, tmp_path: Path
 ) -> None:
     await context.tracing.start(screenshots=True, snapshots=True)
 
@@ -162,7 +162,7 @@ async def _handle_response(response: Response) -> None:
     await page.goto(server.PREFIX + "/grid.html")
     await received_response
     await page.close()
-    trace_file_path = tmpdir / "trace.zip"
+    trace_file_path = tmp_path / "trace.zip"
     await context.tracing.stop(path=trace_file_path)
 
     (_, events) = parse_trace(trace_file_path)
@@ -174,19 +174,19 @@ async def _handle_response(response: Response) -> None:
 
 
 async def test_should_collect_two_traces(
-    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+    context: BrowserContext, page: Page, server: Server, tmp_path: Path
 ) -> None:
     await context.tracing.start(screenshots=True, snapshots=True)
     await page.goto(server.EMPTY_PAGE)
     await page.set_content("<button>Click</button>")
     await page.click('"Click"')
-    tracing1_path = tmpdir / "trace1.zip"
+    tracing1_path = tmp_path / "trace1.zip"
     await context.tracing.stop(path=tracing1_path)
 
     await context.tracing.start(screenshots=True, snapshots=True)
     await page.dblclick('"Click"')
     await page.close()
-    tracing2_path = tmpdir / "trace2.zip"
+    tracing2_path = tmp_path / "trace2.zip"
     await context.tracing.stop(path=tracing2_path)
 
     (_, events) = parse_trace(tracing1_path)
@@ -209,7 +209,7 @@ async def test_should_not_throw_when_stopping_without_start_but_not_exporting(
 
 
 async def test_should_work_with_playwright_context_managers(
-    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+    context: BrowserContext, page: Page, server: Server, tmp_path: Path
 ) -> None:
     await context.tracing.start(screenshots=True, snapshots=True)
     await page.goto(server.EMPTY_PAGE)
@@ -221,7 +221,7 @@ async def test_should_work_with_playwright_context_managers(
 
     async with page.expect_popup():
         await page.evaluate("window._popup = window.open(document.location.href)")
-    trace_file_path = tmpdir / "trace.zip"
+    trace_file_path = tmp_path / "trace.zip"
     await context.tracing.stop(path=trace_file_path)
 
     (_, events) = parse_trace(trace_file_path)
@@ -238,7 +238,7 @@ async def test_should_work_with_playwright_context_managers(
 
 
 async def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
-    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+    context: BrowserContext, page: Page, server: Server, tmp_path: Path
 ) -> None:
     await context.tracing.start(screenshots=True, snapshots=True)
 
@@ -246,7 +246,7 @@ async def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
     await page.wait_for_load_state("load")
     await page.wait_for_load_state("load")
 
-    trace_file_path = tmpdir / "trace.zip"
+    trace_file_path = tmp_path / "trace.zip"
     await context.tracing.stop(path=trace_file_path)
 
     (_, events) = parse_trace(trace_file_path)
@@ -260,23 +260,23 @@ async def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
 async def test_should_respect_traces_dir_and_name(
     browser_type: BrowserType,
     server: Server,
-    tmpdir: Path,
+    tmp_path: Path,
     launch_arguments: Dict,
 ) -> None:
-    traces_dir = tmpdir / "traces"
+    traces_dir = tmp_path / "traces"
     browser = await browser_type.launch(traces_dir=traces_dir, **launch_arguments)
     context = await browser.new_context()
     page = await context.new_page()
 
     await context.tracing.start(name="name1", snapshots=True)
     await page.goto(server.PREFIX + "/one-style.html")
-    await context.tracing.stop_chunk(path=tmpdir / "trace1.zip")
+    await context.tracing.stop_chunk(path=tmp_path / "trace1.zip")
     assert (traces_dir / "name1.trace").exists()
     assert (traces_dir / "name1.network").exists()
 
     await context.tracing.start_chunk(name="name2")
     await page.goto(server.PREFIX + "/har.html")
-    await context.tracing.stop(path=tmpdir / "trace2.zip")
+    await context.tracing.stop(path=tmp_path / "trace2.zip")
     assert (traces_dir / "name2.trace").exists()
     assert (traces_dir / "name2.network").exists()
 
@@ -290,7 +290,7 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
             ]
         )
 
-    (resources, events) = parse_trace(tmpdir / "trace1.zip")
+    (resources, events) = parse_trace(tmp_path / "trace1.zip")
     assert get_trace_actions(events) == ["Page.goto"]
     assert resource_names(resources) == [
         "resources/XXX.css",
@@ -300,7 +300,7 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
         "trace.trace",
     ]
 
-    (resources, events) = parse_trace(tmpdir / "trace2.zip")
+    (resources, events) = parse_trace(tmp_path / "trace2.zip")
     assert get_trace_actions(events) == ["Page.goto"]
     assert resource_names(resources) == [
         "resources/XXX.css",
diff --git a/tests/async/test_video.py b/tests/async/test_video.py
index b0ab4c529..08d757794 100644
--- a/tests/async/test_video.py
+++ b/tests/async/test_video.py
@@ -21,37 +21,37 @@
 
 
 async def test_should_expose_video_path(
-    browser: Browser, tmpdir: Path, server: Server
+    browser: Browser, tmp_path: Path, server: Server
 ) -> None:
-    page = await browser.new_page(record_video_dir=tmpdir)
+    page = await browser.new_page(record_video_dir=tmp_path)
     await page.goto(server.PREFIX + "/grid.html")
     assert page.video
     path = await page.video.path()
-    assert str(tmpdir) in str(path)
+    assert str(tmp_path) in str(path)
     await page.context.close()
 
 
 async def test_short_video_should_throw(
-    browser: Browser, tmpdir: Path, server: Server
+    browser: Browser, tmp_path: Path, server: Server
 ) -> None:
-    page = await browser.new_page(record_video_dir=tmpdir)
+    page = await browser.new_page(record_video_dir=tmp_path)
     await page.goto(server.PREFIX + "/grid.html")
     assert page.video
     path = await page.video.path()
-    assert str(tmpdir) in str(path)
+    assert str(tmp_path) in str(path)
     await page.wait_for_timeout(1000)
     await page.context.close()
     assert os.path.exists(path)
 
 
 async def test_short_video_should_throw_persistent_context(
-    browser_type: BrowserType, tmpdir: Path, launch_arguments: Dict, server: Server
+    browser_type: BrowserType, tmp_path: Path, launch_arguments: Dict, server: Server
 ) -> None:
     context = await browser_type.launch_persistent_context(
-        str(tmpdir),
+        str(tmp_path),
         **launch_arguments,
         viewport={"width": 320, "height": 240},
-        record_video_dir=str(tmpdir) + "1",
+        record_video_dir=str(tmp_path) + "1",
     )
     page = context.pages[0]
     await page.goto(server.PREFIX + "/grid.html")
@@ -60,16 +60,16 @@ async def test_short_video_should_throw_persistent_context(
 
     assert page.video
     path = await page.video.path()
-    assert str(tmpdir) in str(path)
+    assert str(tmp_path) in str(path)
 
 
 async def test_should_not_error_if_page_not_closed_before_save_as(
-    browser: Browser, tmpdir: Path, server: Server
+    browser: Browser, tmp_path: Path, server: Server
 ) -> None:
-    page = await browser.new_page(record_video_dir=tmpdir)
+    page = await browser.new_page(record_video_dir=tmp_path)
     await page.goto(server.PREFIX + "/grid.html")
     await page.wait_for_timeout(1000)  # make sure video has some data
-    out_path = tmpdir / "some-video.webm"
+    out_path = tmp_path / "some-video.webm"
     assert page.video
     saved = page.video.save_as(out_path)
     await page.close()
@@ -79,7 +79,7 @@ async def test_should_not_error_if_page_not_closed_before_save_as(
 
 
 async def test_should_be_None_if_not_recording(
-    browser: Browser, tmpdir: Path, server: Server
+    browser: Browser, tmp_path: Path, server: Server
 ) -> None:
     page = await browser.new_page()
     assert page.video is None
diff --git a/tests/sync/test_browsercontext_storage_state.py b/tests/sync/test_browsercontext_storage_state.py
index f7db067d4..6850de8a1 100644
--- a/tests/sync/test_browsercontext_storage_state.py
+++ b/tests/sync/test_browsercontext_storage_state.py
@@ -93,7 +93,7 @@ def test_should_set_local_storage(browser: Browser) -> None:
 
 
 def test_should_round_trip_through_the_file(
-    browser: Browser, context: BrowserContext, tmpdir: Path
+    browser: Browser, context: BrowserContext, tmp_path: Path
 ) -> None:
     page1 = context.new_page()
     page1.route(
@@ -109,7 +109,7 @@ def test_should_round_trip_through_the_file(
         }"""
     )
 
-    path = tmpdir / "storage-state.json"
+    path = tmp_path / "storage-state.json"
     state = context.storage_state(path=path)
     with open(path, "r") as f:
         written = json.load(f)
diff --git a/tests/sync/test_fetch_global.py b/tests/sync/test_fetch_global.py
index 9efc6e93b..7305834a9 100644
--- a/tests/sync/test_fetch_global.py
+++ b/tests/sync/test_fetch_global.py
@@ -236,7 +236,7 @@ def test_should_return_empty_body(playwright: Playwright, server: Server) -> Non
 
 
 def test_storage_state_should_round_trip_through_file(
-    playwright: Playwright, tmpdir: Path
+    playwright: Playwright, tmp_path: Path
 ) -> None:
     expected: StorageState = {
         "cookies": [
@@ -254,7 +254,7 @@ def test_storage_state_should_round_trip_through_file(
         "origins": [],
     }
     request = playwright.request.new_context(storage_state=expected)
-    path = tmpdir / "storage-state.json"
+    path = tmp_path / "storage-state.json"
     actual = request.storage_state(path=path)
     assert actual == expected
 
diff --git a/tests/sync/test_har.py b/tests/sync/test_har.py
index 0644d3856..990b1d382 100644
--- a/tests/sync/test_har.py
+++ b/tests/sync/test_har.py
@@ -25,8 +25,8 @@
 from tests.server import Server
 
 
-def test_should_work(browser: Browser, server: Server, tmpdir: Path) -> None:
-    path = os.path.join(tmpdir, "log.har")
+def test_should_work(browser: Browser, server: Server, tmp_path: Path) -> None:
+    path = os.path.join(tmp_path, "log.har")
     context = browser.new_context(record_har_path=path)
     page = context.new_page()
     page.goto(server.EMPTY_PAGE)
@@ -36,8 +36,8 @@ def test_should_work(browser: Browser, server: Server, tmpdir: Path) -> None:
         assert "log" in data
 
 
-def test_should_omit_content(browser: Browser, server: Server, tmpdir: Path) -> None:
-    path = os.path.join(tmpdir, "log.har")
+def test_should_omit_content(browser: Browser, server: Server, tmp_path: Path) -> None:
+    path = os.path.join(tmp_path, "log.har")
     context = browser.new_context(record_har_path=path, record_har_content="omit")
     page = context.new_page()
     page.goto(server.PREFIX + "/har.html")
@@ -53,9 +53,9 @@ def test_should_omit_content(browser: Browser, server: Server, tmpdir: Path) ->
 
 
 def test_should_omit_content_legacy(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = browser.new_context(record_har_path=path, record_har_omit_content=True)
     page = context.new_page()
     page.goto(server.PREFIX + "/har.html")
@@ -70,8 +70,10 @@ def test_should_omit_content_legacy(
         assert "encoding" not in content1
 
 
-def test_should_attach_content(browser: Browser, server: Server, tmpdir: Path) -> None:
-    path = os.path.join(tmpdir, "log.har.zip")
+def test_should_attach_content(
+    browser: Browser, server: Server, tmp_path: Path
+) -> None:
+    path = os.path.join(tmp_path, "log.har.zip")
     context = browser.new_context(
         record_har_path=path,
         record_har_content="attach",
@@ -127,8 +129,10 @@ def test_should_attach_content(browser: Browser, server: Server, tmpdir: Path) -
                 assert len(f.read()) == entries[2]["response"]["content"]["size"]
 
 
-def test_should_include_content(browser: Browser, server: Server, tmpdir: Path) -> None:
-    path = os.path.join(tmpdir, "log.har")
+def test_should_include_content(
+    browser: Browser, server: Server, tmp_path: Path
+) -> None:
+    path = os.path.join(tmp_path, "log.har")
     context = browser.new_context(record_har_path=path)
     page = context.new_page()
     page.goto(server.PREFIX + "/har.html")
@@ -144,9 +148,9 @@ def test_should_include_content(browser: Browser, server: Server, tmpdir: Path)
 
 
 def test_should_default_to_full_mode(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = browser.new_context(
         record_har_path=path,
     )
@@ -161,9 +165,9 @@ def test_should_default_to_full_mode(
 
 
 def test_should_support_minimal_mode(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    path = os.path.join(tmpdir, "log.har")
+    path = os.path.join(tmp_path, "log.har")
     context = browser.new_context(
         record_har_path=path,
         record_har_mode="minimal",
@@ -178,8 +182,8 @@ def test_should_support_minimal_mode(
         assert log["entries"][0]["request"]["bodySize"] == -1
 
 
-def test_should_filter_by_glob(browser: Browser, server: Server, tmpdir: str) -> None:
-    path = os.path.join(tmpdir, "log.har")
+def test_should_filter_by_glob(browser: Browser, server: Server, tmp_path: str) -> None:
+    path = os.path.join(tmp_path, "log.har")
     context = browser.new_context(
         base_url=server.PREFIX,
         record_har_path=path,
@@ -197,8 +201,10 @@ def test_should_filter_by_glob(browser: Browser, server: Server, tmpdir: str) ->
         assert log["entries"][0]["request"]["url"].endswith("one-style.css")
 
 
-def test_should_filter_by_regexp(browser: Browser, server: Server, tmpdir: str) -> None:
-    path = os.path.join(tmpdir, "log.har")
+def test_should_filter_by_regexp(
+    browser: Browser, server: Server, tmp_path: str
+) -> None:
+    path = os.path.join(tmp_path, "log.har")
     context = browser.new_context(
         base_url=server.PREFIX,
         record_har_path=path,
@@ -270,9 +276,9 @@ def test_by_default_should_abort_requests_not_found_in_har(
 
 
 def test_fallback_continue_should_continue_requests_on_bad_har(
-    context: BrowserContext, server: Server, tmpdir: Path
+    context: BrowserContext, server: Server, tmp_path: Path
 ) -> None:
-    path_to_invalid_har = tmpdir / "invalid.har"
+    path_to_invalid_har = tmp_path / "invalid.har"
     with path_to_invalid_har.open("w") as f:
         json.dump({"log": {}}, f)
     context.route_from_har(har=path_to_invalid_har, not_found="fallback")
@@ -423,9 +429,9 @@ def test_should_fulfill_from_har_with_content_in_a_file(
 
 
 def test_should_round_trip_har_zip(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context_1 = browser.new_context(record_har_mode="minimal", record_har_path=har_path)
     page_1 = context_1.new_page()
     page_1.goto(server.PREFIX + "/one-style.html")
@@ -440,7 +446,7 @@ def test_should_round_trip_har_zip(
 
 
 def test_should_round_trip_har_with_post_data(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
     server.set_route(
         "/echo", lambda req: (req.write(cast(Any, req).post_body), req.finish())
@@ -451,7 +457,7 @@ def test_should_round_trip_har_with_post_data(
             return response.text();
         };
     """
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context_1 = browser.new_context(record_har_mode="minimal", record_har_path=har_path)
     page_1 = context_1.new_page()
     page_1.goto(server.EMPTY_PAGE)
@@ -473,7 +479,7 @@ def test_should_round_trip_har_with_post_data(
 
 
 def test_should_disambiguate_by_header(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
     server.set_route(
         "/echo",
@@ -493,7 +499,7 @@ def test_should_disambiguate_by_header(
             return response.text();
         };
     """
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context_1 = browser.new_context(record_har_mode="minimal", record_har_path=har_path)
     page_1 = context_1.new_page()
     page_1.goto(server.EMPTY_PAGE)
@@ -514,9 +520,9 @@ def test_should_disambiguate_by_header(
 
 
 def test_should_produce_extracted_zip(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.har"
+    har_path = tmp_path / "har.har"
     context = browser.new_context(
         record_har_mode="minimal", record_har_path=har_path, record_har_content="attach"
     )
@@ -539,9 +545,9 @@ def test_should_produce_extracted_zip(
 
 
 def test_should_update_har_zip_for_context(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context = browser.new_context()
     context.route_from_har(har_path, update=True)
     page_1 = context.new_page()
@@ -559,9 +565,9 @@ def test_should_update_har_zip_for_context(
 
 
 def test_should_update_har_zip_for_page(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context = browser.new_context()
     page_1 = context.new_page()
     page_1.route_from_har(har_path, update=True)
@@ -579,9 +585,9 @@ def test_should_update_har_zip_for_page(
 
 
 def test_should_update_har_zip_for_page_with_different_options(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.zip"
+    har_path = tmp_path / "har.zip"
     context1 = browser.new_context()
     page1 = context1.new_page()
     page1.route_from_har(
@@ -600,9 +606,9 @@ def test_should_update_har_zip_for_page_with_different_options(
 
 
 def test_should_update_extracted_har_zip_for_page(
-    browser: Browser, server: Server, tmpdir: Path
+    browser: Browser, server: Server, tmp_path: Path
 ) -> None:
-    har_path = tmpdir / "har.har"
+    har_path = tmp_path / "har.har"
     context = browser.new_context()
     page_1 = context.new_page()
     page_1.route_from_har(har_path, update=True)
diff --git a/tests/sync/test_launcher.py b/tests/sync/test_launcher.py
index 8577fd200..52deeb827 100644
--- a/tests/sync/test_launcher.py
+++ b/tests/sync/test_launcher.py
@@ -93,7 +93,7 @@ def test_browser_close_should_be_callable_twice(
 @pytest.mark.only_browser("chromium")
 def test_browser_launch_should_return_background_pages(
     browser_type: BrowserType,
-    tmpdir: Path,
+    tmp_path: Path,
     browser_channel: Optional[str],
     assetdir: Path,
     launch_arguments: Dict,
@@ -103,7 +103,7 @@ def test_browser_launch_should_return_background_pages(
 
     extension_path = str(assetdir / "simple-extension")
     context = browser_type.launch_persistent_context(
-        str(tmpdir),
+        str(tmp_path),
         **{
             **launch_arguments,
             "headless": False,
diff --git a/tests/sync/test_pdf.py b/tests/sync/test_pdf.py
index 684f27268..552d0f6bf 100644
--- a/tests/sync/test_pdf.py
+++ b/tests/sync/test_pdf.py
@@ -21,8 +21,8 @@
 
 
 @pytest.mark.only_browser("chromium")
-def test_should_be_able_to_save_pdf_file(page: Page, tmpdir: Path) -> None:
-    output_file = tmpdir / "foo.png"
+def test_should_be_able_to_save_pdf_file(page: Page, tmp_path: Path) -> None:
+    output_file = tmp_path / "foo.png"
     page.pdf(path=str(output_file))
     assert os.path.getsize(output_file) > 0
 
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index 9308d5d0a..cf08ac0c6 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -80,7 +80,7 @@ def test_should_collect_sources(
 
 
 def test_should_collect_trace_with_resources_but_no_js(
-    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+    context: BrowserContext, page: Page, server: Server, tmp_path: Path
 ) -> None:
     context.tracing.start(screenshots=True, snapshots=True)
     page.goto(server.PREFIX + "/frames/frame.html")
@@ -98,7 +98,7 @@ def test_should_collect_trace_with_resources_but_no_js(
         server.PREFIX + "/one-style.html"
     )  # should not produce a route.continue_ entry since we continue all routes if no match.
     page.close()
-    trace_file_path = tmpdir / "trace.zip"
+    trace_file_path = tmp_path / "trace.zip"
     context.tracing.stop(path=trace_file_path)
 
     (_, events) = parse_trace(trace_file_path)
@@ -140,7 +140,7 @@ def test_should_collect_trace_with_resources_but_no_js(
 
 
 def test_should_correctly_determine_sync_apiname(
-    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+    context: BrowserContext, page: Page, server: Server, tmp_path: Path
 ) -> None:
     context.tracing.start(screenshots=True, snapshots=True)
     received_response = threading.Event()
@@ -155,7 +155,7 @@ def _handle_response(response: Response) -> None:
     received_response.wait()
 
     page.close()
-    trace_file_path = tmpdir / "trace.zip"
+    trace_file_path = tmp_path / "trace.zip"
     context.tracing.stop(path=trace_file_path)
 
     (_, events) = parse_trace(trace_file_path)
@@ -167,19 +167,19 @@ def _handle_response(response: Response) -> None:
 
 
 def test_should_collect_two_traces(
-    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+    context: BrowserContext, page: Page, server: Server, tmp_path: Path
 ) -> None:
     context.tracing.start(screenshots=True, snapshots=True)
     page.goto(server.EMPTY_PAGE)
     page.set_content("<button>Click</button>")
     page.click('"Click"')
-    tracing1_path = tmpdir / "trace1.zip"
+    tracing1_path = tmp_path / "trace1.zip"
     context.tracing.stop(path=tracing1_path)
 
     context.tracing.start(screenshots=True, snapshots=True)
     page.dblclick('"Click"')
     page.close()
-    tracing2_path = tmpdir / "trace2.zip"
+    tracing2_path = tmp_path / "trace2.zip"
     context.tracing.stop(path=tracing2_path)
 
     (_, events) = parse_trace(tracing1_path)
@@ -202,7 +202,7 @@ def test_should_not_throw_when_stopping_without_start_but_not_exporting(
 
 
 def test_should_work_with_playwright_context_managers(
-    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+    context: BrowserContext, page: Page, server: Server, tmp_path: Path
 ) -> None:
     context.tracing.start(screenshots=True, snapshots=True)
     page.goto(server.EMPTY_PAGE)
@@ -214,7 +214,7 @@ def test_should_work_with_playwright_context_managers(
 
     with page.expect_popup():
         page.evaluate("window._popup = window.open(document.location.href)")
-    trace_file_path = tmpdir / "trace.zip"
+    trace_file_path = tmp_path / "trace.zip"
     context.tracing.stop(path=trace_file_path)
 
     (_, events) = parse_trace(trace_file_path)
@@ -231,7 +231,7 @@ def test_should_work_with_playwright_context_managers(
 
 
 def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
-    context: BrowserContext, page: Page, server: Server, tmpdir: Path
+    context: BrowserContext, page: Page, server: Server, tmp_path: Path
 ) -> None:
     context.tracing.start(screenshots=True, snapshots=True)
 
@@ -239,7 +239,7 @@ def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
     page.wait_for_load_state("load")
     page.wait_for_load_state("load")
 
-    trace_file_path = tmpdir / "trace.zip"
+    trace_file_path = tmp_path / "trace.zip"
     context.tracing.stop(path=trace_file_path)
 
     (_, events) = parse_trace(trace_file_path)
@@ -253,23 +253,23 @@ def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
 def test_should_respect_traces_dir_and_name(
     browser_type: BrowserType,
     server: Server,
-    tmpdir: Path,
+    tmp_path: Path,
     launch_arguments: Any,
 ) -> None:
-    traces_dir = tmpdir / "traces"
+    traces_dir = tmp_path / "traces"
     browser = browser_type.launch(traces_dir=traces_dir, **launch_arguments)
     context = browser.new_context()
     page = context.new_page()
 
     context.tracing.start(name="name1", snapshots=True)
     page.goto(server.PREFIX + "/one-style.html")
-    context.tracing.stop_chunk(path=tmpdir / "trace1.zip")
+    context.tracing.stop_chunk(path=tmp_path / "trace1.zip")
     assert (traces_dir / "name1.trace").exists()
     assert (traces_dir / "name1.network").exists()
 
     context.tracing.start_chunk(name="name2")
     page.goto(server.PREFIX + "/har.html")
-    context.tracing.stop(path=tmpdir / "trace2.zip")
+    context.tracing.stop(path=tmp_path / "trace2.zip")
     assert (traces_dir / "name2.trace").exists()
     assert (traces_dir / "name2.network").exists()
 
@@ -283,7 +283,7 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
             ]
         )
 
-    (resources, events) = parse_trace(tmpdir / "trace1.zip")
+    (resources, events) = parse_trace(tmp_path / "trace1.zip")
     assert get_trace_actions(events) == ["Page.goto"]
     assert resource_names(resources) == [
         "resources/XXX.css",
@@ -293,7 +293,7 @@ def resource_names(resources: Dict[str, bytes]) -> List[str]:
         "trace.trace",
     ]
 
-    (resources, events) = parse_trace(tmpdir / "trace2.zip")
+    (resources, events) = parse_trace(tmp_path / "trace2.zip")
     assert get_trace_actions(events) == ["Page.goto"]
     assert resource_names(resources) == [
         "resources/XXX.css",
diff --git a/tests/sync/test_video.py b/tests/sync/test_video.py
index ec45c1fad..3ae1daa21 100644
--- a/tests/sync/test_video.py
+++ b/tests/sync/test_video.py
@@ -23,85 +23,85 @@
 
 
 def test_should_expose_video_path(
-    browser: Browser, tmpdir: Path, server: Server
+    browser: Browser, tmp_path: Path, server: Server
 ) -> None:
     page = browser.new_page(
-        record_video_dir=tmpdir, record_video_size={"width": 100, "height": 200}
+        record_video_dir=tmp_path, record_video_size={"width": 100, "height": 200}
     )
     page.goto(server.PREFIX + "/grid.html")
     video = page.video
     assert video
     path = video.path()
     assert repr(page.video) == f"<Video page={page}>"
-    assert str(tmpdir) in str(path)
+    assert str(tmp_path) in str(path)
     page.wait_for_timeout(1000)
     page.context.close()
 
 
-def test_video_should_exist(browser: Browser, tmpdir: Path, server: Server) -> None:
-    page = browser.new_page(record_video_dir=tmpdir)
+def test_video_should_exist(browser: Browser, tmp_path: Path, server: Server) -> None:
+    page = browser.new_page(record_video_dir=tmp_path)
     page.goto(server.PREFIX + "/grid.html")
     video = page.video
     assert video
     path = video.path()
-    assert str(tmpdir) in str(path)
+    assert str(tmp_path) in str(path)
     page.wait_for_timeout(1000)
     page.context.close()
     assert os.path.exists(path)
 
 
-def test_record_video_to_path(browser: Browser, tmpdir: Path, server: Server) -> None:
-    page = browser.new_page(record_video_dir=tmpdir)
+def test_record_video_to_path(browser: Browser, tmp_path: Path, server: Server) -> None:
+    page = browser.new_page(record_video_dir=tmp_path)
     page.goto(server.PREFIX + "/grid.html")
     video = page.video
     assert video
     path = video.path()
-    assert str(tmpdir) in str(path)
+    assert str(tmp_path) in str(path)
     page.wait_for_timeout(1000)
     page.context.close()
     assert os.path.exists(path)
 
 
 def test_record_video_to_path_persistent(
-    browser_type: BrowserType, tmpdir: Path, server: Server, launch_arguments: Dict
+    browser_type: BrowserType, tmp_path: Path, server: Server, launch_arguments: Dict
 ) -> None:
     context = browser_type.launch_persistent_context(
-        tmpdir, **launch_arguments, record_video_dir=tmpdir
+        tmp_path, **launch_arguments, record_video_dir=tmp_path
     )
     page = context.pages[0]
     page.goto(server.PREFIX + "/grid.html")
     video = page.video
     assert video
     path = video.path()
-    assert str(tmpdir) in str(path)
+    assert str(tmp_path) in str(path)
     page.wait_for_timeout(1000)
     context.close()
     assert os.path.exists(path)
 
 
 def test_record_video_can_get_video_path_immediately(
-    browser_type: BrowserType, tmpdir: Path, launch_arguments: Dict
+    browser_type: BrowserType, tmp_path: Path, launch_arguments: Dict
 ) -> None:
     context = browser_type.launch_persistent_context(
-        tmpdir, **launch_arguments, record_video_dir=tmpdir
+        tmp_path, **launch_arguments, record_video_dir=tmp_path
     )
     page = context.pages[0]
     video = page.video
     assert video
     path = video.path()
-    assert str(tmpdir) in str(path)
+    assert str(tmp_path) in str(path)
     page.wait_for_timeout(1000)
     context.close()
     assert os.path.exists(path)
 
 
 def test_should_error_if_page_not_closed_before_save_as(
-    browser: Browser, tmpdir: Path, server: Server
+    browser: Browser, tmp_path: Path, server: Server
 ) -> None:
-    page = browser.new_page(record_video_dir=tmpdir)
+    page = browser.new_page(record_video_dir=tmp_path)
     page.goto(server.PREFIX + "/grid.html")
     page.wait_for_timeout(1000)  # Give it some time to record.
-    out_path = tmpdir / "some-video.webm"
+    out_path = tmp_path / "some-video.webm"
     with pytest.raises(Error) as err:
         video = page.video
         assert video

From 2c8aa6d7dc243b34652b923eb886162ab829a8dd Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Wed, 11 Jun 2025 13:40:15 +0200
Subject: [PATCH 390/438] test: refactor trace viewer tests to use actual trace
 viewer (#2885)

---
 tests/async/conftest.py                 |  80 ++++++
 tests/async/test_browsertype_connect.py |  39 ++-
 tests/async/test_tracing.py             | 310 +++++++++++++----------
 tests/conftest.py                       |   6 +-
 tests/server.py                         |  54 +++-
 tests/sync/conftest.py                  |  74 ++++++
 tests/sync/test_tracing.py              | 314 ++++++++++++++----------
 tests/utils.py                          |  45 +---
 8 files changed, 593 insertions(+), 329 deletions(-)

diff --git a/tests/async/conftest.py b/tests/async/conftest.py
index 65a963507..a007d55ac 100644
--- a/tests/async/conftest.py
+++ b/tests/async/conftest.py
@@ -13,19 +13,25 @@
 # limitations under the License.
 
 import asyncio
+from contextlib import asynccontextmanager
+from pathlib import Path
 from typing import Any, AsyncGenerator, Awaitable, Callable, Dict, Generator
 
 import pytest
 
+from playwright._impl._driver import compute_driver_executable
 from playwright.async_api import (
     Browser,
     BrowserContext,
     BrowserType,
+    FrameLocator,
+    Locator,
     Page,
     Playwright,
     Selectors,
     async_playwright,
 )
+from tests.server import HTTPServer
 
 from .utils import Utils
 from .utils import utils as utils_object
@@ -131,3 +137,77 @@ async def page(context: BrowserContext) -> AsyncGenerator[Page, None]:
 @pytest.fixture(scope="session")
 def selectors(playwright: Playwright) -> Selectors:
     return playwright.selectors
+
+
+class TraceViewerPage:
+    def __init__(self, page: Page):
+        self.page = page
+
+    @property
+    def actions_tree(self) -> Locator:
+        return self.page.get_by_test_id("actions-tree")
+
+    @property
+    def action_titles(self) -> Locator:
+        return self.page.locator(".action-title")
+
+    @property
+    def stack_frames(self) -> Locator:
+        return self.page.get_by_test_id("stack-trace-list").locator(".list-view-entry")
+
+    async def select_action(self, title: str, ordinal: int = 0) -> None:
+        await self.page.locator(f'.action-title:has-text("{title}")').nth(
+            ordinal
+        ).click()
+
+    async def select_snapshot(self, name: str) -> None:
+        await self.page.click(
+            f'.snapshot-tab .tabbed-pane-tab-label:has-text("{name}")'
+        )
+
+    async def snapshot_frame(
+        self, action_name: str, ordinal: int = 0, has_subframe: bool = False
+    ) -> FrameLocator:
+        await self.select_action(action_name, ordinal)
+        expected_frames = 4 if has_subframe else 3
+        while len(self.page.frames) < expected_frames:
+            await self.page.wait_for_event("frameattached")
+        return self.page.frame_locator("iframe.snapshot-visible[name=snapshot]")
+
+    async def show_source_tab(self) -> None:
+        await self.page.click("text='Source'")
+
+    async def expand_action(self, title: str, ordinal: int = 0) -> None:
+        await self.actions_tree.locator(".tree-view-entry", has_text=title).nth(
+            ordinal
+        ).locator(".codicon-chevron-right").click()
+
+
+@pytest.fixture
+async def show_trace_viewer(browser: Browser) -> AsyncGenerator[Callable, None]:
+    """Fixture that provides a function to show trace viewer for a trace file."""
+
+    @asynccontextmanager
+    async def _show_trace_viewer(
+        trace_path: Path,
+    ) -> AsyncGenerator[TraceViewerPage, None]:
+        trace_viewer_path = (
+            Path(compute_driver_executable()[0]) / "../package/lib/vite/traceViewer"
+        ).resolve()
+
+        server = HTTPServer()
+        server.start(trace_viewer_path)
+        server.set_route("/trace.zip", lambda request: request.serve_file(trace_path))
+
+        page = await browser.new_page()
+
+        try:
+            await page.goto(
+                f"{server.PREFIX}/index.html?trace={server.PREFIX}/trace.zip"
+            )
+            yield TraceViewerPage(page)
+        finally:
+            await page.close()
+            server.stop()
+
+    yield _show_trace_viewer
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index 8295a6960..d2eca4628 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -16,14 +16,16 @@
 import os
 import re
 from pathlib import Path
-from typing import Callable
+from typing import AsyncContextManager, Callable
 
 import pytest
 
-from playwright.async_api import BrowserType, Error, Playwright, Route
+from playwright.async_api import BrowserType, Error, Playwright, Route, expect
 from tests.conftest import RemoteServer
 from tests.server import Server, TestServerRequest, WebSocketProtocol
-from tests.utils import chromium_version_less_than, parse_trace
+from tests.utils import chromium_version_less_than
+
+from .conftest import TraceViewerPage
 
 
 async def test_should_print_custom_ws_close_error(
@@ -325,6 +327,7 @@ async def test_should_record_trace_with_source(
     server: Server,
     tmp_path: Path,
     browser_type: BrowserType,
+    show_trace_viewer: Callable[[Path], AsyncContextManager[TraceViewerPage]],
 ) -> None:
     remote = launch_server()
     browser = await browser_type.connect(remote.ws_endpoint)
@@ -341,14 +344,28 @@ async def test_should_record_trace_with_source(
     await context.close()
     await browser.close()
 
-    (resources, events) = parse_trace(path)
-    current_file_content = Path(__file__).read_bytes()
-    found_current_file = False
-    for name, resource in resources.items():
-        if resource == current_file_content:
-            found_current_file = True
-            break
-    assert found_current_file
+    async with show_trace_viewer(path) as trace_viewer:
+        await expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile("Page.goto"),
+                re.compile("Page.set_content"),
+                re.compile("Page.click"),
+            ]
+        )
+        await trace_viewer.show_source_tab()
+        await expect(trace_viewer.stack_frames).to_contain_text(
+            [
+                re.compile(r"test_should_record_trace_with_source"),
+            ]
+        )
+        await trace_viewer.select_action("Page.set_content")
+        # Check that the source file is shown
+        await expect(
+            trace_viewer.page.locator(".source-tab-file-name")
+        ).to_have_attribute("title", re.compile(r".*test_browsertype_connect\.py"))
+        await expect(trace_viewer.page.locator(".source-line-running")).to_contain_text(
+            'page.set_content("<button>Click</button>")'
+        )
 
 
 async def test_should_record_trace_with_relative_trace_path(
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index 6b0c557f2..270bbfb80 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -15,11 +15,19 @@
 import asyncio
 import re
 from pathlib import Path
-from typing import Dict, List
-
-from playwright.async_api import Browser, BrowserContext, BrowserType, Page, Response
+from typing import AsyncContextManager, Callable
+
+from playwright.async_api import (
+    Browser,
+    BrowserContext,
+    BrowserType,
+    Page,
+    Response,
+    expect,
+)
 from tests.server import Server
-from tests.utils import get_trace_actions, parse_trace
+
+from .conftest import TraceViewerPage
 
 
 async def test_browser_context_output_trace(
@@ -41,7 +49,7 @@ async def test_start_stop(browser: Browser) -> None:
 
 
 async def test_browser_context_should_not_throw_when_stopping_without_start_but_not_exporting(
-    context: BrowserContext, server: Server, tmp_path: Path
+    context: BrowserContext,
 ) -> None:
     await context.tracing.stop()
 
@@ -67,27 +75,60 @@ async def test_browser_context_output_trace_chunk(
 
 
 async def test_should_collect_sources(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], AsyncContextManager[TraceViewerPage]],
 ) -> None:
     await context.tracing.start(sources=True)
     await page.goto(server.EMPTY_PAGE)
     await page.set_content("<button>Click</button>")
-    await page.click("button")
+
+    async def my_method_outer() -> None:
+        async def my_method_inner() -> None:
+            await page.get_by_text("Click").click()
+
+        await my_method_inner()
+
+    await my_method_outer()
     path = tmp_path / "trace.zip"
     await context.tracing.stop(path=path)
 
-    (resources, events) = parse_trace(path)
-    current_file_content = Path(__file__).read_bytes()
-    found_current_file = False
-    for name, resource in resources.items():
-        if resource == current_file_content:
-            found_current_file = True
-            break
-    assert found_current_file
+    async with show_trace_viewer(path) as trace_viewer:
+        await expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile(r"Page.goto"),
+                re.compile(r"Page.set_content"),
+                re.compile(r"Locator.click"),
+            ]
+        )
+        await trace_viewer.show_source_tab()
+        # Check that stack frames are shown (they might be anonymous in Python)
+        await expect(trace_viewer.stack_frames).to_contain_text(
+            [
+                re.compile(r"my_method_inner"),
+                re.compile(r"my_method_outer"),
+                re.compile(r"test_should_collect_sources"),
+            ]
+        )
+
+        await trace_viewer.select_action("Page.set_content")
+        # Check that the source file is shown
+        await expect(
+            trace_viewer.page.locator(".source-tab-file-name")
+        ).to_have_attribute("title", re.compile(r".*test_.*\.py"))
+        await expect(trace_viewer.page.locator(".source-line-running")).to_contain_text(
+            'page.set_content("<button>Click</button>")'
+        )
 
 
 async def test_should_collect_trace_with_resources_but_no_js(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], AsyncContextManager[TraceViewerPage]],
 ) -> None:
     await context.tracing.start(screenshots=True, snapshots=True)
     await page.goto(server.PREFIX + "/frames/frame.html")
@@ -108,46 +149,37 @@ async def test_should_collect_trace_with_resources_but_no_js(
     trace_file_path = tmp_path / "trace.zip"
     await context.tracing.stop(path=trace_file_path)
 
-    (_, events) = parse_trace(trace_file_path)
-    assert events[0]["type"] == "context-options"
-    assert get_trace_actions(events) == [
-        "Page.goto",
-        "Page.set_content",
-        "Page.click",
-        "Mouse.move",
-        "Mouse.dblclick",
-        "Keyboard.insert_text",
-        "Page.wait_for_timeout",
-        "Page.route",
-        "Page.goto",
-        "Page.goto",
-        "Page.close",
-    ]
-
-    assert len(list(filter(lambda e: e["type"] == "frame-snapshot", events))) >= 1
-    assert len(list(filter(lambda e: e["type"] == "screencast-frame", events))) >= 1
-    style = list(
-        filter(
-            lambda e: e["type"] == "resource-snapshot"
-            and e["snapshot"]["request"]["url"].endswith("style.css"),
-            events,
-        )
-    )[0]
-    assert style
-    assert style["snapshot"]["response"]["content"]["_sha1"]
-    script = list(
-        filter(
-            lambda e: e["type"] == "resource-snapshot"
-            and e["snapshot"]["request"]["url"].endswith("script.js"),
-            events,
+    async with show_trace_viewer(trace_file_path) as trace_viewer:
+        await expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile("Page.goto"),
+                re.compile("Page.set_content"),
+                re.compile("Page.click"),
+                re.compile("Mouse.move"),
+                re.compile("Mouse.dblclick"),
+                re.compile("Keyboard.insert_text"),
+                re.compile("Page.wait_for_timeout"),
+                re.compile("Page.route"),
+                re.compile("Page.goto"),
+                re.compile("Page.goto"),
+                re.compile("Page.close"),
+            ]
         )
-    )[0]
-    assert script
-    assert script["snapshot"]["response"]["content"].get("_sha1") is None
+
+        await trace_viewer.select_action("Page.set_content")
+        await expect(
+            trace_viewer.page.locator(".browser-frame-address-bar")
+        ).to_have_text(server.PREFIX + "/frames/frame.html")
+        frame = await trace_viewer.snapshot_frame("Page.set_content", 0, False)
+        await expect(frame.locator("button")).to_have_text("Click")
 
 
 async def test_should_correctly_determine_sync_apiname(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable,
 ) -> None:
     await context.tracing.start(screenshots=True, snapshots=True)
 
@@ -165,16 +197,21 @@ async def _handle_response(response: Response) -> None:
     trace_file_path = tmp_path / "trace.zip"
     await context.tracing.stop(path=trace_file_path)
 
-    (_, events) = parse_trace(trace_file_path)
-    assert events[0]["type"] == "context-options"
-    assert get_trace_actions(events) == [
-        "Page.goto",
-        "Page.close",
-    ]
+    async with show_trace_viewer(trace_file_path) as trace_viewer:
+        await expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile(r"Page.goto"),
+                re.compile(r"Page.close"),
+            ]
+        )
 
 
 async def test_should_collect_two_traces(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], AsyncContextManager[TraceViewerPage]],
 ) -> None:
     await context.tracing.start(screenshots=True, snapshots=True)
     await page.goto(server.EMPTY_PAGE)
@@ -189,27 +226,30 @@ async def test_should_collect_two_traces(
     tracing2_path = tmp_path / "trace2.zip"
     await context.tracing.stop(path=tracing2_path)
 
-    (_, events) = parse_trace(tracing1_path)
-    assert events[0]["type"] == "context-options"
-    assert get_trace_actions(events) == [
-        "Page.goto",
-        "Page.set_content",
-        "Page.click",
-    ]
-
-    (_, events) = parse_trace(tracing2_path)
-    assert events[0]["type"] == "context-options"
-    assert get_trace_actions(events) == ["Page.dblclick", "Page.close"]
-
+    async with show_trace_viewer(tracing1_path) as trace_viewer:
+        await expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile("Page.goto"),
+                re.compile("Page.set_content"),
+                re.compile("Page.click"),
+            ]
+        )
 
-async def test_should_not_throw_when_stopping_without_start_but_not_exporting(
-    context: BrowserContext,
-) -> None:
-    await context.tracing.stop()
+    async with show_trace_viewer(tracing2_path) as trace_viewer:
+        await expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile(r"Page.dblclick"),
+                re.compile(r"Page.close"),
+            ]
+        )
 
 
 async def test_should_work_with_playwright_context_managers(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], AsyncContextManager[TraceViewerPage]],
 ) -> None:
     await context.tracing.start(screenshots=True, snapshots=True)
     await page.goto(server.EMPTY_PAGE)
@@ -224,21 +264,26 @@ async def test_should_work_with_playwright_context_managers(
     trace_file_path = tmp_path / "trace.zip"
     await context.tracing.stop(path=trace_file_path)
 
-    (_, events) = parse_trace(trace_file_path)
-    assert events[0]["type"] == "context-options"
-    assert get_trace_actions(events) == [
-        "Page.goto",
-        "Page.set_content",
-        "Page.expect_console_message",
-        "Page.evaluate",
-        "Page.click",
-        "Page.expect_popup",
-        "Page.evaluate",
-    ]
+    async with show_trace_viewer(trace_file_path) as trace_viewer:
+        await expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile("Page.goto"),
+                re.compile("Page.set_content"),
+                re.compile("Page.expect_console_message"),
+                re.compile("Page.evaluate"),
+                re.compile("Page.click"),
+                re.compile("Page.expect_popup"),
+                re.compile("Page.evaluate"),
+            ]
+        )
 
 
 async def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], AsyncContextManager[TraceViewerPage]],
 ) -> None:
     await context.tracing.start(screenshots=True, snapshots=True)
 
@@ -249,19 +294,22 @@ async def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
     trace_file_path = tmp_path / "trace.zip"
     await context.tracing.stop(path=trace_file_path)
 
-    (_, events) = parse_trace(trace_file_path)
-    assert get_trace_actions(events) == [
-        "Page.goto",
-        "Page.wait_for_load_state",
-        "Page.wait_for_load_state",
-    ]
+    async with show_trace_viewer(trace_file_path) as trace_viewer:
+        await expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile(r"Page.goto"),
+                re.compile(r"Page.wait_for_load_state"),
+                re.compile(r"Page.wait_for_load_state"),
+            ]
+        )
 
 
 async def test_should_respect_traces_dir_and_name(
     browser_type: BrowserType,
     server: Server,
     tmp_path: Path,
-    launch_arguments: Dict,
+    launch_arguments: dict,
+    show_trace_viewer: Callable[[Path], AsyncContextManager[TraceViewerPage]],
 ) -> None:
     traces_dir = tmp_path / "traces"
     browser = await browser_type.launch(traces_dir=traces_dir, **launch_arguments)
@@ -282,38 +330,35 @@ async def test_should_respect_traces_dir_and_name(
 
     await browser.close()
 
-    def resource_names(resources: Dict[str, bytes]) -> List[str]:
-        return sorted(
+    async with show_trace_viewer(tmp_path / "trace1.zip") as trace_viewer:
+        await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.sub(r"^resources/.*\.(html|css)$", r"resources/XXX.\g<1>", file)
-                for file in resources.keys()
+                re.compile(r"Page.goto"),
             ]
         )
+        frame = await trace_viewer.snapshot_frame("Page.goto", 0, False)
+        await expect(frame.locator("body")).to_have_css(
+            "background-color", "rgb(255, 192, 203)"
+        )
+        await expect(frame.locator("body")).to_have_text("hello, world!")
 
-    (resources, events) = parse_trace(tmp_path / "trace1.zip")
-    assert get_trace_actions(events) == ["Page.goto"]
-    assert resource_names(resources) == [
-        "resources/XXX.css",
-        "resources/XXX.html",
-        "trace.network",
-        "trace.stacks",
-        "trace.trace",
-    ]
-
-    (resources, events) = parse_trace(tmp_path / "trace2.zip")
-    assert get_trace_actions(events) == ["Page.goto"]
-    assert resource_names(resources) == [
-        "resources/XXX.css",
-        "resources/XXX.html",
-        "resources/XXX.html",
-        "trace.network",
-        "trace.stacks",
-        "trace.trace",
-    ]
+    async with show_trace_viewer(tmp_path / "trace2.zip") as trace_viewer:
+        await expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile(r"Page.goto"),
+            ]
+        )
+        frame = await trace_viewer.snapshot_frame("Page.goto", 0, False)
+        await expect(frame.locator("body")).to_have_css(
+            "background-color", "rgb(255, 192, 203)"
+        )
+        await expect(frame.locator("body")).to_have_text("hello, world!")
 
 
 async def test_should_show_tracing_group_in_action_list(
-    context: BrowserContext, tmp_path: Path
+    context: BrowserContext,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], AsyncContextManager[TraceViewerPage]],
 ) -> None:
     await context.tracing.start()
     page = await context.new_page()
@@ -331,15 +376,16 @@ async def test_should_show_tracing_group_in_action_list(
     trace_path = tmp_path / "trace.zip"
     await context.tracing.stop(path=trace_path)
 
-    (resources, events) = parse_trace(trace_path)
-    actions = get_trace_actions(events)
-
-    assert actions == [
-        "BrowserContext.new_page",
-        "outer group",
-        "Page.goto",
-        "inner group 1",
-        "Locator.click",
-        "inner group 2",
-        "Locator.is_visible",
-    ]
+    async with show_trace_viewer(trace_path) as trace_viewer:
+        await trace_viewer.expand_action("inner group 1")
+        await expect(trace_viewer.action_titles).to_have_text(
+            [
+                "BrowserContext.new_page",
+                "outer group",
+                re.compile("Page.goto"),
+                "inner group 1",
+                re.compile("Locator.click"),
+                "inner group 2",
+                re.compile("Locator.is_visible"),
+            ]
+        )
diff --git a/tests/conftest.py b/tests/conftest.py
index 15505c30c..2b533f15f 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -57,10 +57,12 @@ def headless(pytestconfig: pytest.Config) -> bool:
 
 @pytest.fixture(scope="session")
 def launch_arguments(pytestconfig: pytest.Config, headless: bool) -> Dict:
-    return {
+    args: Dict = {
         "headless": headless,
-        "channel": pytestconfig.getoption("--browser-channel"),
     }
+    if pytestconfig.getoption("--browser-channel"):
+        args["channel"] = pytestconfig.getoption("--browser-channel")
+    return args
 
 
 @pytest.fixture
diff --git a/tests/server.py b/tests/server.py
index cc8145317..d69176950 100644
--- a/tests/server.py
+++ b/tests/server.py
@@ -17,6 +17,7 @@
 import contextlib
 import gzip
 import mimetypes
+import pathlib
 import socket
 import threading
 from contextlib import closing
@@ -85,8 +86,7 @@ def process(self) -> None:
             self.content.seek(0, 0)
         else:
             self.post_body = None
-        uri = urlparse(self.uri.decode())
-        path = uri.path
+        path = urlparse(self.uri.decode()).path
 
         request_subscriber = server.request_subscribers.get(path)
         if request_subscriber:
@@ -118,15 +118,23 @@ def process(self) -> None:
         if server.routes.get(path):
             server.routes[path](self)
             return
+
+        self._serve_file(server.static_path / path[1:], path)
+
+    def serve_file(self, path: pathlib.Path) -> None:
+        return self._serve_file(path, urlparse(self.uri.decode()).path)
+
+    def _serve_file(self, path: pathlib.Path, request_path: str) -> None:
+        server = self.channel.factory.server_instance
         file_content = None
         try:
-            file_content = (server.static_path / path[1:]).read_bytes()
+            file_content = path.read_bytes()
             content_type = mimetypes.guess_type(path)[0]
             if content_type and content_type.startswith("text/"):
                 content_type += "; charset=utf-8"
             self.setHeader(b"Content-Type", content_type)
             self.setHeader(b"Cache-Control", "no-cache, no-store")
-            if path in server.gzip_routes:
+            if request_path in server.gzip_routes:
                 self.setHeader("Content-Encoding", "gzip")
                 self.write(gzip.compress(file_content))
             else:
@@ -173,7 +181,7 @@ def __repr__(self) -> str:
     def listen(self, factory: TestServerFactory) -> None:
         pass
 
-    def start(self) -> None:
+    def start(self, static_path: pathlib.Path = _dirname / "assets") -> None:
         request_subscribers: Dict[str, asyncio.Future] = {}
         auth: Dict[str, Tuple[str, str]] = {}
         csp: Dict[str, str] = {}
@@ -185,7 +193,7 @@ def start(self) -> None:
         self.routes = routes
         self._ws_handlers: List[Callable[["WebSocketProtocol"], None]] = []
         self.gzip_routes = gzip_routes
-        self.static_path = _dirname / "assets"
+        self.static_path = static_path
         factory = TestServerFactory()
         factory.server_instance = self
 
@@ -276,17 +284,34 @@ def once_web_socket_connection(
 
 
 class HTTPServer(Server):
+    def __init__(self) -> None:
+        self._listeners: list[Any] = []
+        super().__init__()
+
     def listen(self, factory: http.HTTPFactory) -> None:
-        reactor.listenTCP(self.PORT, factory, interface="127.0.0.1")
+        self._listeners.append(
+            reactor.listenTCP(self.PORT, factory, interface="127.0.0.1")
+        )
         try:
-            reactor.listenTCP(self.PORT, factory, interface="::1")
+            self._listeners.append(
+                reactor.listenTCP(self.PORT, factory, interface="::1")
+            )
         except Exception:
             pass
 
+    def stop(self) -> None:
+        for listener in self._listeners:
+            listener.stopListening()
+        self._listeners.clear()
+
 
 class HTTPSServer(Server):
     protocol = "https"
 
+    def __init__(self) -> None:
+        self._listeners: list[Any] = []
+        super().__init__()
+
     def listen(self, factory: http.HTTPFactory) -> None:
         cert = ssl.PrivateCertificate.fromCertificateAndKeyPair(
             ssl.Certificate.loadPEM(
@@ -297,12 +322,21 @@ def listen(self, factory: http.HTTPFactory) -> None:
             ),
         )
         contextFactory = cert.options()
-        reactor.listenSSL(self.PORT, factory, contextFactory, interface="127.0.0.1")
+        self._listeners.append(
+            reactor.listenSSL(self.PORT, factory, contextFactory, interface="127.0.0.1")
+        )
         try:
-            reactor.listenSSL(self.PORT, factory, contextFactory, interface="::1")
+            self._listeners.append(
+                reactor.listenSSL(self.PORT, factory, contextFactory, interface="::1")
+            )
         except Exception:
             pass
 
+    def stop(self) -> None:
+        for listener in self._listeners:
+            listener.stopListening()
+        self._listeners.clear()
+
 
 class WebSocketProtocol(WebSocketServerProtocol):
     def __init__(self, *args: Any, **kwargs: Any) -> None:
diff --git a/tests/sync/conftest.py b/tests/sync/conftest.py
index b825ca2fe..46bf86239 100644
--- a/tests/sync/conftest.py
+++ b/tests/sync/conftest.py
@@ -14,20 +14,26 @@
 
 
 import asyncio
+from contextlib import contextmanager
+from pathlib import Path
 from typing import Any, Callable, Dict, Generator, List
 
 import pytest
 from greenlet import greenlet
 
+from playwright._impl._driver import compute_driver_executable
 from playwright.sync_api import (
     Browser,
     BrowserContext,
     BrowserType,
+    FrameLocator,
+    Locator,
     Page,
     Playwright,
     Selectors,
     sync_playwright,
 )
+from tests.server import HTTPServer
 
 from .utils import Utils
 from .utils import utils as utils_object
@@ -121,3 +127,71 @@ async def task() -> None:
         return list(map(lambda action: results[action], actions))
 
     yield _sync_gather_impl
+
+
+class TraceViewerPage:
+    def __init__(self, page: Page):
+        self.page = page
+
+    @property
+    def actions_tree(self) -> Locator:
+        return self.page.get_by_test_id("actions-tree")
+
+    @property
+    def action_titles(self) -> Locator:
+        return self.page.locator(".action-title")
+
+    @property
+    def stack_frames(self) -> Locator:
+        return self.page.get_by_test_id("stack-trace-list").locator(".list-view-entry")
+
+    def select_action(self, title: str, ordinal: int = 0) -> None:
+        self.page.locator(f'.action-title:has-text("{title}")').nth(ordinal).click()
+
+    def select_snapshot(self, name: str) -> None:
+        self.page.click(f'.snapshot-tab .tabbed-pane-tab-label:has-text("{name}")')
+
+    def snapshot_frame(
+        self, action_name: str, ordinal: int = 0, has_subframe: bool = False
+    ) -> FrameLocator:
+        self.select_action(action_name, ordinal)
+        expected_frames = 4 if has_subframe else 3
+        while len(self.page.frames) < expected_frames:
+            self.page.wait_for_event("frameattached")
+        return self.page.frame_locator("iframe.snapshot-visible[name=snapshot]")
+
+    def show_source_tab(self) -> None:
+        self.page.click("text='Source'")
+
+    def expand_action(self, title: str, ordinal: int = 0) -> None:
+        self.actions_tree.locator(".tree-view-entry", has_text=title).nth(
+            ordinal
+        ).locator(".codicon-chevron-right").click()
+
+
+@pytest.fixture
+def show_trace_viewer(browser: Browser) -> Generator[Callable, None, None]:
+    """Fixture that provides a function to show trace viewer for a trace file."""
+
+    @contextmanager
+    def _show_trace_viewer(
+        trace_path: Path,
+    ) -> Generator[TraceViewerPage, None, None]:
+        trace_viewer_path = (
+            Path(compute_driver_executable()[0]) / "../package/lib/vite/traceViewer"
+        ).resolve()
+
+        server = HTTPServer()
+        server.start(trace_viewer_path)
+        server.set_route("/trace.zip", lambda request: request.serve_file(trace_path))
+
+        page = browser.new_page()
+
+        try:
+            page.goto(f"{server.PREFIX}/index.html?trace={server.PREFIX}/trace.zip")
+            yield TraceViewerPage(page)
+        finally:
+            page.close()
+            server.stop()
+
+    yield _show_trace_viewer
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index cf08ac0c6..43e875b16 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -15,11 +15,19 @@
 import re
 import threading
 from pathlib import Path
-from typing import Any, Dict, List
-
-from playwright.sync_api import Browser, BrowserContext, BrowserType, Page, Response
+from typing import Callable, ContextManager
+
+from playwright.sync_api import (
+    Browser,
+    BrowserContext,
+    BrowserType,
+    Page,
+    Response,
+    expect,
+)
 from tests.server import Server
-from tests.utils import get_trace_actions, parse_trace
+
+from .conftest import TraceViewerPage
 
 
 def test_browser_context_output_trace(
@@ -33,6 +41,13 @@ def test_browser_context_output_trace(
     assert Path(tmp_path / "trace.zip").exists()
 
 
+def test_start_stop(browser: Browser) -> None:
+    context = browser.new_context()
+    context.tracing.start()
+    context.tracing.stop()
+    context.close()
+
+
 def test_browser_context_should_not_throw_when_stopping_without_start_but_not_exporting(
     context: BrowserContext,
 ) -> None:
@@ -60,27 +75,60 @@ def test_browser_context_output_trace_chunk(
 
 
 def test_should_collect_sources(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], ContextManager[TraceViewerPage]],
 ) -> None:
     context.tracing.start(sources=True)
     page.goto(server.EMPTY_PAGE)
     page.set_content("<button>Click</button>")
-    page.click("button")
+
+    def my_method_outer() -> None:
+        def my_method_inner() -> None:
+            page.get_by_text("Click").click()
+
+        my_method_inner()
+
+    my_method_outer()
     path = tmp_path / "trace.zip"
     context.tracing.stop(path=path)
 
-    (resources, events) = parse_trace(path)
-    current_file_content = Path(__file__).read_bytes()
-    found_current_file = False
-    for name, resource in resources.items():
-        if resource == current_file_content:
-            found_current_file = True
-            break
-    assert found_current_file
+    with show_trace_viewer(path) as trace_viewer:
+        expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile(r"Page.goto"),
+                re.compile(r"Page.set_content"),
+                re.compile(r"Locator.click"),
+            ]
+        )
+        trace_viewer.show_source_tab()
+        # Check that stack frames are shown (they might be anonymous in Python)
+        expect(trace_viewer.stack_frames).to_contain_text(
+            [
+                re.compile(r"my_method_inner"),
+                re.compile(r"my_method_outer"),
+                re.compile(r"test_should_collect_sources"),
+            ]
+        )
+
+        trace_viewer.select_action("Page.set_content")
+        # Check that the source file is shown
+        expect(trace_viewer.page.locator(".source-tab-file-name")).to_have_attribute(
+            "title", re.compile(r".*test_.*\.py")
+        )
+        expect(trace_viewer.page.locator(".source-line-running")).to_contain_text(
+            'page.set_content("<button>Click</button>")'
+        )
 
 
 def test_should_collect_trace_with_resources_but_no_js(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], ContextManager[TraceViewerPage]],
 ) -> None:
     context.tracing.start(screenshots=True, snapshots=True)
     page.goto(server.PREFIX + "/frames/frame.html")
@@ -101,48 +149,40 @@ def test_should_collect_trace_with_resources_but_no_js(
     trace_file_path = tmp_path / "trace.zip"
     context.tracing.stop(path=trace_file_path)
 
-    (_, events) = parse_trace(trace_file_path)
-    assert events[0]["type"] == "context-options"
-    assert get_trace_actions(events) == [
-        "Page.goto",
-        "Page.set_content",
-        "Page.click",
-        "Mouse.move",
-        "Mouse.dblclick",
-        "Keyboard.insert_text",
-        "Page.wait_for_timeout",
-        "Page.route",
-        "Page.goto",
-        "Page.goto",
-        "Page.close",
-    ]
-
-    assert len(list(filter(lambda e: e["type"] == "frame-snapshot", events))) >= 1
-    assert len(list(filter(lambda e: e["type"] == "screencast-frame", events))) >= 1
-    style = list(
-        filter(
-            lambda e: e["type"] == "resource-snapshot"
-            and e["snapshot"]["request"]["url"].endswith("style.css"),
-            events,
+    with show_trace_viewer(trace_file_path) as trace_viewer:
+        expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile("Page.goto"),
+                re.compile("Page.set_content"),
+                re.compile("Page.click"),
+                re.compile("Mouse.move"),
+                re.compile("Mouse.dblclick"),
+                re.compile("Keyboard.insert_text"),
+                re.compile("Page.wait_for_timeout"),
+                re.compile("Page.route"),
+                re.compile("Page.goto"),
+                re.compile("Page.goto"),
+                re.compile("Page.close"),
+            ]
         )
-    )[0]
-    assert style
-    assert style["snapshot"]["response"]["content"]["_sha1"]
-    script = list(
-        filter(
-            lambda e: e["type"] == "resource-snapshot"
-            and e["snapshot"]["request"]["url"].endswith("script.js"),
-            events,
+
+        trace_viewer.select_action("Page.set_content")
+        expect(trace_viewer.page.locator(".browser-frame-address-bar")).to_have_text(
+            server.PREFIX + "/frames/frame.html"
         )
-    )[0]
-    assert script
-    assert script["snapshot"]["response"]["content"].get("_sha1") is None
+        frame = trace_viewer.snapshot_frame("Page.set_content", 0, False)
+        expect(frame.locator("button")).to_have_text("Click")
 
 
 def test_should_correctly_determine_sync_apiname(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable,
 ) -> None:
     context.tracing.start(screenshots=True, snapshots=True)
+
     received_response = threading.Event()
 
     def _handle_response(response: Response) -> None:
@@ -158,16 +198,21 @@ def _handle_response(response: Response) -> None:
     trace_file_path = tmp_path / "trace.zip"
     context.tracing.stop(path=trace_file_path)
 
-    (_, events) = parse_trace(trace_file_path)
-    assert events[0]["type"] == "context-options"
-    assert get_trace_actions(events) == [
-        "Page.goto",
-        "Page.close",
-    ]
+    with show_trace_viewer(trace_file_path) as trace_viewer:
+        expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile(r"Page.goto"),
+                re.compile(r"Page.close"),
+            ]
+        )
 
 
 def test_should_collect_two_traces(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], ContextManager[TraceViewerPage]],
 ) -> None:
     context.tracing.start(screenshots=True, snapshots=True)
     page.goto(server.EMPTY_PAGE)
@@ -182,27 +227,30 @@ def test_should_collect_two_traces(
     tracing2_path = tmp_path / "trace2.zip"
     context.tracing.stop(path=tracing2_path)
 
-    (_, events) = parse_trace(tracing1_path)
-    assert events[0]["type"] == "context-options"
-    assert get_trace_actions(events) == [
-        "Page.goto",
-        "Page.set_content",
-        "Page.click",
-    ]
-
-    (_, events) = parse_trace(tracing2_path)
-    assert events[0]["type"] == "context-options"
-    assert get_trace_actions(events) == ["Page.dblclick", "Page.close"]
-
+    with show_trace_viewer(tracing1_path) as trace_viewer:
+        expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile("Page.goto"),
+                re.compile("Page.set_content"),
+                re.compile("Page.click"),
+            ]
+        )
 
-def test_should_not_throw_when_stopping_without_start_but_not_exporting(
-    context: BrowserContext,
-) -> None:
-    context.tracing.stop()
+    with show_trace_viewer(tracing2_path) as trace_viewer:
+        expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile(r"Page.dblclick"),
+                re.compile(r"Page.close"),
+            ]
+        )
 
 
 def test_should_work_with_playwright_context_managers(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], ContextManager[TraceViewerPage]],
 ) -> None:
     context.tracing.start(screenshots=True, snapshots=True)
     page.goto(server.EMPTY_PAGE)
@@ -217,21 +265,26 @@ def test_should_work_with_playwright_context_managers(
     trace_file_path = tmp_path / "trace.zip"
     context.tracing.stop(path=trace_file_path)
 
-    (_, events) = parse_trace(trace_file_path)
-    assert events[0]["type"] == "context-options"
-    assert get_trace_actions(events) == [
-        "Page.goto",
-        "Page.set_content",
-        "Page.expect_console_message",
-        "Page.evaluate",
-        "Page.click",
-        "Page.expect_popup",
-        "Page.evaluate",
-    ]
+    with show_trace_viewer(trace_file_path) as trace_viewer:
+        expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile("Page.goto"),
+                re.compile("Page.set_content"),
+                re.compile("Page.expect_console_message"),
+                re.compile("Page.evaluate"),
+                re.compile("Page.click"),
+                re.compile("Page.expect_popup"),
+                re.compile("Page.evaluate"),
+            ]
+        )
 
 
 def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
-    context: BrowserContext, page: Page, server: Server, tmp_path: Path
+    context: BrowserContext,
+    page: Page,
+    server: Server,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], ContextManager[TraceViewerPage]],
 ) -> None:
     context.tracing.start(screenshots=True, snapshots=True)
 
@@ -242,19 +295,22 @@ def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
     trace_file_path = tmp_path / "trace.zip"
     context.tracing.stop(path=trace_file_path)
 
-    (_, events) = parse_trace(trace_file_path)
-    assert get_trace_actions(events) == [
-        "Page.goto",
-        "Page.wait_for_load_state",
-        "Page.wait_for_load_state",
-    ]
+    with show_trace_viewer(trace_file_path) as trace_viewer:
+        expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile(r"Page.goto"),
+                re.compile(r"Page.wait_for_load_state"),
+                re.compile(r"Page.wait_for_load_state"),
+            ]
+        )
 
 
 def test_should_respect_traces_dir_and_name(
     browser_type: BrowserType,
     server: Server,
     tmp_path: Path,
-    launch_arguments: Any,
+    launch_arguments: dict,
+    show_trace_viewer: Callable[[Path], ContextManager[TraceViewerPage]],
 ) -> None:
     traces_dir = tmp_path / "traces"
     browser = browser_type.launch(traces_dir=traces_dir, **launch_arguments)
@@ -275,38 +331,35 @@ def test_should_respect_traces_dir_and_name(
 
     browser.close()
 
-    def resource_names(resources: Dict[str, bytes]) -> List[str]:
-        return sorted(
+    with show_trace_viewer(tmp_path / "trace1.zip") as trace_viewer:
+        expect(trace_viewer.action_titles).to_have_text(
             [
-                re.sub(r"^resources/.*\.(html|css)$", r"resources/XXX.\g<1>", file)
-                for file in resources.keys()
+                re.compile(r"Page.goto"),
             ]
         )
+        frame = trace_viewer.snapshot_frame("Page.goto", 0, False)
+        expect(frame.locator("body")).to_have_css(
+            "background-color", "rgb(255, 192, 203)"
+        )
+        expect(frame.locator("body")).to_have_text("hello, world!")
 
-    (resources, events) = parse_trace(tmp_path / "trace1.zip")
-    assert get_trace_actions(events) == ["Page.goto"]
-    assert resource_names(resources) == [
-        "resources/XXX.css",
-        "resources/XXX.html",
-        "trace.network",
-        "trace.stacks",
-        "trace.trace",
-    ]
-
-    (resources, events) = parse_trace(tmp_path / "trace2.zip")
-    assert get_trace_actions(events) == ["Page.goto"]
-    assert resource_names(resources) == [
-        "resources/XXX.css",
-        "resources/XXX.html",
-        "resources/XXX.html",
-        "trace.network",
-        "trace.stacks",
-        "trace.trace",
-    ]
+    with show_trace_viewer(tmp_path / "trace2.zip") as trace_viewer:
+        expect(trace_viewer.action_titles).to_have_text(
+            [
+                re.compile(r"Page.goto"),
+            ]
+        )
+        frame = trace_viewer.snapshot_frame("Page.goto", 0, False)
+        expect(frame.locator("body")).to_have_css(
+            "background-color", "rgb(255, 192, 203)"
+        )
+        expect(frame.locator("body")).to_have_text("hello, world!")
 
 
 def test_should_show_tracing_group_in_action_list(
-    context: BrowserContext, tmp_path: Path
+    context: BrowserContext,
+    tmp_path: Path,
+    show_trace_viewer: Callable[[Path], ContextManager[TraceViewerPage]],
 ) -> None:
     context.tracing.start()
     page = context.new_page()
@@ -324,15 +377,16 @@ def test_should_show_tracing_group_in_action_list(
     trace_path = tmp_path / "trace.zip"
     context.tracing.stop(path=trace_path)
 
-    (resources, events) = parse_trace(trace_path)
-    actions = get_trace_actions(events)
-
-    assert actions == [
-        "BrowserContext.new_page",
-        "outer group",
-        "Page.goto",
-        "inner group 1",
-        "Locator.click",
-        "inner group 2",
-        "Locator.is_visible",
-    ]
+    with show_trace_viewer(trace_path) as trace_viewer:
+        trace_viewer.expand_action("inner group 1")
+        expect(trace_viewer.action_titles).to_have_text(
+            [
+                "BrowserContext.new_page",
+                "outer group",
+                re.compile("Page.goto"),
+                "inner group 1",
+                re.compile("Locator.click"),
+                "inner group 2",
+                re.compile("Locator.is_visible"),
+            ]
+        )
diff --git a/tests/utils.py b/tests/utils.py
index c6c10a810..6a78eefaf 100644
--- a/tests/utils.py
+++ b/tests/utils.py
@@ -12,50 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import json
-import zipfile
-from pathlib import Path
-from typing import Any, Dict, List, Optional, Tuple, TypeVar
-
-
-def parse_trace(path: Path) -> Tuple[Dict[str, bytes], List[Any]]:
-    resources: Dict[str, bytes] = {}
-    with zipfile.ZipFile(path, "r") as zip:
-        for name in zip.namelist():
-            resources[name] = zip.read(name)
-    action_map: Dict[str, Any] = {}
-    events: List[Any] = []
-    for name in ["trace.trace", "trace.network"]:
-        for line in resources[name].decode().splitlines():
-            if not line:
-                continue
-            event = json.loads(line)
-            if event["type"] == "before":
-                event["type"] = "action"
-                action_map[event["callId"]] = event
-                events.append(event)
-            elif event["type"] == "input":
-                pass
-            elif event["type"] == "after":
-                existing = action_map[event["callId"]]
-                existing["error"] = event.get("error", None)
-            else:
-                events.append(event)
-    return (resources, events)
-
-
-def get_trace_actions(events: List[Any]) -> List[str]:
-    action_events = sorted(
-        list(
-            filter(
-                lambda e: e["type"] == "action",
-                events,
-            )
-        ),
-        key=lambda e: e["startTime"],
-    )
-    return [e["apiName"] for e in action_events]
-
+from typing import Optional, TypeVar
 
 TARGET_CLOSED_ERROR_MESSAGE = "Target page, context or browser has been closed"
 

From 8587bc6986fc3bccad66683b6ecce78caa808489 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 13 Jun 2025 00:43:56 +0200
Subject: [PATCH 391/438] build(deps): bump greenlet from 3.2.2 to 3.2.3
 (#2880)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 28863d0dd..a6b31fd67 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,6 @@
 # This file was autogenerated by uv via the following command:
 #    uv pip compile pyproject.toml -o requirements.txt
-greenlet==3.2.2
+greenlet==3.2.3
     # via playwright (pyproject.toml)
 pyee==13.0.0
     # via playwright (pyproject.toml)

From 0ff7fc983ef39ed6121ffbac4eaf15e9b02a6aba Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 13 Jun 2025 00:44:04 +0200
Subject: [PATCH 392/438] build(deps): bump requests from 2.32.3 to 2.32.4
 (#2882)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 56b7edd22..99eaf42a5 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -15,7 +15,7 @@ pytest-repeat==0.9.4
 pytest-rerunfailures==15.1
 pytest-timeout==2.4.0
 pytest-xdist==3.6.1
-requests==2.32.3
+requests==2.32.4
 service_identity==24.2.0
 twisted==24.11.0
 types-pyOpenSSL==24.1.0.20240722

From 767288e7e6fa1d708c22d9896a98bc25384c5318 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 21 Jun 2025 19:26:25 +0200
Subject: [PATCH 393/438] build(deps): bump pytest-xdist from 3.6.1 to 3.7.0
 (#2881)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 99eaf42a5..da3b04258 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -14,7 +14,7 @@ pytest-cov==6.1.1
 pytest-repeat==0.9.4
 pytest-rerunfailures==15.1
 pytest-timeout==2.4.0
-pytest-xdist==3.6.1
+pytest-xdist==3.7.0
 requests==2.32.4
 service_identity==24.2.0
 twisted==24.11.0

From f4a9b58b78236d36054dfee7be59431dc67c8fcf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 21 Jun 2025 19:26:50 +0200
Subject: [PATCH 394/438] build(deps): bump twisted from 24.11.0 to 25.5.0
 (#2889)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index da3b04258..567b81818 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -17,6 +17,6 @@ pytest-timeout==2.4.0
 pytest-xdist==3.7.0
 requests==2.32.4
 service_identity==24.2.0
-twisted==24.11.0
+twisted==25.5.0
 types-pyOpenSSL==24.1.0.20240722
 types-requests==2.32.0.20250602

From 114d7cf3490fa6cf8876359f6636a44c4fcf1ec8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 21 Jun 2025 20:03:43 +0200
Subject: [PATCH 395/438] build(deps): bump types-requests from 2.32.0.20250602
 to 2.32.4.20250611 (#2890)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 567b81818..12c2da3ef 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,4 +19,4 @@ requests==2.32.4
 service_identity==24.2.0
 twisted==25.5.0
 types-pyOpenSSL==24.1.0.20240722
-types-requests==2.32.0.20250602
+types-requests==2.32.4.20250611

From 6e3b718246dff3945edc715ec7e1682f39546529 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 21 Jun 2025 20:03:52 +0200
Subject: [PATCH 396/438] build(deps): bump pytest-cov from 6.1.1 to 6.2.1
 (#2888)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 12c2da3ef..afe7e4bb8 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -10,7 +10,7 @@ pre-commit==3.5.0
 pyOpenSSL==25.1.0
 pytest==8.4.0
 pytest-asyncio==1.0.0
-pytest-cov==6.1.1
+pytest-cov==6.2.1
 pytest-repeat==0.9.4
 pytest-rerunfailures==15.1
 pytest-timeout==2.4.0

From b0c0ee0f0954dc78b1ac0e08715edf069fba4c90 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 24 Jun 2025 18:01:28 +0200
Subject: [PATCH 397/438] devops: use windows-2019 for conda builds (#2899)

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 0a6d8fcd5..c18a04bc6 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -160,7 +160,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-22.04, macos-13, windows-2019]
+        os: [ubuntu-22.04, macos-13, windows-2022]
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4

From fdca00ccdc399f85298d3265a30280270d07e55c Mon Sep 17 00:00:00 2001
From: Adam Gastineau <adam@agg.im>
Date: Tue, 24 Jun 2025 10:52:34 -0700
Subject: [PATCH 398/438] chore: roll to 1.53.1 (#2892)

---
 README.md                                 |   6 +-
 playwright/_impl/_assertions.py           |  35 +++-
 playwright/_impl/_browser.py              | 108 ++++++------
 playwright/_impl/_browser_context.py      |  89 ++++++----
 playwright/_impl/_browser_type.py         | 116 +++++++++----
 playwright/_impl/_connection.py           |  71 ++++++--
 playwright/_impl/_element_handle.py       |   4 +-
 playwright/_impl/_fetch.py                |   5 +-
 playwright/_impl/_frame.py                |  46 +++--
 playwright/_impl/_helper.py               |  24 ++-
 playwright/_impl/_input.py                |  19 ++-
 playwright/_impl/_local_utils.py          |   1 -
 playwright/_impl/_locator.py              |  16 +-
 playwright/_impl/_network.py              |   6 +-
 playwright/_impl/_object_factory.py       |   3 -
 playwright/_impl/_page.py                 |  30 +++-
 playwright/_impl/_playwright.py           |  10 +-
 playwright/_impl/_selectors.py            |  49 ++----
 playwright/_impl/_tracing.py              |   1 -
 playwright/async_api/_generated.py        | 191 ++++++++++++---------
 playwright/sync_api/_generated.py         | 197 ++++++++++++----------
 setup.py                                  |   2 +-
 tests/async/conftest.py                   |   4 +-
 tests/async/test_assertions.py            |  37 +++-
 tests/async/test_browsertype_connect.py   |   8 +-
 tests/async/test_defaultbrowsercontext.py |   3 +-
 tests/async/test_page_aria_snapshot.py    |  11 --
 tests/async/test_tracing.py               |  99 ++++++-----
 tests/sync/conftest.py                    |   2 +-
 tests/sync/test_assertions.py             |  10 +-
 tests/sync/test_har.py                    |   7 +
 tests/sync/test_page_aria_snapshot.py     |  11 --
 tests/sync/test_route_web_socket.py       |   1 +
 tests/sync/test_tracing.py                |  99 ++++++-----
 34 files changed, 782 insertions(+), 539 deletions(-)

diff --git a/README.md b/README.md
index b450b87f2..9577b82e8 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 -->136.0.7103.25<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| WebKit <!-- GEN:webkit-version -->18.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->137.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->138.0.7204.23<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| WebKit <!-- GEN:webkit-version -->18.5<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->139.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 2a3beb756..6e0161b7c 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -51,6 +51,7 @@ async def _expect_impl(
         expect_options: FrameExpectOptions,
         expected: Any,
         message: str,
+        title: str = None,
     ) -> None:
         __tracebackhide__ = True
         expect_options["isNot"] = self._is_not
@@ -60,7 +61,7 @@ async def _expect_impl(
             message = message.replace("expected to", "expected not to")
         if "useInnerText" in expect_options and expect_options["useInnerText"] is None:
             del expect_options["useInnerText"]
-        result = await self._actual_locator._expect(expression, expect_options)
+        result = await self._actual_locator._expect(expression, expect_options, title)
         if result["matches"] == self._is_not:
             actual = result.get("received")
             if self._custom_message:
@@ -105,6 +106,7 @@ async def to_have_title(
             FrameExpectOptions(expectedText=expected_values, timeout=timeout),
             titleOrRegExp,
             "Page title expected to be",
+            'Expect "to_have_title"',
         )
 
     async def not_to_have_title(
@@ -129,6 +131,7 @@ async def to_have_url(
             FrameExpectOptions(expectedText=expected_text, timeout=timeout),
             urlOrRegExp,
             "Page URL expected to be",
+            'Expect "to_have_url"',
         )
 
     async def not_to_have_url(
@@ -190,6 +193,7 @@ async def to_contain_text(
                 ),
                 expected,
                 "Locator expected to contain text",
+                'Expect "to_contain_text"',
             )
         else:
             expected_text = to_expected_text_values(
@@ -207,6 +211,7 @@ async def to_contain_text(
                 ),
                 expected,
                 "Locator expected to contain text",
+                'Expect "to_contain_text"',
             )
 
     async def not_to_contain_text(
@@ -241,6 +246,7 @@ async def to_have_attribute(
             ),
             value,
             "Locator expected to have attribute",
+            'Expect "to_have_attribute"',
         )
 
     async def not_to_have_attribute(
@@ -276,6 +282,7 @@ async def to_have_class(
                 FrameExpectOptions(expectedText=expected_text, timeout=timeout),
                 expected,
                 "Locator expected to have class",
+                'Expect "to_have_class"',
             )
         else:
             expected_text = to_expected_text_values([expected])
@@ -284,6 +291,7 @@ async def to_have_class(
                 FrameExpectOptions(expectedText=expected_text, timeout=timeout),
                 expected,
                 "Locator expected to have class",
+                'Expect "to_have_class"',
             )
 
     async def not_to_have_class(
@@ -318,6 +326,7 @@ async def to_contain_class(
                 FrameExpectOptions(expectedText=expected_text, timeout=timeout),
                 expected,
                 "Locator expected to contain class names",
+                'Expect "to_contain_class"',
             )
         else:
             expected_text = to_expected_text_values([expected])
@@ -326,6 +335,7 @@ async def to_contain_class(
                 FrameExpectOptions(expectedText=expected_text, timeout=timeout),
                 expected,
                 "Locator expected to contain class",
+                'Expect "to_contain_class"',
             )
 
     async def not_to_contain_class(
@@ -350,6 +360,7 @@ async def to_have_count(
             FrameExpectOptions(expectedNumber=count, timeout=timeout),
             count,
             "Locator expected to have count",
+            'Expect "to_have_count"',
         )
 
     async def not_to_have_count(
@@ -375,6 +386,7 @@ async def to_have_css(
             ),
             value,
             "Locator expected to have CSS",
+            'Expect "to_have_css"',
         )
 
     async def not_to_have_css(
@@ -398,6 +410,7 @@ async def to_have_id(
             FrameExpectOptions(expectedText=expected_text, timeout=timeout),
             id,
             "Locator expected to have ID",
+            'Expect "to_have_id"',
         )
 
     async def not_to_have_id(
@@ -422,6 +435,7 @@ async def to_have_js_property(
             ),
             value,
             "Locator expected to have JS Property",
+            'Expect "to_have_property"',
         )
 
     async def not_to_have_js_property(
@@ -445,6 +459,7 @@ async def to_have_value(
             FrameExpectOptions(expectedText=expected_text, timeout=timeout),
             value,
             "Locator expected to have Value",
+            'Expect "to_have_value"',
         )
 
     async def not_to_have_value(
@@ -469,6 +484,7 @@ async def to_have_values(
             FrameExpectOptions(expectedText=expected_text, timeout=timeout),
             values,
             "Locator expected to have Values",
+            'Expect "to_have_values"',
         )
 
     async def not_to_have_values(
@@ -512,6 +528,7 @@ async def to_have_text(
                 ),
                 expected,
                 "Locator expected to have text",
+                'Expect "to_have_text"',
             )
         else:
             expected_text = to_expected_text_values(
@@ -526,6 +543,7 @@ async def to_have_text(
                 ),
                 expected,
                 "Locator expected to have text",
+                'Expect "to_have_text"',
             )
 
     async def not_to_have_text(
@@ -558,6 +576,7 @@ async def to_be_attached(
             FrameExpectOptions(timeout=timeout),
             None,
             f"Locator expected to be {attached_string}",
+            'Expect "to_be_attached"',
         )
 
     async def to_be_checked(
@@ -582,6 +601,7 @@ async def to_be_checked(
             FrameExpectOptions(timeout=timeout, expectedValue=expected_value),
             None,
             f"Locator expected to be {checked_string}",
+            'Expect "to_be_checked"',
         )
 
     async def not_to_be_attached(
@@ -609,6 +629,7 @@ async def to_be_disabled(
             FrameExpectOptions(timeout=timeout),
             None,
             "Locator expected to be disabled",
+            'Expect "to_be_disabled"',
         )
 
     async def not_to_be_disabled(
@@ -632,6 +653,7 @@ async def to_be_editable(
             FrameExpectOptions(timeout=timeout),
             None,
             f"Locator expected to be {editable_string}",
+            'Expect "to_be_editable"',
         )
 
     async def not_to_be_editable(
@@ -652,6 +674,7 @@ async def to_be_empty(
             FrameExpectOptions(timeout=timeout),
             None,
             "Locator expected to be empty",
+            'Expect "to_be_empty"',
         )
 
     async def not_to_be_empty(
@@ -675,6 +698,7 @@ async def to_be_enabled(
             FrameExpectOptions(timeout=timeout),
             None,
             f"Locator expected to be {enabled_string}",
+            'Expect "to_be_enabled"',
         )
 
     async def not_to_be_enabled(
@@ -695,6 +719,7 @@ async def to_be_hidden(
             FrameExpectOptions(timeout=timeout),
             None,
             "Locator expected to be hidden",
+            'Expect "to_be_hidden"',
         )
 
     async def not_to_be_hidden(
@@ -718,6 +743,7 @@ async def to_be_visible(
             FrameExpectOptions(timeout=timeout),
             None,
             f"Locator expected to be {visible_string}",
+            'Expect "to_be_visible"',
         )
 
     async def not_to_be_visible(
@@ -738,6 +764,7 @@ async def to_be_focused(
             FrameExpectOptions(timeout=timeout),
             None,
             "Locator expected to be focused",
+            'Expect "to_be_focused"',
         )
 
     async def not_to_be_focused(
@@ -758,6 +785,7 @@ async def to_be_in_viewport(
             FrameExpectOptions(timeout=timeout, expectedNumber=ratio),
             None,
             "Locator expected to be in viewport",
+            'Expect "to_be_in_viewport"',
         )
 
     async def not_to_be_in_viewport(
@@ -781,6 +809,7 @@ async def to_have_accessible_description(
             FrameExpectOptions(expectedText=expected_values, timeout=timeout),
             None,
             "Locator expected to have accessible description",
+            'Expect "to_have_accessible_description"',
         )
 
     async def not_to_have_accessible_description(
@@ -807,6 +836,7 @@ async def to_have_accessible_name(
             FrameExpectOptions(expectedText=expected_values, timeout=timeout),
             None,
             "Locator expected to have accessible name",
+            'Expect "to_have_accessible_name"',
         )
 
     async def not_to_have_accessible_name(
@@ -828,6 +858,7 @@ async def to_have_role(self, role: AriaRole, timeout: float = None) -> None:
             FrameExpectOptions(expectedText=expected_values, timeout=timeout),
             None,
             "Locator expected to have accessible role",
+            'Expect "to_have_role"',
         )
 
     async def to_have_accessible_error_message(
@@ -845,6 +876,7 @@ async def to_have_accessible_error_message(
             FrameExpectOptions(expectedText=expected_values, timeout=timeout),
             None,
             "Locator expected to have accessible error message",
+            'Expect "to_have_accessible_error_message"',
         )
 
     async def not_to_have_accessible_error_message(
@@ -871,6 +903,7 @@ async def to_match_aria_snapshot(
             FrameExpectOptions(expectedValue=expected, timeout=timeout),
             expected,
             "Locator expected to match Aria snapshot",
+            'Expect "to_match_aria_snapshot"',
         )
 
     async def not_to_match_aria_snapshot(
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index aa56d8244..9b3c1cacc 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -12,10 +12,19 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import json
 from pathlib import Path
 from types import SimpleNamespace
-from typing import TYPE_CHECKING, Dict, List, Optional, Pattern, Sequence, Union, cast
+from typing import (
+    TYPE_CHECKING,
+    Dict,
+    List,
+    Optional,
+    Pattern,
+    Sequence,
+    Set,
+    Union,
+    cast,
+)
 
 from playwright._impl._api_structures import (
     ClientCertificate,
@@ -38,12 +47,9 @@
     HarMode,
     ReducedMotion,
     ServiceWorkersPolicy,
-    async_readfile,
     locals_to_params,
     make_dirs_for_file,
-    prepare_record_har_options,
 )
-from playwright._impl._network import serialize_headers, to_client_certificates_protocol
 from playwright._impl._page import Page
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -59,28 +65,61 @@ def __init__(
         self, parent: "BrowserType", type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self._browser_type = parent
+        self._browser_type: Optional["BrowserType"] = None
         self._is_connected = True
         self._should_close_connection_on_close = False
         self._cr_tracing_path: Optional[str] = None
 
-        self._contexts: List[BrowserContext] = []
+        self._contexts: Set[BrowserContext] = set()
+        self._traces_dir: Optional[str] = None
+        self._channel.on(
+            "context",
+            lambda params: self._did_create_context(
+                cast(BrowserContext, from_channel(params["context"]))
+            ),
+        )
         self._channel.on("close", lambda _: self._on_close())
         self._close_reason: Optional[str] = None
 
     def __repr__(self) -> str:
         return f"<Browser type={self._browser_type} version={self.version}>"
 
+    def _connect_to_browser_type(
+        self,
+        browser_type: "BrowserType",
+        traces_dir: Optional[str] = None,
+    ) -> None:
+        # Note: when using connect(), `browserType` is different from `this.parent`.
+        # This is why browser type is not wired up in the constructor, and instead this separate method is called later on.
+        self._browser_type = browser_type
+        self._traces_dir = traces_dir
+        for context in self._contexts:
+            self._setup_browser_context(context)
+
+    def _did_create_context(self, context: BrowserContext) -> None:
+        context._browser = self
+        self._contexts.add(context)
+        # Note: when connecting to a browser, initial contexts arrive before `_browserType` is set,
+        # and will be configured later in `ConnectToBrowserType`.
+        if self._browser_type:
+            self._setup_browser_context(context)
+
+    def _setup_browser_context(self, context: BrowserContext) -> None:
+        context._tracing._traces_dir = self._traces_dir
+        assert self._browser_type is not None
+        self._browser_type._playwright.selectors._contexts_for_selectors.add(context)
+
     def _on_close(self) -> None:
         self._is_connected = False
         self.emit(Browser.Events.Disconnected, self)
 
     @property
     def contexts(self) -> List[BrowserContext]:
-        return self._contexts.copy()
+        return list(self._contexts)
 
     @property
     def browser_type(self) -> "BrowserType":
+        assert self._browser_type is not None
         return self._browser_type
 
     def is_connected(self) -> bool:
@@ -126,11 +165,18 @@ async def new_context(
         clientCertificates: List[ClientCertificate] = None,
     ) -> BrowserContext:
         params = locals_to_params(locals())
-        await prepare_browser_context_params(params)
+        assert self._browser_type is not None
+        await self._browser_type._prepare_browser_context_params(params)
 
         channel = await self._channel.send("newContext", params)
         context = cast(BrowserContext, from_channel(channel))
-        self._browser_type._did_create_context(context, params, {})
+        await context._initialize_har_from_options(
+            record_har_content=recordHarContent,
+            record_har_mode=recordHarMode,
+            record_har_omit_content=recordHarOmitContent,
+            record_har_path=recordHarPath,
+            record_har_url_filter=recordHarUrlFilter,
+        )
         return context
 
     async def new_page(
@@ -181,7 +227,7 @@ async def inner() -> Page:
             context._owner_page = page
             return page
 
-        return await self._connection.wrap_api_call(inner)
+        return await self._connection.wrap_api_call(inner, title="Create page")
 
     async def close(self, reason: str = None) -> None:
         self._close_reason = reason
@@ -226,43 +272,3 @@ async def stop_tracing(self) -> bytes:
                 f.write(buffer)
             self._cr_tracing_path = None
         return buffer
-
-
-async def prepare_browser_context_params(params: Dict) -> None:
-    if params.get("noViewport"):
-        del params["noViewport"]
-        params["noDefaultViewport"] = True
-    if "defaultBrowserType" in params:
-        del params["defaultBrowserType"]
-    if "extraHTTPHeaders" in params:
-        params["extraHTTPHeaders"] = serialize_headers(params["extraHTTPHeaders"])
-    if "recordHarPath" in params:
-        params["recordHar"] = prepare_record_har_options(params)
-        del params["recordHarPath"]
-    if "recordVideoDir" in params:
-        params["recordVideo"] = {"dir": Path(params["recordVideoDir"]).absolute()}
-        if "recordVideoSize" in params:
-            params["recordVideo"]["size"] = params["recordVideoSize"]
-            del params["recordVideoSize"]
-        del params["recordVideoDir"]
-    if "storageState" in params:
-        storageState = params["storageState"]
-        if not isinstance(storageState, dict):
-            params["storageState"] = json.loads(
-                (await async_readfile(storageState)).decode()
-            )
-    if params.get("colorScheme", None) == "null":
-        params["colorScheme"] = "no-override"
-    if params.get("reducedMotion", None) == "null":
-        params["reducedMotion"] = "no-override"
-    if params.get("forcedColors", None) == "null":
-        params["forcedColors"] = "no-override"
-    if params.get("contrast", None) == "null":
-        params["contrast"] = "no-override"
-    if "acceptDownloads" in params:
-        params["acceptDownloads"] = "accept" if params["acceptDownloads"] else "deny"
-
-    if "clientCertificates" in params:
-        params["clientCertificates"] = await to_client_certificates_protocol(
-            params["clientCertificates"]
-        )
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 22da4375d..1264d3f8b 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -66,7 +66,6 @@
     async_writefile,
     locals_to_params,
     parse_error,
-    prepare_record_har_options,
     to_impl,
 )
 from playwright._impl._network import (
@@ -106,18 +105,18 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        # Browser is null for browser contexts created outside of normal browser, e.g. android or electron.
         # circular import workaround:
         self._browser: Optional["Browser"] = None
         if parent.__class__.__name__ == "Browser":
             self._browser = cast("Browser", parent)
-            self._browser._contexts.append(self)
         self._pages: List[Page] = []
         self._routes: List[RouteHandler] = []
         self._web_socket_routes: List[WebSocketRouteHandler] = []
         self._bindings: Dict[str, Any] = {}
         self._timeout_settings = TimeoutSettings(None)
         self._owner_page: Optional[Page] = None
-        self._options: Dict[str, Any] = {}
+        self._options: Dict[str, Any] = initializer["options"]
         self._background_pages: Set[Page] = set()
         self._service_workers: Set[Worker] = set()
         self._tracing = cast(Tracing, from_channel(initializer["tracing"]))
@@ -220,7 +219,7 @@ def __init__(
                 BrowserContext.Events.RequestFailed: "requestFailed",
             }
         )
-        self._close_was_called = False
+        self._closing_or_closed = False
 
     def __repr__(self) -> str:
         return f"<BrowserContext browser={self.browser}>"
@@ -237,7 +236,7 @@ async def _on_route(self, route: Route) -> None:
         route_handlers = self._routes.copy()
         for route_handler in route_handlers:
             # If the page or the context was closed we stall all requests right away.
-            if (page and page._close_was_called) or self._close_was_called:
+            if (page and page._close_was_called) or self._closing_or_closed:
                 return
             if not route_handler.matches(route.request.url):
                 continue
@@ -288,19 +287,12 @@ def set_default_navigation_timeout(self, timeout: float) -> None:
 
     def _set_default_navigation_timeout_impl(self, timeout: Optional[float]) -> None:
         self._timeout_settings.set_default_navigation_timeout(timeout)
-        self._channel.send_no_reply(
-            "setDefaultNavigationTimeoutNoReply",
-            {} if timeout is None else {"timeout": timeout},
-        )
 
     def set_default_timeout(self, timeout: float) -> None:
         return self._set_default_timeout_impl(timeout)
 
     def _set_default_timeout_impl(self, timeout: Optional[float]) -> None:
         self._timeout_settings.set_default_timeout(timeout)
-        self._channel.send_no_reply(
-            "setDefaultTimeoutNoReply", {} if timeout is None else {"timeout": timeout}
-        )
 
     @property
     def pages(self) -> List[Page]:
@@ -310,14 +302,30 @@ def pages(self) -> List[Page]:
     def browser(self) -> Optional["Browser"]:
         return self._browser
 
-    def _set_options(self, context_options: Dict, browser_options: Dict) -> None:
-        self._options = context_options
-        if self._options.get("recordHar"):
-            self._har_recorders[""] = {
-                "path": self._options["recordHar"]["path"],
-                "content": self._options["recordHar"].get("content"),
-            }
-        self._tracing._traces_dir = browser_options.get("tracesDir")
+    async def _initialize_har_from_options(
+        self,
+        record_har_path: Optional[Union[Path, str]],
+        record_har_content: Optional[HarContentPolicy],
+        record_har_omit_content: Optional[bool],
+        record_har_url_filter: Optional[Union[Pattern[str], str]],
+        record_har_mode: Optional[HarMode],
+    ) -> None:
+        if not record_har_path:
+            return
+        record_har_path = str(record_har_path)
+        default_policy: HarContentPolicy = (
+            "attach" if record_har_path.endswith(".zip") else "embed"
+        )
+        content_policy: HarContentPolicy = record_har_content or (
+            "omit" if record_har_omit_content is True else default_policy
+        )
+        await self._record_into_har(
+            har=record_har_path,
+            page=None,
+            url=record_har_url_filter,
+            update_content=content_policy,
+            update_mode=(record_har_mode or "full"),
+        )
 
     async def new_page(self) -> Page:
         if self._owner_page:
@@ -476,22 +484,25 @@ async def _record_into_har(
         update_content: HarContentPolicy = None,
         update_mode: HarMode = None,
     ) -> None:
+        update_content = update_content or "attach"
         params: Dict[str, Any] = {
-            "options": prepare_record_har_options(
-                {
-                    "recordHarPath": har,
-                    "recordHarContent": update_content or "attach",
-                    "recordHarMode": update_mode or "minimal",
-                    "recordHarUrlFilter": url,
-                }
-            )
+            "options": {
+                "zip": str(har).endswith(".zip"),
+                "content": update_content,
+                "urlGlob": url if isinstance(url, str) else None,
+                "urlRegexSource": url.pattern if isinstance(url, Pattern) else None,
+                "urlRegexFlags": (
+                    escape_regex_flags(url) if isinstance(url, Pattern) else None
+                ),
+                "mode": update_mode or "minimal",
+            }
         }
         if page:
             params["page"] = page._channel
         har_id = await self._channel.send("harStart", params)
         self._har_recorders[har_id] = {
             "path": str(har),
-            "content": update_content or "attach",
+            "content": update_content,
         }
 
     async def route_from_har(
@@ -555,22 +566,30 @@ def expect_event(
         return EventContextManagerImpl(waiter.result())
 
     def _on_close(self) -> None:
+        self._closing_or_closed = True
         if self._browser:
-            self._browser._contexts.remove(self)
+            if self in self._browser._contexts:
+                self._browser._contexts.remove(self)
+            assert self._browser._browser_type is not None
+            if (
+                self
+                in self._browser._browser_type._playwright.selectors._contexts_for_selectors
+            ):
+                self._browser._browser_type._playwright.selectors._contexts_for_selectors.remove(
+                    self
+                )
 
         self._dispose_har_routers()
         self._tracing._reset_stack_counter()
         self.emit(BrowserContext.Events.Close, self)
 
     async def close(self, reason: str = None) -> None:
-        if self._close_was_called:
+        if self._closing_or_closed:
             return
         self._close_reason = reason
-        self._close_was_called = True
+        self._closing_or_closed = True
 
-        await self._channel._connection.wrap_api_call(
-            lambda: self.request.dispose(reason=reason), True
-        )
+        await self.request.dispose(reason=reason)
 
         async def _inner_close() -> None:
             for har_id, params in self._har_recorders.items():
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index bedc5ea73..ab8c00e97 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import asyncio
+import json
 import pathlib
 import sys
 from pathlib import Path
@@ -25,16 +26,12 @@
     ProxySettings,
     ViewportSize,
 )
-from playwright._impl._browser import Browser, prepare_browser_context_params
+from playwright._impl._browser import Browser
 from playwright._impl._browser_context import BrowserContext
-from playwright._impl._connection import (
-    ChannelOwner,
-    Connection,
-    from_channel,
-    from_nullable_channel,
-)
+from playwright._impl._connection import ChannelOwner, Connection, from_channel
 from playwright._impl._errors import Error
 from playwright._impl._helper import (
+    PLAYWRIGHT_MAX_DEADLINE,
     ColorScheme,
     Contrast,
     Env,
@@ -43,10 +40,12 @@
     HarMode,
     ReducedMotion,
     ServiceWorkersPolicy,
+    TimeoutSettings,
+    async_readfile,
     locals_to_params,
 )
 from playwright._impl._json_pipe import JsonPipeTransport
-from playwright._impl._network import serialize_headers
+from playwright._impl._network import serialize_headers, to_client_certificates_protocol
 from playwright._impl._waiter import throw_on_timeout
 
 if TYPE_CHECKING:
@@ -96,7 +95,9 @@ async def launch(
         browser = cast(
             Browser, from_channel(await self._channel.send("launch", params))
         )
-        self._did_launch_browser(browser)
+        browser._connect_to_browser_type(
+            self, str(tracesDir) if tracesDir is not None else None
+        )
         return browser
 
     async def launch_persistent_context(
@@ -155,13 +156,26 @@ async def launch_persistent_context(
     ) -> BrowserContext:
         userDataDir = self._user_data_dir(userDataDir)
         params = locals_to_params(locals())
-        await prepare_browser_context_params(params)
+        await self._prepare_browser_context_params(params)
         normalize_launch_params(params)
-        context = cast(
-            BrowserContext,
-            from_channel(await self._channel.send("launchPersistentContext", params)),
+        result = await self._channel.send_return_as_dict(
+            "launchPersistentContext", params
+        )
+        browser = cast(
+            Browser,
+            from_channel(result["browser"]),
+        )
+        browser._connect_to_browser_type(
+            self, str(tracesDir) if tracesDir is not None else None
+        )
+        context = cast(BrowserContext, from_channel(result["context"]))
+        await context._initialize_har_from_options(
+            record_har_content=recordHarContent,
+            record_har_mode=recordHarMode,
+            record_har_omit_content=recordHarOmitContent,
+            record_har_path=recordHarPath,
+            record_har_url_filter=recordHarUrlFilter,
         )
-        self._did_create_context(context, params, params)
         return context
 
     def _user_data_dir(self, userDataDir: Optional[Union[str, Path]]) -> str:
@@ -183,18 +197,13 @@ async def connect_over_cdp(
         headers: Dict[str, str] = None,
     ) -> Browser:
         params = locals_to_params(locals())
+        params["timeout"] = TimeoutSettings.launch_timeout(timeout)
         if params.get("headers"):
             params["headers"] = serialize_headers(params["headers"])
         response = await self._channel.send_return_as_dict("connectOverCDP", params)
         browser = cast(Browser, from_channel(response["browser"]))
-        self._did_launch_browser(browser)
+        browser._connect_to_browser_type(self, None)
 
-        default_context = cast(
-            Optional[BrowserContext],
-            from_nullable_channel(response.get("defaultContext")),
-        )
-        if default_context:
-            self._did_create_context(default_context, {}, {})
         return browser
 
     async def connect(
@@ -205,8 +214,6 @@ async def connect(
         headers: Dict[str, str] = None,
         exposeNetwork: str = None,
     ) -> Browser:
-        if timeout is None:
-            timeout = 30000
         if slowMo is None:
             slowMo = 0
 
@@ -219,7 +226,7 @@ async def connect(
                     "wsEndpoint": wsEndpoint,
                     "headers": headers,
                     "slowMo": slowMo,
-                    "timeout": timeout,
+                    "timeout": timeout if timeout is not None else 0,
                     "exposeNetwork": exposeNetwork,
                 },
             )
@@ -259,7 +266,10 @@ def handle_transport_close(reason: Optional[str]) -> None:
         connection._loop.create_task(connection.run())
         playwright_future = connection.playwright_future
 
-        timeout_future = throw_on_timeout(timeout, Error("Connection timed out"))
+        timeout_future = throw_on_timeout(
+            timeout if timeout is not None else PLAYWRIGHT_MAX_DEADLINE,
+            Error("Connection timed out"),
+        )
         done, pending = await asyncio.wait(
             {transport.on_error_future, playwright_future, timeout_future},
             return_when=asyncio.FIRST_COMPLETED,
@@ -274,18 +284,59 @@ def handle_transport_close(reason: Optional[str]) -> None:
         pre_launched_browser = playwright._initializer.get("preLaunchedBrowser")
         assert pre_launched_browser
         browser = cast(Browser, from_channel(pre_launched_browser))
-        self._did_launch_browser(browser)
         browser._should_close_connection_on_close = True
+        browser._connect_to_browser_type(self, None)
 
         return browser
 
-    def _did_create_context(
-        self, context: BrowserContext, context_options: Dict, browser_options: Dict
-    ) -> None:
-        context._set_options(context_options, browser_options)
+    async def _prepare_browser_context_params(self, params: Dict) -> None:
+        if params.get("noViewport"):
+            del params["noViewport"]
+            params["noDefaultViewport"] = True
+        if "defaultBrowserType" in params:
+            del params["defaultBrowserType"]
+        if "extraHTTPHeaders" in params:
+            params["extraHTTPHeaders"] = serialize_headers(params["extraHTTPHeaders"])
+        if "recordVideoDir" in params:
+            params["recordVideo"] = {"dir": Path(params["recordVideoDir"]).absolute()}
+            if "recordVideoSize" in params:
+                params["recordVideo"]["size"] = params["recordVideoSize"]
+                del params["recordVideoSize"]
+            del params["recordVideoDir"]
+        if "storageState" in params:
+            storageState = params["storageState"]
+            if not isinstance(storageState, dict):
+                params["storageState"] = json.loads(
+                    (await async_readfile(storageState)).decode()
+                )
+        if params.get("colorScheme", None) == "null":
+            params["colorScheme"] = "no-override"
+        if params.get("reducedMotion", None) == "null":
+            params["reducedMotion"] = "no-override"
+        if params.get("forcedColors", None) == "null":
+            params["forcedColors"] = "no-override"
+        if params.get("contrast", None) == "null":
+            params["contrast"] = "no-override"
+        if "acceptDownloads" in params:
+            params["acceptDownloads"] = (
+                "accept" if params["acceptDownloads"] else "deny"
+            )
+
+        if "clientCertificates" in params:
+            params["clientCertificates"] = await to_client_certificates_protocol(
+                params["clientCertificates"]
+            )
+        params["selectorEngines"] = self._playwright.selectors._selector_engines
+        params["testIdAttributeName"] = (
+            self._playwright.selectors._test_id_attribute_name
+        )
 
-    def _did_launch_browser(self, browser: Browser) -> None:
-        browser._browser_type = self
+        # Remove HAR options
+        params.pop("recordHarPath", None)
+        params.pop("recordHarOmitContent", None)
+        params.pop("recordHarUrlFilter", None)
+        params.pop("recordHarMode", None)
+        params.pop("recordHarContent", None)
 
 
 def normalize_launch_params(params: Dict) -> None:
@@ -304,3 +355,4 @@ def normalize_launch_params(params: Dict) -> None:
         params["downloadsPath"] = str(Path(params["downloadsPath"]))
     if "tracesDir" in params:
         params["tracesDir"] = str(Path(params["tracesDir"]))
+    params["timeout"] = TimeoutSettings.launch_timeout(params.get("timeout"))
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 1328e7c97..3519aeebd 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -55,26 +55,48 @@ def __init__(self, connection: "Connection", object: "ChannelOwner") -> None:
         self._guid = object._guid
         self._object = object
         self.on("error", lambda exc: self._connection._on_event_listener_error(exc))
-        self._is_internal_type = False
+        self._timeout_calculator: Optional[Callable[[Optional[float]], float]] = None
 
-    async def send(self, method: str, params: Dict = None) -> Any:
+    async def send(
+        self,
+        method: str,
+        params: Dict = None,
+        is_internal: bool = False,
+        title: str = None,
+    ) -> Any:
         return await self._connection.wrap_api_call(
             lambda: self._inner_send(method, params, False),
-            self._is_internal_type,
+            is_internal,
+            title,
         )
 
-    async def send_return_as_dict(self, method: str, params: Dict = None) -> Any:
+    async def send_return_as_dict(
+        self,
+        method: str,
+        params: Dict = None,
+        is_internal: bool = False,
+        title: str = None,
+    ) -> Any:
         return await self._connection.wrap_api_call(
             lambda: self._inner_send(method, params, True),
-            self._is_internal_type,
+            is_internal,
+            title,
         )
 
-    def send_no_reply(self, method: str, params: Dict = None) -> None:
+    def send_no_reply(
+        self,
+        method: str,
+        params: Dict = None,
+        is_internal: bool = False,
+        title: str = None,
+    ) -> None:
         # No reply messages are used to e.g. waitForEventInfo(after).
         self._connection.wrap_api_call_sync(
             lambda: self._connection._send_message_to_server(
                 self._object, method, {} if params is None else params, True
-            )
+            ),
+            is_internal,
+            title,
         )
 
     async def _inner_send(
@@ -82,6 +104,8 @@ async def _inner_send(
     ) -> Any:
         if params is None:
             params = {}
+        if self._timeout_calculator is not None:
+            params["timeout"] = self._timeout_calculator(params.get("timeout"))
         if self._connection._error:
             error = self._connection._error
             self._connection._error = None
@@ -112,8 +136,10 @@ async def _inner_send(
         key = next(iter(result))
         return result[key]
 
-    def mark_as_internal_type(self) -> None:
-        self._is_internal_type = True
+    def _set_timeout_calculator(
+        self, timeout_calculator: Callable[[Optional[float]], float]
+    ) -> None:
+        self._timeout_calculator = timeout_calculator
 
 
 class ChannelOwner(AsyncIOEventEmitter):
@@ -355,6 +381,9 @@ def _send_message_to_server(
         }
         if location:
             metadata["location"] = location  # type: ignore
+        title = stack_trace_information["title"]
+        if title:
+            metadata["title"] = title
         message = {
             "id": id,
             "guid": object._guid,
@@ -507,7 +536,7 @@ def _replace_guids_with_channels(self, payload: Any) -> Any:
         return payload
 
     async def wrap_api_call(
-        self, cb: Callable[[], Any], is_internal: bool = False
+        self, cb: Callable[[], Any], is_internal: bool = False, title: str = None
     ) -> Any:
         if self._api_zone.get():
             return await cb()
@@ -516,7 +545,7 @@ async def wrap_api_call(
             task, "__pw_stack__", None
         ) or inspect.stack(0)
 
-        parsed_st = _extract_stack_trace_information_from_stack(st, is_internal)
+        parsed_st = _extract_stack_trace_information_from_stack(st, is_internal, title)
         self._api_zone.set(parsed_st)
         try:
             return await cb()
@@ -526,7 +555,7 @@ async def wrap_api_call(
             self._api_zone.set(None)
 
     def wrap_api_call_sync(
-        self, cb: Callable[[], Any], is_internal: bool = False
+        self, cb: Callable[[], Any], is_internal: bool = False, title: str = None
     ) -> Any:
         if self._api_zone.get():
             return cb()
@@ -534,7 +563,7 @@ def wrap_api_call_sync(
         st: List[inspect.FrameInfo] = getattr(
             task, "__pw_stack__", None
         ) or inspect.stack(0)
-        parsed_st = _extract_stack_trace_information_from_stack(st, is_internal)
+        parsed_st = _extract_stack_trace_information_from_stack(st, is_internal, title)
         self._api_zone.set(parsed_st)
         try:
             return cb()
@@ -562,10 +591,11 @@ class StackFrame(TypedDict):
 class ParsedStackTrace(TypedDict):
     frames: List[StackFrame]
     apiName: Optional[str]
+    title: Optional[str]
 
 
 def _extract_stack_trace_information_from_stack(
-    st: List[inspect.FrameInfo], is_internal: bool
+    st: List[inspect.FrameInfo], is_internal: bool, title: str = None
 ) -> ParsedStackTrace:
     playwright_module_path = str(Path(playwright.__file__).parents[0])
     last_internal_api_name = ""
@@ -605,11 +635,22 @@ def _extract_stack_trace_information_from_stack(
     return {
         "frames": parsed_frames,
         "apiName": "" if is_internal else api_name,
+        "title": title,
     }
 
 
 def _filter_none(d: Mapping) -> Dict:
-    return {k: v for k, v in d.items() if v is not None}
+    result = {}
+    for k, v in d.items():
+        if v is None:
+            continue
+        elif isinstance(v, dict):
+            filtered_v = _filter_none(v)
+            if filtered_v:
+                result[k] = filtered_v
+        else:
+            result[k] = v
+    return result
 
 
 def format_call_log(log: Optional[List[str]]) -> str:
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index cb3d672d4..fd99c0b00 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -55,6 +55,8 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        self._frame = cast("Frame", parent)
+        self._channel._set_timeout_calculator(self._frame._timeout)
 
     async def _createSelectorForTest(self, name: str) -> Optional[str]:
         return await self._channel.send("createSelectorForTest", dict(name=name))
@@ -204,7 +206,7 @@ async def set_input_files(
         await self._channel.send(
             "setInputFiles",
             {
-                "timeout": timeout,
+                "timeout": self._frame._timeout(timeout),
                 **converted,
             },
         )
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index 88f5810ee..a0120e0cd 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -36,6 +36,7 @@
     Error,
     NameValue,
     TargetClosedError,
+    TimeoutSettings,
     async_readfile,
     async_writefile,
     is_file_payload,
@@ -92,6 +93,7 @@ async def new_context(
             APIRequestContext,
             from_channel(await self.playwright._channel.send("newRequest", params)),
         )
+        context._timeout_settings.set_default_timeout(timeout)
         return context
 
 
@@ -102,6 +104,8 @@ def __init__(
         super().__init__(parent, type, guid, initializer)
         self._tracing: Tracing = from_channel(initializer["tracing"])
         self._close_reason: Optional[str] = None
+        self._timeout_settings = TimeoutSettings(None)
+        self._channel._set_timeout_calculator(self._timeout_settings.timeout)
 
     async def dispose(self, reason: str = None) -> None:
         self._close_reason = reason
@@ -414,7 +418,6 @@ async def _inner_fetch(
                 "jsonData": json_data,
                 "formData": form_data,
                 "multipartData": multipart_data,
-                "timeout": timeout,
                 "failOnStatusCode": failOnStatusCode,
                 "ignoreHTTPSErrors": ignoreHTTPSErrors,
                 "maxRedirects": maxRedirects,
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index d616046e6..fc3c4a54d 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -19,6 +19,7 @@
     Any,
     Dict,
     List,
+    Literal,
     Optional,
     Pattern,
     Sequence,
@@ -42,8 +43,8 @@
     DocumentLoadState,
     FrameNavigatedEvent,
     KeyboardModifier,
-    Literal,
     MouseButton,
+    TimeoutSettings,
     URLMatch,
     async_readfile,
     locals_to_params,
@@ -100,6 +101,7 @@ def __init__(
             "navigated",
             lambda params: self._on_frame_navigated(params),
         )
+        self._channel._set_timeout_calculator(self._timeout)
 
     def __repr__(self) -> str:
         return f"<Frame name={self.name} url={self.url!r}>"
@@ -142,7 +144,9 @@ async def goto(
         return cast(
             Optional[Response],
             from_nullable_channel(
-                await self._channel.send("goto", locals_to_params(locals()))
+                await self._channel.send(
+                    "goto", self._locals_to_params_with_navigation_timeout(locals())
+                )
             ),
         )
 
@@ -163,8 +167,7 @@ def _setup_navigation_waiter(self, wait_name: str, timeout: float = None) -> Wai
             Error("Navigating frame was detached!"),
             lambda frame: frame == self,
         )
-        if timeout is None:
-            timeout = self._page._timeout_settings.navigation_timeout()
+        timeout = self._page._timeout_settings.navigation_timeout(timeout)
         waiter.reject_on_timeout(timeout, f"Timeout {timeout}ms exceeded.")
         return waiter
 
@@ -270,6 +273,18 @@ def handle_load_state_event(actual_state: str) -> bool:
             )
         await waiter.result()
 
+    def _timeout(self, timeout: Optional[float]) -> float:
+        timeout_settings = (
+            self._page._timeout_settings if self._page else TimeoutSettings(None)
+        )
+        return timeout_settings.timeout(timeout)
+
+    def _navigation_timeout(self, timeout: Optional[float]) -> float:
+        timeout_settings = (
+            self._page._timeout_settings if self._page else TimeoutSettings(None)
+        )
+        return timeout_settings.navigation_timeout(timeout)
+
     async def frame_element(self) -> ElementHandle:
         return from_channel(await self._channel.send("frameElement"))
 
@@ -343,14 +358,10 @@ async def is_enabled(
     ) -> bool:
         return await self._channel.send("isEnabled", locals_to_params(locals()))
 
-    async def is_hidden(
-        self, selector: str, strict: bool = None, timeout: float = None
-    ) -> bool:
+    async def is_hidden(self, selector: str, strict: bool = None) -> bool:
         return await self._channel.send("isHidden", locals_to_params(locals()))
 
-    async def is_visible(
-        self, selector: str, strict: bool = None, timeout: float = None
-    ) -> bool:
+    async def is_visible(self, selector: str, strict: bool = None) -> bool:
         return await self._channel.send("isVisible", locals_to_params(locals()))
 
     async def dispatch_event(
@@ -421,7 +432,9 @@ async def set_content(
         timeout: float = None,
         waitUntil: DocumentLoadState = None,
     ) -> None:
-        await self._channel.send("setContent", locals_to_params(locals()))
+        await self._channel.send(
+            "setContent", self._locals_to_params_with_navigation_timeout(locals())
+        )
 
     @property
     def name(self) -> str:
@@ -500,7 +513,9 @@ async def dblclick(
         strict: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("dblclick", locals_to_params(locals()))
+        await self._channel.send(
+            "dblclick", locals_to_params(locals()), title="Double click"
+        )
 
     async def tap(
         self,
@@ -701,7 +716,7 @@ async def set_input_files(
             {
                 "selector": selector,
                 "strict": strict,
-                "timeout": timeout,
+                "timeout": self._timeout(timeout),
                 **converted,
             },
         )
@@ -805,3 +820,8 @@ async def set_checked(
 
     async def _highlight(self, selector: str) -> None:
         await self._channel.send("highlight", {"selector": selector})
+
+    def _locals_to_params_with_navigation_timeout(self, args: Dict) -> Dict:
+        params = locals_to_params(args)
+        params["timeout"] = self._navigation_timeout(params.get("timeout"))
+        return params
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 96acb8857..67a096dc5 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -250,7 +250,21 @@ class HarLookupResult(TypedDict, total=False):
     body: Optional[str]
 
 
+DEFAULT_PLAYWRIGHT_TIMEOUT_IN_MILLISECONDS = 30000
+DEFAULT_PLAYWRIGHT_LAUNCH_TIMEOUT_IN_MILLISECONDS = 180000
+PLAYWRIGHT_MAX_DEADLINE = 2147483647  # 2^31-1
+
+
 class TimeoutSettings:
+
+    @staticmethod
+    def launch_timeout(timeout: Optional[float] = None) -> float:
+        return (
+            timeout
+            if timeout is not None
+            else DEFAULT_PLAYWRIGHT_LAUNCH_TIMEOUT_IN_MILLISECONDS
+        )
+
     def __init__(self, parent: Optional["TimeoutSettings"]) -> None:
         self._parent = parent
         self._default_timeout: Optional[float] = None
@@ -266,7 +280,7 @@ def timeout(self, timeout: float = None) -> float:
             return self._default_timeout
         if self._parent:
             return self._parent.timeout()
-        return 30000
+        return DEFAULT_PLAYWRIGHT_TIMEOUT_IN_MILLISECONDS
 
     def set_default_navigation_timeout(
         self, navigation_timeout: Optional[float]
@@ -279,12 +293,16 @@ def default_navigation_timeout(self) -> Optional[float]:
     def default_timeout(self) -> Optional[float]:
         return self._default_timeout
 
-    def navigation_timeout(self) -> float:
+    def navigation_timeout(self, timeout: float = None) -> float:
+        if timeout is not None:
+            return timeout
         if self._default_navigation_timeout is not None:
             return self._default_navigation_timeout
+        if self._default_timeout is not None:
+            return self._default_timeout
         if self._parent:
             return self._parent.navigation_timeout()
-        return 30000
+        return DEFAULT_PLAYWRIGHT_TIMEOUT_IN_MILLISECONDS
 
 
 def serialize_error(ex: Exception, tb: Optional[TracebackType]) -> ErrorPayload:
diff --git a/playwright/_impl/_input.py b/playwright/_impl/_input.py
index a97ba5d11..0e986ae8c 100644
--- a/playwright/_impl/_input.py
+++ b/playwright/_impl/_input.py
@@ -61,6 +61,17 @@ async def up(
     ) -> None:
         await self._channel.send("mouseUp", locals_to_params(locals()))
 
+    async def _click(
+        self,
+        x: float,
+        y: float,
+        delay: float = None,
+        button: MouseButton = None,
+        clickCount: int = None,
+        title: str = None,
+    ) -> None:
+        await self._channel.send("mouseClick", locals_to_params(locals()), title=title)
+
     async def click(
         self,
         x: float,
@@ -69,7 +80,9 @@ async def click(
         button: MouseButton = None,
         clickCount: int = None,
     ) -> None:
-        await self._channel.send("mouseClick", locals_to_params(locals()))
+        params = locals()
+        del params["self"]
+        await self._click(**params)
 
     async def dblclick(
         self,
@@ -78,7 +91,9 @@ async def dblclick(
         delay: float = None,
         button: MouseButton = None,
     ) -> None:
-        await self.click(x, y, delay=delay, button=button, clickCount=2)
+        await self._click(
+            x, y, delay=delay, button=button, clickCount=2, title="Double click"
+        )
 
     async def wheel(self, deltaX: float, deltaY: float) -> None:
         await self._channel.send("mouseWheel", locals_to_params(locals()))
diff --git a/playwright/_impl/_local_utils.py b/playwright/_impl/_local_utils.py
index 5ea8b644d..7172ee58a 100644
--- a/playwright/_impl/_local_utils.py
+++ b/playwright/_impl/_local_utils.py
@@ -25,7 +25,6 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self._channel.mark_as_internal_type()
         self.devices = {
             device["name"]: parse_device_descriptor(device["descriptor"])
             for device in initializer["deviceDescriptors"]
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 189485f47..9d190c453 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -107,7 +107,7 @@ async def _with_element(
         task: Callable[[ElementHandle, float], Awaitable[T]],
         timeout: float = None,
     ) -> T:
-        timeout = self._frame.page._timeout_settings.timeout(timeout)
+        timeout = self._frame._timeout(timeout)
         deadline = (monotonic_time() + timeout) if timeout else 0
         handle = await self.element_handle(timeout=timeout)
         if not handle:
@@ -336,6 +336,12 @@ def nth(self, index: int) -> "Locator":
     def content_frame(self) -> "FrameLocator":
         return FrameLocator(self._frame, self._selector)
 
+    def describe(self, description: str) -> "Locator":
+        return Locator(
+            self._frame,
+            f"{self._selector} >> internal:describe={json.dumps(description)}",
+        )
+
     def filter(
         self,
         hasText: Union[str, Pattern[str]] = None,
@@ -540,7 +546,7 @@ async def screenshot(
             ),
         )
 
-    async def aria_snapshot(self, timeout: float = None, ref: bool = None) -> str:
+    async def aria_snapshot(self, timeout: float = None) -> str:
         return await self._frame._channel.send(
             "ariaSnapshot",
             {
@@ -711,7 +717,10 @@ async def set_checked(
             )
 
     async def _expect(
-        self, expression: str, options: FrameExpectOptions
+        self,
+        expression: str,
+        options: FrameExpectOptions,
+        title: str = None,
     ) -> FrameExpectResult:
         if "expectedValue" in options:
             options["expectedValue"] = serialize_argument(options["expectedValue"])
@@ -722,6 +731,7 @@ async def _expect(
                 "expression": expression,
                 **options,
             },
+            title=title,
         )
         if result.get("received"):
             result["received"] = parse_value(result["received"])
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 768c22f0c..748967dd8 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -131,7 +131,6 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self._channel.mark_as_internal_type()
         self._redirected_from: Optional["Request"] = from_nullable_channel(
             initializer.get("redirectedFrom")
         )
@@ -292,7 +291,7 @@ async def _actual_headers(self) -> "RawHeaders":
             return RawHeaders(serialize_headers(override))
         if not self._all_headers_future:
             self._all_headers_future = asyncio.Future()
-            headers = await self._channel.send("rawRequestHeaders")
+            headers = await self._channel.send("rawRequestHeaders", is_internal=True)
             self._all_headers_future.set_result(RawHeaders(headers))
         return await self._all_headers_future
 
@@ -319,7 +318,6 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self._channel.mark_as_internal_type()
         self._handling_future: Optional[asyncio.Future["bool"]] = None
         self._context: "BrowserContext" = cast("BrowserContext", None)
         self._did_throw = False
@@ -610,7 +608,6 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self._channel.mark_as_internal_type()
         self._on_page_message: Optional[Callable[[Union[str, bytes]], Any]] = None
         self._on_page_close: Optional[Callable[[Optional[int], Optional[str]], Any]] = (
             None
@@ -768,7 +765,6 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self._channel.mark_as_internal_type()
         self._request: Request = from_channel(self._initializer["request"])
         timing = self._initializer["timing"]
         self._request._timing["startTime"] = timing["startTime"]
diff --git a/playwright/_impl/_object_factory.py b/playwright/_impl/_object_factory.py
index 5f38b781b..b44009bc3 100644
--- a/playwright/_impl/_object_factory.py
+++ b/playwright/_impl/_object_factory.py
@@ -35,7 +35,6 @@
 )
 from playwright._impl._page import BindingCall, Page, Worker
 from playwright._impl._playwright import Playwright
-from playwright._impl._selectors import SelectorsOwner
 from playwright._impl._stream import Stream
 from playwright._impl._tracing import Tracing
 from playwright._impl._writable_stream import WritableStream
@@ -100,6 +99,4 @@ def create_remote_object(
         return Worker(parent, type, guid, initializer)
     if type == "WritableStream":
         return WritableStream(parent, type, guid, initializer)
-    if type == "Selectors":
-        return SelectorsOwner(parent, type, guid, initializer)
     return DummyObject(parent, type, guid, initializer)
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 6327cce70..82b43a231 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -227,6 +227,7 @@ def __init__(
             ),
         )
         self._channel.on("video", lambda params: self._on_video(params))
+        self._channel.on("viewportSizeChanged", self._on_viewport_size_changed)
         self._channel.on(
             "webSocket",
             lambda params: self.emit(
@@ -236,6 +237,7 @@ def __init__(
         self._channel.on(
             "worker", lambda params: self._on_worker(from_channel(params["worker"]))
         )
+        self._channel._set_timeout_calculator(self._timeout_settings.timeout)
         self._closed_or_crashed_future: asyncio.Future = asyncio.Future()
         self.on(
             Page.Events.Close,
@@ -286,7 +288,7 @@ async def _on_route(self, route: Route) -> None:
         route_handlers = self._routes.copy()
         for route_handler in route_handlers:
             # If the page was closed we stall all requests right away.
-            if self._close_was_called or self.context._close_was_called:
+            if self._close_was_called or self.context._closing_or_closed:
                 return
             if not route_handler.matches(route.request.url):
                 continue
@@ -363,6 +365,9 @@ 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"]
+
     @property
     def context(self) -> "BrowserContext":
         return self._browser_context
@@ -397,13 +402,9 @@ def frames(self) -> List[Frame]:
 
     def set_default_navigation_timeout(self, timeout: float) -> None:
         self._timeout_settings.set_default_navigation_timeout(timeout)
-        self._channel.send_no_reply(
-            "setDefaultNavigationTimeoutNoReply", dict(timeout=timeout)
-        )
 
     def set_default_timeout(self, timeout: float) -> None:
         self._timeout_settings.set_default_timeout(timeout)
-        self._channel.send_no_reply("setDefaultTimeoutNoReply", dict(timeout=timeout))
 
     async def query_selector(
         self,
@@ -557,7 +558,9 @@ async def reload(
         waitUntil: DocumentLoadState = None,
     ) -> Optional[Response]:
         return from_nullable_channel(
-            await self._channel.send("reload", locals_to_params(locals()))
+            await self._channel.send(
+                "reload", self._locals_to_params_with_navigation_timeout(locals())
+            )
         )
 
     async def wait_for_load_state(
@@ -588,7 +591,9 @@ async def go_back(
         waitUntil: DocumentLoadState = None,
     ) -> Optional[Response]:
         return from_nullable_channel(
-            await self._channel.send("goBack", locals_to_params(locals()))
+            await self._channel.send(
+                "goBack", self._locals_to_params_with_navigation_timeout(locals())
+            )
         )
 
     async def go_forward(
@@ -597,7 +602,9 @@ async def go_forward(
         waitUntil: DocumentLoadState = None,
     ) -> Optional[Response]:
         return from_nullable_channel(
-            await self._channel.send("goForward", locals_to_params(locals()))
+            await self._channel.send(
+                "goForward", self._locals_to_params_with_navigation_timeout(locals())
+            )
         )
 
     async def request_gc(self) -> None:
@@ -1400,6 +1407,13 @@ async def remove_locator_handler(self, locator: "Locator") -> None:
                 del self._locator_handlers[uid]
                 self._channel.send_no_reply("unregisterLocatorHandler", {"uid": uid})
 
+    def _locals_to_params_with_navigation_timeout(self, args: Dict) -> Dict:
+        params = locals_to_params(args)
+        params["timeout"] = self._timeout_settings.navigation_timeout(
+            params.get("timeout")
+        )
+        return params
+
 
 class Worker(ChannelOwner):
     Events = SimpleNamespace(Close="close")
diff --git a/playwright/_impl/_playwright.py b/playwright/_impl/_playwright.py
index c02e73316..5c0151158 100644
--- a/playwright/_impl/_playwright.py
+++ b/playwright/_impl/_playwright.py
@@ -17,7 +17,7 @@
 from playwright._impl._browser_type import BrowserType
 from playwright._impl._connection import ChannelOwner, from_channel
 from playwright._impl._fetch import APIRequest
-from playwright._impl._selectors import Selectors, SelectorsOwner
+from playwright._impl._selectors import Selectors
 
 
 class Playwright(ChannelOwner):
@@ -41,12 +41,7 @@ def __init__(
         self.webkit._playwright = self
 
         self.selectors = Selectors(self._loop, self._dispatcher_fiber)
-        selectors_owner: SelectorsOwner = from_channel(initializer["selectors"])
-        self.selectors._add_channel(selectors_owner)
 
-        self._connection.on(
-            "close", lambda: self.selectors._remove_channel(selectors_owner)
-        )
         self.devices = self._connection.local_utils.devices
 
     def __getitem__(self, value: str) -> "BrowserType":
@@ -59,10 +54,7 @@ def __getitem__(self, value: str) -> "BrowserType":
         raise ValueError("Invalid browser " + value)
 
     def _set_selectors(self, selectors: Selectors) -> None:
-        selectors_owner = from_channel(self._initializer["selectors"])
-        self.selectors._remove_channel(selectors_owner)
         self.selectors = selectors
-        self.selectors._add_channel(selectors_owner)
 
     async def stop(self) -> None:
         pass
diff --git a/playwright/_impl/_selectors.py b/playwright/_impl/_selectors.py
index cf8af8c06..b0cf5afbb 100644
--- a/playwright/_impl/_selectors.py
+++ b/playwright/_impl/_selectors.py
@@ -14,20 +14,21 @@
 
 import asyncio
 from pathlib import Path
-from typing import Any, Dict, List, Set, Union
+from typing import Any, Dict, List, Optional, Set, Union
 
-from playwright._impl._connection import ChannelOwner
+from playwright._impl._browser_context import BrowserContext
 from playwright._impl._errors import Error
 from playwright._impl._helper import async_readfile
-from playwright._impl._locator import set_test_id_attribute_name, test_id_attribute_name
+from playwright._impl._locator import set_test_id_attribute_name
 
 
 class Selectors:
     def __init__(self, loop: asyncio.AbstractEventLoop, dispatcher_fiber: Any) -> None:
         self._loop = loop
-        self._channels: Set[SelectorsOwner] = set()
-        self._registrations: List[Dict] = []
+        self._contexts_for_selectors: Set[BrowserContext] = set()
+        self._selector_engines: List[Dict] = []
         self._dispatcher_fiber = dispatcher_fiber
+        self._test_id_attribute_name: Optional[str] = None
 
     async def register(
         self,
@@ -40,37 +41,19 @@ async def register(
             raise Error("Either source or path should be specified")
         if path:
             script = (await async_readfile(path)).decode()
-        params: Dict[str, Any] = dict(name=name, source=script)
+        engine: Dict[str, Any] = dict(name=name, source=script)
         if contentScript:
-            params["contentScript"] = True
-        for channel in self._channels:
-            await channel._channel.send("register", params)
-        self._registrations.append(params)
+            engine["contentScript"] = contentScript
+        for context in self._contexts_for_selectors:
+            await context._channel.send(
+                "registerSelectorEngine", {"selectorEngine": engine}
+            )
+        self._selector_engines.append(engine)
 
     def set_test_id_attribute(self, attributeName: str) -> None:
         set_test_id_attribute_name(attributeName)
-        for channel in self._channels:
-            channel._channel.send_no_reply(
+        self._test_id_attribute_name = attributeName
+        for context in self._contexts_for_selectors:
+            context._channel.send_no_reply(
                 "setTestIdAttributeName", {"testIdAttributeName": attributeName}
             )
-
-    def _add_channel(self, channel: "SelectorsOwner") -> None:
-        self._channels.add(channel)
-        for params in self._registrations:
-            # This should not fail except for connection closure, but just in case we catch.
-            channel._channel.send_no_reply("register", params)
-            channel._channel.send_no_reply(
-                "setTestIdAttributeName",
-                {"testIdAttributeName": test_id_attribute_name()},
-            )
-
-    def _remove_channel(self, channel: "SelectorsOwner") -> None:
-        if channel in self._channels:
-            self._channels.remove(channel)
-
-
-class SelectorsOwner(ChannelOwner):
-    def __init__(
-        self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
-    ) -> None:
-        super().__init__(parent, type, guid, initializer)
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index a68b53bf7..e984bcbad 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -26,7 +26,6 @@ def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
-        self._channel.mark_as_internal_type()
         self._include_sources: bool = False
         self._stacks_id: Optional[str] = None
         self._is_tracing: bool = False
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index b622ab858..5f0af8bf0 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -674,7 +674,7 @@ async def fulfill(
         headers: typing.Optional[typing.Dict[str, str]] = None,
         body: typing.Optional[typing.Union[str, bytes]] = None,
         json: typing.Optional[typing.Any] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content_type: typing.Optional[str] = None,
         response: typing.Optional["APIResponse"] = None,
     ) -> None:
@@ -2770,7 +2770,7 @@ async def screenshot(
         *,
         timeout: typing.Optional[float] = None,
         type: typing.Optional[Literal["jpeg", "png"]] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         quality: typing.Optional[int] = None,
         omit_background: typing.Optional[bool] = None,
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
@@ -3918,11 +3918,7 @@ async def is_enabled(
         )
 
     async def is_hidden(
-        self,
-        selector: str,
-        *,
-        strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None,
+        self, selector: str, *, strict: typing.Optional[bool] = None
     ) -> bool:
         """Frame.is_hidden
 
@@ -3937,8 +3933,6 @@ async def is_hidden(
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
-        timeout : Union[float, None]
-            Deprecated: This option is ignored. `frame.is_hidden()` does not wait for the element to become hidden and returns immediately.
 
         Returns
         -------
@@ -3946,17 +3940,11 @@ async def is_hidden(
         """
 
         return mapping.from_maybe_impl(
-            await self._impl_obj.is_hidden(
-                selector=selector, strict=strict, timeout=timeout
-            )
+            await self._impl_obj.is_hidden(selector=selector, strict=strict)
         )
 
     async def is_visible(
-        self,
-        selector: str,
-        *,
-        strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None,
+        self, selector: str, *, strict: typing.Optional[bool] = None
     ) -> bool:
         """Frame.is_visible
 
@@ -3971,8 +3959,6 @@ async def is_visible(
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
-        timeout : Union[float, None]
-            Deprecated: This option is ignored. `frame.is_visible()` does not wait for the element to become visible and returns immediately.
 
         Returns
         -------
@@ -3980,9 +3966,7 @@ async def is_visible(
         """
 
         return mapping.from_maybe_impl(
-            await self._impl_obj.is_visible(
-                selector=selector, strict=strict, timeout=timeout
-            )
+            await self._impl_obj.is_visible(selector=selector, strict=strict)
         )
 
     async def dispatch_event(
@@ -4216,7 +4200,7 @@ async def add_script_tag(
         self,
         *,
         url: typing.Optional[str] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content: typing.Optional[str] = None,
         type: typing.Optional[str] = None,
     ) -> "ElementHandle":
@@ -4254,7 +4238,7 @@ async def add_style_tag(
         self,
         *,
         url: typing.Optional[str] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Frame.add_style_tag
@@ -4576,8 +4560,8 @@ def locator(
         self,
         selector: str,
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        has_not_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
@@ -4844,7 +4828,7 @@ def get_by_role(
         expanded: typing.Optional[bool] = None,
         include_hidden: typing.Optional[bool] = None,
         level: typing.Optional[int] = None,
-        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        name: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
         exact: typing.Optional[bool] = None,
@@ -6061,8 +6045,8 @@ def locator(
         self,
         selector_or_locator: typing.Union["Locator", str],
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        has_not_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
@@ -6326,7 +6310,7 @@ def get_by_role(
         expanded: typing.Optional[bool] = None,
         include_hidden: typing.Optional[bool] = None,
         level: typing.Optional[int] = None,
-        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        name: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
         exact: typing.Optional[bool] = None,
@@ -6722,7 +6706,7 @@ async def register(
         name: str,
         script: typing.Optional[str] = None,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content_script: typing.Optional[bool] = None,
     ) -> None:
         """Selectors.register
@@ -8662,7 +8646,7 @@ async def add_script_tag(
         self,
         *,
         url: typing.Optional[str] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content: typing.Optional[str] = None,
         type: typing.Optional[str] = None,
     ) -> "ElementHandle":
@@ -8699,7 +8683,7 @@ async def add_style_tag(
         self,
         *,
         url: typing.Optional[str] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Page.add_style_tag
@@ -9385,7 +9369,7 @@ async def add_init_script(
         self,
         script: typing.Optional[str] = None,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
     ) -> None:
         """Page.add_init_script
 
@@ -9607,7 +9591,7 @@ async def route_from_har(
         self,
         har: typing.Union[pathlib.Path, str],
         *,
-        url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        url: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
         update_content: typing.Optional[Literal["attach", "embed"]] = None,
@@ -9663,7 +9647,7 @@ async def screenshot(
         *,
         timeout: typing.Optional[float] = None,
         type: typing.Optional[Literal["jpeg", "png"]] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         quality: typing.Optional[int] = None,
         omit_background: typing.Optional[bool] = None,
         full_page: typing.Optional[bool] = None,
@@ -10097,8 +10081,8 @@ def locator(
         self,
         selector: str,
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        has_not_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
@@ -10363,7 +10347,7 @@ def get_by_role(
         expanded: typing.Optional[bool] = None,
         include_hidden: typing.Optional[bool] = None,
         level: typing.Optional[int] = None,
-        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        name: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
         exact: typing.Optional[bool] = None,
@@ -11512,7 +11496,7 @@ async def pdf(
         height: typing.Optional[typing.Union[str, float]] = None,
         prefer_css_page_size: typing.Optional[bool] = None,
         margin: typing.Optional[PdfMargins] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         outline: typing.Optional[bool] = None,
         tagged: typing.Optional[bool] = None,
     ) -> bytes:
@@ -12836,9 +12820,9 @@ async def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
     async def clear_cookies(
         self,
         *,
-        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        domain: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        path: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        name: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        domain: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        path: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
     ) -> None:
         """BrowserContext.clear_cookies
 
@@ -12991,7 +12975,7 @@ async def add_init_script(
         self,
         script: typing.Optional[str] = None,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
     ) -> None:
         """BrowserContext.add_init_script
 
@@ -13340,7 +13324,7 @@ async def route_from_har(
         self,
         har: typing.Union[pathlib.Path, str],
         *,
-        url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        url: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
         update_content: typing.Optional[Literal["attach", "embed"]] = None,
@@ -13450,7 +13434,7 @@ async def close(self, *, reason: typing.Optional[str] = None) -> None:
     async def storage_state(
         self,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         indexed_db: typing.Optional[bool] = None,
     ) -> StorageState:
         """BrowserContext.storage_state
@@ -13752,9 +13736,9 @@ async def new_context(
         accept_downloads: typing.Optional[bool] = None,
         default_browser_type: typing.Optional[str] = None,
         proxy: typing.Optional[ProxySettings] = None,
-        record_har_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_har_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_har_omit_content: typing.Optional[bool] = None,
-        record_video_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_video_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_video_size: typing.Optional[ViewportSize] = None,
         storage_state: typing.Optional[
             typing.Union[StorageState, str, pathlib.Path]
@@ -13763,7 +13747,7 @@ async def new_context(
         strict_selectors: typing.Optional[bool] = None,
         service_workers: typing.Optional[Literal["allow", "block"]] = None,
         record_har_url_filter: typing.Optional[
-            typing.Union[str, typing.Pattern[str]]
+            typing.Union[typing.Pattern[str], str]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
@@ -13999,9 +13983,9 @@ async def new_page(
         accept_downloads: typing.Optional[bool] = None,
         default_browser_type: typing.Optional[str] = None,
         proxy: typing.Optional[ProxySettings] = None,
-        record_har_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_har_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_har_omit_content: typing.Optional[bool] = None,
-        record_video_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_video_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_video_size: typing.Optional[ViewportSize] = None,
         storage_state: typing.Optional[
             typing.Union[StorageState, str, pathlib.Path]
@@ -14010,7 +13994,7 @@ async def new_page(
         strict_selectors: typing.Optional[bool] = None,
         service_workers: typing.Optional[Literal["allow", "block"]] = None,
         record_har_url_filter: typing.Optional[
-            typing.Union[str, typing.Pattern[str]]
+            typing.Union[typing.Pattern[str], str]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
@@ -14240,7 +14224,7 @@ async def start_tracing(
         self,
         *,
         page: typing.Optional["Page"] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         screenshots: typing.Optional[bool] = None,
         categories: typing.Optional[typing.Sequence[str]] = None,
     ) -> None:
@@ -14333,7 +14317,7 @@ def executable_path(self) -> str:
     async def launch(
         self,
         *,
-        executable_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        executable_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         channel: typing.Optional[str] = None,
         args: typing.Optional[typing.Sequence[str]] = None,
         ignore_default_args: typing.Optional[
@@ -14347,9 +14331,9 @@ async def launch(
         headless: typing.Optional[bool] = None,
         devtools: typing.Optional[bool] = None,
         proxy: typing.Optional[ProxySettings] = None,
-        downloads_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        downloads_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         slow_mo: typing.Optional[float] = None,
-        traces_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        traces_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]]
@@ -14442,6 +14426,9 @@ async def launch(
             Firefox user preferences. Learn more about the Firefox user preferences at
             [`about:config`](https://support.mozilla.org/en-US/kb/about-config-editor-firefox).
 
+            You can also provide a path to a custom [`policies.json` file](https://mozilla.github.io/policy-templates/) via
+            `PLAYWRIGHT_FIREFOX_POLICIES_JSON` environment variable.
+
         Returns
         -------
         Browser
@@ -14474,7 +14461,7 @@ async def launch_persistent_context(
         user_data_dir: typing.Union[str, pathlib.Path],
         *,
         channel: typing.Optional[str] = None,
-        executable_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        executable_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         args: typing.Optional[typing.Sequence[str]] = None,
         ignore_default_args: typing.Optional[
             typing.Union[bool, typing.Sequence[str]]
@@ -14487,7 +14474,7 @@ async def launch_persistent_context(
         headless: typing.Optional[bool] = None,
         devtools: typing.Optional[bool] = None,
         proxy: typing.Optional[ProxySettings] = None,
-        downloads_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        downloads_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         slow_mo: typing.Optional[float] = None,
         viewport: typing.Optional[ViewportSize] = None,
         screen: typing.Optional[ViewportSize] = None,
@@ -14515,20 +14502,20 @@ async def launch_persistent_context(
         forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
         contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
-        traces_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        traces_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]]
         ] = None,
-        record_har_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_har_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_har_omit_content: typing.Optional[bool] = None,
-        record_video_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_video_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_video_size: typing.Optional[ViewportSize] = None,
         base_url: typing.Optional[str] = None,
         strict_selectors: typing.Optional[bool] = None,
         service_workers: typing.Optional[Literal["allow", "block"]] = None,
         record_har_url_filter: typing.Optional[
-            typing.Union[str, typing.Pattern[str]]
+            typing.Union[typing.Pattern[str], str]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
@@ -14673,6 +14660,9 @@ async def launch_persistent_context(
         firefox_user_prefs : Union[Dict[str, Union[bool, float, str]], None]
             Firefox user preferences. Learn more about the Firefox user preferences at
             [`about:config`](https://support.mozilla.org/en-US/kb/about-config-editor-firefox).
+
+            You can also provide a path to a custom [`policies.json` file](https://mozilla.github.io/policy-templates/) via
+            `PLAYWRIGHT_FIREFOX_POLICIES_JSON` environment variable.
         record_har_path : Union[pathlib.Path, str, None]
             Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
             on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
@@ -15047,6 +15037,15 @@ async def start(
 
         Start tracing.
 
+        **NOTE** You probably want to
+        [enable tracing in your config file](https://playwright.dev/docs/api/class-testoptions#test-options-trace) instead
+        of using `Tracing.start`.
+
+        The `context.tracing` API captures browser operations and network activity, but it doesn't record test assertions
+        (like `expect` calls). We recommend
+        [enabling tracing through Playwright Test configuration](https://playwright.dev/docs/api/class-testoptions#test-options-trace),
+        which includes those assertions and provides a more complete trace for debugging test failures.
+
         **Usage**
 
         ```py
@@ -15126,7 +15125,7 @@ async def start_chunk(
         )
 
     async def stop_chunk(
-        self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        self, *, path: typing.Optional[typing.Union[pathlib.Path, str]] = None
     ) -> None:
         """Tracing.stop_chunk
 
@@ -15141,7 +15140,7 @@ async def stop_chunk(
         return mapping.from_maybe_impl(await self._impl_obj.stop_chunk(path=path))
 
     async def stop(
-        self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        self, *, path: typing.Optional[typing.Union[pathlib.Path, str]] = None
     ) -> None:
         """Tracing.stop
 
@@ -15627,6 +15626,13 @@ async def evaluate(
 
         **Usage**
 
+        Passing argument to `expression`:
+
+        ```py
+        result = await page.get_by_testid(\"myId\").evaluate(\"(element, [x, y]) => element.textContent + ' ' + x * y\", [7, 8])
+        print(result) # prints \"myId text 56\"
+        ```
+
         Parameters
         ----------
         expression : str
@@ -15838,8 +15844,8 @@ def locator(
         self,
         selector_or_locator: typing.Union[str, "Locator"],
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        has_not_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
@@ -16103,7 +16109,7 @@ def get_by_role(
         expanded: typing.Optional[bool] = None,
         include_hidden: typing.Optional[bool] = None,
         level: typing.Optional[int] = None,
-        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        name: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
         exact: typing.Optional[bool] = None,
@@ -16433,11 +16439,36 @@ def nth(self, index: int) -> "Locator":
 
         return mapping.from_impl(self._impl_obj.nth(index=index))
 
+    def describe(self, description: str) -> "Locator":
+        """Locator.describe
+
+        Describes the locator, description is used in the trace viewer and reports. Returns the locator pointing to the
+        same element.
+
+        **Usage**
+
+        ```py
+        button = page.get_by_test_id(\"btn-sub\").describe(\"Subscribe button\")
+        await button.click()
+        ```
+
+        Parameters
+        ----------
+        description : str
+            Locator description.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.describe(description=description))
+
     def filter(
         self,
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        has_not_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
         visible: typing.Optional[bool] = None,
@@ -17117,7 +17148,7 @@ async def screenshot(
         *,
         timeout: typing.Optional[float] = None,
         type: typing.Optional[Literal["jpeg", "png"]] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         quality: typing.Optional[int] = None,
         omit_background: typing.Optional[bool] = None,
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
@@ -17220,12 +17251,7 @@ async def screenshot(
             )
         )
 
-    async def aria_snapshot(
-        self,
-        *,
-        timeout: typing.Optional[float] = None,
-        ref: typing.Optional[bool] = None,
-    ) -> str:
+    async def aria_snapshot(self, *, timeout: typing.Optional[float] = 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
@@ -17270,9 +17296,6 @@ async def aria_snapshot(
         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.
-        ref : Union[bool, None]
-            Generate symbolic reference for each element. One can use `aria-ref=<ref>` locator immediately after capturing the
-            snapshot to perform actions on the element.
 
         Returns
         -------
@@ -17280,7 +17303,7 @@ async def aria_snapshot(
         """
 
         return mapping.from_maybe_impl(
-            await self._impl_obj.aria_snapshot(timeout=timeout, ref=ref)
+            await self._impl_obj.aria_snapshot(timeout=timeout)
         )
 
     async def scroll_into_view_if_needed(
@@ -18667,7 +18690,7 @@ async def fetch(
     async def storage_state(
         self,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         indexed_db: typing.Optional[bool] = None,
     ) -> StorageState:
         """APIRequestContext.storage_state
@@ -19175,7 +19198,7 @@ async def to_have_class(
         ```py
         from playwright.async_api import expect
 
-        locator = page.locator(\"list > .component\")
+        locator = page.locator(\".list > .component\")
         await expect(locator).to_have_class([\"component\", \"component selected\", \"component\"])
         ```
 
@@ -19256,7 +19279,7 @@ async def to_contain_class(
         expected class lists. Each element's class attribute is matched against the corresponding class in the array:
 
         ```html
-        <div class='list'></div>
+        <div class='list'>
           <div class='component inactive'></div>
           <div class='component active'></div>
           <div class='component inactive'></div>
@@ -19266,7 +19289,7 @@ async def to_contain_class(
         ```py
         from playwright.async_api import expect
 
-        locator = page.locator(\"list > .component\")
+        locator = page.locator(\".list > .component\")
         await expect(locator).to_contain_class([\"inactive\", \"active\", \"inactive\"])
         ```
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 828636efe..763df6de3 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -682,7 +682,7 @@ def fulfill(
         headers: typing.Optional[typing.Dict[str, str]] = None,
         body: typing.Optional[typing.Union[str, bytes]] = None,
         json: typing.Optional[typing.Any] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content_type: typing.Optional[str] = None,
         response: typing.Optional["APIResponse"] = None,
     ) -> None:
@@ -2804,7 +2804,7 @@ def screenshot(
         *,
         timeout: typing.Optional[float] = None,
         type: typing.Optional[Literal["jpeg", "png"]] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         quality: typing.Optional[int] = None,
         omit_background: typing.Optional[bool] = None,
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
@@ -3980,13 +3980,7 @@ def is_enabled(
             )
         )
 
-    def is_hidden(
-        self,
-        selector: str,
-        *,
-        strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None,
-    ) -> bool:
+    def is_hidden(self, selector: str, *, strict: typing.Optional[bool] = None) -> bool:
         """Frame.is_hidden
 
         Returns whether the element is hidden, the opposite of [visible](https://playwright.dev/python/docs/actionability#visible).  `selector` that
@@ -4000,8 +3994,6 @@ def is_hidden(
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
-        timeout : Union[float, None]
-            Deprecated: This option is ignored. `frame.is_hidden()` does not wait for the element to become hidden and returns immediately.
 
         Returns
         -------
@@ -4009,19 +4001,11 @@ def is_hidden(
         """
 
         return mapping.from_maybe_impl(
-            self._sync(
-                self._impl_obj.is_hidden(
-                    selector=selector, strict=strict, timeout=timeout
-                )
-            )
+            self._sync(self._impl_obj.is_hidden(selector=selector, strict=strict))
         )
 
     def is_visible(
-        self,
-        selector: str,
-        *,
-        strict: typing.Optional[bool] = None,
-        timeout: typing.Optional[float] = None,
+        self, selector: str, *, strict: typing.Optional[bool] = None
     ) -> bool:
         """Frame.is_visible
 
@@ -4036,8 +4020,6 @@ def is_visible(
         strict : Union[bool, None]
             When true, the call requires selector to resolve to a single element. If given selector resolves to more than one
             element, the call throws an exception.
-        timeout : Union[float, None]
-            Deprecated: This option is ignored. `frame.is_visible()` does not wait for the element to become visible and returns immediately.
 
         Returns
         -------
@@ -4045,11 +4027,7 @@ def is_visible(
         """
 
         return mapping.from_maybe_impl(
-            self._sync(
-                self._impl_obj.is_visible(
-                    selector=selector, strict=strict, timeout=timeout
-                )
-            )
+            self._sync(self._impl_obj.is_visible(selector=selector, strict=strict))
         )
 
     def dispatch_event(
@@ -4291,7 +4269,7 @@ def add_script_tag(
         self,
         *,
         url: typing.Optional[str] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content: typing.Optional[str] = None,
         type: typing.Optional[str] = None,
     ) -> "ElementHandle":
@@ -4331,7 +4309,7 @@ def add_style_tag(
         self,
         *,
         url: typing.Optional[str] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Frame.add_style_tag
@@ -4663,8 +4641,8 @@ def locator(
         self,
         selector: str,
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        has_not_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
@@ -4931,7 +4909,7 @@ def get_by_role(
         expanded: typing.Optional[bool] = None,
         include_hidden: typing.Optional[bool] = None,
         level: typing.Optional[int] = None,
-        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        name: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
         exact: typing.Optional[bool] = None,
@@ -6175,8 +6153,8 @@ def locator(
         self,
         selector_or_locator: typing.Union["Locator", str],
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        has_not_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
@@ -6440,7 +6418,7 @@ def get_by_role(
         expanded: typing.Optional[bool] = None,
         include_hidden: typing.Optional[bool] = None,
         level: typing.Optional[int] = None,
-        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        name: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
         exact: typing.Optional[bool] = None,
@@ -6834,7 +6812,7 @@ def register(
         name: str,
         script: typing.Optional[str] = None,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content_script: typing.Optional[bool] = None,
     ) -> None:
         """Selectors.register
@@ -8691,7 +8669,7 @@ def add_script_tag(
         self,
         *,
         url: typing.Optional[str] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content: typing.Optional[str] = None,
         type: typing.Optional[str] = None,
     ) -> "ElementHandle":
@@ -8730,7 +8708,7 @@ def add_style_tag(
         self,
         *,
         url: typing.Optional[str] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         content: typing.Optional[str] = None,
     ) -> "ElementHandle":
         """Page.add_style_tag
@@ -9428,7 +9406,7 @@ def add_init_script(
         self,
         script: typing.Optional[str] = None,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
     ) -> None:
         """Page.add_init_script
 
@@ -9656,7 +9634,7 @@ def route_from_har(
         self,
         har: typing.Union[pathlib.Path, str],
         *,
-        url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        url: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
         update_content: typing.Optional[Literal["attach", "embed"]] = None,
@@ -9714,7 +9692,7 @@ def screenshot(
         *,
         timeout: typing.Optional[float] = None,
         type: typing.Optional[Literal["jpeg", "png"]] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         quality: typing.Optional[int] = None,
         omit_background: typing.Optional[bool] = None,
         full_page: typing.Optional[bool] = None,
@@ -10160,8 +10138,8 @@ def locator(
         self,
         selector: str,
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        has_not_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
@@ -10426,7 +10404,7 @@ def get_by_role(
         expanded: typing.Optional[bool] = None,
         include_hidden: typing.Optional[bool] = None,
         level: typing.Optional[int] = None,
-        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        name: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
         exact: typing.Optional[bool] = None,
@@ -11600,7 +11578,7 @@ def pdf(
         height: typing.Optional[typing.Union[str, float]] = None,
         prefer_css_page_size: typing.Optional[bool] = None,
         margin: typing.Optional[PdfMargins] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         outline: typing.Optional[bool] = None,
         tagged: typing.Optional[bool] = None,
     ) -> bytes:
@@ -12864,9 +12842,9 @@ def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
     def clear_cookies(
         self,
         *,
-        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        domain: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        path: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        name: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        domain: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        path: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
     ) -> None:
         """BrowserContext.clear_cookies
 
@@ -13021,7 +12999,7 @@ def add_init_script(
         self,
         script: typing.Optional[str] = None,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
     ) -> None:
         """BrowserContext.add_init_script
 
@@ -13375,7 +13353,7 @@ def route_from_har(
         self,
         har: typing.Union[pathlib.Path, str],
         *,
-        url: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        url: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         not_found: typing.Optional[Literal["abort", "fallback"]] = None,
         update: typing.Optional[bool] = None,
         update_content: typing.Optional[Literal["attach", "embed"]] = None,
@@ -13487,7 +13465,7 @@ def close(self, *, reason: typing.Optional[str] = None) -> None:
     def storage_state(
         self,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         indexed_db: typing.Optional[bool] = None,
     ) -> StorageState:
         """BrowserContext.storage_state
@@ -13789,9 +13767,9 @@ def new_context(
         accept_downloads: typing.Optional[bool] = None,
         default_browser_type: typing.Optional[str] = None,
         proxy: typing.Optional[ProxySettings] = None,
-        record_har_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_har_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_har_omit_content: typing.Optional[bool] = None,
-        record_video_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_video_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_video_size: typing.Optional[ViewportSize] = None,
         storage_state: typing.Optional[
             typing.Union[StorageState, str, pathlib.Path]
@@ -13800,7 +13778,7 @@ def new_context(
         strict_selectors: typing.Optional[bool] = None,
         service_workers: typing.Optional[Literal["allow", "block"]] = None,
         record_har_url_filter: typing.Optional[
-            typing.Union[str, typing.Pattern[str]]
+            typing.Union[typing.Pattern[str], str]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
@@ -14038,9 +14016,9 @@ def new_page(
         accept_downloads: typing.Optional[bool] = None,
         default_browser_type: typing.Optional[str] = None,
         proxy: typing.Optional[ProxySettings] = None,
-        record_har_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_har_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_har_omit_content: typing.Optional[bool] = None,
-        record_video_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_video_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_video_size: typing.Optional[ViewportSize] = None,
         storage_state: typing.Optional[
             typing.Union[StorageState, str, pathlib.Path]
@@ -14049,7 +14027,7 @@ def new_page(
         strict_selectors: typing.Optional[bool] = None,
         service_workers: typing.Optional[Literal["allow", "block"]] = None,
         record_har_url_filter: typing.Optional[
-            typing.Union[str, typing.Pattern[str]]
+            typing.Union[typing.Pattern[str], str]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
@@ -14281,7 +14259,7 @@ def start_tracing(
         self,
         *,
         page: typing.Optional["Page"] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         screenshots: typing.Optional[bool] = None,
         categories: typing.Optional[typing.Sequence[str]] = None,
     ) -> None:
@@ -14376,7 +14354,7 @@ def executable_path(self) -> str:
     def launch(
         self,
         *,
-        executable_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        executable_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         channel: typing.Optional[str] = None,
         args: typing.Optional[typing.Sequence[str]] = None,
         ignore_default_args: typing.Optional[
@@ -14390,9 +14368,9 @@ def launch(
         headless: typing.Optional[bool] = None,
         devtools: typing.Optional[bool] = None,
         proxy: typing.Optional[ProxySettings] = None,
-        downloads_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        downloads_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         slow_mo: typing.Optional[float] = None,
-        traces_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        traces_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]]
@@ -14485,6 +14463,9 @@ def launch(
             Firefox user preferences. Learn more about the Firefox user preferences at
             [`about:config`](https://support.mozilla.org/en-US/kb/about-config-editor-firefox).
 
+            You can also provide a path to a custom [`policies.json` file](https://mozilla.github.io/policy-templates/) via
+            `PLAYWRIGHT_FIREFOX_POLICIES_JSON` environment variable.
+
         Returns
         -------
         Browser
@@ -14519,7 +14500,7 @@ def launch_persistent_context(
         user_data_dir: typing.Union[str, pathlib.Path],
         *,
         channel: typing.Optional[str] = None,
-        executable_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        executable_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         args: typing.Optional[typing.Sequence[str]] = None,
         ignore_default_args: typing.Optional[
             typing.Union[bool, typing.Sequence[str]]
@@ -14532,7 +14513,7 @@ def launch_persistent_context(
         headless: typing.Optional[bool] = None,
         devtools: typing.Optional[bool] = None,
         proxy: typing.Optional[ProxySettings] = None,
-        downloads_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        downloads_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         slow_mo: typing.Optional[float] = None,
         viewport: typing.Optional[ViewportSize] = None,
         screen: typing.Optional[ViewportSize] = None,
@@ -14560,20 +14541,20 @@ def launch_persistent_context(
         forced_colors: typing.Optional[Literal["active", "none", "null"]] = None,
         contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
-        traces_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        traces_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]]
         ] = None,
-        record_har_path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_har_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_har_omit_content: typing.Optional[bool] = None,
-        record_video_dir: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        record_video_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         record_video_size: typing.Optional[ViewportSize] = None,
         base_url: typing.Optional[str] = None,
         strict_selectors: typing.Optional[bool] = None,
         service_workers: typing.Optional[Literal["allow", "block"]] = None,
         record_har_url_filter: typing.Optional[
-            typing.Union[str, typing.Pattern[str]]
+            typing.Union[typing.Pattern[str], str]
         ] = None,
         record_har_mode: typing.Optional[Literal["full", "minimal"]] = None,
         record_har_content: typing.Optional[Literal["attach", "embed", "omit"]] = None,
@@ -14718,6 +14699,9 @@ def launch_persistent_context(
         firefox_user_prefs : Union[Dict[str, Union[bool, float, str]], None]
             Firefox user preferences. Learn more about the Firefox user preferences at
             [`about:config`](https://support.mozilla.org/en-US/kb/about-config-editor-firefox).
+
+            You can also provide a path to a custom [`policies.json` file](https://mozilla.github.io/policy-templates/) via
+            `PLAYWRIGHT_FIREFOX_POLICIES_JSON` environment variable.
         record_har_path : Union[pathlib.Path, str, None]
             Enables [HAR](http://www.softwareishard.com/blog/har-12-spec) recording for all pages into the specified HAR file
             on the filesystem. If not specified, the HAR is not recorded. Make sure to call `browser_context.close()`
@@ -15095,6 +15079,15 @@ def start(
 
         Start tracing.
 
+        **NOTE** You probably want to
+        [enable tracing in your config file](https://playwright.dev/docs/api/class-testoptions#test-options-trace) instead
+        of using `Tracing.start`.
+
+        The `context.tracing` API captures browser operations and network activity, but it doesn't record test assertions
+        (like `expect` calls). We recommend
+        [enabling tracing through Playwright Test configuration](https://playwright.dev/docs/api/class-testoptions#test-options-trace),
+        which includes those assertions and provides a more complete trace for debugging test failures.
+
         **Usage**
 
         ```py
@@ -15176,7 +15169,7 @@ def start_chunk(
         )
 
     def stop_chunk(
-        self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        self, *, path: typing.Optional[typing.Union[pathlib.Path, str]] = None
     ) -> None:
         """Tracing.stop_chunk
 
@@ -15191,7 +15184,7 @@ def stop_chunk(
         return mapping.from_maybe_impl(self._sync(self._impl_obj.stop_chunk(path=path)))
 
     def stop(
-        self, *, path: typing.Optional[typing.Union[str, pathlib.Path]] = None
+        self, *, path: typing.Optional[typing.Union[pathlib.Path, str]] = None
     ) -> None:
         """Tracing.stop
 
@@ -15685,6 +15678,13 @@ def evaluate(
 
         **Usage**
 
+        Passing argument to `expression`:
+
+        ```py
+        result = page.get_by_testid(\"myId\").evaluate(\"(element, [x, y]) => element.textContent + ' ' + x * y\", [7, 8])
+        print(result) # prints \"myId text 56\"
+        ```
+
         Parameters
         ----------
         expression : str
@@ -15906,8 +15906,8 @@ def locator(
         self,
         selector_or_locator: typing.Union[str, "Locator"],
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        has_not_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
     ) -> "Locator":
@@ -16171,7 +16171,7 @@ def get_by_role(
         expanded: typing.Optional[bool] = None,
         include_hidden: typing.Optional[bool] = None,
         level: typing.Optional[int] = None,
-        name: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        name: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         pressed: typing.Optional[bool] = None,
         selected: typing.Optional[bool] = None,
         exact: typing.Optional[bool] = None,
@@ -16503,11 +16503,36 @@ def nth(self, index: int) -> "Locator":
 
         return mapping.from_impl(self._impl_obj.nth(index=index))
 
+    def describe(self, description: str) -> "Locator":
+        """Locator.describe
+
+        Describes the locator, description is used in the trace viewer and reports. Returns the locator pointing to the
+        same element.
+
+        **Usage**
+
+        ```py
+        button = page.get_by_test_id(\"btn-sub\").describe(\"Subscribe button\")
+        button.click()
+        ```
+
+        Parameters
+        ----------
+        description : str
+            Locator description.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._impl_obj.describe(description=description))
+
     def filter(
         self,
         *,
-        has_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
-        has_not_text: typing.Optional[typing.Union[str, typing.Pattern[str]]] = None,
+        has_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
+        has_not_text: typing.Optional[typing.Union[typing.Pattern[str], str]] = None,
         has: typing.Optional["Locator"] = None,
         has_not: typing.Optional["Locator"] = None,
         visible: typing.Optional[bool] = None,
@@ -17206,7 +17231,7 @@ def screenshot(
         *,
         timeout: typing.Optional[float] = None,
         type: typing.Optional[Literal["jpeg", "png"]] = None,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         quality: typing.Optional[int] = None,
         omit_background: typing.Optional[bool] = None,
         animations: typing.Optional[Literal["allow", "disabled"]] = None,
@@ -17311,12 +17336,7 @@ def screenshot(
             )
         )
 
-    def aria_snapshot(
-        self,
-        *,
-        timeout: typing.Optional[float] = None,
-        ref: typing.Optional[bool] = None,
-    ) -> str:
+    def aria_snapshot(self, *, timeout: typing.Optional[float] = 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
@@ -17361,9 +17381,6 @@ def aria_snapshot(
         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.
-        ref : Union[bool, None]
-            Generate symbolic reference for each element. One can use `aria-ref=<ref>` locator immediately after capturing the
-            snapshot to perform actions on the element.
 
         Returns
         -------
@@ -17371,7 +17388,7 @@ def aria_snapshot(
         """
 
         return mapping.from_maybe_impl(
-            self._sync(self._impl_obj.aria_snapshot(timeout=timeout, ref=ref))
+            self._sync(self._impl_obj.aria_snapshot(timeout=timeout))
         )
 
     def scroll_into_view_if_needed(
@@ -18794,7 +18811,7 @@ def fetch(
     def storage_state(
         self,
         *,
-        path: typing.Optional[typing.Union[str, pathlib.Path]] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         indexed_db: typing.Optional[bool] = None,
     ) -> StorageState:
         """APIRequestContext.storage_state
@@ -19320,7 +19337,7 @@ def to_have_class(
         ```py
         from playwright.sync_api import expect
 
-        locator = page.locator(\"list > .component\")
+        locator = page.locator(\".list > .component\")
         expect(locator).to_have_class([\"component\", \"component selected\", \"component\"])
         ```
 
@@ -19405,7 +19422,7 @@ def to_contain_class(
         expected class lists. Each element's class attribute is matched against the corresponding class in the array:
 
         ```html
-        <div class='list'></div>
+        <div class='list'>
           <div class='component inactive'></div>
           <div class='component active'></div>
           <div class='component inactive'></div>
@@ -19415,7 +19432,7 @@ def to_contain_class(
         ```py
         from playwright.sync_api import expect
 
-        locator = page.locator(\"list > .component\")
+        locator = page.locator(\".list > .component\")
         await expect(locator).to_contain_class([\"inactive\", \"active\", \"inactive\"])
         ```
 
diff --git a/setup.py b/setup.py
index abe2fd6e2..fd590167f 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.52.0"
+driver_version = "1.53.1"
 
 base_wheel_bundles = [
     {
diff --git a/tests/async/conftest.py b/tests/async/conftest.py
index a007d55ac..f2e06d56e 100644
--- a/tests/async/conftest.py
+++ b/tests/async/conftest.py
@@ -156,9 +156,7 @@ def stack_frames(self) -> Locator:
         return self.page.get_by_test_id("stack-trace-list").locator(".list-view-entry")
 
     async def select_action(self, title: str, ordinal: int = 0) -> None:
-        await self.page.locator(f'.action-title:has-text("{title}")').nth(
-            ordinal
-        ).click()
+        await self.page.locator(".action-title", has_text=title).nth(ordinal).click()
 
     async def select_snapshot(self, name: str) -> None:
         await self.page.click(
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 58f4ea5f5..3213e5523 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -161,7 +161,7 @@ async def test_assertions_locator_to_contain_class(page: Page, server: Server) -
 
     assert excinfo.match("Locator expected to contain class 'does-not-exist'")
     assert excinfo.match("Actual value: foo bar baz")
-    assert excinfo.match("LocatorAssertions.to_contain_class with timeout 100ms")
+    assert excinfo.match('Expect "to_contain_class" with timeout 100ms')
 
     await page.set_content(
         '<div class="foo"></div><div class="hello bar"></div><div class="baz"></div>'
@@ -552,6 +552,35 @@ async def test_assertions_locator_to_be_checked(page: Page, server: Server) -> N
     await expect(my_checkbox).to_be_checked()
 
 
+async def test_assertions_boolean_checked_with_intermediate_true(page: Page) -> None:
+    await page.set_content("<input type=checkbox></input>")
+    await page.locator("input").evaluate("e => e.indeterminate = true")
+    await expect(page.locator("input")).to_be_checked(indeterminate=True)
+
+
+async def test_assertions_boolean_checked_with_intermediate_true_and_checked(
+    page: Page,
+) -> None:
+    await page.set_content("<input type=checkbox></input>")
+    await page.locator("input").evaluate("e => e.indeterminate = true")
+    with pytest.raises(
+        Error, match="Can't assert indeterminate and checked at the same time"
+    ):
+        await expect(page.locator("input")).to_be_checked(
+            checked=False, indeterminate=True
+        )
+
+
+async def test_assertions_boolean_fail_with_indeterminate_true(page: Page) -> None:
+    await page.set_content("<input type=checkbox></input>")
+    with pytest.raises(
+        AssertionError, match='Expect "to_be_checked" with timeout 1000ms'
+    ):
+        await expect(page.locator("input")).to_be_checked(
+            indeterminate=True, timeout=1000
+        )
+
+
 async def test_assertions_locator_to_be_disabled_enabled(
     page: Page, server: Server
 ) -> None:
@@ -991,7 +1020,7 @@ async def test_should_be_attached_over_navigation(page: Page, server: Server) ->
 async def test_should_be_able_to_set_custom_timeout(page: Page) -> None:
     with pytest.raises(AssertionError) as exc_info:
         await expect(page.locator("#a1")).to_be_visible(timeout=111)
-    assert "LocatorAssertions.to_be_visible with timeout 111ms" in str(exc_info.value)
+    assert 'Expect "to_be_visible" with timeout 111ms' in str(exc_info.value)
 
 
 async def test_should_be_able_to_set_custom_global_timeout(page: Page) -> None:
@@ -999,9 +1028,7 @@ async def test_should_be_able_to_set_custom_global_timeout(page: Page) -> None:
         expect.set_options(timeout=111)
         with pytest.raises(AssertionError) as exc_info:
             await expect(page.locator("#a1")).to_be_visible()
-        assert "LocatorAssertions.to_be_visible with timeout 111ms" in str(
-            exc_info.value
-        )
+        assert 'Expect "to_be_visible" with timeout 111ms' in str(exc_info.value)
     finally:
         expect.set_options(timeout=None)
 
diff --git a/tests/async/test_browsertype_connect.py b/tests/async/test_browsertype_connect.py
index d2eca4628..ccb112ab9 100644
--- a/tests/async/test_browsertype_connect.py
+++ b/tests/async/test_browsertype_connect.py
@@ -347,9 +347,9 @@ async def test_should_record_trace_with_source(
     async with show_trace_viewer(path) as trace_viewer:
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile("Page.goto"),
-                re.compile("Page.set_content"),
-                re.compile("Page.click"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r"Set content"),
+                re.compile(r"Click"),
             ]
         )
         await trace_viewer.show_source_tab()
@@ -358,7 +358,7 @@ async def test_should_record_trace_with_source(
                 re.compile(r"test_should_record_trace_with_source"),
             ]
         )
-        await trace_viewer.select_action("Page.set_content")
+        await trace_viewer.select_action("Set content")
         # Check that the source file is shown
         await expect(
             trace_viewer.page.locator(".source-tab-file-name")
diff --git a/tests/async/test_defaultbrowsercontext.py b/tests/async/test_defaultbrowsercontext.py
index 67de51702..25ef0c3f8 100644
--- a/tests/async/test_defaultbrowsercontext.py
+++ b/tests/async/test_defaultbrowsercontext.py
@@ -24,6 +24,7 @@
     List,
     Literal,
     Optional,
+    Sequence,
     Tuple,
 )
 
@@ -124,7 +125,7 @@ async def test_context_add_cookies_should_work(
     ]
 
 
-def _filter_cookies(cookies: List[Cookie]) -> List[Cookie]:
+def _filter_cookies(cookies: Sequence[Cookie]) -> List[Cookie]:
     return list(
         filter(lambda cookie: cookie["domain"] != "copilot.microsoft.com", cookies)
     )
diff --git a/tests/async/test_page_aria_snapshot.py b/tests/async/test_page_aria_snapshot.py
index 007d1f56c..30a9c9661 100644
--- a/tests/async/test_page_aria_snapshot.py
+++ b/tests/async/test_page_aria_snapshot.py
@@ -96,17 +96,6 @@ async def test_should_snapshot_complex(page: Page) -> None:
     )
 
 
-async def test_should_snapshot_with_ref(page: Page) -> None:
-    await page.set_content('<ul><li><a href="about:blank">link</a></li></ul>')
-    expected = """
-      - list [ref=s1e3]:
-        - listitem [ref=s1e4]:
-          - link "link" [ref=s1e5]:
-            - /url: about:blank
-    """
-    assert await page.locator("body").aria_snapshot(ref=True) == _unshift(expected)
-
-
 async def test_should_snapshot_with_unexpected_children_equal(page: Page) -> None:
     await page.set_content(
         """
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index 270bbfb80..e735c96a8 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -98,9 +98,9 @@ async def my_method_inner() -> None:
     async with show_trace_viewer(path) as trace_viewer:
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.goto"),
-                re.compile(r"Page.set_content"),
-                re.compile(r"Locator.click"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r"Set content"),
+                re.compile(r"Click"),
             ]
         )
         await trace_viewer.show_source_tab()
@@ -113,7 +113,7 @@ async def my_method_inner() -> None:
             ]
         )
 
-        await trace_viewer.select_action("Page.set_content")
+        await trace_viewer.select_action("Set content")
         # Check that the source file is shown
         await expect(
             trace_viewer.page.locator(".source-tab-file-name")
@@ -138,13 +138,9 @@ async def test_should_collect_trace_with_resources_but_no_js(
     await page.mouse.dblclick(30, 30)
     await page.keyboard.insert_text("abc")
     await page.wait_for_timeout(2000)  # Give it some time to produce screenshots.
-    await page.route(
-        "**/empty.html", lambda route: route.continue_()
-    )  # should produce a route.continue_ entry.
+    await page.route("**/empty.html", lambda route: route.continue_())
     await page.goto(server.EMPTY_PAGE)
-    await page.goto(
-        server.PREFIX + "/one-style.html"
-    )  # should not produce a route.continue_ entry since we continue all routes if no match.
+    await page.goto(server.PREFIX + "/one-style.html")
     await page.close()
     trace_file_path = tmp_path / "trace.zip"
     await context.tracing.stop(path=trace_file_path)
@@ -152,25 +148,24 @@ async def test_should_collect_trace_with_resources_but_no_js(
     async with show_trace_viewer(trace_file_path) as trace_viewer:
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile("Page.goto"),
-                re.compile("Page.set_content"),
-                re.compile("Page.click"),
-                re.compile("Mouse.move"),
-                re.compile("Mouse.dblclick"),
-                re.compile("Keyboard.insert_text"),
-                re.compile("Page.wait_for_timeout"),
-                re.compile("Page.route"),
-                re.compile("Page.goto"),
-                re.compile("Page.goto"),
-                re.compile("Page.close"),
+                re.compile(r'Navigate to "/frames/frame\.html"'),
+                re.compile(r"Set content"),
+                re.compile(r"Click"),
+                re.compile(r"Mouse move"),
+                re.compile(r"Double click"),
+                re.compile(r'Insert "abc"'),
+                re.compile(r"Wait for timeout"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r'Navigate to "/one-style\.html"'),
+                re.compile(r"Close"),
             ]
         )
 
-        await trace_viewer.select_action("Page.set_content")
+        await trace_viewer.select_action("Set content")
         await expect(
             trace_viewer.page.locator(".browser-frame-address-bar")
         ).to_have_text(server.PREFIX + "/frames/frame.html")
-        frame = await trace_viewer.snapshot_frame("Page.set_content", 0, False)
+        frame = await trace_viewer.snapshot_frame("Set content", 0, False)
         await expect(frame.locator("button")).to_have_text("Click")
 
 
@@ -200,8 +195,8 @@ async def _handle_response(response: Response) -> None:
     async with show_trace_viewer(trace_file_path) as trace_viewer:
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.goto"),
-                re.compile(r"Page.close"),
+                re.compile(r'Navigate to "/grid\.html"'),
+                re.compile(r"Close"),
             ]
         )
 
@@ -229,17 +224,17 @@ async def test_should_collect_two_traces(
     async with show_trace_viewer(tracing1_path) as trace_viewer:
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile("Page.goto"),
-                re.compile("Page.set_content"),
-                re.compile("Page.click"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r"Set content"),
+                re.compile(r"Click"),
             ]
         )
 
     async with show_trace_viewer(tracing2_path) as trace_viewer:
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.dblclick"),
-                re.compile(r"Page.close"),
+                re.compile(r"Double click"),
+                re.compile(r"Close"),
             ]
         )
 
@@ -267,13 +262,13 @@ async def test_should_work_with_playwright_context_managers(
     async with show_trace_viewer(trace_file_path) as trace_viewer:
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile("Page.goto"),
-                re.compile("Page.set_content"),
-                re.compile("Page.expect_console_message"),
-                re.compile("Page.evaluate"),
-                re.compile("Page.click"),
-                re.compile("Page.expect_popup"),
-                re.compile("Page.evaluate"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r"Set content"),
+                re.compile(r'Wait for event "page\.expect_event\(console\)"'),
+                re.compile(r"Evaluate"),
+                re.compile(r"Click"),
+                re.compile(r'Wait for event "page\.expect_event\(popup\)"'),
+                re.compile(r"Evaluate"),
             ]
         )
 
@@ -297,9 +292,9 @@ async def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
     async with show_trace_viewer(trace_file_path) as trace_viewer:
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.goto"),
-                re.compile(r"Page.wait_for_load_state"),
-                re.compile(r"Page.wait_for_load_state"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r'Wait for event "frame\.wait_for_load_state"'),
+                re.compile(r'Wait for event "frame\.wait_for_load_state"'),
             ]
         )
 
@@ -333,10 +328,12 @@ async def test_should_respect_traces_dir_and_name(
     async with show_trace_viewer(tmp_path / "trace1.zip") as trace_viewer:
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.goto"),
+                re.compile('Navigate to "/one-style\\.html"'),
             ]
         )
-        frame = await trace_viewer.snapshot_frame("Page.goto", 0, False)
+        frame = await trace_viewer.snapshot_frame(
+            'Navigate to "/one-style.html"', 0, False
+        )
         await expect(frame.locator("body")).to_have_css(
             "background-color", "rgb(255, 192, 203)"
         )
@@ -345,10 +342,10 @@ async def test_should_respect_traces_dir_and_name(
     async with show_trace_viewer(tmp_path / "trace2.zip") as trace_viewer:
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.goto"),
+                re.compile(r'Navigate to "/har\.html"'),
             ]
         )
-        frame = await trace_viewer.snapshot_frame("Page.goto", 0, False)
+        frame = await trace_viewer.snapshot_frame('Navigate to "/har.html"', 0, False)
         await expect(frame.locator("body")).to_have_css(
             "background-color", "rgb(255, 192, 203)"
         )
@@ -380,12 +377,12 @@ async def test_should_show_tracing_group_in_action_list(
         await trace_viewer.expand_action("inner group 1")
         await expect(trace_viewer.action_titles).to_have_text(
             [
-                "BrowserContext.new_page",
-                "outer group",
-                re.compile("Page.goto"),
-                "inner group 1",
-                re.compile("Locator.click"),
-                "inner group 2",
-                re.compile("Locator.is_visible"),
+                re.compile(r"Create page"),
+                re.compile(r"outer group"),
+                re.compile(r"Navigate to \"data:\""),
+                re.compile(r"inner group 1"),
+                re.compile(r"Click"),
+                re.compile(r"inner group 2"),
+                re.compile(r"Is visible"),
             ]
         )
diff --git a/tests/sync/conftest.py b/tests/sync/conftest.py
index 46bf86239..3d7ae9116 100644
--- a/tests/sync/conftest.py
+++ b/tests/sync/conftest.py
@@ -146,7 +146,7 @@ def stack_frames(self) -> Locator:
         return self.page.get_by_test_id("stack-trace-list").locator(".list-view-entry")
 
     def select_action(self, title: str, ordinal: int = 0) -> None:
-        self.page.locator(f'.action-title:has-text("{title}")').nth(ordinal).click()
+        self.page.locator(".action-title", has_text=title).nth(ordinal).click()
 
     def select_snapshot(self, name: str) -> None:
         self.page.click(f'.snapshot-tab .tabbed-pane-tab-label:has-text("{name}")')
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 0dce717d3..740e6e750 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -140,7 +140,7 @@ def test_assertions_locator_to_contain_class(page: Page, server: Server) -> None
 
     assert excinfo.match("Locator expected to contain class 'does-not-exist'")
     assert excinfo.match("Actual value: foo bar baz")
-    assert excinfo.match("LocatorAssertions.to_contain_class with timeout 100ms")
+    assert excinfo.match('Expect "to_contain_class" with timeout 100ms')
 
     page.set_content(
         '<div class="foo"></div><div class="hello bar"></div><div class="baz"></div>'
@@ -548,7 +548,7 @@ def test_assertions_boolean_checked_with_intermediate_true_and_checked(
 def test_assertions_boolean_fail_with_indeterminate_true(page: Page) -> None:
     page.set_content("<input type=checkbox></input>")
     with pytest.raises(
-        AssertionError, match="LocatorAssertions.to_be_checked with timeout 1000ms"
+        AssertionError, match='Expect "to_be_checked" with timeout 1000ms'
     ):
         expect(page.locator("input")).to_be_checked(indeterminate=True, timeout=1000)
 
@@ -957,7 +957,7 @@ def test_should_be_attached_with_impossible_timeout_not(page: Page) -> None:
 def test_should_be_able_to_set_custom_timeout(page: Page) -> None:
     with pytest.raises(AssertionError) as exc_info:
         expect(page.locator("#a1")).to_be_visible(timeout=111)
-    assert "LocatorAssertions.to_be_visible with timeout 111ms" in str(exc_info.value)
+    assert 'Expect "to_be_visible" with timeout 111ms' in str(exc_info.value)
 
 
 def test_should_be_able_to_set_custom_global_timeout(page: Page) -> None:
@@ -965,9 +965,7 @@ def test_should_be_able_to_set_custom_global_timeout(page: Page) -> None:
         expect.set_options(timeout=111)
         with pytest.raises(AssertionError) as exc_info:
             expect(page.locator("#a1")).to_be_visible()
-        assert "LocatorAssertions.to_be_visible with timeout 111ms" in str(
-            exc_info.value
-        )
+        assert 'Expect "to_be_visible" with timeout 111ms' in str(exc_info.value)
     finally:
         expect.set_options(timeout=5_000)
 
diff --git a/tests/sync/test_har.py b/tests/sync/test_har.py
index 990b1d382..6ac848b8a 100644
--- a/tests/sync/test_har.py
+++ b/tests/sync/test_har.py
@@ -443,6 +443,7 @@ def test_should_round_trip_har_zip(
     page_2.goto(server.PREFIX + "/one-style.html")
     assert "hello, world!" in page_2.content()
     expect(page_2.locator("body")).to_have_css("background-color", "rgb(255, 192, 203)")
+    context_2.close()
 
 
 def test_should_round_trip_har_with_post_data(
@@ -476,6 +477,7 @@ def test_should_round_trip_har_with_post_data(
     assert page_2.evaluate(fetch_function, "3") == "3"
     with pytest.raises(Exception):
         page_2.evaluate(fetch_function, "4")
+    context_2.close()
 
 
 def test_should_disambiguate_by_header(
@@ -517,6 +519,7 @@ def test_should_disambiguate_by_header(
     assert page_2.evaluate(fetch_function, "baz2") == "baz2"
     assert page_2.evaluate(fetch_function, "baz3") == "baz3"
     assert page_2.evaluate(fetch_function, "baz4") == "baz1"
+    context_2.close()
 
 
 def test_should_produce_extracted_zip(
@@ -542,6 +545,7 @@ def test_should_produce_extracted_zip(
     page_2.goto(server.PREFIX + "/one-style.html")
     assert "hello, world!" in page_2.content()
     expect(page_2.locator("body")).to_have_css("background-color", "rgb(255, 192, 203)")
+    context_2.close()
 
 
 def test_should_update_har_zip_for_context(
@@ -562,6 +566,7 @@ def test_should_update_har_zip_for_context(
     page_2.goto(server.PREFIX + "/one-style.html")
     assert "hello, world!" in page_2.content()
     expect(page_2.locator("body")).to_have_css("background-color", "rgb(255, 192, 203)")
+    context_2.close()
 
 
 def test_should_update_har_zip_for_page(
@@ -582,6 +587,7 @@ def test_should_update_har_zip_for_page(
     page_2.goto(server.PREFIX + "/one-style.html")
     assert "hello, world!" in page_2.content()
     expect(page_2.locator("body")).to_have_css("background-color", "rgb(255, 192, 203)")
+    context_2.close()
 
 
 def test_should_update_har_zip_for_page_with_different_options(
@@ -627,3 +633,4 @@ def test_should_update_extracted_har_zip_for_page(
     page_2.goto(server.PREFIX + "/one-style.html")
     assert "hello, world!" in page_2.content()
     expect(page_2.locator("body")).to_have_css("background-color", "rgb(255, 192, 203)")
+    context_2.close()
diff --git a/tests/sync/test_page_aria_snapshot.py b/tests/sync/test_page_aria_snapshot.py
index ca1c48393..e892bb371 100644
--- a/tests/sync/test_page_aria_snapshot.py
+++ b/tests/sync/test_page_aria_snapshot.py
@@ -96,17 +96,6 @@ def test_should_snapshot_complex(page: Page) -> None:
     )
 
 
-def test_should_snapshot_with_ref(page: Page) -> None:
-    page.set_content('<ul><li><a href="about:blank">link</a></li></ul>')
-    expected = """
-      - list [ref=s1e3]:
-        - listitem [ref=s1e4]:
-          - link "link" [ref=s1e5]:
-            - /url: about:blank
-    """
-    assert page.locator("body").aria_snapshot(ref=True) == _unshift(expected)
-
-
 def test_should_snapshot_with_unexpected_children_equal(page: Page) -> None:
     page.set_content(
         """
diff --git a/tests/sync/test_route_web_socket.py b/tests/sync/test_route_web_socket.py
index 2e97ebd8d..0cc8eda5d 100644
--- a/tests/sync/test_route_web_socket.py
+++ b/tests/sync/test_route_web_socket.py
@@ -340,6 +340,7 @@ def _handle_ws(ws: WebSocketRoute) -> None:
             f"message: data=echo origin=ws://localhost:{server.PORT} lastEventId=",
         ],
     )
+    context.close()
 
 
 def test_should_work_with_no_trailing_slash(page: Page, server: Server) -> None:
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index 43e875b16..1a42aab9b 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -39,6 +39,7 @@ def test_browser_context_output_trace(
     page.goto(server.PREFIX + "/grid.html")
     context.tracing.stop(path=tmp_path / "trace.zip")
     assert Path(tmp_path / "trace.zip").exists()
+    context.close()
 
 
 def test_start_stop(browser: Browser) -> None:
@@ -72,6 +73,7 @@ def test_browser_context_output_trace_chunk(
     button.click()
     context.tracing.stop_chunk(path=tmp_path / "trace2.zip")
     assert Path(tmp_path / "trace2.zip").exists()
+    context.close()
 
 
 def test_should_collect_sources(
@@ -98,9 +100,9 @@ def my_method_inner() -> None:
     with show_trace_viewer(path) as trace_viewer:
         expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.goto"),
-                re.compile(r"Page.set_content"),
-                re.compile(r"Locator.click"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r"Set content"),
+                re.compile(r"Click"),
             ]
         )
         trace_viewer.show_source_tab()
@@ -113,7 +115,7 @@ def my_method_inner() -> None:
             ]
         )
 
-        trace_viewer.select_action("Page.set_content")
+        trace_viewer.select_action("Set content")
         # Check that the source file is shown
         expect(trace_viewer.page.locator(".source-tab-file-name")).to_have_attribute(
             "title", re.compile(r".*test_.*\.py")
@@ -138,13 +140,9 @@ def test_should_collect_trace_with_resources_but_no_js(
     page.mouse.dblclick(30, 30)
     page.keyboard.insert_text("abc")
     page.wait_for_timeout(2000)  # Give it some time to produce screenshots.
-    page.route(
-        "**/empty.html", lambda route: route.continue_()
-    )  # should produce a route.continue_ entry.
+    page.route("**/empty.html", lambda route: route.continue_())
     page.goto(server.EMPTY_PAGE)
-    page.goto(
-        server.PREFIX + "/one-style.html"
-    )  # should not produce a route.continue_ entry since we continue all routes if no match.
+    page.goto(server.PREFIX + "/one-style.html")
     page.close()
     trace_file_path = tmp_path / "trace.zip"
     context.tracing.stop(path=trace_file_path)
@@ -152,25 +150,24 @@ def test_should_collect_trace_with_resources_but_no_js(
     with show_trace_viewer(trace_file_path) as trace_viewer:
         expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile("Page.goto"),
-                re.compile("Page.set_content"),
-                re.compile("Page.click"),
-                re.compile("Mouse.move"),
-                re.compile("Mouse.dblclick"),
-                re.compile("Keyboard.insert_text"),
-                re.compile("Page.wait_for_timeout"),
-                re.compile("Page.route"),
-                re.compile("Page.goto"),
-                re.compile("Page.goto"),
-                re.compile("Page.close"),
+                re.compile(r'Navigate to "/frames/frame\.html"'),
+                re.compile(r"Set content"),
+                re.compile(r"Click"),
+                re.compile(r"Mouse move"),
+                re.compile(r"Double click"),
+                re.compile(r'Insert "abc"'),
+                re.compile(r"Wait for timeout"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r'Navigate to "/one-style\.html"'),
+                re.compile(r"Close"),
             ]
         )
 
-        trace_viewer.select_action("Page.set_content")
+        trace_viewer.select_action("Set content")
         expect(trace_viewer.page.locator(".browser-frame-address-bar")).to_have_text(
             server.PREFIX + "/frames/frame.html"
         )
-        frame = trace_viewer.snapshot_frame("Page.set_content", 0, False)
+        frame = trace_viewer.snapshot_frame("Set content", 0, False)
         expect(frame.locator("button")).to_have_text("Click")
 
 
@@ -201,8 +198,8 @@ def _handle_response(response: Response) -> None:
     with show_trace_viewer(trace_file_path) as trace_viewer:
         expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.goto"),
-                re.compile(r"Page.close"),
+                re.compile(r'Navigate to "/grid\.html"'),
+                re.compile(r"Close"),
             ]
         )
 
@@ -230,17 +227,17 @@ def test_should_collect_two_traces(
     with show_trace_viewer(tracing1_path) as trace_viewer:
         expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile("Page.goto"),
-                re.compile("Page.set_content"),
-                re.compile("Page.click"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r"Set content"),
+                re.compile(r"Click"),
             ]
         )
 
     with show_trace_viewer(tracing2_path) as trace_viewer:
         expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.dblclick"),
-                re.compile(r"Page.close"),
+                re.compile(r"Double click"),
+                re.compile(r"Close"),
             ]
         )
 
@@ -268,13 +265,13 @@ def test_should_work_with_playwright_context_managers(
     with show_trace_viewer(trace_file_path) as trace_viewer:
         expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile("Page.goto"),
-                re.compile("Page.set_content"),
-                re.compile("Page.expect_console_message"),
-                re.compile("Page.evaluate"),
-                re.compile("Page.click"),
-                re.compile("Page.expect_popup"),
-                re.compile("Page.evaluate"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r"Set content"),
+                re.compile(r'Wait for event "page\.expect_event\(console\)"'),
+                re.compile(r"Evaluate"),
+                re.compile(r"Click"),
+                re.compile(r'Wait for event "page\.expect_event\(popup\)"'),
+                re.compile(r"Evaluate"),
             ]
         )
 
@@ -298,9 +295,9 @@ def test_should_display_wait_for_load_state_even_if_did_not_wait_for_it(
     with show_trace_viewer(trace_file_path) as trace_viewer:
         expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.goto"),
-                re.compile(r"Page.wait_for_load_state"),
-                re.compile(r"Page.wait_for_load_state"),
+                re.compile(r'Navigate to "/empty\.html"'),
+                re.compile(r'Wait for event "frame\.wait_for_load_state"'),
+                re.compile(r'Wait for event "frame\.wait_for_load_state"'),
             ]
         )
 
@@ -334,10 +331,10 @@ def test_should_respect_traces_dir_and_name(
     with show_trace_viewer(tmp_path / "trace1.zip") as trace_viewer:
         expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.goto"),
+                re.compile(r'Navigate to "/one-style\.html"'),
             ]
         )
-        frame = trace_viewer.snapshot_frame("Page.goto", 0, False)
+        frame = trace_viewer.snapshot_frame('Navigate to "/one-style.html"', 0, False)
         expect(frame.locator("body")).to_have_css(
             "background-color", "rgb(255, 192, 203)"
         )
@@ -346,10 +343,10 @@ def test_should_respect_traces_dir_and_name(
     with show_trace_viewer(tmp_path / "trace2.zip") as trace_viewer:
         expect(trace_viewer.action_titles).to_have_text(
             [
-                re.compile(r"Page.goto"),
+                re.compile(r'Navigate to "/har\.html"'),
             ]
         )
-        frame = trace_viewer.snapshot_frame("Page.goto", 0, False)
+        frame = trace_viewer.snapshot_frame('Navigate to "/har.html"', 0, False)
         expect(frame.locator("body")).to_have_css(
             "background-color", "rgb(255, 192, 203)"
         )
@@ -381,12 +378,12 @@ def test_should_show_tracing_group_in_action_list(
         trace_viewer.expand_action("inner group 1")
         expect(trace_viewer.action_titles).to_have_text(
             [
-                "BrowserContext.new_page",
-                "outer group",
-                re.compile("Page.goto"),
-                "inner group 1",
-                re.compile("Locator.click"),
-                "inner group 2",
-                re.compile("Locator.is_visible"),
+                re.compile(r"Create page"),
+                re.compile(r"outer group"),
+                re.compile(r"Navigate to \"data:\""),
+                re.compile(r"inner group 1"),
+                re.compile(r"Click"),
+                re.compile(r"inner group 2"),
+                re.compile(r"Is visible"),
             ]
         )

From 3713a322d85482d9ff7a591272e1938b31b10848 Mon Sep 17 00:00:00 2001
From: Adam Gastineau <adam@agg.im>
Date: Wed, 25 Jun 2025 09:15:21 -0700
Subject: [PATCH 399/438] chore: explicit timeout config for send (#2900)

---
 playwright/_impl/_accessibility.py           |   2 +-
 playwright/_impl/_artifact.py                |  40 ++++++-
 playwright/_impl/_browser.py                 |  12 +-
 playwright/_impl/_browser_context.py         |  35 +++---
 playwright/_impl/_browser_type.py            |  16 ++-
 playwright/_impl/_cdp_session.py             |   7 +-
 playwright/_impl/_clock.py                   |  32 +++--
 playwright/_impl/_connection.py              |  55 +++++----
 playwright/_impl/_dialog.py                  |   7 +-
 playwright/_impl/_element_handle.py          | 110 ++++++++++++------
 playwright/_impl/_fetch.py                   |  13 ++-
 playwright/_impl/_frame.py                   | 116 ++++++++++++-------
 playwright/_impl/_har_router.py              |   4 +-
 playwright/_impl/_input.py                   |  24 ++--
 playwright/_impl/_js_handle.py               |  21 +++-
 playwright/_impl/_json_pipe.py               |   4 +-
 playwright/_impl/_local_utils.py             |  15 +--
 playwright/_impl/_locator.py                 |   3 +
 playwright/_impl/_network.py                 |  74 +++++++++---
 playwright/_impl/_page.py                    |  81 ++++++++-----
 playwright/_impl/_selectors.py               |   8 +-
 playwright/_impl/_set_input_files_helpers.py |   1 +
 playwright/_impl/_stream.py                  |   4 +-
 playwright/_impl/_tracing.py                 |  23 ++--
 playwright/_impl/_waiter.py                  |   3 +
 playwright/_impl/_writable_stream.py         |   4 +-
 26 files changed, 478 insertions(+), 236 deletions(-)

diff --git a/playwright/_impl/_accessibility.py b/playwright/_impl/_accessibility.py
index 010b4e8c5..fe6909c21 100644
--- a/playwright/_impl/_accessibility.py
+++ b/playwright/_impl/_accessibility.py
@@ -65,5 +65,5 @@ async def snapshot(
         params = locals_to_params(locals())
         if root:
             params["root"] = root._channel
-        result = await self._channel.send("accessibilitySnapshot", params)
+        result = await self._channel.send("accessibilitySnapshot", None, params)
         return _ax_node_from_protocol(result) if result else None
diff --git a/playwright/_impl/_artifact.py b/playwright/_impl/_artifact.py
index a5af44573..a08294cbe 100644
--- a/playwright/_impl/_artifact.py
+++ b/playwright/_impl/_artifact.py
@@ -33,27 +33,55 @@ async def path_after_finished(self) -> pathlib.Path:
             raise Error(
                 "Path is not available when using browser_type.connect(). Use save_as() to save a local copy."
             )
-        path = await self._channel.send("pathAfterFinished")
+        path = await self._channel.send(
+            "pathAfterFinished",
+            None,
+        )
         return pathlib.Path(path)
 
     async def save_as(self, path: Union[str, Path]) -> None:
-        stream = cast(Stream, from_channel(await self._channel.send("saveAsStream")))
+        stream = cast(
+            Stream,
+            from_channel(
+                await self._channel.send(
+                    "saveAsStream",
+                    None,
+                )
+            ),
+        )
         make_dirs_for_file(path)
         await stream.save_as(path)
 
     async def failure(self) -> Optional[str]:
-        reason = await self._channel.send("failure")
+        reason = await self._channel.send(
+            "failure",
+            None,
+        )
         if reason is None:
             return None
         return patch_error_message(reason)
 
     async def delete(self) -> None:
-        await self._channel.send("delete")
+        await self._channel.send(
+            "delete",
+            None,
+        )
 
     async def read_info_buffer(self) -> bytes:
-        stream = cast(Stream, from_channel(await self._channel.send("stream")))
+        stream = cast(
+            Stream,
+            from_channel(
+                await self._channel.send(
+                    "stream",
+                    None,
+                )
+            ),
+        )
         buffer = await stream.read_all()
         return buffer
 
     async def cancel(self) -> None:  # pyright: ignore[reportIncompatibleMethodOverride]
-        await self._channel.send("cancel")
+        await self._channel.send(
+            "cancel",
+            None,
+        )
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index 9b3c1cacc..5a9a87450 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -168,7 +168,7 @@ async def new_context(
         assert self._browser_type is not None
         await self._browser_type._prepare_browser_context_params(params)
 
-        channel = await self._channel.send("newContext", params)
+        channel = await self._channel.send("newContext", None, params)
         context = cast(BrowserContext, from_channel(channel))
         await context._initialize_har_from_options(
             record_har_content=recordHarContent,
@@ -235,7 +235,7 @@ async def close(self, reason: str = None) -> None:
             if self._should_close_connection_on_close:
                 await self._connection.stop_async()
             else:
-                await self._channel.send("close", {"reason": reason})
+                await self._channel.send("close", None, {"reason": reason})
         except Exception as e:
             if not is_target_closed_error(e):
                 raise e
@@ -245,7 +245,7 @@ def version(self) -> str:
         return self._initializer["version"]
 
     async def new_browser_cdp_session(self) -> CDPSession:
-        return from_channel(await self._channel.send("newBrowserCDPSession"))
+        return from_channel(await self._channel.send("newBrowserCDPSession", None))
 
     async def start_tracing(
         self,
@@ -260,10 +260,12 @@ async def start_tracing(
         if path:
             self._cr_tracing_path = str(path)
             params["path"] = str(path)
-        await self._channel.send("startTracing", params)
+        await self._channel.send("startTracing", None, params)
 
     async def stop_tracing(self) -> bytes:
-        artifact = cast(Artifact, from_channel(await self._channel.send("stopTracing")))
+        artifact = cast(
+            Artifact, from_channel(await self._channel.send("stopTracing", None))
+        )
         buffer = await artifact.read_info_buffer()
         await artifact.delete()
         if self._cr_tracing_path:
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 1264d3f8b..60b60c46e 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -330,17 +330,17 @@ async def _initialize_har_from_options(
     async def new_page(self) -> Page:
         if self._owner_page:
             raise Error("Please use browser.new_context()")
-        return from_channel(await self._channel.send("newPage"))
+        return from_channel(await self._channel.send("newPage", None))
 
     async def cookies(self, urls: Union[str, Sequence[str]] = None) -> List[Cookie]:
         if urls is None:
             urls = []
         if isinstance(urls, str):
             urls = [urls]
-        return await self._channel.send("cookies", dict(urls=urls))
+        return await self._channel.send("cookies", None, dict(urls=urls))
 
     async def add_cookies(self, cookies: Sequence[SetCookieParam]) -> None:
-        await self._channel.send("addCookies", dict(cookies=cookies))
+        await self._channel.send("addCookies", None, dict(cookies=cookies))
 
     async def clear_cookies(
         self,
@@ -350,6 +350,7 @@ async def clear_cookies(
     ) -> None:
         await self._channel.send(
             "clearCookies",
+            None,
             {
                 "name": name if isinstance(name, str) else None,
                 "nameRegexSource": name.pattern if isinstance(name, Pattern) else None,
@@ -374,21 +375,21 @@ async def clear_cookies(
     async def grant_permissions(
         self, permissions: Sequence[str], origin: str = None
     ) -> None:
-        await self._channel.send("grantPermissions", locals_to_params(locals()))
+        await self._channel.send("grantPermissions", None, locals_to_params(locals()))
 
     async def clear_permissions(self) -> None:
-        await self._channel.send("clearPermissions")
+        await self._channel.send("clearPermissions", None)
 
     async def set_geolocation(self, geolocation: Geolocation = None) -> None:
-        await self._channel.send("setGeolocation", locals_to_params(locals()))
+        await self._channel.send("setGeolocation", None, locals_to_params(locals()))
 
     async def set_extra_http_headers(self, headers: Dict[str, str]) -> None:
         await self._channel.send(
-            "setExtraHTTPHeaders", dict(headers=serialize_headers(headers))
+            "setExtraHTTPHeaders", None, dict(headers=serialize_headers(headers))
         )
 
     async def set_offline(self, offline: bool) -> None:
-        await self._channel.send("setOffline", dict(offline=offline))
+        await self._channel.send("setOffline", None, dict(offline=offline))
 
     async def add_init_script(
         self, script: str = None, path: Union[str, Path] = None
@@ -397,7 +398,7 @@ async def add_init_script(
             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", dict(source=script))
+        await self._channel.send("addInitScript", None, dict(source=script))
 
     async def expose_binding(
         self, name: str, callback: Callable, handle: bool = None
@@ -411,7 +412,7 @@ async def expose_binding(
             raise Error(f'Function "{name}" has been already registered')
         self._bindings[name] = callback
         await self._channel.send(
-            "exposeBinding", dict(name=name, needsHandle=handle or False)
+            "exposeBinding", None, dict(name=name, needsHandle=handle or False)
         )
 
     async def expose_function(self, name: str, callback: Callable) -> None:
@@ -499,7 +500,7 @@ async def _record_into_har(
         }
         if page:
             params["page"] = page._channel
-        har_id = await self._channel.send("harStart", params)
+        har_id = await self._channel.send("harStart", None, params)
         self._har_recorders[har_id] = {
             "path": str(har),
             "content": update_content,
@@ -535,7 +536,7 @@ async def route_from_har(
     async def _update_interception_patterns(self) -> None:
         patterns = RouteHandler.prepare_interception_patterns(self._routes)
         await self._channel.send(
-            "setNetworkInterceptionPatterns", {"patterns": patterns}
+            "setNetworkInterceptionPatterns", None, {"patterns": patterns}
         )
 
     async def _update_web_socket_interception_patterns(self) -> None:
@@ -543,7 +544,7 @@ async def _update_web_socket_interception_patterns(self) -> None:
             self._web_socket_routes
         )
         await self._channel.send(
-            "setWebSocketInterceptionPatterns", {"patterns": patterns}
+            "setWebSocketInterceptionPatterns", None, {"patterns": patterns}
         )
 
     def expect_event(
@@ -596,7 +597,7 @@ async def _inner_close() -> None:
                 har = cast(
                     Artifact,
                     from_channel(
-                        await self._channel.send("harExport", {"harId": har_id})
+                        await self._channel.send("harExport", None, {"harId": har_id})
                     ),
                 )
                 # Server side will compress artifact if content is attach or if file is .zip.
@@ -615,14 +616,14 @@ async def _inner_close() -> None:
                 await har.delete()
 
         await self._channel._connection.wrap_api_call(_inner_close, True)
-        await self._channel.send("close", {"reason": reason})
+        await self._channel.send("close", None, {"reason": reason})
         await self._closed_future
 
     async def storage_state(
         self, path: Union[str, Path] = None, indexedDB: bool = None
     ) -> StorageState:
         result = await self._channel.send_return_as_dict(
-            "storageState", {"indexedDB": indexedDB}
+            "storageState", None, {"indexedDB": indexedDB}
         )
         if path:
             await async_writefile(path, json.dumps(result))
@@ -749,7 +750,7 @@ async def new_cdp_session(self, page: Union[Page, Frame]) -> CDPSession:
             params["frame"] = page._channel
         else:
             raise Error("page: expected Page or Frame")
-        return from_channel(await self._channel.send("newCDPSession", params))
+        return from_channel(await self._channel.send("newCDPSession", None, params))
 
     @property
     def tracing(self) -> Tracing:
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index ab8c00e97..93173160c 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -93,7 +93,12 @@ async def launch(
         params = locals_to_params(locals())
         normalize_launch_params(params)
         browser = cast(
-            Browser, from_channel(await self._channel.send("launch", params))
+            Browser,
+            from_channel(
+                await self._channel.send(
+                    "launch", TimeoutSettings.launch_timeout, params
+                )
+            ),
         )
         browser._connect_to_browser_type(
             self, str(tracesDir) if tracesDir is not None else None
@@ -159,7 +164,7 @@ async def launch_persistent_context(
         await self._prepare_browser_context_params(params)
         normalize_launch_params(params)
         result = await self._channel.send_return_as_dict(
-            "launchPersistentContext", params
+            "launchPersistentContext", TimeoutSettings.launch_timeout, params
         )
         browser = cast(
             Browser,
@@ -197,10 +202,11 @@ async def connect_over_cdp(
         headers: Dict[str, str] = None,
     ) -> Browser:
         params = locals_to_params(locals())
-        params["timeout"] = TimeoutSettings.launch_timeout(timeout)
         if params.get("headers"):
             params["headers"] = serialize_headers(params["headers"])
-        response = await self._channel.send_return_as_dict("connectOverCDP", params)
+        response = await self._channel.send_return_as_dict(
+            "connectOverCDP", TimeoutSettings.launch_timeout, params
+        )
         browser = cast(Browser, from_channel(response["browser"]))
         browser._connect_to_browser_type(self, None)
 
@@ -222,6 +228,7 @@ async def connect(
         pipe_channel = (
             await local_utils._channel.send_return_as_dict(
                 "connect",
+                None,
                 {
                     "wsEndpoint": wsEndpoint,
                     "headers": headers,
@@ -355,4 +362,3 @@ def normalize_launch_params(params: Dict) -> None:
         params["downloadsPath"] = str(Path(params["downloadsPath"]))
     if "tracesDir" in params:
         params["tracesDir"] = str(Path(params["tracesDir"]))
-    params["timeout"] = TimeoutSettings.launch_timeout(params.get("timeout"))
diff --git a/playwright/_impl/_cdp_session.py b/playwright/_impl/_cdp_session.py
index b6e383ff2..95e65c57a 100644
--- a/playwright/_impl/_cdp_session.py
+++ b/playwright/_impl/_cdp_session.py
@@ -29,7 +29,10 @@ def _on_event(self, params: Any) -> None:
         self.emit(params["method"], params.get("params"))
 
     async def send(self, method: str, params: Dict = None) -> Dict:
-        return await self._channel.send("send", locals_to_params(locals()))
+        return await self._channel.send("send", None, locals_to_params(locals()))
 
     async def detach(self) -> None:
-        await self._channel.send("detach")
+        await self._channel.send(
+            "detach",
+            None,
+        )
diff --git a/playwright/_impl/_clock.py b/playwright/_impl/_clock.py
index d8bb58718..928536019 100644
--- a/playwright/_impl/_clock.py
+++ b/playwright/_impl/_clock.py
@@ -27,7 +27,9 @@ def __init__(self, browser_context: "BrowserContext") -> None:
 
     async def install(self, time: Union[float, str, datetime.datetime] = None) -> None:
         await self._browser_context._channel.send(
-            "clockInstall", parse_time(time) if time is not None else {}
+            "clockInstall",
+            None,
+            parse_time(time) if time is not None else {},
         )
 
     async def fast_forward(
@@ -35,38 +37,54 @@ async def fast_forward(
         ticks: Union[int, str],
     ) -> None:
         await self._browser_context._channel.send(
-            "clockFastForward", parse_ticks(ticks)
+            "clockFastForward",
+            None,
+            parse_ticks(ticks),
         )
 
     async def pause_at(
         self,
         time: Union[float, str, datetime.datetime],
     ) -> None:
-        await self._browser_context._channel.send("clockPauseAt", parse_time(time))
+        await self._browser_context._channel.send(
+            "clockPauseAt",
+            None,
+            parse_time(time),
+        )
 
     async def resume(
         self,
     ) -> None:
-        await self._browser_context._channel.send("clockResume")
+        await self._browser_context._channel.send("clockResume", None)
 
     async def run_for(
         self,
         ticks: Union[int, str],
     ) -> None:
-        await self._browser_context._channel.send("clockRunFor", parse_ticks(ticks))
+        await self._browser_context._channel.send(
+            "clockRunFor",
+            None,
+            parse_ticks(ticks),
+        )
 
     async def set_fixed_time(
         self,
         time: Union[float, str, datetime.datetime],
     ) -> None:
-        await self._browser_context._channel.send("clockSetFixedTime", parse_time(time))
+        await self._browser_context._channel.send(
+            "clockSetFixedTime",
+            None,
+            parse_time(time),
+        )
 
     async def set_system_time(
         self,
         time: Union[float, str, datetime.datetime],
     ) -> None:
         await self._browser_context._channel.send(
-            "clockSetSystemTime", parse_time(time)
+            "clockSetSystemTime",
+            None,
+            parse_time(time),
         )
 
 
diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 3519aeebd..a837500b1 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -47,6 +47,8 @@
     from playwright._impl._local_utils import LocalUtils
     from playwright._impl._playwright import Playwright
 
+TimeoutCalculator = Optional[Callable[[Optional[float]], float]]
+
 
 class Channel(AsyncIOEventEmitter):
     def __init__(self, connection: "Connection", object: "ChannelOwner") -> None:
@@ -55,17 +57,17 @@ def __init__(self, connection: "Connection", object: "ChannelOwner") -> None:
         self._guid = object._guid
         self._object = object
         self.on("error", lambda exc: self._connection._on_event_listener_error(exc))
-        self._timeout_calculator: Optional[Callable[[Optional[float]], float]] = None
 
     async def send(
         self,
         method: str,
+        timeout_calculator: TimeoutCalculator,
         params: Dict = None,
         is_internal: bool = False,
         title: str = None,
     ) -> Any:
         return await self._connection.wrap_api_call(
-            lambda: self._inner_send(method, params, False),
+            lambda: self._inner_send(method, timeout_calculator, params, False),
             is_internal,
             title,
         )
@@ -73,12 +75,13 @@ async def send(
     async def send_return_as_dict(
         self,
         method: str,
+        timeout_calculator: TimeoutCalculator,
         params: Dict = None,
         is_internal: bool = False,
         title: str = None,
     ) -> Any:
         return await self._connection.wrap_api_call(
-            lambda: self._inner_send(method, params, True),
+            lambda: self._inner_send(method, timeout_calculator, params, True),
             is_internal,
             title,
         )
@@ -86,6 +89,7 @@ async def send_return_as_dict(
     def send_no_reply(
         self,
         method: str,
+        timeout_calculator: TimeoutCalculator,
         params: Dict = None,
         is_internal: bool = False,
         title: str = None,
@@ -93,25 +97,28 @@ def send_no_reply(
         # No reply messages are used to e.g. waitForEventInfo(after).
         self._connection.wrap_api_call_sync(
             lambda: self._connection._send_message_to_server(
-                self._object, method, {} if params is None else params, True
+                self._object,
+                method,
+                _augment_params(params, timeout_calculator),
+                True,
             ),
             is_internal,
             title,
         )
 
     async def _inner_send(
-        self, method: str, params: Optional[Dict], return_as_dict: bool
+        self,
+        method: str,
+        timeout_calculator: TimeoutCalculator,
+        params: Optional[Dict],
+        return_as_dict: bool,
     ) -> Any:
-        if params is None:
-            params = {}
-        if self._timeout_calculator is not None:
-            params["timeout"] = self._timeout_calculator(params.get("timeout"))
         if self._connection._error:
             error = self._connection._error
             self._connection._error = None
             raise error
         callback = self._connection._send_message_to_server(
-            self._object, method, _filter_none(params)
+            self._object, method, _augment_params(params, timeout_calculator)
         )
         done, _ = await asyncio.wait(
             {
@@ -136,11 +143,6 @@ async def _inner_send(
         key = next(iter(result))
         return result[key]
 
-    def _set_timeout_calculator(
-        self, timeout_calculator: Callable[[Optional[float]], float]
-    ) -> None:
-        self._timeout_calculator = timeout_calculator
-
 
 class ChannelOwner(AsyncIOEventEmitter):
     def __init__(
@@ -197,7 +199,9 @@ def _update_subscription(self, event: str, enabled: bool) -> None:
         if protocol_event:
             self._connection.wrap_api_call_sync(
                 lambda: self._channel.send_no_reply(
-                    "updateSubscription", {"event": protocol_event, "enabled": enabled}
+                    "updateSubscription",
+                    None,
+                    {"event": protocol_event, "enabled": enabled},
                 ),
                 True,
             )
@@ -244,6 +248,7 @@ async def initialize(self) -> "Playwright":
         return from_channel(
             await self._channel.send(
                 "initialize",
+                None,
                 {
                     "sdkLanguage": "python",
                 },
@@ -639,17 +644,23 @@ def _extract_stack_trace_information_from_stack(
     }
 
 
+def _augment_params(
+    params: Optional[Dict],
+    timeout_calculator: Optional[Callable[[Optional[float]], float]],
+) -> Dict:
+    if params is None:
+        params = {}
+    if timeout_calculator:
+        params["timeout"] = timeout_calculator(params.get("timeout"))
+    return _filter_none(params)
+
+
 def _filter_none(d: Mapping) -> Dict:
     result = {}
     for k, v in d.items():
         if v is None:
             continue
-        elif isinstance(v, dict):
-            filtered_v = _filter_none(v)
-            if filtered_v:
-                result[k] = filtered_v
-        else:
-            result[k] = v
+        result[k] = _filter_none(v) if isinstance(v, dict) else v
     return result
 
 
diff --git a/playwright/_impl/_dialog.py b/playwright/_impl/_dialog.py
index a0c6ca77f..226e703b9 100644
--- a/playwright/_impl/_dialog.py
+++ b/playwright/_impl/_dialog.py
@@ -48,7 +48,10 @@ def page(self) -> Optional["Page"]:
         return self._page
 
     async def accept(self, promptText: str = None) -> None:
-        await self._channel.send("accept", locals_to_params(locals()))
+        await self._channel.send("accept", None, locals_to_params(locals()))
 
     async def dismiss(self) -> None:
-        await self._channel.send("dismiss")
+        await self._channel.send(
+            "dismiss",
+            None,
+        )
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index fd99c0b00..88f1a7358 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -56,57 +56,62 @@ def __init__(
     ) -> None:
         super().__init__(parent, type, guid, initializer)
         self._frame = cast("Frame", parent)
-        self._channel._set_timeout_calculator(self._frame._timeout)
 
     async def _createSelectorForTest(self, name: str) -> Optional[str]:
-        return await self._channel.send("createSelectorForTest", dict(name=name))
+        return await self._channel.send(
+            "createSelectorForTest", self._frame._timeout, dict(name=name)
+        )
 
     def as_element(self) -> Optional["ElementHandle"]:
         return self
 
     async def owner_frame(self) -> Optional["Frame"]:
-        return from_nullable_channel(await self._channel.send("ownerFrame"))
+        return from_nullable_channel(await self._channel.send("ownerFrame", None))
 
     async def content_frame(self) -> Optional["Frame"]:
-        return from_nullable_channel(await self._channel.send("contentFrame"))
+        return from_nullable_channel(await self._channel.send("contentFrame", None))
 
     async def get_attribute(self, name: str) -> Optional[str]:
-        return await self._channel.send("getAttribute", dict(name=name))
+        return await self._channel.send("getAttribute", None, dict(name=name))
 
     async def text_content(self) -> Optional[str]:
-        return await self._channel.send("textContent")
+        return await self._channel.send("textContent", None)
 
     async def inner_text(self) -> str:
-        return await self._channel.send("innerText")
+        return await self._channel.send("innerText", None)
 
     async def inner_html(self) -> str:
-        return await self._channel.send("innerHTML")
+        return await self._channel.send("innerHTML", None)
 
     async def is_checked(self) -> bool:
-        return await self._channel.send("isChecked")
+        return await self._channel.send("isChecked", None)
 
     async def is_disabled(self) -> bool:
-        return await self._channel.send("isDisabled")
+        return await self._channel.send("isDisabled", None)
 
     async def is_editable(self) -> bool:
-        return await self._channel.send("isEditable")
+        return await self._channel.send("isEditable", None)
 
     async def is_enabled(self) -> bool:
-        return await self._channel.send("isEnabled")
+        return await self._channel.send("isEnabled", None)
 
     async def is_hidden(self) -> bool:
-        return await self._channel.send("isHidden")
+        return await self._channel.send("isHidden", None)
 
     async def is_visible(self) -> bool:
-        return await self._channel.send("isVisible")
+        return await self._channel.send("isVisible", None)
 
     async def dispatch_event(self, type: str, eventInit: Dict = None) -> None:
         await self._channel.send(
-            "dispatchEvent", dict(type=type, eventInit=serialize_argument(eventInit))
+            "dispatchEvent",
+            None,
+            dict(type=type, eventInit=serialize_argument(eventInit)),
         )
 
     async def scroll_into_view_if_needed(self, timeout: float = None) -> None:
-        await self._channel.send("scrollIntoViewIfNeeded", locals_to_params(locals()))
+        await self._channel.send(
+            "scrollIntoViewIfNeeded", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def hover(
         self,
@@ -117,7 +122,9 @@ async def hover(
         force: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("hover", locals_to_params(locals()))
+        await self._channel.send(
+            "hover", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def click(
         self,
@@ -131,7 +138,9 @@ async def click(
         noWaitAfter: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("click", locals_to_params(locals()))
+        await self._channel.send(
+            "click", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def dblclick(
         self,
@@ -144,7 +153,9 @@ async def dblclick(
         noWaitAfter: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("dblclick", locals_to_params(locals()))
+        await self._channel.send(
+            "dblclick", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def select_option(
         self,
@@ -163,7 +174,7 @@ async def select_option(
                 **convert_select_option_values(value, index, label, element),
             )
         )
-        return await self._channel.send("selectOption", params)
+        return await self._channel.send("selectOption", self._frame._timeout, params)
 
     async def tap(
         self,
@@ -174,7 +185,9 @@ async def tap(
         noWaitAfter: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("tap", locals_to_params(locals()))
+        await self._channel.send(
+            "tap", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def fill(
         self,
@@ -183,13 +196,19 @@ async def fill(
         noWaitAfter: bool = None,
         force: bool = None,
     ) -> None:
-        await self._channel.send("fill", locals_to_params(locals()))
+        await self._channel.send(
+            "fill", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def select_text(self, force: bool = None, timeout: float = None) -> None:
-        await self._channel.send("selectText", locals_to_params(locals()))
+        await self._channel.send(
+            "selectText", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def input_value(self, timeout: float = None) -> str:
-        return await self._channel.send("inputValue", locals_to_params(locals()))
+        return await self._channel.send(
+            "inputValue", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def set_input_files(
         self,
@@ -205,14 +224,15 @@ async def set_input_files(
         converted = await convert_input_files(files, frame.page.context)
         await self._channel.send(
             "setInputFiles",
+            self._frame._timeout,
             {
-                "timeout": self._frame._timeout(timeout),
+                "timeout": timeout,
                 **converted,
             },
         )
 
     async def focus(self) -> None:
-        await self._channel.send("focus")
+        await self._channel.send("focus", None)
 
     async def type(
         self,
@@ -221,7 +241,9 @@ async def type(
         timeout: float = None,
         noWaitAfter: bool = None,
     ) -> None:
-        await self._channel.send("type", locals_to_params(locals()))
+        await self._channel.send(
+            "type", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def press(
         self,
@@ -230,7 +252,9 @@ async def press(
         timeout: float = None,
         noWaitAfter: bool = None,
     ) -> None:
-        await self._channel.send("press", locals_to_params(locals()))
+        await self._channel.send(
+            "press", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def set_checked(
         self,
@@ -264,7 +288,9 @@ async def check(
         noWaitAfter: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("check", locals_to_params(locals()))
+        await self._channel.send(
+            "check", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def uncheck(
         self,
@@ -274,10 +300,12 @@ async def uncheck(
         noWaitAfter: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("uncheck", locals_to_params(locals()))
+        await self._channel.send(
+            "uncheck", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def bounding_box(self) -> Optional[FloatRect]:
-        return await self._channel.send("boundingBox")
+        return await self._channel.send("boundingBox", None)
 
     async def screenshot(
         self,
@@ -308,7 +336,9 @@ async def screenshot(
                     params["mask"],
                 )
             )
-        encoded_binary = await self._channel.send("screenshot", params)
+        encoded_binary = await self._channel.send(
+            "screenshot", self._frame._timeout, params
+        )
         decoded_binary = base64.b64decode(encoded_binary)
         if path:
             make_dirs_for_file(path)
@@ -317,14 +347,16 @@ async def screenshot(
 
     async def query_selector(self, selector: str) -> Optional["ElementHandle"]:
         return from_nullable_channel(
-            await self._channel.send("querySelector", dict(selector=selector))
+            await self._channel.send("querySelector", None, dict(selector=selector))
         )
 
     async def query_selector_all(self, selector: str) -> List["ElementHandle"]:
         return list(
             map(
                 cast(Callable[[Any], Any], from_nullable_channel),
-                await self._channel.send("querySelectorAll", dict(selector=selector)),
+                await self._channel.send(
+                    "querySelectorAll", None, dict(selector=selector)
+                ),
             )
         )
 
@@ -337,6 +369,7 @@ async def eval_on_selector(
         return parse_result(
             await self._channel.send(
                 "evalOnSelector",
+                None,
                 dict(
                     selector=selector,
                     expression=expression,
@@ -354,6 +387,7 @@ async def eval_on_selector_all(
         return parse_result(
             await self._channel.send(
                 "evalOnSelectorAll",
+                None,
                 dict(
                     selector=selector,
                     expression=expression,
@@ -369,7 +403,9 @@ async def wait_for_element_state(
         ],
         timeout: float = None,
     ) -> None:
-        await self._channel.send("waitForElementState", locals_to_params(locals()))
+        await self._channel.send(
+            "waitForElementState", self._frame._timeout, locals_to_params(locals())
+        )
 
     async def wait_for_selector(
         self,
@@ -379,7 +415,9 @@ async def wait_for_selector(
         strict: bool = None,
     ) -> Optional["ElementHandle"]:
         return from_nullable_channel(
-            await self._channel.send("waitForSelector", locals_to_params(locals()))
+            await self._channel.send(
+                "waitForSelector", self._frame._timeout, locals_to_params(locals())
+            )
         )
 
 
diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index a0120e0cd..e4174ea27 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -91,7 +91,9 @@ async def new_context(
         )
         context = cast(
             APIRequestContext,
-            from_channel(await self.playwright._channel.send("newRequest", params)),
+            from_channel(
+                await self.playwright._channel.send("newRequest", None, params)
+            ),
         )
         context._timeout_settings.set_default_timeout(timeout)
         return context
@@ -105,12 +107,11 @@ def __init__(
         self._tracing: Tracing = from_channel(initializer["tracing"])
         self._close_reason: Optional[str] = None
         self._timeout_settings = TimeoutSettings(None)
-        self._channel._set_timeout_calculator(self._timeout_settings.timeout)
 
     async def dispose(self, reason: str = None) -> None:
         self._close_reason = reason
         try:
-            await self._channel.send("dispose", {"reason": reason})
+            await self._channel.send("dispose", None, {"reason": reason})
         except Error as e:
             if is_target_closed_error(e):
                 return
@@ -408,6 +409,7 @@ async def _inner_fetch(
 
         response = await self._channel.send(
             "fetch",
+            self._timeout_settings.timeout,
             {
                 "url": url,
                 "params": object_to_array(params) if isinstance(params, dict) else None,
@@ -432,7 +434,7 @@ async def storage_state(
         indexedDB: bool = None,
     ) -> StorageState:
         result = await self._channel.send_return_as_dict(
-            "storageState", {"indexedDB": indexedDB}
+            "storageState", None, {"indexedDB": indexedDB}
         )
         if path:
             await async_writefile(path, json.dumps(result))
@@ -487,6 +489,7 @@ async def body(self) -> bytes:
             result = await self._request._connection.wrap_api_call(
                 lambda: self._request._channel.send_return_as_dict(
                     "fetchResponseBody",
+                    None,
                     {
                         "fetchUid": self._fetch_uid,
                     },
@@ -512,6 +515,7 @@ async def json(self) -> Any:
     async def dispose(self) -> None:
         await self._request._channel.send(
             "disposeAPIResponse",
+            None,
             {
                 "fetchUid": self._fetch_uid,
             },
@@ -524,6 +528,7 @@ def _fetch_uid(self) -> str:
     async def _fetch_log(self) -> List[str]:
         return await self._request._channel.send(
             "fetchLog",
+            None,
             {
                 "fetchUid": self._fetch_uid,
             },
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index fc3c4a54d..c0646b680 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -101,7 +101,6 @@ def __init__(
             "navigated",
             lambda params: self._on_frame_navigated(params),
         )
-        self._channel._set_timeout_calculator(self._timeout)
 
     def __repr__(self) -> str:
         return f"<Frame name={self.name} url={self.url!r}>"
@@ -127,7 +126,7 @@ def _on_frame_navigated(self, event: FrameNavigatedEvent) -> None:
             self._page.emit("framenavigated", self)
 
     async def _query_count(self, selector: str) -> int:
-        return await self._channel.send("queryCount", {"selector": selector})
+        return await self._channel.send("queryCount", None, {"selector": selector})
 
     @property
     def page(self) -> "Page":
@@ -145,7 +144,7 @@ async def goto(
             Optional[Response],
             from_nullable_channel(
                 await self._channel.send(
-                    "goto", self._locals_to_params_with_navigation_timeout(locals())
+                    "goto", self._navigation_timeout, locals_to_params(locals())
                 )
             ),
         )
@@ -286,12 +285,13 @@ def _navigation_timeout(self, timeout: Optional[float]) -> float:
         return timeout_settings.navigation_timeout(timeout)
 
     async def frame_element(self) -> ElementHandle:
-        return from_channel(await self._channel.send("frameElement"))
+        return from_channel(await self._channel.send("frameElement", None))
 
     async def evaluate(self, expression: str, arg: Serializable = None) -> Any:
         return parse_result(
             await self._channel.send(
                 "evaluateExpression",
+                None,
                 dict(
                     expression=expression,
                     arg=serialize_argument(arg),
@@ -305,6 +305,7 @@ async def evaluate_handle(
         return from_channel(
             await self._channel.send(
                 "evaluateExpressionHandle",
+                None,
                 dict(
                     expression=expression,
                     arg=serialize_argument(arg),
@@ -316,14 +317,16 @@ async def query_selector(
         self, selector: str, strict: bool = None
     ) -> Optional[ElementHandle]:
         return from_nullable_channel(
-            await self._channel.send("querySelector", locals_to_params(locals()))
+            await self._channel.send("querySelector", None, locals_to_params(locals()))
         )
 
     async def query_selector_all(self, selector: str) -> List[ElementHandle]:
         return list(
             map(
                 from_channel,
-                await self._channel.send("querySelectorAll", dict(selector=selector)),
+                await self._channel.send(
+                    "querySelectorAll", None, dict(selector=selector)
+                ),
             )
         )
 
@@ -335,34 +338,48 @@ async def wait_for_selector(
         state: Literal["attached", "detached", "hidden", "visible"] = None,
     ) -> Optional[ElementHandle]:
         return from_nullable_channel(
-            await self._channel.send("waitForSelector", locals_to_params(locals()))
+            await self._channel.send(
+                "waitForSelector", self._timeout, locals_to_params(locals())
+            )
         )
 
     async def is_checked(
         self, selector: str, strict: bool = None, timeout: float = None
     ) -> bool:
-        return await self._channel.send("isChecked", locals_to_params(locals()))
+        return await self._channel.send(
+            "isChecked", self._timeout, locals_to_params(locals())
+        )
 
     async def is_disabled(
         self, selector: str, strict: bool = None, timeout: float = None
     ) -> bool:
-        return await self._channel.send("isDisabled", locals_to_params(locals()))
+        return await self._channel.send(
+            "isDisabled", self._timeout, locals_to_params(locals())
+        )
 
     async def is_editable(
         self, selector: str, strict: bool = None, timeout: float = None
     ) -> bool:
-        return await self._channel.send("isEditable", locals_to_params(locals()))
+        return await self._channel.send(
+            "isEditable", self._timeout, locals_to_params(locals())
+        )
 
     async def is_enabled(
         self, selector: str, strict: bool = None, timeout: float = None
     ) -> bool:
-        return await self._channel.send("isEnabled", locals_to_params(locals()))
+        return await self._channel.send(
+            "isEnabled", self._timeout, locals_to_params(locals())
+        )
 
     async def is_hidden(self, selector: str, strict: bool = None) -> bool:
-        return await self._channel.send("isHidden", locals_to_params(locals()))
+        return await self._channel.send(
+            "isHidden", self._timeout, locals_to_params(locals())
+        )
 
     async def is_visible(self, selector: str, strict: bool = None) -> bool:
-        return await self._channel.send("isVisible", locals_to_params(locals()))
+        return await self._channel.send(
+            "isVisible", self._timeout, locals_to_params(locals())
+        )
 
     async def dispatch_event(
         self,
@@ -374,6 +391,7 @@ async def dispatch_event(
     ) -> None:
         await self._channel.send(
             "dispatchEvent",
+            self._timeout,
             locals_to_params(
                 dict(
                     selector=selector,
@@ -395,6 +413,7 @@ async def eval_on_selector(
         return parse_result(
             await self._channel.send(
                 "evalOnSelector",
+                None,
                 locals_to_params(
                     dict(
                         selector=selector,
@@ -415,6 +434,7 @@ async def eval_on_selector_all(
         return parse_result(
             await self._channel.send(
                 "evalOnSelectorAll",
+                None,
                 dict(
                     selector=selector,
                     expression=expression,
@@ -424,7 +444,7 @@ async def eval_on_selector_all(
         )
 
     async def content(self) -> str:
-        return await self._channel.send("content")
+        return await self._channel.send("content", None)
 
     async def set_content(
         self,
@@ -433,7 +453,7 @@ async def set_content(
         waitUntil: DocumentLoadState = None,
     ) -> None:
         await self._channel.send(
-            "setContent", self._locals_to_params_with_navigation_timeout(locals())
+            "setContent", self._navigation_timeout, locals_to_params(locals())
         )
 
     @property
@@ -468,7 +488,7 @@ async def add_script_tag(
                 (await async_readfile(path)).decode(), path
             )
             del params["path"]
-        return from_channel(await self._channel.send("addScriptTag", params))
+        return from_channel(await self._channel.send("addScriptTag", None, params))
 
     async def add_style_tag(
         self, url: str = None, path: Union[str, Path] = None, content: str = None
@@ -482,7 +502,7 @@ async def add_style_tag(
                 + "*/"
             )
             del params["path"]
-        return from_channel(await self._channel.send("addStyleTag", params))
+        return from_channel(await self._channel.send("addStyleTag", None, params))
 
     async def click(
         self,
@@ -498,7 +518,7 @@ async def click(
         strict: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("click", locals_to_params(locals()))
+        await self._channel.send("click", self._timeout, locals_to_params(locals()))
 
     async def dblclick(
         self,
@@ -514,7 +534,7 @@ async def dblclick(
         trial: bool = None,
     ) -> None:
         await self._channel.send(
-            "dblclick", locals_to_params(locals()), title="Double click"
+            "dblclick", self._timeout, locals_to_params(locals()), title="Double click"
         )
 
     async def tap(
@@ -528,7 +548,7 @@ async def tap(
         strict: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("tap", locals_to_params(locals()))
+        await self._channel.send("tap", self._timeout, locals_to_params(locals()))
 
     async def fill(
         self,
@@ -539,7 +559,7 @@ async def fill(
         strict: bool = None,
         force: bool = None,
     ) -> None:
-        await self._channel.send("fill", locals_to_params(locals()))
+        await self._channel.send("fill", self._timeout, locals_to_params(locals()))
 
     def locator(
         self,
@@ -620,27 +640,35 @@ def frame_locator(self, selector: str) -> FrameLocator:
     async def focus(
         self, selector: str, strict: bool = None, timeout: float = None
     ) -> None:
-        await self._channel.send("focus", locals_to_params(locals()))
+        await self._channel.send("focus", self._timeout, locals_to_params(locals()))
 
     async def text_content(
         self, selector: str, strict: bool = None, timeout: float = None
     ) -> Optional[str]:
-        return await self._channel.send("textContent", locals_to_params(locals()))
+        return await self._channel.send(
+            "textContent", self._timeout, locals_to_params(locals())
+        )
 
     async def inner_text(
         self, selector: str, strict: bool = None, timeout: float = None
     ) -> str:
-        return await self._channel.send("innerText", locals_to_params(locals()))
+        return await self._channel.send(
+            "innerText", self._timeout, locals_to_params(locals())
+        )
 
     async def inner_html(
         self, selector: str, strict: bool = None, timeout: float = None
     ) -> str:
-        return await self._channel.send("innerHTML", locals_to_params(locals()))
+        return await self._channel.send(
+            "innerHTML", self._timeout, locals_to_params(locals())
+        )
 
     async def get_attribute(
         self, selector: str, name: str, strict: bool = None, timeout: float = None
     ) -> Optional[str]:
-        return await self._channel.send("getAttribute", locals_to_params(locals()))
+        return await self._channel.send(
+            "getAttribute", self._timeout, locals_to_params(locals())
+        )
 
     async def hover(
         self,
@@ -653,7 +681,7 @@ async def hover(
         strict: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("hover", locals_to_params(locals()))
+        await self._channel.send("hover", self._timeout, locals_to_params(locals()))
 
     async def drag_and_drop(
         self,
@@ -667,7 +695,9 @@ async def drag_and_drop(
         timeout: float = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("dragAndDrop", locals_to_params(locals()))
+        await self._channel.send(
+            "dragAndDrop", self._timeout, locals_to_params(locals())
+        )
 
     async def select_option(
         self,
@@ -690,7 +720,7 @@ async def select_option(
                 **convert_select_option_values(value, index, label, element),
             )
         )
-        return await self._channel.send("selectOption", params)
+        return await self._channel.send("selectOption", self._timeout, params)
 
     async def input_value(
         self,
@@ -698,7 +728,9 @@ async def input_value(
         strict: bool = None,
         timeout: float = None,
     ) -> str:
-        return await self._channel.send("inputValue", locals_to_params(locals()))
+        return await self._channel.send(
+            "inputValue", self._timeout, locals_to_params(locals())
+        )
 
     async def set_input_files(
         self,
@@ -713,6 +745,7 @@ async def set_input_files(
         converted = await convert_input_files(files, self.page.context)
         await self._channel.send(
             "setInputFiles",
+            self._timeout,
             {
                 "selector": selector,
                 "strict": strict,
@@ -730,7 +763,7 @@ async def type(
         timeout: float = None,
         noWaitAfter: bool = None,
     ) -> None:
-        await self._channel.send("type", locals_to_params(locals()))
+        await self._channel.send("type", self._timeout, locals_to_params(locals()))
 
     async def press(
         self,
@@ -741,7 +774,7 @@ async def press(
         timeout: float = None,
         noWaitAfter: bool = None,
     ) -> None:
-        await self._channel.send("press", locals_to_params(locals()))
+        await self._channel.send("press", self._timeout, locals_to_params(locals()))
 
     async def check(
         self,
@@ -753,7 +786,7 @@ async def check(
         strict: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("check", locals_to_params(locals()))
+        await self._channel.send("check", self._timeout, locals_to_params(locals()))
 
     async def uncheck(
         self,
@@ -765,10 +798,10 @@ async def uncheck(
         strict: bool = None,
         trial: bool = None,
     ) -> None:
-        await self._channel.send("uncheck", locals_to_params(locals()))
+        await self._channel.send("uncheck", self._timeout, locals_to_params(locals()))
 
     async def wait_for_timeout(self, timeout: float) -> None:
-        await self._channel.send("waitForTimeout", locals_to_params(locals()))
+        await self._channel.send("waitForTimeout", None, locals_to_params(locals()))
 
     async def wait_for_function(
         self,
@@ -783,10 +816,12 @@ async def wait_for_function(
         params["arg"] = serialize_argument(arg)
         if polling is not None and polling != "raf":
             params["pollingInterval"] = polling
-        return from_channel(await self._channel.send("waitForFunction", params))
+        return from_channel(
+            await self._channel.send("waitForFunction", self._timeout, params)
+        )
 
     async def title(self) -> str:
-        return await self._channel.send("title")
+        return await self._channel.send("title", None)
 
     async def set_checked(
         self,
@@ -819,9 +854,4 @@ async def set_checked(
             )
 
     async def _highlight(self, selector: str) -> None:
-        await self._channel.send("highlight", {"selector": selector})
-
-    def _locals_to_params_with_navigation_timeout(self, args: Dict) -> Dict:
-        params = locals_to_params(args)
-        params["timeout"] = self._navigation_timeout(params.get("timeout"))
-        return params
+        await self._channel.send("highlight", None, {"selector": selector})
diff --git a/playwright/_impl/_har_router.py b/playwright/_impl/_har_router.py
index 33ff37871..1fa1b0433 100644
--- a/playwright/_impl/_har_router.py
+++ b/playwright/_impl/_har_router.py
@@ -49,7 +49,7 @@ async def create(
         not_found_action: RouteFromHarNotFoundPolicy,
         url_matcher: Optional[URLMatch] = None,
     ) -> "HarRouter":
-        har_id = await local_utils._channel.send("harOpen", {"file": file})
+        har_id = await local_utils._channel.send("harOpen", None, {"file": file})
         return HarRouter(
             local_utils=local_utils,
             har_id=har_id,
@@ -118,5 +118,5 @@ async def add_page_route(self, page: "Page") -> None:
 
     def dispose(self) -> None:
         asyncio.create_task(
-            self._local_utils._channel.send("harClose", {"harId": self._har_id})
+            self._local_utils._channel.send("harClose", None, {"harId": self._har_id})
         )
diff --git a/playwright/_impl/_input.py b/playwright/_impl/_input.py
index 0e986ae8c..8a39242ee 100644
--- a/playwright/_impl/_input.py
+++ b/playwright/_impl/_input.py
@@ -23,19 +23,19 @@ def __init__(self, channel: Channel) -> None:
         self._dispatcher_fiber = channel._connection._dispatcher_fiber
 
     async def down(self, key: str) -> None:
-        await self._channel.send("keyboardDown", locals_to_params(locals()))
+        await self._channel.send("keyboardDown", None, locals_to_params(locals()))
 
     async def up(self, key: str) -> None:
-        await self._channel.send("keyboardUp", locals_to_params(locals()))
+        await self._channel.send("keyboardUp", None, locals_to_params(locals()))
 
     async def insert_text(self, text: str) -> None:
-        await self._channel.send("keyboardInsertText", locals_to_params(locals()))
+        await self._channel.send("keyboardInsertText", None, locals_to_params(locals()))
 
     async def type(self, text: str, delay: float = None) -> None:
-        await self._channel.send("keyboardType", locals_to_params(locals()))
+        await self._channel.send("keyboardType", None, locals_to_params(locals()))
 
     async def press(self, key: str, delay: float = None) -> None:
-        await self._channel.send("keyboardPress", locals_to_params(locals()))
+        await self._channel.send("keyboardPress", None, locals_to_params(locals()))
 
 
 class Mouse:
@@ -45,21 +45,21 @@ def __init__(self, channel: Channel) -> None:
         self._dispatcher_fiber = channel._connection._dispatcher_fiber
 
     async def move(self, x: float, y: float, steps: int = None) -> None:
-        await self._channel.send("mouseMove", locals_to_params(locals()))
+        await self._channel.send("mouseMove", None, locals_to_params(locals()))
 
     async def down(
         self,
         button: MouseButton = None,
         clickCount: int = None,
     ) -> None:
-        await self._channel.send("mouseDown", locals_to_params(locals()))
+        await self._channel.send("mouseDown", None, locals_to_params(locals()))
 
     async def up(
         self,
         button: MouseButton = None,
         clickCount: int = None,
     ) -> None:
-        await self._channel.send("mouseUp", locals_to_params(locals()))
+        await self._channel.send("mouseUp", None, locals_to_params(locals()))
 
     async def _click(
         self,
@@ -70,7 +70,9 @@ async def _click(
         clickCount: int = None,
         title: str = None,
     ) -> None:
-        await self._channel.send("mouseClick", locals_to_params(locals()), title=title)
+        await self._channel.send(
+            "mouseClick", None, locals_to_params(locals()), title=title
+        )
 
     async def click(
         self,
@@ -96,7 +98,7 @@ async def dblclick(
         )
 
     async def wheel(self, deltaX: float, deltaY: float) -> None:
-        await self._channel.send("mouseWheel", locals_to_params(locals()))
+        await self._channel.send("mouseWheel", None, locals_to_params(locals()))
 
 
 class Touchscreen:
@@ -106,4 +108,4 @@ def __init__(self, channel: Channel) -> None:
         self._dispatcher_fiber = channel._connection._dispatcher_fiber
 
     async def tap(self, x: float, y: float) -> None:
-        await self._channel.send("touchscreenTap", locals_to_params(locals()))
+        await self._channel.send("touchscreenTap", None, locals_to_params(locals()))
diff --git a/playwright/_impl/_js_handle.py b/playwright/_impl/_js_handle.py
index 0d0d7e2ef..84ef40d18 100644
--- a/playwright/_impl/_js_handle.py
+++ b/playwright/_impl/_js_handle.py
@@ -71,6 +71,7 @@ async def evaluate(self, expression: str, arg: Serializable = None) -> Any:
         return parse_result(
             await self._channel.send(
                 "evaluateExpression",
+                None,
                 dict(
                     expression=expression,
                     arg=serialize_argument(arg),
@@ -84,6 +85,7 @@ async def evaluate_handle(
         return from_channel(
             await self._channel.send(
                 "evaluateExpressionHandle",
+                None,
                 dict(
                     expression=expression,
                     arg=serialize_argument(arg),
@@ -93,13 +95,16 @@ async def evaluate_handle(
 
     async def get_property(self, propertyName: str) -> "JSHandle":
         return from_channel(
-            await self._channel.send("getProperty", dict(name=propertyName))
+            await self._channel.send("getProperty", None, dict(name=propertyName))
         )
 
     async def get_properties(self) -> Dict[str, "JSHandle"]:
         return {
             prop["name"]: from_channel(prop["value"])
-            for prop in await self._channel.send("getPropertyList")
+            for prop in await self._channel.send(
+                "getPropertyList",
+                None,
+            )
         }
 
     def as_element(self) -> Optional["ElementHandle"]:
@@ -107,13 +112,21 @@ def as_element(self) -> Optional["ElementHandle"]:
 
     async def dispose(self) -> None:
         try:
-            await self._channel.send("dispose")
+            await self._channel.send(
+                "dispose",
+                None,
+            )
         except Exception as e:
             if not is_target_closed_error(e):
                 raise e
 
     async def json_value(self) -> Any:
-        return parse_result(await self._channel.send("jsonValue"))
+        return parse_result(
+            await self._channel.send(
+                "jsonValue",
+                None,
+            )
+        )
 
 
 def serialize_value(
diff --git a/playwright/_impl/_json_pipe.py b/playwright/_impl/_json_pipe.py
index 3a6973baf..41973b8c7 100644
--- a/playwright/_impl/_json_pipe.py
+++ b/playwright/_impl/_json_pipe.py
@@ -36,7 +36,7 @@ def __init__(
 
     def request_stop(self) -> None:
         self._stop_requested = True
-        self._pipe_channel.send_no_reply("close", {})
+        self._pipe_channel.send_no_reply("close", None, {})
 
     def dispose(self) -> None:
         self.on_error_future.cancel()
@@ -74,4 +74,4 @@ async def run(self) -> None:
     def send(self, message: Dict) -> None:
         if self._stop_requested:
             raise Error("Playwright connection closed")
-        self._pipe_channel.send_no_reply("send", {"message": message})
+        self._pipe_channel.send_no_reply("send", None, {"message": message})
diff --git a/playwright/_impl/_local_utils.py b/playwright/_impl/_local_utils.py
index 7172ee58a..c2d2d3fca 100644
--- a/playwright/_impl/_local_utils.py
+++ b/playwright/_impl/_local_utils.py
@@ -31,11 +31,11 @@ def __init__(
         }
 
     async def zip(self, params: Dict) -> None:
-        await self._channel.send("zip", params)
+        await self._channel.send("zip", None, params)
 
     async def har_open(self, file: str) -> None:
         params = locals_to_params(locals())
-        await self._channel.send("harOpen", params)
+        await self._channel.send("harOpen", None, params)
 
     async def har_lookup(
         self,
@@ -51,27 +51,28 @@ async def har_lookup(
             params["postData"] = base64.b64encode(params["postData"]).decode()
         return cast(
             HarLookupResult,
-            await self._channel.send_return_as_dict("harLookup", params),
+            await self._channel.send_return_as_dict("harLookup", None, params),
         )
 
     async def har_close(self, harId: str) -> None:
         params = locals_to_params(locals())
-        await self._channel.send("harClose", params)
+        await self._channel.send("harClose", None, params)
 
     async def har_unzip(self, zipFile: str, harFile: str) -> None:
         params = locals_to_params(locals())
-        await self._channel.send("harUnzip", params)
+        await self._channel.send("harUnzip", None, params)
 
     async def tracing_started(self, tracesDir: Optional[str], traceName: str) -> str:
         params = locals_to_params(locals())
-        return await self._channel.send("tracingStarted", params)
+        return await self._channel.send("tracingStarted", None, params)
 
     async def trace_discarded(self, stacks_id: str) -> None:
-        return await self._channel.send("traceDiscarded", {"stacksId": stacks_id})
+        return await self._channel.send("traceDiscarded", None, {"stacksId": stacks_id})
 
     def add_stack_to_tracing_no_reply(self, id: int, frames: List[StackFrame]) -> None:
         self._channel.send_no_reply(
             "addStackToTracingNoReply",
+            None,
             {
                 "callData": {
                     "stack": frames,
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 9d190c453..6fe075130 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -383,6 +383,7 @@ async def focus(self, timeout: float = None) -> None:
     async def blur(self, timeout: float = None) -> None:
         await self._frame._channel.send(
             "blur",
+            self._frame._timeout,
             {
                 "selector": self._selector,
                 "strict": True,
@@ -549,6 +550,7 @@ async def screenshot(
     async def aria_snapshot(self, timeout: float = None) -> str:
         return await self._frame._channel.send(
             "ariaSnapshot",
+            self._frame._timeout,
             {
                 "selector": self._selector,
                 **locals_to_params(locals()),
@@ -726,6 +728,7 @@ async def _expect(
             options["expectedValue"] = serialize_argument(options["expectedValue"])
         result = await self._frame._channel.send_return_as_dict(
             "expect",
+            self._frame._timeout,
             {
                 "selector": self._selector,
                 "expression": expression,
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 748967dd8..616c75ec9 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -192,7 +192,10 @@ async def sizes(self) -> RequestSizes:
         response = await self.response()
         if not response:
             raise Error("Unable to fetch sizes for failed request")
-        return await response._channel.send("sizes")
+        return await response._channel.send(
+            "sizes",
+            None,
+        )
 
     @property
     def post_data(self) -> Optional[str]:
@@ -226,7 +229,12 @@ def post_data_buffer(self) -> Optional[bytes]:
         return None
 
     async def response(self) -> Optional["Response"]:
-        return from_nullable_channel(await self._channel.send("response"))
+        return from_nullable_channel(
+            await self._channel.send(
+                "response",
+                None,
+            )
+        )
 
     @property
     def frame(self) -> "Frame":
@@ -291,7 +299,9 @@ async def _actual_headers(self) -> "RawHeaders":
             return RawHeaders(serialize_headers(override))
         if not self._all_headers_future:
             self._all_headers_future = asyncio.Future()
-            headers = await self._channel.send("rawRequestHeaders", is_internal=True)
+            headers = await self._channel.send(
+                "rawRequestHeaders", None, is_internal=True
+            )
             self._all_headers_future.set_result(RawHeaders(headers))
         return await self._all_headers_future
 
@@ -348,6 +358,7 @@ async def abort(self, errorCode: str = None) -> None:
             lambda: self._race_with_page_close(
                 self._channel.send(
                     "abort",
+                    None,
                     {
                         "errorCode": errorCode,
                     },
@@ -433,7 +444,7 @@ async def _inner_fulfill(
             headers["content-length"] = str(length)
         params["headers"] = serialize_headers(headers)
 
-        await self._race_with_page_close(self._channel.send("fulfill", params))
+        await self._race_with_page_close(self._channel.send("fulfill", None, params))
 
     async def _handle_route(self, callback: Callable) -> None:
         self._check_not_handled()
@@ -499,6 +510,7 @@ async def _inner_continue(self, is_fallback: bool = False) -> None:
         await self._race_with_page_close(
             self._channel.send(
                 "continue",
+                None,
                 {
                     "url": options.url,
                     "method": options.method,
@@ -518,7 +530,7 @@ async def _inner_continue(self, is_fallback: bool = False) -> None:
     async def _redirected_navigation_request(self, url: str) -> None:
         await self._handle_route(
             lambda: self._race_with_page_close(
-                self._channel.send("redirectNavigationRequest", {"url": url})
+                self._channel.send("redirectNavigationRequest", None, {"url": url})
             )
         )
 
@@ -577,6 +589,7 @@ def close(self, code: int = None, reason: str = None) -> None:
             self._ws._loop,
             self._ws._channel.send(
                 "closeServer",
+                None,
                 {
                     "code": code,
                     "reason": reason,
@@ -590,7 +603,7 @@ def send(self, message: Union[str, bytes]) -> None:
             _create_task_and_ignore_exception(
                 self._ws._loop,
                 self._ws._channel.send(
-                    "sendToServer", {"message": message, "isBase64": False}
+                    "sendToServer", None, {"message": message, "isBase64": False}
                 ),
             )
         else:
@@ -598,6 +611,7 @@ def send(self, message: Union[str, bytes]) -> None:
                 self._ws._loop,
                 self._ws._channel.send(
                     "sendToServer",
+                    None,
                     {"message": base64.b64encode(message).decode(), "isBase64": True},
                 ),
             )
@@ -633,7 +647,7 @@ def _channel_message_from_page(self, event: Dict) -> None:
             )
         elif self._connected:
             _create_task_and_ignore_exception(
-                self._loop, self._channel.send("sendToServer", event)
+                self._loop, self._channel.send("sendToServer", None, event)
             )
 
     def _channel_message_from_server(self, event: Dict) -> None:
@@ -645,7 +659,7 @@ def _channel_message_from_server(self, event: Dict) -> None:
             )
         else:
             _create_task_and_ignore_exception(
-                self._loop, self._channel.send("sendToPage", event)
+                self._loop, self._channel.send("sendToPage", None, event)
             )
 
     def _channel_close_page(self, event: Dict) -> None:
@@ -653,7 +667,7 @@ def _channel_close_page(self, event: Dict) -> None:
             self._on_page_close(event["code"], event["reason"])
         else:
             _create_task_and_ignore_exception(
-                self._loop, self._channel.send("closeServer", event)
+                self._loop, self._channel.send("closeServer", None, event)
             )
 
     def _channel_close_server(self, event: Dict) -> None:
@@ -661,7 +675,7 @@ def _channel_close_server(self, event: Dict) -> None:
             self._on_server_close(event["code"], event["reason"])
         else:
             _create_task_and_ignore_exception(
-                self._loop, self._channel.send("closePage", event)
+                self._loop, self._channel.send("closePage", None, event)
             )
 
     @property
@@ -671,7 +685,7 @@ def url(self) -> str:
     async def close(self, code: int = None, reason: str = None) -> None:
         try:
             await self._channel.send(
-                "closePage", {"code": code, "reason": reason, "wasClean": True}
+                "closePage", None, {"code": code, "reason": reason, "wasClean": True}
             )
         except Exception:
             pass
@@ -680,7 +694,12 @@ def connect_to_server(self) -> "WebSocketRoute":
         if self._connected:
             raise Error("Already connected to the server")
         self._connected = True
-        asyncio.create_task(self._channel.send("connect"))
+        asyncio.create_task(
+            self._channel.send(
+                "connect",
+                None,
+            )
+        )
         return cast("WebSocketRoute", self._server)
 
     def send(self, message: Union[str, bytes]) -> None:
@@ -688,7 +707,7 @@ def send(self, message: Union[str, bytes]) -> None:
             _create_task_and_ignore_exception(
                 self._loop,
                 self._channel.send(
-                    "sendToPage", {"message": message, "isBase64": False}
+                    "sendToPage", None, {"message": message, "isBase64": False}
                 ),
             )
         else:
@@ -696,6 +715,7 @@ def send(self, message: Union[str, bytes]) -> None:
                 self._loop,
                 self._channel.send(
                     "sendToPage",
+                    None,
                     {
                         "message": base64.b64encode(message).decode(),
                         "isBase64": True,
@@ -713,7 +733,10 @@ async def _after_handle(self) -> None:
         if self._connected:
             return
         # Ensure that websocket is "open" and can send messages without an actual server connection.
-        await self._channel.send("ensureOpened")
+        await self._channel.send(
+            "ensureOpened",
+            None,
+        )
 
 
 class WebSocketRouteHandler:
@@ -826,15 +849,27 @@ async def header_values(self, name: str) -> List[str]:
     async def _actual_headers(self) -> "RawHeaders":
         if not self._raw_headers_future:
             self._raw_headers_future = asyncio.Future()
-            headers = cast(HeadersArray, await self._channel.send("rawResponseHeaders"))
+            headers = cast(
+                HeadersArray,
+                await self._channel.send(
+                    "rawResponseHeaders",
+                    None,
+                ),
+            )
             self._raw_headers_future.set_result(RawHeaders(headers))
         return await self._raw_headers_future
 
     async def server_addr(self) -> Optional[RemoteAddr]:
-        return await self._channel.send("serverAddr")
+        return await self._channel.send(
+            "serverAddr",
+            None,
+        )
 
     async def security_details(self) -> Optional[SecurityDetails]:
-        return await self._channel.send("securityDetails")
+        return await self._channel.send(
+            "securityDetails",
+            None,
+        )
 
     async def finished(self) -> None:
         async def on_finished() -> None:
@@ -853,7 +888,10 @@ async def on_finished() -> None:
             await on_finished_task
 
     async def body(self) -> bytes:
-        binary = await self._channel.send("body")
+        binary = await self._channel.send(
+            "body",
+            None,
+        )
         return base64.b64decode(binary)
 
     async def text(self) -> str:
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 82b43a231..20bba35db 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -237,7 +237,6 @@ def __init__(
         self._channel.on(
             "worker", lambda params: self._on_worker(from_channel(params["worker"]))
         )
-        self._channel._set_timeout_calculator(self._timeout_settings.timeout)
         self._closed_or_crashed_future: asyncio.Future = asyncio.Future()
         self.on(
             Page.Events.Close,
@@ -520,12 +519,16 @@ async def expose_binding(
             )
         self._bindings[name] = callback
         await self._channel.send(
-            "exposeBinding", dict(name=name, needsHandle=handle or False)
+            "exposeBinding",
+            None,
+            dict(name=name, needsHandle=handle or False),
         )
 
     async def set_extra_http_headers(self, headers: Dict[str, str]) -> None:
         await self._channel.send(
-            "setExtraHTTPHeaders", dict(headers=serialize_headers(headers))
+            "setExtraHTTPHeaders",
+            None,
+            dict(headers=serialize_headers(headers)),
         )
 
     @property
@@ -559,7 +562,9 @@ async def reload(
     ) -> Optional[Response]:
         return from_nullable_channel(
             await self._channel.send(
-                "reload", self._locals_to_params_with_navigation_timeout(locals())
+                "reload",
+                self._timeout_settings.navigation_timeout,
+                locals_to_params(locals()),
             )
         )
 
@@ -592,7 +597,9 @@ async def go_back(
     ) -> Optional[Response]:
         return from_nullable_channel(
             await self._channel.send(
-                "goBack", self._locals_to_params_with_navigation_timeout(locals())
+                "goBack",
+                self._timeout_settings.navigation_timeout,
+                locals_to_params(locals()),
             )
         )
 
@@ -603,12 +610,14 @@ async def go_forward(
     ) -> Optional[Response]:
         return from_nullable_channel(
             await self._channel.send(
-                "goForward", self._locals_to_params_with_navigation_timeout(locals())
+                "goForward",
+                self._timeout_settings.navigation_timeout,
+                locals_to_params(locals()),
             )
         )
 
     async def request_gc(self) -> None:
-        await self._channel.send("requestGC")
+        await self._channel.send("requestGC", None)
 
     async def emulate_media(
         self,
@@ -637,18 +646,22 @@ async def emulate_media(
             params["contrast"] = (
                 "no-override" if params["contrast"] == "null" else contrast
             )
-        await self._channel.send("emulateMedia", params)
+        await self._channel.send("emulateMedia", None, params)
 
     async def set_viewport_size(self, viewportSize: ViewportSize) -> None:
         self._viewport_size = viewportSize
-        await self._channel.send("setViewportSize", locals_to_params(locals()))
+        await self._channel.send(
+            "setViewportSize",
+            None,
+            locals_to_params(locals()),
+        )
 
     @property
     def viewport_size(self) -> Optional[ViewportSize]:
         return self._viewport_size
 
     async def bring_to_front(self) -> None:
-        await self._channel.send("bringToFront")
+        await self._channel.send("bringToFront", None)
 
     async def add_init_script(
         self, script: str = None, path: Union[str, Path] = None
@@ -659,7 +672,7 @@ async def add_init_script(
             )
         if not isinstance(script, str):
             raise Error("Either path or script parameter must be specified")
-        await self._channel.send("addInitScript", dict(source=script))
+        await self._channel.send("addInitScript", None, dict(source=script))
 
     async def route(
         self, url: URLMatch, handler: RouteHandlerCallback, times: int = None
@@ -757,7 +770,9 @@ async def route_from_har(
     async def _update_interception_patterns(self) -> None:
         patterns = RouteHandler.prepare_interception_patterns(self._routes)
         await self._channel.send(
-            "setNetworkInterceptionPatterns", {"patterns": patterns}
+            "setNetworkInterceptionPatterns",
+            None,
+            {"patterns": patterns},
         )
 
     async def _update_web_socket_interception_patterns(self) -> None:
@@ -765,7 +780,9 @@ async def _update_web_socket_interception_patterns(self) -> None:
             self._web_socket_routes
         )
         await self._channel.send(
-            "setWebSocketInterceptionPatterns", {"patterns": patterns}
+            "setWebSocketInterceptionPatterns",
+            None,
+            {"patterns": patterns},
         )
 
     async def screenshot(
@@ -799,7 +816,9 @@ async def screenshot(
                     params["mask"],
                 )
             )
-        encoded_binary = await self._channel.send("screenshot", params)
+        encoded_binary = await self._channel.send(
+            "screenshot", self._timeout_settings.timeout, params
+        )
         decoded_binary = base64.b64decode(encoded_binary)
         if path:
             make_dirs_for_file(path)
@@ -813,7 +832,7 @@ async def close(self, runBeforeUnload: bool = None, reason: str = None) -> None:
         self._close_reason = reason
         self._close_was_called = True
         try:
-            await self._channel.send("close", locals_to_params(locals()))
+            await self._channel.send("close", None, locals_to_params(locals()))
             if self._owned_context:
                 await self._owned_context.close()
         except Exception as e:
@@ -1112,7 +1131,9 @@ async def pause(self) -> None:
         try:
             await asyncio.wait(
                 [
-                    asyncio.create_task(self._browser_context._channel.send("pause")),
+                    asyncio.create_task(
+                        self._browser_context._channel.send("pause", None)
+                    ),
                     self._closed_or_crashed_future,
                 ],
                 return_when=asyncio.FIRST_COMPLETED,
@@ -1144,7 +1165,7 @@ async def pdf(
         params = locals_to_params(locals())
         if "path" in params:
             del params["path"]
-        encoded_binary = await self._channel.send("pdf", params)
+        encoded_binary = await self._channel.send("pdf", None, params)
         decoded_binary = base64.b64decode(encoded_binary)
         if path:
             make_dirs_for_file(path)
@@ -1354,6 +1375,7 @@ async def add_locator_handler(
             return
         uid = await self._channel.send(
             "registerLocatorHandler",
+            None,
             {
                 "selector": locator._selector,
                 "noWaitAfter": noWaitAfter,
@@ -1394,7 +1416,9 @@ def _handler() -> None:
             try:
                 await self._connection.wrap_api_call(
                     lambda: self._channel.send(
-                        "resolveLocatorHandlerNoReply", {"uid": uid, "remove": remove}
+                        "resolveLocatorHandlerNoReply",
+                        None,
+                        {"uid": uid, "remove": remove},
                     ),
                     is_internal=True,
                 )
@@ -1405,14 +1429,11 @@ async def remove_locator_handler(self, locator: "Locator") -> None:
         for uid, data in self._locator_handlers.copy().items():
             if data.locator._equals(locator):
                 del self._locator_handlers[uid]
-                self._channel.send_no_reply("unregisterLocatorHandler", {"uid": uid})
-
-    def _locals_to_params_with_navigation_timeout(self, args: Dict) -> Dict:
-        params = locals_to_params(args)
-        params["timeout"] = self._timeout_settings.navigation_timeout(
-            params.get("timeout")
-        )
-        return params
+                self._channel.send_no_reply(
+                    "unregisterLocatorHandler",
+                    None,
+                    {"uid": uid},
+                )
 
 
 class Worker(ChannelOwner):
@@ -1444,6 +1465,7 @@ async def evaluate(self, expression: str, arg: Serializable = None) -> Any:
         return parse_result(
             await self._channel.send(
                 "evaluateExpression",
+                None,
                 dict(
                     expression=expression,
                     arg=serialize_argument(arg),
@@ -1457,6 +1479,7 @@ async def evaluate_handle(
         return from_channel(
             await self._channel.send(
                 "evaluateExpressionHandle",
+                None,
                 dict(
                     expression=expression,
                     arg=serialize_argument(arg),
@@ -1482,12 +1505,14 @@ async def call(self, func: Callable) -> None:
                 result = func(source, *func_args)
             if inspect.iscoroutine(result):
                 result = await result
-            await self._channel.send("resolve", dict(result=serialize_argument(result)))
+            await self._channel.send(
+                "resolve", None, dict(result=serialize_argument(result))
+            )
         except Exception as e:
             tb = sys.exc_info()[2]
             asyncio.create_task(
                 self._channel.send(
-                    "reject", dict(error=dict(error=serialize_error(e, tb)))
+                    "reject", None, dict(error=dict(error=serialize_error(e, tb)))
                 )
             )
 
diff --git a/playwright/_impl/_selectors.py b/playwright/_impl/_selectors.py
index b0cf5afbb..2a2e70974 100644
--- a/playwright/_impl/_selectors.py
+++ b/playwright/_impl/_selectors.py
@@ -46,7 +46,9 @@ async def register(
             engine["contentScript"] = contentScript
         for context in self._contexts_for_selectors:
             await context._channel.send(
-                "registerSelectorEngine", {"selectorEngine": engine}
+                "registerSelectorEngine",
+                None,
+                {"selectorEngine": engine},
             )
         self._selector_engines.append(engine)
 
@@ -55,5 +57,7 @@ def set_test_id_attribute(self, attributeName: str) -> None:
         self._test_id_attribute_name = attributeName
         for context in self._contexts_for_selectors:
             context._channel.send_no_reply(
-                "setTestIdAttributeName", {"testIdAttributeName": attributeName}
+                "setTestIdAttributeName",
+                None,
+                {"testIdAttributeName": attributeName},
             )
diff --git a/playwright/_impl/_set_input_files_helpers.py b/playwright/_impl/_set_input_files_helpers.py
index ababf5fab..f868886a3 100644
--- a/playwright/_impl/_set_input_files_helpers.py
+++ b/playwright/_impl/_set_input_files_helpers.py
@@ -84,6 +84,7 @@ async def convert_input_files(
             result = await context._connection.wrap_api_call(
                 lambda: context._channel.send_return_as_dict(
                     "createTempFiles",
+                    None,
                     {
                         "rootDirName": (
                             os.path.basename(local_directory)
diff --git a/playwright/_impl/_stream.py b/playwright/_impl/_stream.py
index d27427589..04afa48e1 100644
--- a/playwright/_impl/_stream.py
+++ b/playwright/_impl/_stream.py
@@ -28,7 +28,7 @@ def __init__(
     async def save_as(self, path: Union[str, Path]) -> None:
         file = await self._loop.run_in_executor(None, lambda: open(path, "wb"))
         while True:
-            binary = await self._channel.send("read", {"size": 1024 * 1024})
+            binary = await self._channel.send("read", None, {"size": 1024 * 1024})
             if not binary:
                 break
             await self._loop.run_in_executor(
@@ -39,7 +39,7 @@ async def save_as(self, path: Union[str, Path]) -> None:
     async def read_all(self) -> bytes:
         binary = b""
         while True:
-            chunk = await self._channel.send("read", {"size": 1024 * 1024})
+            chunk = await self._channel.send("read", None, {"size": 1024 * 1024})
             if not chunk:
                 break
             binary += base64.b64decode(chunk)
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index e984bcbad..bbc6ec35e 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -42,15 +42,15 @@ async def start(
         params = locals_to_params(locals())
         self._include_sources = bool(sources)
 
-        await self._channel.send("tracingStart", params)
+        await self._channel.send("tracingStart", None, params)
         trace_name = await self._channel.send(
-            "tracingStartChunk", {"title": title, "name": name}
+            "tracingStartChunk", None, {"title": title, "name": name}
         )
         await self._start_collecting_stacks(trace_name)
 
     async def start_chunk(self, title: str = None, name: str = None) -> None:
         params = locals_to_params(locals())
-        trace_name = await self._channel.send("tracingStartChunk", params)
+        trace_name = await self._channel.send("tracingStartChunk", None, params)
         await self._start_collecting_stacks(trace_name)
 
     async def _start_collecting_stacks(self, trace_name: str) -> None:
@@ -66,14 +66,17 @@ async def stop_chunk(self, path: Union[pathlib.Path, str] = None) -> None:
 
     async def stop(self, path: Union[pathlib.Path, str] = None) -> None:
         await self._do_stop_chunk(path)
-        await self._channel.send("tracingStop")
+        await self._channel.send(
+            "tracingStop",
+            None,
+        )
 
     async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> None:
         self._reset_stack_counter()
 
         if not file_path:
             # Not interested in any artifacts
-            await self._channel.send("tracingStopChunk", {"mode": "discard"})
+            await self._channel.send("tracingStopChunk", None, {"mode": "discard"})
             if self._stacks_id:
                 await self._connection.local_utils.trace_discarded(self._stacks_id)
             return
@@ -82,7 +85,7 @@ async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> No
 
         if is_local:
             result = await self._channel.send_return_as_dict(
-                "tracingStopChunk", {"mode": "entries"}
+                "tracingStopChunk", None, {"mode": "entries"}
             )
             await self._connection.local_utils.zip(
                 {
@@ -97,6 +100,7 @@ async def _do_stop_chunk(self, file_path: Union[pathlib.Path, str] = None) -> No
 
         result = await self._channel.send_return_as_dict(
             "tracingStopChunk",
+            None,
             {
                 "mode": "archive",
             },
@@ -133,7 +137,10 @@ def _reset_stack_counter(self) -> None:
             self._connection.set_is_tracing(False)
 
     async def group(self, name: str, location: TracingGroupLocation = None) -> None:
-        await self._channel.send("tracingGroup", locals_to_params(locals()))
+        await self._channel.send("tracingGroup", None, locals_to_params(locals()))
 
     async def group_end(self) -> None:
-        await self._channel.send("tracingGroupEnd")
+        await self._channel.send(
+            "tracingGroupEnd",
+            None,
+        )
diff --git a/playwright/_impl/_waiter.py b/playwright/_impl/_waiter.py
index 7b0ad2cc6..f7ff4b6c1 100644
--- a/playwright/_impl/_waiter.py
+++ b/playwright/_impl/_waiter.py
@@ -38,6 +38,7 @@ def __init__(self, channel_owner: ChannelOwner, event: str) -> None:
     def _wait_for_event_info_before(self, wait_id: str, event: str) -> None:
         self._channel.send_no_reply(
             "waitForEventInfo",
+            None,
             {
                 "info": {
                     "waitId": wait_id,
@@ -51,6 +52,7 @@ def _wait_for_event_info_after(self, wait_id: str, error: Exception = None) -> N
         self._channel._connection.wrap_api_call_sync(
             lambda: self._channel.send_no_reply(
                 "waitForEventInfo",
+                None,
                 {
                     "info": {
                         "waitId": wait_id,
@@ -130,6 +132,7 @@ def log(self, message: str) -> None:
             self._channel._connection.wrap_api_call_sync(
                 lambda: self._channel.send_no_reply(
                     "waitForEventInfo",
+                    None,
                     {
                         "info": {
                             "waitId": self._wait_id,
diff --git a/playwright/_impl/_writable_stream.py b/playwright/_impl/_writable_stream.py
index 702adf153..7d5b7704b 100644
--- a/playwright/_impl/_writable_stream.py
+++ b/playwright/_impl/_writable_stream.py
@@ -37,6 +37,6 @@ async def copy(self, path: Union[str, Path]) -> None:
                 if not data:
                     break
                 await self._channel.send(
-                    "write", {"binary": base64.b64encode(data).decode()}
+                    "write", None, {"binary": base64.b64encode(data).decode()}
                 )
-        await self._channel.send("close")
+        await self._channel.send("close", None)

From b7882d99feae7d5b31bb83c814c55abf2090461d Mon Sep 17 00:00:00 2001
From: Adam Gastineau <adam@agg.im>
Date: Thu, 26 Jun 2025 06:56:03 -0700
Subject: [PATCH 400/438] fix(api): ignore deprecated timeout arg provided to
 is_visible/hidden (#2905)

---
 playwright/_impl/_locator.py | 6 ++----
 playwright/_impl/_page.py    | 6 ++++--
 tests/async/test_locators.py | 9 +++++++++
 tests/async/test_page.py     | 8 ++++++++
 tests/sync/test_locators.py  | 9 +++++++++
 tests/sync/test_page.py      | 8 ++++++++
 6 files changed, 40 insertions(+), 6 deletions(-)

diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 6fe075130..a1ea180ed 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -501,19 +501,17 @@ async def is_enabled(self, timeout: float = None) -> bool:
         )
 
     async def is_hidden(self, timeout: float = None) -> bool:
-        params = locals_to_params(locals())
+        # timeout is deprecated and does nothing
         return await self._frame.is_hidden(
             self._selector,
             strict=True,
-            **params,
         )
 
     async def is_visible(self, timeout: float = None) -> bool:
-        params = locals_to_params(locals())
+        # timeout is deprecated and does nothing
         return await self._frame.is_visible(
             self._selector,
             strict=True,
-            **params,
         )
 
     async def press(
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 20bba35db..55ee44df2 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -447,12 +447,14 @@ async def is_enabled(
     async def is_hidden(
         self, selector: str, strict: bool = None, timeout: float = None
     ) -> bool:
-        return await self._main_frame.is_hidden(**locals_to_params(locals()))
+        # timeout is deprecated and does nothing
+        return await self._main_frame.is_hidden(selector=selector, strict=strict)
 
     async def is_visible(
         self, selector: str, strict: bool = None, timeout: float = None
     ) -> bool:
-        return await self._main_frame.is_visible(**locals_to_params(locals()))
+        # timeout is deprecated and does nothing
+        return await self._main_frame.is_visible(selector=selector, strict=strict)
 
     async def dispatch_event(
         self,
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index a5891f558..980de041f 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -1143,3 +1143,12 @@ async def test_locator_click_timeout_error_should_contain_call_log(page: Page) -
         "During handling of the above exception, another exception occurred"
         not in formatted_exception
     )
+
+
+async def test_locator_should_ignore_deprecated_is_hidden_and_visible_timeout(
+    page: Page,
+) -> None:
+    await page.set_content("<div>foo</div>")
+    div = page.locator("div")
+    assert await div.is_hidden(timeout=10) is False
+    assert await div.is_visible(timeout=10) is True
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 962a11e59..03907c4b9 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -1451,3 +1451,11 @@ async def test_page_pause_should_reset_custom_timeouts(
     server.set_route("/empty.html", lambda route: None)
     with pytest.raises(Error, match="Timeout 456ms exceeded."):
         await page.goto(server.EMPTY_PAGE)
+
+
+async def test_page_should_ignore_deprecated_is_hidden_and_visible_timeout(
+    page: Page,
+) -> None:
+    await page.set_content("<div>foo</div>")
+    assert await page.is_hidden("div", timeout=10) is False
+    assert await page.is_visible("div", timeout=10) is True
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index 31d7b174b..b554f0544 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -997,3 +997,12 @@ def test_locator_click_timeout_error_should_contain_call_log(page: Page) -> None
         "During handling of the above exception, another exception occurred"
         not in formatted_exception
     )
+
+
+def test_locator_should_ignore_deprecated_is_hidden_and_visible_timeout(
+    page: Page,
+) -> None:
+    page.set_content("<div>foo</div>")
+    div = page.locator("div")
+    assert div.is_hidden(timeout=10) is False
+    assert div.is_visible(timeout=10) is True
diff --git a/tests/sync/test_page.py b/tests/sync/test_page.py
index 7550a80d1..e29c7cabc 100644
--- a/tests/sync/test_page.py
+++ b/tests/sync/test_page.py
@@ -114,3 +114,11 @@ def test_page_pause_should_reset_custom_timeouts(
     server.set_route("/empty.html", lambda route: None)
     with pytest.raises(Error, match="Timeout 456ms exceeded."):
         page.goto(server.EMPTY_PAGE)
+
+
+def test_page_should_ignore_deprecated_is_hidden_and_visible_timeout(
+    page: Page,
+) -> None:
+    page.set_content("<div>foo</div>")
+    assert page.is_hidden("div", timeout=10) is False
+    assert page.is_visible("div", timeout=10) is True

From 6157d89ed543719a7e149f1debf0d0fd1de73a1d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 8 Jul 2025 11:06:59 +0200
Subject: [PATCH 401/438] build(deps): bump typing-extensions from 4.13.2 to
 4.14.1 (#2912)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index a6b31fd67..14dc0500a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -4,5 +4,5 @@ greenlet==3.2.3
     # via playwright (pyproject.toml)
 pyee==13.0.0
     # via playwright (pyproject.toml)
-typing-extensions==4.13.2
+typing-extensions==4.14.1
     # via pyee

From 8cd92566bc6724d54216c4aa333546c3906c81b4 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 10 Jul 2025 13:11:08 +0200
Subject: [PATCH 402/438] fix: Make context manager __exit__/__aexit__
 signatures compatible with typing protocols (#2915)

---
 playwright/_impl/_async_base.py | 6 +++---
 playwright/_impl/_sync_base.py  | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/playwright/_impl/_async_base.py b/playwright/_impl/_async_base.py
index b06994a65..db7e5d005 100644
--- a/playwright/_impl/_async_base.py
+++ b/playwright/_impl/_async_base.py
@@ -96,9 +96,9 @@ async def __aenter__(self: Self) -> Self:
 
     async def __aexit__(
         self,
-        exc_type: Type[BaseException],
-        exc_val: BaseException,
-        traceback: TracebackType,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        traceback: Optional[TracebackType],
     ) -> None:
         await self.close()
 
diff --git a/playwright/_impl/_sync_base.py b/playwright/_impl/_sync_base.py
index e6fac9750..3fef433b5 100644
--- a/playwright/_impl/_sync_base.py
+++ b/playwright/_impl/_sync_base.py
@@ -142,9 +142,9 @@ def __enter__(self: Self) -> Self:
 
     def __exit__(
         self,
-        exc_type: Type[BaseException],
-        exc_val: BaseException,
-        _traceback: TracebackType,
+        exc_type: Optional[Type[BaseException]],
+        exc_val: Optional[BaseException],
+        _traceback: Optional[TracebackType],
     ) -> None:
         self.close()
 

From 3f957528af49f6c5314b0fdb5317e15eeb87bb5e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 10 Jul 2025 15:07:35 +0200
Subject: [PATCH 403/438] build(deps): bump pytest from 8.4.0 to 8.4.1 (#2897)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index afe7e4bb8..e19488956 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -8,7 +8,7 @@ Pillow==11.2.1
 pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==25.1.0
-pytest==8.4.0
+pytest==8.4.1
 pytest-asyncio==1.0.0
 pytest-cov==6.2.1
 pytest-repeat==0.9.4

From 6af4fb2ac5951576b8a47ce553aacf84f2ef5561 Mon Sep 17 00:00:00 2001
From: Adam Gastineau <adam@agg.im>
Date: Fri, 11 Jul 2025 08:06:15 -0700
Subject: [PATCH 404/438] chore: roll to 1.54.0 (#2913)

---
 README.md                                    |  6 +--
 playwright/_impl/_api_structures.py          | 15 +++++-
 playwright/_impl/_assertions.py              | 26 ++++++++-
 playwright/_impl/_browser_context.py         | 11 ++--
 playwright/_impl/_console_message.py         | 23 +++++++-
 playwright/_impl/_frame.py                   | 52 +++++++++++++++---
 playwright/_impl/_helper.py                  | 10 ++++
 playwright/_impl/_locator.py                 | 21 ++------
 playwright/_impl/_network.py                 | 11 ++--
 playwright/_impl/_page.py                    | 31 +++++------
 playwright/_impl/_selectors.py               |  4 ++
 playwright/async_api/__init__.py             |  2 +
 playwright/async_api/_generated.py           | 37 +++++++++----
 playwright/sync_api/__init__.py              |  2 +
 playwright/sync_api/_generated.py            | 37 +++++++++----
 setup.py                                     |  2 +-
 tests/async/conftest.py                      |  2 +-
 tests/async/test_browsercontext.py           |  4 +-
 tests/async/test_chromium_tracing.py         | 18 +++++--
 tests/async/test_fetch_global.py             |  2 +-
 tests/async/test_geolocation.py              |  4 +-
 tests/async/test_page_add_locator_handler.py |  2 +-
 tests/async/test_page_request_intercept.py   |  2 +-
 tests/async/test_page_route.py               | 12 +++++
 tests/async/test_selectors_misc.py           | 28 ++++++++++
 tests/async/test_tracing.py                  |  2 +
 tests/async/test_unroute_behavior.py         | 56 ++++++++++++++++++++
 tests/sync/conftest.py                       |  2 +-
 tests/sync/test_fetch_global.py              |  2 +-
 tests/sync/test_page_add_locator_handler.py  |  2 +-
 tests/sync/test_tracing.py                   |  2 +
 31 files changed, 338 insertions(+), 92 deletions(-)

diff --git a/README.md b/README.md
index 9577b82e8..fa9e246a9 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 -->138.0.7204.23<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| WebKit <!-- GEN:webkit-version -->18.5<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->139.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->139.0.7258.5<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| WebKit <!-- GEN:webkit-version -->26.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->140.0.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index 3b639486a..0afa0d02e 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -32,6 +32,18 @@ class Cookie(TypedDict, total=False):
     httpOnly: bool
     secure: bool
     sameSite: Literal["Lax", "None", "Strict"]
+    partitionKey: Optional[str]
+
+
+class StorageStateCookie(TypedDict, total=False):
+    name: str
+    value: str
+    domain: str
+    path: str
+    expires: float
+    httpOnly: bool
+    secure: bool
+    sameSite: Literal["Lax", "None", "Strict"]
 
 
 # TODO: We are waiting for PEP705 so SetCookieParam can be readonly and matches Cookie.
@@ -45,6 +57,7 @@ class SetCookieParam(TypedDict, total=False):
     httpOnly: Optional[bool]
     secure: Optional[bool]
     sameSite: Optional[Literal["Lax", "None", "Strict"]]
+    partitionKey: Optional[str]
 
 
 class FloatRect(TypedDict):
@@ -97,7 +110,7 @@ class ProxySettings(TypedDict, total=False):
 
 
 class StorageState(TypedDict, total=False):
-    cookies: List[Cookie]
+    cookies: List[StorageStateCookie]
     origins: List[OriginState]
 
 
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 6e0161b7c..3aadbf5fe 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -20,6 +20,7 @@
     AriaRole,
     ExpectedTextValue,
     FrameExpectOptions,
+    FrameExpectResult,
 )
 from playwright._impl._connection import format_call_log
 from playwright._impl._errors import Error
@@ -45,6 +46,13 @@ def __init__(
         self._is_not = is_not
         self._custom_message = message
 
+    async def _call_expect(
+        self, expression: str, expect_options: FrameExpectOptions, title: Optional[str]
+    ) -> FrameExpectResult:
+        raise NotImplementedError(
+            "_call_expect must be implemented in a derived class."
+        )
+
     async def _expect_impl(
         self,
         expression: str,
@@ -61,7 +69,7 @@ async def _expect_impl(
             message = message.replace("expected to", "expected not to")
         if "useInnerText" in expect_options and expect_options["useInnerText"] is None:
             del expect_options["useInnerText"]
-        result = await self._actual_locator._expect(expression, expect_options, title)
+        result = await self._call_expect(expression, expect_options, title)
         if result["matches"] == self._is_not:
             actual = result.get("received")
             if self._custom_message:
@@ -88,6 +96,14 @@ def __init__(
         super().__init__(page.locator(":root"), timeout, is_not, message)
         self._actual_page = page
 
+    async def _call_expect(
+        self, expression: str, expect_options: FrameExpectOptions, title: Optional[str]
+    ) -> FrameExpectResult:
+        __tracebackhide__ = True
+        return await self._actual_page.main_frame._expect(
+            None, expression, expect_options, title
+        )
+
     @property
     def _not(self) -> "PageAssertions":
         return PageAssertions(
@@ -122,7 +138,7 @@ async def to_have_url(
         ignoreCase: bool = None,
     ) -> None:
         __tracebackhide__ = True
-        base_url = self._actual_page.context._options.get("baseURL")
+        base_url = self._actual_page.context._base_url
         if isinstance(urlOrRegExp, str) and base_url:
             urlOrRegExp = urljoin(base_url, urlOrRegExp)
         expected_text = to_expected_text_values([urlOrRegExp], ignoreCase=ignoreCase)
@@ -155,6 +171,12 @@ def __init__(
         super().__init__(locator, timeout, is_not, message)
         self._actual_locator = locator
 
+    async def _call_expect(
+        self, expression: str, expect_options: FrameExpectOptions, title: Optional[str]
+    ) -> FrameExpectResult:
+        __tracebackhide__ = True
+        return await self._actual_locator._expect(expression, expect_options, title)
+
     @property
     def _not(self) -> "LocatorAssertions":
         return LocatorAssertions(
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 60b60c46e..391e61ec6 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -119,6 +119,8 @@ def __init__(
         self._options: Dict[str, Any] = initializer["options"]
         self._background_pages: Set[Page] = set()
         self._service_workers: Set[Worker] = set()
+        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._har_recorders: Dict[str, HarRecordingMetadata] = {}
         self._request: APIRequestContext = from_channel(initializer["requestContext"])
@@ -424,7 +426,7 @@ async def route(
         self._routes.insert(
             0,
             RouteHandler(
-                self._options.get("baseURL"),
+                self._base_url,
                 url,
                 handler,
                 True if self._dispatcher_fiber else False,
@@ -452,17 +454,16 @@ async def _unroute_internal(
         behavior: Literal["default", "ignoreErrors", "wait"] = None,
     ) -> None:
         self._routes = remaining
+        if behavior is not None and behavior != "default":
+            await asyncio.gather(*map(lambda router: router.stop(behavior), removed))  # type: ignore
         await self._update_interception_patterns()
-        if behavior is None or behavior == "default":
-            return
-        await asyncio.gather(*map(lambda router: router.stop(behavior), removed))  # type: ignore
 
     async def route_web_socket(
         self, url: URLMatch, handler: WebSocketRouteHandlerCallback
     ) -> None:
         self._web_socket_routes.insert(
             0,
-            WebSocketRouteHandler(self._options.get("baseURL"), url, handler),
+            WebSocketRouteHandler(self._base_url, url, handler),
         )
         await self._update_web_socket_interception_patterns()
 
diff --git a/playwright/_impl/_console_message.py b/playwright/_impl/_console_message.py
index ba8fc0a38..53c0dee95 100644
--- a/playwright/_impl/_console_message.py
+++ b/playwright/_impl/_console_message.py
@@ -13,7 +13,7 @@
 # limitations under the License.
 
 from asyncio import AbstractEventLoop
-from typing import TYPE_CHECKING, Any, Dict, List, Optional
+from typing import TYPE_CHECKING, Any, Dict, List, Literal, Optional, Union
 
 from playwright._impl._api_structures import SourceLocation
 from playwright._impl._connection import from_channel, from_nullable_channel
@@ -39,7 +39,26 @@ def __str__(self) -> str:
         return self.text
 
     @property
-    def type(self) -> str:
+    def type(self) -> Union[
+        Literal["assert"],
+        Literal["clear"],
+        Literal["count"],
+        Literal["debug"],
+        Literal["dir"],
+        Literal["dirxml"],
+        Literal["endGroup"],
+        Literal["error"],
+        Literal["info"],
+        Literal["log"],
+        Literal["profile"],
+        Literal["profileEnd"],
+        Literal["startGroup"],
+        Literal["startGroupCollapsed"],
+        Literal["table"],
+        Literal["timeEnd"],
+        Literal["trace"],
+        Literal["warning"],
+    ]:
         return self._event["type"]
 
     @property
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index c0646b680..fe19a576d 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.py
@@ -30,7 +30,13 @@
 
 from pyee import EventEmitter
 
-from playwright._impl._api_structures import AriaRole, FilePayload, Position
+from playwright._impl._api_structures import (
+    AriaRole,
+    FilePayload,
+    FrameExpectOptions,
+    FrameExpectResult,
+    Position,
+)
 from playwright._impl._connection import (
     ChannelOwner,
     from_channel,
@@ -56,6 +62,7 @@
     Serializable,
     add_source_url_to_script,
     parse_result,
+    parse_value,
     serialize_argument,
 )
 from playwright._impl._locator import (
@@ -170,6 +177,29 @@ def _setup_navigation_waiter(self, wait_name: str, timeout: float = None) -> Wai
         waiter.reject_on_timeout(timeout, f"Timeout {timeout}ms exceeded.")
         return waiter
 
+    async def _expect(
+        self,
+        selector: Optional[str],
+        expression: str,
+        options: FrameExpectOptions,
+        title: str = None,
+    ) -> FrameExpectResult:
+        if "expectedValue" in options:
+            options["expectedValue"] = serialize_argument(options["expectedValue"])
+        result = await self._channel.send_return_as_dict(
+            "expect",
+            self._timeout,
+            {
+                "selector": selector,
+                "expression": expression,
+                **options,
+            },
+            title=title,
+        )
+        if result.get("received"):
+            result["received"] = parse_value(result["received"])
+        return result
+
     def expect_navigation(
         self,
         url: URLMatch = None,
@@ -194,7 +224,7 @@ def predicate(event: Any) -> bool:
                 return True
             waiter.log(f'  navigated to "{event["url"]}"')
             return url_matches(
-                cast("Page", self._page)._browser_context._options.get("baseURL"),
+                cast("Page", self._page)._browser_context._base_url,
                 event["url"],
                 url,
             )
@@ -227,9 +257,7 @@ async def wait_for_url(
         timeout: float = None,
     ) -> None:
         assert self._page
-        if url_matches(
-            self._page._browser_context._options.get("baseURL"), self.url, url
-        ):
+        if url_matches(self._page._browser_context._base_url, self.url, url):
             await self._wait_for_load_state_impl(state=waitUntil, timeout=timeout)
             return
         async with self.expect_navigation(
@@ -558,6 +586,18 @@ async def fill(
         noWaitAfter: bool = None,
         strict: bool = None,
         force: bool = None,
+    ) -> None:
+        await self._fill(**locals_to_params(locals()))
+
+    async def _fill(
+        self,
+        selector: str,
+        value: str,
+        timeout: float = None,
+        noWaitAfter: bool = None,
+        strict: bool = None,
+        force: bool = None,
+        title: str = None,
     ) -> None:
         await self._channel.send("fill", self._timeout, locals_to_params(locals()))
 
@@ -801,7 +841,7 @@ async def uncheck(
         await self._channel.send("uncheck", self._timeout, locals_to_params(locals()))
 
     async def wait_for_timeout(self, timeout: float) -> None:
-        await self._channel.send("waitForTimeout", None, locals_to_params(locals()))
+        await self._channel.send("waitForTimeout", None, {"waitTimeout": timeout})
 
     async def wait_for_function(
         self,
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 67a096dc5..66e59c65f 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -189,6 +189,16 @@ def map_token(original: str, replacement: str) -> str:
 
     # Escaped `\\?` behaves the same as `?` in our glob patterns.
     match = match.replace(r"\\?", "?")
+    # Special case about: URLs as they are not relative to base_url
+    if (
+        match.startswith("about:")
+        or match.startswith("data:")
+        or match.startswith("chrome:")
+        or match.startswith("edge:")
+        or match.startswith("file:")
+    ):
+        # about: and data: URLs are not relative to base_url, so we return them as is.
+        return match
     # Glob symbols may be escaped in the URL and some of them such as ? affect resolution,
     # so we replace them with safe components first.
     processed_parts = []
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index a1ea180ed..a65b68266 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -47,7 +47,7 @@
     monotonic_time,
     to_impl,
 )
-from playwright._impl._js_handle import Serializable, parse_value, serialize_argument
+from playwright._impl._js_handle import Serializable
 from playwright._impl._str_utils import (
     escape_for_attribute_selector,
     escape_for_text_selector,
@@ -217,7 +217,8 @@ async def clear(
         noWaitAfter: bool = None,
         force: bool = None,
     ) -> None:
-        await self.fill("", timeout=timeout, force=force)
+        params = locals_to_params(locals())
+        await self._frame._fill(self._selector, value="", title="Clear", **params)
 
     def locator(
         self,
@@ -722,21 +723,7 @@ async def _expect(
         options: FrameExpectOptions,
         title: str = None,
     ) -> FrameExpectResult:
-        if "expectedValue" in options:
-            options["expectedValue"] = serialize_argument(options["expectedValue"])
-        result = await self._frame._channel.send_return_as_dict(
-            "expect",
-            self._frame._timeout,
-            {
-                "selector": self._selector,
-                "expression": expression,
-                **options,
-            },
-            title=title,
-        )
-        if result.get("received"):
-            result["received"] = parse_value(result["received"])
-        return result
+        return await self._frame._expect(self._selector, expression, options, title)
 
     async def highlight(self) -> None:
         await self._frame._highlight(self._selector)
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 616c75ec9..a999ce73c 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -733,10 +733,13 @@ async def _after_handle(self) -> None:
         if self._connected:
             return
         # Ensure that websocket is "open" and can send messages without an actual server connection.
-        await self._channel.send(
-            "ensureOpened",
-            None,
-        )
+        try:
+            await self._channel.send(
+                "ensureOpened",
+                None,
+            )
+        except Exception:
+            pass
 
 
 class WebSocketRouteHandler:
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 55ee44df2..a0fa4eec2 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -388,9 +388,7 @@ def frame(self, name: str = None, url: URLMatch = None) -> Optional[Frame]:
         for frame in self._frames:
             if name and frame.name == name:
                 return frame
-            if url and url_matches(
-                self._browser_context._options.get("baseURL"), frame.url, url
-            ):
+            if url and url_matches(self._browser_context._base_url, frame.url, url):
                 return frame
 
         return None
@@ -682,7 +680,7 @@ async def route(
         self._routes.insert(
             0,
             RouteHandler(
-                self._browser_context._options.get("baseURL"),
+                self._browser_context._base_url,
                 url,
                 handler,
                 True if self._dispatcher_fiber else False,
@@ -710,24 +708,21 @@ async def _unroute_internal(
         behavior: Literal["default", "ignoreErrors", "wait"] = None,
     ) -> None:
         self._routes = remaining
-        await self._update_interception_patterns()
-        if behavior is None or behavior == "default":
-            return
-        await asyncio.gather(
-            *map(
-                lambda route: route.stop(behavior),  # type: ignore
-                removed,
+        if behavior is not None and behavior != "default":
+            await asyncio.gather(
+                *map(
+                    lambda route: route.stop(behavior),  # type: ignore
+                    removed,
+                )
             )
-        )
+        await self._update_interception_patterns()
 
     async def route_web_socket(
         self, url: URLMatch, handler: WebSocketRouteHandlerCallback
     ) -> None:
         self._web_socket_routes.insert(
             0,
-            WebSocketRouteHandler(
-                self._browser_context._options.get("baseURL"), url, handler
-            ),
+            WebSocketRouteHandler(self._browser_context._base_url, url, handler),
         )
         await self._update_web_socket_interception_patterns()
 
@@ -1186,7 +1181,7 @@ def 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._options.get("recordVideo"):
+        if not self._browser_context._videos_dir:
             return None
         return self._force_video()
 
@@ -1273,7 +1268,7 @@ def expect_request(
         def my_predicate(request: Request) -> bool:
             if not callable(urlOrPredicate):
                 return url_matches(
-                    self._browser_context._options.get("baseURL"),
+                    self._browser_context._base_url,
                     request.url,
                     urlOrPredicate,
                 )
@@ -1305,7 +1300,7 @@ def expect_response(
         def my_predicate(request: Response) -> bool:
             if not callable(urlOrPredicate):
                 return url_matches(
-                    self._browser_context._options.get("baseURL"),
+                    self._browser_context._base_url,
                     request.url,
                     urlOrPredicate,
                 )
diff --git a/playwright/_impl/_selectors.py b/playwright/_impl/_selectors.py
index 2a2e70974..c3bac78e5 100644
--- a/playwright/_impl/_selectors.py
+++ b/playwright/_impl/_selectors.py
@@ -37,6 +37,10 @@ async def register(
         path: Union[str, Path] = None,
         contentScript: bool = None,
     ) -> None:
+        if any(engine for engine in self._selector_engines if engine["name"] == name):
+            raise Error(
+                f'Selectors.register: "{name}" selector engine has been already registered'
+            )
         if not script and not path:
             raise Error("Either source or path should be specified")
         if path:
diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index be918f53c..257ac2022 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.py
@@ -79,6 +79,7 @@
 ResourceTiming = playwright._impl._api_structures.ResourceTiming
 SourceLocation = playwright._impl._api_structures.SourceLocation
 StorageState = playwright._impl._api_structures.StorageState
+StorageStateCookie = playwright._impl._api_structures.StorageStateCookie
 ViewportSize = playwright._impl._api_structures.ViewportSize
 
 Error = playwright._impl._errors.Error
@@ -187,6 +188,7 @@ def __call__(
     "Selectors",
     "SourceLocation",
     "StorageState",
+    "StorageStateCookie",
     "TimeoutError",
     "Touchscreen",
     "Video",
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 5f0af8bf0..bedf233de 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -6975,16 +6975,33 @@ async def set_system_time(
 class ConsoleMessage(AsyncBase):
 
     @property
-    def type(self) -> str:
+    def type(
+        self,
+    ) -> typing.Union[
+        Literal["assert"],
+        Literal["clear"],
+        Literal["count"],
+        Literal["debug"],
+        Literal["dir"],
+        Literal["dirxml"],
+        Literal["endGroup"],
+        Literal["error"],
+        Literal["info"],
+        Literal["log"],
+        Literal["profile"],
+        Literal["profileEnd"],
+        Literal["startGroup"],
+        Literal["startGroupCollapsed"],
+        Literal["table"],
+        Literal["timeEnd"],
+        Literal["trace"],
+        Literal["warning"],
+    ]:
         """ConsoleMessage.type
 
-        One of the following values: `'log'`, `'debug'`, `'info'`, `'error'`, `'warning'`, `'dir'`, `'dirxml'`, `'table'`,
-        `'trace'`, `'clear'`, `'startGroup'`, `'startGroupCollapsed'`, `'endGroup'`, `'assert'`, `'profile'`,
-        `'profileEnd'`, `'count'`, `'timeEnd'`.
-
         Returns
         -------
-        str
+        Union["assert", "clear", "count", "debug", "dir", "dirxml", "endGroup", "error", "info", "log", "profile", "profileEnd", "startGroup", "startGroupCollapsed", "table", "timeEnd", "trace", "warning"]
         """
         return mapping.from_maybe_impl(self._impl_obj.type)
 
@@ -12649,7 +12666,8 @@ def pages(self) -> typing.List["Page"]:
     def browser(self) -> typing.Optional["Browser"]:
         """BrowserContext.browser
 
-        Returns the browser instance of the context. If it was launched as a persistent context null gets returned.
+        Gets the browser instance that owns the context. Returns `null` if the context is created outside of normal
+        browser, e.g. Android or Electron.
 
         Returns
         -------
@@ -12789,7 +12807,7 @@ async def cookies(
 
         Returns
         -------
-        List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}]
+        List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"], partitionKey: Union[str, None]}]
         """
 
         return mapping.from_impl_list(
@@ -12810,7 +12828,7 @@ async def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
 
         Parameters
         ----------
-        cookies : Sequence[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
+        cookies : Sequence[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None], partitionKey: Union[str, None]}]
         """
 
         return mapping.from_maybe_impl(
@@ -12884,6 +12902,7 @@ async def grant_permissions(
             - `'notifications'`
             - `'payment-handler'`
             - `'storage-access'`
+            - `'local-fonts'`
         origin : Union[str, None]
             The [origin] to grant permissions to, e.g. "https://example.com".
         """
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index 136433982..e901cadbf 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -79,6 +79,7 @@
 ResourceTiming = playwright._impl._api_structures.ResourceTiming
 SourceLocation = playwright._impl._api_structures.SourceLocation
 StorageState = playwright._impl._api_structures.StorageState
+StorageStateCookie = playwright._impl._api_structures.StorageStateCookie
 ViewportSize = playwright._impl._api_structures.ViewportSize
 
 Error = playwright._impl._errors.Error
@@ -186,6 +187,7 @@ def __call__(
     "Selectors",
     "SourceLocation",
     "StorageState",
+    "StorageStateCookie",
     "sync_playwright",
     "TimeoutError",
     "Touchscreen",
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 763df6de3..8f4b60764 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -7083,16 +7083,33 @@ def set_system_time(
 class ConsoleMessage(SyncBase):
 
     @property
-    def type(self) -> str:
+    def type(
+        self,
+    ) -> typing.Union[
+        Literal["assert"],
+        Literal["clear"],
+        Literal["count"],
+        Literal["debug"],
+        Literal["dir"],
+        Literal["dirxml"],
+        Literal["endGroup"],
+        Literal["error"],
+        Literal["info"],
+        Literal["log"],
+        Literal["profile"],
+        Literal["profileEnd"],
+        Literal["startGroup"],
+        Literal["startGroupCollapsed"],
+        Literal["table"],
+        Literal["timeEnd"],
+        Literal["trace"],
+        Literal["warning"],
+    ]:
         """ConsoleMessage.type
 
-        One of the following values: `'log'`, `'debug'`, `'info'`, `'error'`, `'warning'`, `'dir'`, `'dirxml'`, `'table'`,
-        `'trace'`, `'clear'`, `'startGroup'`, `'startGroupCollapsed'`, `'endGroup'`, `'assert'`, `'profile'`,
-        `'profileEnd'`, `'count'`, `'timeEnd'`.
-
         Returns
         -------
-        str
+        Union["assert", "clear", "count", "debug", "dir", "dirxml", "endGroup", "error", "info", "log", "profile", "profileEnd", "startGroup", "startGroupCollapsed", "table", "timeEnd", "trace", "warning"]
         """
         return mapping.from_maybe_impl(self._impl_obj.type)
 
@@ -12671,7 +12688,8 @@ def pages(self) -> typing.List["Page"]:
     def browser(self) -> typing.Optional["Browser"]:
         """BrowserContext.browser
 
-        Returns the browser instance of the context. If it was launched as a persistent context null gets returned.
+        Gets the browser instance that owns the context. Returns `null` if the context is created outside of normal
+        browser, e.g. Android or Electron.
 
         Returns
         -------
@@ -12811,7 +12829,7 @@ def cookies(
 
         Returns
         -------
-        List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}]
+        List[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"], partitionKey: Union[str, None]}]
         """
 
         return mapping.from_impl_list(
@@ -12832,7 +12850,7 @@ def add_cookies(self, cookies: typing.Sequence[SetCookieParam]) -> None:
 
         Parameters
         ----------
-        cookies : Sequence[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None]}]
+        cookies : Sequence[{name: str, value: str, url: Union[str, None], domain: Union[str, None], path: Union[str, None], expires: Union[float, None], httpOnly: Union[bool, None], secure: Union[bool, None], sameSite: Union["Lax", "None", "Strict", None], partitionKey: Union[str, None]}]
         """
 
         return mapping.from_maybe_impl(
@@ -12908,6 +12926,7 @@ def grant_permissions(
             - `'notifications'`
             - `'payment-handler'`
             - `'storage-access'`
+            - `'local-fonts'`
         origin : Union[str, None]
             The [origin] to grant permissions to, e.g. "https://example.com".
         """
diff --git a/setup.py b/setup.py
index fd590167f..c4a75870a 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.53.1"
+driver_version = "1.54.0"
 
 base_wheel_bundles = [
     {
diff --git a/tests/async/conftest.py b/tests/async/conftest.py
index f2e06d56e..5dff9794f 100644
--- a/tests/async/conftest.py
+++ b/tests/async/conftest.py
@@ -153,7 +153,7 @@ def action_titles(self) -> Locator:
 
     @property
     def stack_frames(self) -> Locator:
-        return self.page.get_by_test_id("stack-trace-list").locator(".list-view-entry")
+        return self.page.get_by_role("list", name="Stack Trace").get_by_role("listitem")
 
     async def select_action(self, title: str, ordinal: int = 0) -> None:
         await self.page.locator(".action-title", has_text=title).nth(ordinal).click()
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index 37c812f57..ba53b6f95 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -118,9 +118,9 @@ async def test_page_event_should_propagate_default_viewport_to_the_page(
 
 
 async def test_page_event_should_respect_device_scale_factor(browser: Browser) -> None:
-    context = await browser.new_context(device_scale_factor=3)
+    context = await browser.new_context(device_scale_factor=3.5)
     page = await context.new_page()
-    assert await page.evaluate("window.devicePixelRatio") == 3
+    assert await page.evaluate("window.devicePixelRatio") == 3.5
     await context.close()
 
 
diff --git a/tests/async/test_chromium_tracing.py b/tests/async/test_chromium_tracing.py
index 23608e009..fd065efde 100644
--- a/tests/async/test_chromium_tracing.py
+++ b/tests/async/test_chromium_tracing.py
@@ -44,6 +44,13 @@ async def test_should_create_directories_as_needed(
     assert os.path.getsize(output_file) > 0
 
 
+async def rafraf(target: Page, count: int = 1) -> None:
+    for _ in range(count):
+        await target.evaluate(
+            "async () => await new Promise(f => window.requestAnimationFrame(() => window.requestAnimationFrame(f)));"
+        )
+
+
 @pytest.mark.only_browser("chromium")
 async def test_should_run_with_custom_categories_if_provided(
     browser: Browser, page: Page, tmp_path: Path
@@ -51,16 +58,19 @@ async def test_should_run_with_custom_categories_if_provided(
     output_file = tmp_path / "trace.json"
     await browser.start_tracing(
         page=page,
-        screenshots=True,
         path=output_file,
-        categories=["disabled-by-default-v8.cpu_profiler.hires"],
+        categories=["disabled-by-default-cc.debug"],
     )
+    await rafraf(page)
     await browser.stop_tracing()
     with open(output_file, mode="r") as of:
         trace_json = json.load(of)
+        trace_config = trace_json["metadata"].get("trace-config")
+        trace_events = trace_json["traceEvents"]
         assert (
-            "disabled-by-default-v8.cpu_profiler.hires"
-            in trace_json["metadata"]["trace-config"]
+            trace_config is not None and "disabled-by-default-cc.debug" in trace_config
+        ) or any(
+            event.get("cat") == "disabled-by-default-cc.debug" for event in trace_events
         )
 
 
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index 6b74208e2..e2a7678c5 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -85,7 +85,7 @@ async def test_should_support_global_timeout_option(
 ) -> None:
     request = await playwright.request.new_context(timeout=100)
     server.set_route("/empty.html", lambda req: None)
-    with pytest.raises(Error, match="Request timed out after 100ms"):
+    with pytest.raises(Error, match="Timeout 100ms exceeded"):
         await request.get(server.EMPTY_PAGE)
 
 
diff --git a/tests/async/test_geolocation.py b/tests/async/test_geolocation.py
index 5791b5984..12b00a4fa 100644
--- a/tests/async/test_geolocation.py
+++ b/tests/async/test_geolocation.py
@@ -48,7 +48,7 @@ async def test_should_isolate_contexts(
     await page.goto(server.EMPTY_PAGE)
 
     context2 = await browser.new_context(
-        permissions=["geolocation"], geolocation={"latitude": 20, "longitude": 20}
+        permissions=["geolocation"], geolocation={"latitude": 10.5, "longitude": 10.5}
     )
 
     page2 = await context2.new_page()
@@ -66,7 +66,7 @@ async def test_should_isolate_contexts(
       resolve({latitude: position.coords.latitude, longitude: position.coords.longitude})
     }))"""
     )
-    assert geolocation2 == {"latitude": 20, "longitude": 20}
+    assert geolocation2 == {"latitude": 10.5, "longitude": 10.5}
 
     await context2.close()
 
diff --git a/tests/async/test_page_add_locator_handler.py b/tests/async/test_page_add_locator_handler.py
index 4492037a7..4a5a44323 100644
--- a/tests/async/test_page_add_locator_handler.py
+++ b/tests/async/test_page_add_locator_handler.py
@@ -312,7 +312,7 @@ def _handler() -> None:
     with pytest.raises(Error) as exc_info:
         await page.locator("#target").click(timeout=3000)
     assert await page.evaluate("window.clicked") == 0
-    await expect(page.locator("#interstitial")).to_be_visible()
+    assert await page.locator("#interstitial").is_visible()
     assert called == 1
     assert (
         'locator handler has finished, waiting for get_by_role("button", name="close") to be hidden'
diff --git a/tests/async/test_page_request_intercept.py b/tests/async/test_page_request_intercept.py
index 934aed8a0..dc8f7416a 100644
--- a/tests/async/test_page_request_intercept.py
+++ b/tests/async/test_page_request_intercept.py
@@ -34,7 +34,7 @@ def _handler(request: TestServerRequest) -> None:
     async def handle(route: Route) -> None:
         with pytest.raises(Error) as error:
             await route.fetch(timeout=1000)
-        assert "Request timed out after 1000ms" in error.value.message
+        assert "Timeout 1000ms exceeded" in error.value.message
 
     await page.route("**/*", lambda route: handle(route))
     with pytest.raises(Error) as error:
diff --git a/tests/async/test_page_route.py b/tests/async/test_page_route.py
index b04f96145..fecafdfba 100644
--- a/tests/async/test_page_route.py
+++ b/tests/async/test_page_route.py
@@ -1155,6 +1155,18 @@ 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/")
 
+    custom_prefixes = ["about", "data", "chrome", "edge", "file"]
+    for prefix in custom_prefixes:
+        assert url_matches(
+            "http://playwright.dev/", f"{prefix}:blank", f"{prefix}:blank"
+        )
+        assert not url_matches(
+            "http://playwright.dev/", f"{prefix}:blank", "http://playwright.dev/"
+        )
+        assert url_matches(None, f"{prefix}:blank", f"{prefix}:blank")
+        assert url_matches(None, f"{prefix}:blank", f"{prefix}:*")
+        assert not url_matches(None, f"not{prefix}:blank", f"{prefix}:*")
+
     # Added for Python implementation
     assert url_matches(
         None,
diff --git a/tests/async/test_selectors_misc.py b/tests/async/test_selectors_misc.py
index 5527d6ec8..5ad6c3519 100644
--- a/tests/async/test_selectors_misc.py
+++ b/tests/async/test_selectors_misc.py
@@ -12,6 +12,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import pytest
+
+from playwright._impl._browser import Browser
+from playwright._impl._errors import Error
+from playwright._impl._selectors import Selectors
 from playwright.async_api import Page
 
 
@@ -52,3 +57,26 @@ async def test_should_work_with_internal_and(page: Page) -> None:
             '.bar >> internal:and="span"', "els => els.map(e => e.textContent)"
         )
     ) == ["world2"]
+
+
+async def test_should_throw_already_registered_error_when_registering(
+    selectors: Selectors,
+    browser: Browser,
+) -> None:
+    create_tag_selector = """
+    () => ({
+        query(root, selector) {
+            return root.querySelector(selector);
+        },
+        queryAll(root, selector) {
+            return Array.from(root.querySelectorAll(selector));
+        }
+    })
+    """
+    name = f"alreadyRegistered-{browser.browser_type.name}"
+    await selectors.register(name, create_tag_selector)
+    with pytest.raises(
+        Error,
+        match=f'Selectors.register: "{name}" selector engine has been already registered',
+    ):
+        await selectors.register(name, create_tag_selector)
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index e735c96a8..e902eafbd 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -136,6 +136,7 @@ async def test_should_collect_trace_with_resources_but_no_js(
     await page.click('"Click"')
     await page.mouse.move(20, 20)
     await page.mouse.dblclick(30, 30)
+    await page.request.get(server.EMPTY_PAGE)
     await page.keyboard.insert_text("abc")
     await page.wait_for_timeout(2000)  # Give it some time to produce screenshots.
     await page.route("**/empty.html", lambda route: route.continue_())
@@ -153,6 +154,7 @@ async def test_should_collect_trace_with_resources_but_no_js(
                 re.compile(r"Click"),
                 re.compile(r"Mouse move"),
                 re.compile(r"Double click"),
+                re.compile(r"GET \"/empty\.html\""),
                 re.compile(r'Insert "abc"'),
                 re.compile(r"Wait for timeout"),
                 re.compile(r'Navigate to "/empty\.html"'),
diff --git a/tests/async/test_unroute_behavior.py b/tests/async/test_unroute_behavior.py
index 036423cdc..ff737eaab 100644
--- a/tests/async/test_unroute_behavior.py
+++ b/tests/async/test_unroute_behavior.py
@@ -451,3 +451,59 @@ async def _goto_ignore_exceptions() -> None:
     await page.close()
     # Should not throw.
     await route.fulfill()
+
+
+async def test_should_not_continue_requests_in_flight_page(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+
+    async def handle(route: Route) -> None:
+        route_future.set_result(route)
+        await asyncio.sleep(3)
+        await route.fulfill(status=200)
+
+    async def _evaluate_ignore_exceptions() -> None:
+        try:
+            await page.evaluate("() => fetch('/')")
+        except Error:
+            pass
+
+    await page.route(
+        "**/*",
+        handle,
+    )
+
+    asyncio.create_task(_evaluate_ignore_exceptions())
+    await route_future
+    await page.unroute_all(behavior="wait")
+
+
+async def test_should_not_continue_requests_in_flight_context(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+
+    route_future: "asyncio.Future[Route]" = asyncio.Future()
+
+    async def handle(route: Route) -> None:
+        route_future.set_result(route)
+        await asyncio.sleep(3)
+        await route.fulfill(status=200)
+
+    async def _evaluate_ignore_exceptions() -> None:
+        try:
+            await page.evaluate("() => fetch('/')")
+        except Error:
+            pass
+
+    await context.route(
+        "**/*",
+        handle,
+    )
+
+    asyncio.create_task(_evaluate_ignore_exceptions())
+    await route_future
+    await context.unroute_all(behavior="wait")
diff --git a/tests/sync/conftest.py b/tests/sync/conftest.py
index 3d7ae9116..58193c0de 100644
--- a/tests/sync/conftest.py
+++ b/tests/sync/conftest.py
@@ -143,7 +143,7 @@ def action_titles(self) -> Locator:
 
     @property
     def stack_frames(self) -> Locator:
-        return self.page.get_by_test_id("stack-trace-list").locator(".list-view-entry")
+        return self.page.get_by_role("list", name="Stack trace").get_by_role("listitem")
 
     def select_action(self, title: str, ordinal: int = 0) -> None:
         self.page.locator(".action-title", has_text=title).nth(ordinal).click()
diff --git a/tests/sync/test_fetch_global.py b/tests/sync/test_fetch_global.py
index 7305834a9..bf3970c21 100644
--- a/tests/sync/test_fetch_global.py
+++ b/tests/sync/test_fetch_global.py
@@ -67,7 +67,7 @@ def test_should_support_global_timeout_option(
 ) -> None:
     request = playwright.request.new_context(timeout=100)
     server.set_route("/empty.html", lambda req: None)
-    with pytest.raises(Error, match="Request timed out after 100ms"):
+    with pytest.raises(Error, match="Timeout 100ms exceeded"):
         request.get(server.EMPTY_PAGE)
 
 
diff --git a/tests/sync/test_page_add_locator_handler.py b/tests/sync/test_page_add_locator_handler.py
index b069520ec..b2d037f07 100644
--- a/tests/sync/test_page_add_locator_handler.py
+++ b/tests/sync/test_page_add_locator_handler.py
@@ -310,7 +310,7 @@ def _handler() -> None:
     with pytest.raises(Error) as exc_info:
         page.locator("#target").click(timeout=3000)
     assert page.evaluate("window.clicked") == 0
-    expect(page.locator("#interstitial")).to_be_visible()
+    assert page.locator("#interstitial").is_visible()
     assert called == 1
     assert (
         'locator handler has finished, waiting for get_by_role("button", name="close") to be hidden'
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index 1a42aab9b..8d0eaa191 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -138,6 +138,7 @@ def test_should_collect_trace_with_resources_but_no_js(
     page.click('"Click"')
     page.mouse.move(20, 20)
     page.mouse.dblclick(30, 30)
+    page.request.get(server.EMPTY_PAGE)
     page.keyboard.insert_text("abc")
     page.wait_for_timeout(2000)  # Give it some time to produce screenshots.
     page.route("**/empty.html", lambda route: route.continue_())
@@ -155,6 +156,7 @@ def test_should_collect_trace_with_resources_but_no_js(
                 re.compile(r"Click"),
                 re.compile(r"Mouse move"),
                 re.compile(r"Double click"),
+                re.compile(r"GET \"/empty\.html\""),
                 re.compile(r'Insert "abc"'),
                 re.compile(r"Wait for timeout"),
                 re.compile(r'Navigate to "/empty\.html"'),

From bd5b0331e67ed22bc75417092e87a456dd73c832 Mon Sep 17 00:00:00 2001
From: Adam Gastineau <adam@agg.im>
Date: Wed, 16 Jul 2025 11:49:13 -0700
Subject: [PATCH 405/438] chore: roll to 1.54.1 (#2919)

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

diff --git a/setup.py b/setup.py
index c4a75870a..5c2911865 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.54.0"
+driver_version = "1.54.1"
 
 base_wheel_bundles = [
     {

From cc27d2512920d9bc7208722d3293815f3f2e6139 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 22 Jul 2025 14:42:42 +0200
Subject: [PATCH 406/438] test: update client certificate test certs (#2923)

---
 tests/assets/client-certificates/README.md    |  57 +---------
 .../client/localhost/localhost.csr            |  27 +++++
 .../client/localhost/localhost.ext            |   1 +
 .../client/localhost/localhost.key            |  52 +++++++++
 .../client/localhost/localhost.pem            |  30 ++++++
 .../client/self-signed/cert.pem               |  50 ++++-----
 .../client/self-signed/csr.pem                |  46 ++++----
 .../client/self-signed/key.pem                | 100 +++++++++---------
 .../client/trusted/cert-legacy.pfx            | Bin 0 -> 4045 bytes
 .../client/trusted/cert.pem                   |  52 ++++-----
 .../client/trusted/cert.pfx                   | Bin 0 -> 4195 bytes
 .../client/trusted/csr.pem                    |  46 ++++----
 .../client/trusted/key.pem                    | 100 +++++++++---------
 tests/assets/client-certificates/generate.sh  |  88 +++++++++++++++
 .../server/server_cert.pem                    |  54 +++++-----
 .../client-certificates/server/server_key.pem | 100 +++++++++---------
 16 files changed, 474 insertions(+), 329 deletions(-)
 create mode 100644 tests/assets/client-certificates/client/localhost/localhost.csr
 create mode 100644 tests/assets/client-certificates/client/localhost/localhost.ext
 create mode 100644 tests/assets/client-certificates/client/localhost/localhost.key
 create mode 100644 tests/assets/client-certificates/client/localhost/localhost.pem
 create mode 100644 tests/assets/client-certificates/client/trusted/cert-legacy.pfx
 create mode 100644 tests/assets/client-certificates/client/trusted/cert.pfx
 create mode 100755 tests/assets/client-certificates/generate.sh

diff --git a/tests/assets/client-certificates/README.md b/tests/assets/client-certificates/README.md
index b0ee78e70..2c73bd92f 100644
--- a/tests/assets/client-certificates/README.md
+++ b/tests/assets/client-certificates/README.md
@@ -1,60 +1,7 @@
 # Client Certificate test-certificates
 
-## Server
+Regenerate all certificates by running:
 
-```bash
-openssl req \
-	-x509 \
-	-newkey rsa:4096 \
-	-keyout server/server_key.pem \
-	-out server/server_cert.pem \
-	-nodes \
-	-days 365 \
-	-subj "/CN=localhost/O=Client\ Certificate\ Demo" \
-	-addext "subjectAltName=DNS:localhost,DNS:local.playwright"
 ```
-
-## Trusted client-certificate (server signed/valid)
-
-```
-mkdir -p client/trusted
-# generate server-signed (valid) certifcate
-openssl req \
-	-newkey rsa:4096 \
-	-keyout client/trusted/key.pem \
-	-out client/trusted/csr.pem \
-	-nodes \
-	-days 365 \
-	-subj "/CN=Alice"
-
-# sign with server_cert.pem
-openssl x509 \
-	-req \
-	-in client/trusted/csr.pem \
-	-CA server/server_cert.pem \
-	-CAkey server/server_key.pem \
-	-out client/trusted/cert.pem \
-	-set_serial 01 \
-	-days 365
-```
-
-## Self-signed certificate (invalid)
-
-```
-mkdir -p client/self-signed
-openssl req \
-	-newkey rsa:4096 \
-	-keyout client/self-signed/key.pem \
-	-out client/self-signed/csr.pem \
-	-nodes \
-	-days 365 \
-	-subj "/CN=Bob"
-
-# sign with self-signed/key.pem
-openssl x509 \
-	-req \
-	-in client/self-signed/csr.pem \
-	-signkey client/self-signed/key.pem \
-	-out client/self-signed/cert.pem \
-	-days 365
+bash generate.sh
 ```
diff --git a/tests/assets/client-certificates/client/localhost/localhost.csr b/tests/assets/client-certificates/client/localhost/localhost.csr
new file mode 100644
index 000000000..cbf60ba43
--- /dev/null
+++ b/tests/assets/client-certificates/client/localhost/localhost.csr
@@ -0,0 +1,27 @@
+-----BEGIN CERTIFICATE REQUEST-----
+MIIEizCCAnMCAQAwFDESMBAGA1UEAwwJbG9jYWxob3N0MIICIjANBgkqhkiG9w0B
+AQEFAAOCAg8AMIICCgKCAgEAuxTIfOTWJzsLSYT/RXu6eUYe95oFA0gMM6pdQAws
+U08ufU8S68UzBIAb6zdwDqM6LD5FqLrwaTsUW73dKefb003EgA19L3sZTHSwnSv9
+g9+rnKw/8EA+1thFo7h3EfdWkO/nuxnPfEnHu5oxMk/mCu+hdjfgh01mxc00PIO/
+wioxZtuhzKNIUu+qQAj70Dwbkzy3Zb1QAnj+02AUYnrVTYhusmP4pjrfYgAWU1x4
+WN+XTSI27LnQHE8t8OxuICFwqEEPcJg4pCFNQgmO0gcRDbd4U7JgQ0xMXZ9na9k0
+f1GOgtjKsz5IIDrAwLnrIOEXiIYlNaQ/v28BrlWytaOHGFKmDxAbGXHz1WuftmR1
+vYQivC5fkXU3+QKWoGPZaLIhA7/ZOMSVgoo+Rv+mS6Mze/6LphatUMcI1oYX4ZBY
+FrsVsAeAO/FPZDcwVct0bdPCRRFBQpgl6DxMyItHMexNHwURi4YHwhYiBBe+Njc1
+tTh6dniA11MUVC5WmKME7CxgXxHVXE4MYcf/w1x4sOnxHneb1bCa8jOPELRc6byR
+8mk23fbBP42EPkrgpCtLhbHgskLKobLFav43xaIiYFn744U7rbINI+5RfJ8BH5Kw
+CB5RlAsymPxwDNcPXyyyeHEEUAQmtnJPrGPSGMN/QODgCWRXEvY556NGx0D5riu7
+MXkCAwEAAaAyMDAGCSqGSIb3DQEJDjEjMCEwHwYDVR0RBBgwFoIJbG9jYWxob3N0
+ggkxMjcuMC4wLjEwDQYJKoZIhvcNAQELBQADggIBAEYqpx28FFRHqXfyumTkkFb/
+hrlUD9qKUYSdjpsPLFRUYiLofNlYhCtEFEuHyLkNHqLO5Z6E7yOpm/HvdXY0eBQy
+tK0verggKXy8MnpLVtsFOf4DgenTwFRG3NbNk2/KynwiAwJ0iwOdDfAmwrzYFLeR
+uXysPE0lGJu277akuo/PDg3QEY44iDJgI4rqtY25sR8J23M9Roa5qN4bdaXl6l10
+UJhdugTG90gRFmmUVLLRa21A3j4m7pvWHu7zYJN7ylS/NQ6ZEnpNno7Ie6MLzrm6
+h8MOSoxtmrXi0e3aYf7PC3u3YLAjyUzHicgMdXk8SjtUXi6l3U5hU+6WBeOKKmwa
+vi+FUpRfnutkWpinNqikmMw0Sqy+bpXwbwgm2oD6driiMneBCT37gW/IyUPWVxzg
+dVgeQIt3i8SMwnGUrzfVo/gqjq4qFBpzS3h9jPPrMYQN2LQdmyo13R9UH26cLGE1
+cgVmqUKa11kX8353wfA36JuW5yGv2yaK4V1kwFISznMvk5AGdOHONdZOrN4sLIIY
+7Npqp5AO1KdoYcNVptCA4n6mN/30fTmA/W1ajsKcfIn5RlmvdgpooKoEgaU/X9RL
+d2ydIpijWbQqm+nF9skpO4jIFPfuQj6mMXCPWtsvbpHCoo0iMHHWfVFcpvsXGYN2
+6ji5z3opVapp1m5uTmcA
+-----END CERTIFICATE REQUEST-----
diff --git a/tests/assets/client-certificates/client/localhost/localhost.ext b/tests/assets/client-certificates/client/localhost/localhost.ext
new file mode 100644
index 000000000..d4d022726
--- /dev/null
+++ b/tests/assets/client-certificates/client/localhost/localhost.ext
@@ -0,0 +1 @@
+subjectAltName=DNS:localhost,DNS:127.0.0.1
diff --git a/tests/assets/client-certificates/client/localhost/localhost.key b/tests/assets/client-certificates/client/localhost/localhost.key
new file mode 100644
index 000000000..7f6adba53
--- /dev/null
+++ b/tests/assets/client-certificates/client/localhost/localhost.key
@@ -0,0 +1,52 @@
+-----BEGIN PRIVATE KEY-----
+MIIJQQIBADANBgkqhkiG9w0BAQEFAASCCSswggknAgEAAoICAQC7FMh85NYnOwtJ
+hP9Fe7p5Rh73mgUDSAwzql1ADCxTTy59TxLrxTMEgBvrN3AOozosPkWouvBpOxRb
+vd0p59vTTcSADX0vexlMdLCdK/2D36ucrD/wQD7W2EWjuHcR91aQ7+e7Gc98Sce7
+mjEyT+YK76F2N+CHTWbFzTQ8g7/CKjFm26HMo0hS76pACPvQPBuTPLdlvVACeP7T
+YBRietVNiG6yY/imOt9iABZTXHhY35dNIjbsudAcTy3w7G4gIXCoQQ9wmDikIU1C
+CY7SBxENt3hTsmBDTExdn2dr2TR/UY6C2MqzPkggOsDAuesg4ReIhiU1pD+/bwGu
+VbK1o4cYUqYPEBsZcfPVa5+2ZHW9hCK8Ll+RdTf5ApagY9losiEDv9k4xJWCij5G
+/6ZLozN7/oumFq1QxwjWhhfhkFgWuxWwB4A78U9kNzBVy3Rt08JFEUFCmCXoPEzI
+i0cx7E0fBRGLhgfCFiIEF742NzW1OHp2eIDXUxRULlaYowTsLGBfEdVcTgxhx//D
+XHiw6fEed5vVsJryM48QtFzpvJHyaTbd9sE/jYQ+SuCkK0uFseCyQsqhssVq/jfF
+oiJgWfvjhTutsg0j7lF8nwEfkrAIHlGUCzKY/HAM1w9fLLJ4cQRQBCa2ck+sY9IY
+w39A4OAJZFcS9jnno0bHQPmuK7sxeQIDAQABAoICAA5XaYcpg8E+JX9dUrRg58qk
+NXuFsxytSUIsrTlbtYotZ8LzbN/mHiMaLwm5Fj4JBUye+XgV3Jg0jzr5MxsjSxbH
+v2iRoCcjqKzTxTZHSQfy/ZTlH4GrayXNLol+eqJF87zopzsQn3dHsKgRCfRxa5Er
+DZWicvPsWxSOxpJdBzY7Rc48yAqH+eNhvAtspOExumtvHCAQgzGtVNufYfCque9X
+piTGxSj5GmbI2u1JCXDGszKWjN9Y3ztMVplBhq+v4JMFacmX4b+zTdjiIrC3GfeT
+OQYxhm+iSbhjn+oEnKGl/ubI98EF5UGTP3OGzR+YIdW1cuTJ0pk6SUa0Cx8hihmR
+rnUgxbXjR/sB383ES4kYVT+tm/a8PIvPd1gu4j28sNRXGgVZ8GU76Y2ZITm3eoDr
+7PzVWsTe+vbxBXenlcmzO9rj91yK0eDBaJnwAIPxHGFxTkQkx3T2nnWStkHrvT6h
+15fHITgKWE+K2FMCIJQj5gIT3qGnZxZDLIgmyowVV9ZXuI2XchehD+L7nVsMhsby
+yIITglz1miYgy7zVL0oolIXuE0eQ4xAZlu1D5wjAQy/VzyB7OYY6bTErC0EmXjNS
+3QAYsI+Kn7YgjNJJNuJ5cC2S8nHNJ2uTJ54KWeA5s1Ry8B5kJrMGZxCT6Uk3POcG
+Ry5BxOczToKIgXeqm4IBAoIBAQDcvNBNXANexHn4r3yXgmL9IH4QXHAJ3h7tO6Ng
+zZh4K5VmoxSJ82CWQkJrs827F1kE2T9Mq6YPvXrh5VlKZjR+II2ZG7KqT00SULDy
+kSgG8OU/2+DWhyoQ6nt1RhXKDz0s4SjHwkeKwBFexTHf5ed+TILPfnPJIUX89gxV
+4EKL+EsqOsT6CMS7gruUuaA29VGVDneBw9KxKD9IdNXDrbot0DhidIYW1QkCed9g
+tnb2QvJrQmTkupUDI+HdWqOfpcBHwf9FIEI1q6cJtpVYSuaZfZX7hbvSHsTt9rwt
+b6gkiuPBy6qoXP1LWHc093tSzXEk1CWy0F4cCPi4r7UWqmWtAoIBAQDY95LGRUTn
+RKRSl2C5uZnsME5G/6XkqVcGhP5TOnT3/li/NLESZDaF+4iEhEh4M1oWVqShq4ps
+S98baYebriZDMmBm8L1YM63N+fhiI3q1+TF26f7zk6XPFQr88WIli58JmrK02EXG
+4XG/GBtzqfsnueBnwBGz5iE8phXqWyPs1/3qGyK+BHnUqnr3BAZpg8aw2PEjMzoC
+ChfLMzSJZRGDNp7sslkMJ9H9CXoMZsG5YJkQp7aSBD1SI5rJ2q7JC3PmOR913CgU
+0DDhxyJhD77aTEwrZOByaHq8F8KxZ8cl+YRl/tnWu7Gwa2pfjnC9DCk1ARCuDcSg
+OW7JTtsd3zx9AoIBAH17uM7BaAkPmGcPG7zlmnBbcE7MvcReSSaDqLT3K53k6OGY
+A60Idff1YtznMiUReMGQ3rMvQQ/hn2Gbh88Lmvu4dcZ8QG0g96dZx72dVyva9ff/
+fyl1XSyQn+5jES/0ycohlZU5lIID/dvqLhgiEh9yT0q1kAzepXLQTOLkwe/gDprL
+Hf8lzPDruMcrXzDe9KnPt5BFShj70D3YbUz4DcbNf8A4jaGdKaoGrj3EfIwyMq1W
+6RQ+HUfTtiqnxCyVhWFFn2Aknn70Pdj/upaevciz4/dAZy1j4H+GrCMIPoXHjwI0
+Tae4dSXH/LxXk/vWXmOZVnT4jwdQ8lPLTx67b2ECggEAK5t20IrTknflXwQ12J5J
+JYN/+B0hxpeSeij4xNmW8NEaHTQF8uBZZQxtH9VGi4ImtR6s8CF+LM4DBYtsSgny
+fsb9QTNZmwSoBiIbnf3rh++R1YiqSWJ/jON51eTeCRXK3S9Og7KEM7jUF8hMnC6p
+4A4n4DJmXHYAcCQhe3zd95hh3E+f5/kWU3wAQu14LHTj1l+D98MwAYDtz1V3VbYO
+kwTDZGdkJmFKf0UMVrnAbfXQTdyngSmA+aVWUwO05Yt7u+X3QMUC+UvuxzIy4rc7
+cLytAnu/8L63DF7qLqXhDOzdg3J5bgNDb2Xnd1U1q4lqLtEL/S+fOWTRs3w55gMc
+MQKCAQA0tO3yakIOlizE7qlJye2n2Y/q0nSx1iFlKqEe1ja0O7/t+UzfklBiaDhA
+NAqYOiUsDsL/vf76KQ0uE/v0No/36SKvBuQxozdNEGlZHf7CnsrIg1w9llrJgkYA
+1FoSHgHCbC84+dUoonjYg9vx3Lsszw5O1bmwqTBaGSSglIr3f+a3zxtQUquxNEPS
+advAKAdvXsNECj2cMkv3mxSokGQtd/s/rpvxJ8zi5nq5ig80Gfe/6GJpwJnC+sLr
++tn38FNfk5pKXk8jBXjyLtMNDb2iJbiTa1iX1P76Ae2jtexSd2gELNu7oWbotb/O
+DjCwHSmcSUmAmx7IXfoyRQuKLeRw
+-----END PRIVATE KEY-----
diff --git a/tests/assets/client-certificates/client/localhost/localhost.pem b/tests/assets/client-certificates/client/localhost/localhost.pem
new file mode 100644
index 000000000..5c1a67505
--- /dev/null
+++ b/tests/assets/client-certificates/client/localhost/localhost.pem
@@ -0,0 +1,30 @@
+-----BEGIN CERTIFICATE-----
+MIIFKDCCAxCgAwIBAgIBATANBgkqhkiG9w0BAQsFADA2MRIwEAYDVQQDDAlsb2Nh
+bGhvc3QxIDAeBgNVBAoMF0NsaWVudCBDZXJ0aWZpY2F0ZSBEZW1vMB4XDTI1MDcy
+MTE1NTYxOVoXDTM1MDcxOTE1NTYxOVowFDESMBAGA1UEAwwJbG9jYWxob3N0MIIC
+IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAuxTIfOTWJzsLSYT/RXu6eUYe
+95oFA0gMM6pdQAwsU08ufU8S68UzBIAb6zdwDqM6LD5FqLrwaTsUW73dKefb003E
+gA19L3sZTHSwnSv9g9+rnKw/8EA+1thFo7h3EfdWkO/nuxnPfEnHu5oxMk/mCu+h
+djfgh01mxc00PIO/wioxZtuhzKNIUu+qQAj70Dwbkzy3Zb1QAnj+02AUYnrVTYhu
+smP4pjrfYgAWU1x4WN+XTSI27LnQHE8t8OxuICFwqEEPcJg4pCFNQgmO0gcRDbd4
+U7JgQ0xMXZ9na9k0f1GOgtjKsz5IIDrAwLnrIOEXiIYlNaQ/v28BrlWytaOHGFKm
+DxAbGXHz1WuftmR1vYQivC5fkXU3+QKWoGPZaLIhA7/ZOMSVgoo+Rv+mS6Mze/6L
+phatUMcI1oYX4ZBYFrsVsAeAO/FPZDcwVct0bdPCRRFBQpgl6DxMyItHMexNHwUR
+i4YHwhYiBBe+Njc1tTh6dniA11MUVC5WmKME7CxgXxHVXE4MYcf/w1x4sOnxHneb
+1bCa8jOPELRc6byR8mk23fbBP42EPkrgpCtLhbHgskLKobLFav43xaIiYFn744U7
+rbINI+5RfJ8BH5KwCB5RlAsymPxwDNcPXyyyeHEEUAQmtnJPrGPSGMN/QODgCWRX
+EvY556NGx0D5riu7MXkCAwEAAaNjMGEwHwYDVR0RBBgwFoIJbG9jYWxob3N0ggkx
+MjcuMC4wLjEwHQYDVR0OBBYEFIE6kbIR0PlzaJuZg52JqXuFFQHBMB8GA1UdIwQY
+MBaAFPHaEfjJoIftSkHTb8mwme27LtifMA0GCSqGSIb3DQEBCwUAA4ICAQB7E57H
+19qUD4DjLxJGAVpDphD8mZg9aR7bUd6laXZ12VQnn3+OrF+6JjJ2TIr8ssRkkzc6
+rMhRqob+DxeB94JqlFQDmwP37wJXnuTtuGj71NHQal15b5ZB28fFdwWgUlYECWyg
+sYeMK5HMnNDziniRnjPoKU6f8urmUW2G8N2SOufnRar/StY/8u24IFh/vDTVJKWB
+a22pVk/PIx6JcErfMx0OJdoIUZd/C9DT/a7t+Pt+t3EPVNM2fcjs9aMcg6tlU6Tp
+YwHMzkFQYmcrp2QEhwy23z2E+wnLbeHTULDsHVOLudUGDcSgkW48bPNTOtZTysQ+
+P4mJf+Ju2HC/EwuVrOa14uuay9c+hC1Q1gsGbLZB8NE6jOX5QYN2a7iiUEdCdufo
+wWIXEC+2dJiEji3ehwJp0q4jK15X0IOIfxLH4PholORH659DdCfpm7YAjoaPE9nr
+28MMd9Lj6zWmfyeb5p0IUDpkreL2huxjXHJkmSm4dcxDxLqsP6KSPlhrPvjAVUqw
+5M/jUarDAHaPLNlwqcqWODb891FIyRmc6YHtSRGujMyfJ8LRS2f9rHeyM3m2jMHf
+8EahOgyQ8nvSs/a42VS97IHkGl6qufK7ZUq/VMhQRb+KbaIDN5TLtNwEQ1I40Bm9
+UOoSX/uP1PstOZvf9gnYto8sf75B+PxO692uYw==
+-----END CERTIFICATE-----
diff --git a/tests/assets/client-certificates/client/self-signed/cert.pem b/tests/assets/client-certificates/client/self-signed/cert.pem
index 3c0771794..d14ac95b2 100644
--- a/tests/assets/client-certificates/client/self-signed/cert.pem
+++ b/tests/assets/client-certificates/client/self-signed/cert.pem
@@ -1,28 +1,28 @@
 -----BEGIN CERTIFICATE-----
-MIIEyzCCArOgAwIBAgIUYps4gh4MqFYg8zqQhHYL7zYfbLkwDQYJKoZIhvcNAQEL
-BQAwDjEMMAoGA1UEAwwDQm9iMB4XDTI0MDcxOTEyNDc0MFoXDTI1MDcxOTEyNDc0
+MIIEyzCCArOgAwIBAgIUUo60oaPj20QM6oeGSn+2CT5j7GYwDQYJKoZIhvcNAQEL
+BQAwDjEMMAoGA1UEAwwDQm9iMB4XDTI1MDcyMTE1NTYyMFoXDTM1MDcxOTE1NTYy
 MFowDjEMMAoGA1UEAwwDQm9iMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKC
-AgEA179eTsqcc1c3AOQHzCZEyYLPta2CCAscUFqcEZ9vWvjW0uzOv9TDlB33Unov
-jch4CElZOBhzTadVsbmnYKpxwyVU89WCuQKvedz4k1vu7S1YryfNbmS8PWbnQ4ds
-9NB7SgJNHZILvx9DXuWeFEyzRIo1984z4HheBzrkf791LqpYKaKziANUo8h8t0dm
-TX/boOz8cEnQNwtTC0ZX3aD0obG/UAhr/22ZGPo/E659fh4ptyYX2LrIUHGy+Eux
-nJ9Y4cTqa88Ee6K6AkDiT/AoNQNxE4X++jqLuie8j/ZYpI1Oll38GwKVOyy1msRL
-toGmISNwkMIQDGABrJlxgpP4QQAQ+08v9srzXOlkdxdr7OCP81r+ccBXiSQEe7BA
-kdJ8l98l5dprJ++GJ+SZcV4+/iGR0dKU2IdAG5HiKZIFn6ch9Ux+UMqeGaYCpkHr
-TiietHwcXgtVBlE0jFmB/HspmI/O0abK+grMmueaH7XtTI8YHnw0mUpL8+yp7mfA
-7zFusgFgyiBPXeD/NQgg8vja67k++d1VGoXm2xr+5WPQCSbgQoMkkOBMLHWJTefd
-6F4Z5M+oI0VwYbf6eQW246wJgpCHSPR0Vdijd6MAGRWKUuLfDsA9+12iGbKvwJ2e
-nJlStft2V2LZcjBfdIMbigW1aSVNN5w6m6YVrQPry3WPkWcCAwEAAaMhMB8wHQYD
-VR0OBBYEFPxKWTFQJSg4HD2qjxL0dnXX/z4qMA0GCSqGSIb3DQEBCwUAA4ICAQBz
-4H1d5eGRU9bekUvi7LbZ5CP/I6w6PL/9AlXqO3BZKxplK7fYGHd3uqyDorJEsvjV
-hxwvFlEnS0JIU3nRzhJU/h4Yaivf1WLRFwGZ4TPBjX9KFU27exFWD3rppazkWybJ
-i4WuEdP3TJMdKLcNTtXWUDroDOgPlS66u6oZ+mUyUROil+B+fgQgVDhjRc5fvRgZ
-Lng8wuejCo3ExQyxkwn2G5guyIimgHmOQghPtLO5xlc67Z4GPUZ1m4tC+BCiFO4D
-YIXl3QiIpmU7Pss39LLKMGXXAgLRqyMzqE52lsznu18v5vDLfTaRH4u/wjzULhXz
-SrV1IUJmhgEXta4EeDmPH0itgKtkbwjgCOD7drrFrJq/EnvIaJ5cpxiI1pFmYD8g
-VVD7/KT/CyT1Uz1dI8QaP/JX8XEgtMJaSkPfjPErIViN9rh9ECCNLgFyv7Y0Plar
-A6YlvdyV1Rta/BHndf5Hqz9QWNhbFCMQRGVQNEcoKwpFyjAE9SXoKJvFIK/w5WXu
-qKzIYA26QXE3p734Xu1n8QiFJIyltVHbyUlD0k06194t5a2WK+/eDeReIsk0QOI8
-FGqhyPZ7YjR5tSZTmgljtViqBO5AA23QOVFqtjOUrjXP5pTbPJel99Z/FTkqSwvB
-Rt4OX7HfuokWQDTT0TMn5jVtJyi54cH7f9MmsNJ23g==
+AgEAzQMXYOZz3ILrbF9qpDng2pw2wJf1UFopehwaYyu7riWJ9+ADrhSnCSFBM3Sc
+MBc/8dIR6etWwci8QwJ/MtvIU0yx4llq+53G+19Bc1teC6q/b4QCRDIcTGxOZoR+
+jfYZVjPODEyJ5y5MZIo34ZP4bu+JnpT4W7+uojm3jOoyNPqXMcc70uAhfSKG+Jfr
+wZKteA4T5VKFytVcWgh4v03z8zTYeW3kD4lCsongBz6yu2dn3D6XMROnxiPwi+IR
+QqX1pwnJ0UA3CTeOHEw1jA3koxWIIg44PWaPaCj9Udrhf4ew00XLPWVZP8T5rVf8
+yUfecWQCR7FueJFqoLhPMMFi17rYmGZUvw3/YkXBjay4Q9e+G2WS3Xk8u+I1sCuV
+BJNBRv9DqtMC9D/N9NI8GkLrXwZmk82SXG+cQ0TSkNUHYI/03YKoqsn5H8PsG7Tc
++Y2Ca6TaCWims7lvOg7U0E6lu2h5NGcdWHFPJ9qfe+xho/yfYYwGqEKanGAu1kd5
+SbIaX6/YiM5/Pp/96MeRNrB9kLzDnZTNuGtdCawVFgbkWmfX2Z6/a0d6SvZGDzBx
+xTVZRB0my01E1FP53MS8YRH98HUjGEwNRVq2e1W+aXldKppgZ85GZD3l2YTeuI0i
+PJCDUzQiaWzFtWc8s13YQ1HLCOyOXF7QqMyNCiLGb4xQ56kCAwEAAaMhMB8wHQYD
+VR0OBBYEFMqdCDxkZm8HxNI4MLLveAVTdH7UMA0GCSqGSIb3DQEBCwUAA4ICAQAB
+MKd3WEJ8zI51FuyeTcMq6L1zk2vmKTFg6T7HZJhNZoD1AYvvsKJ8mrqeSwhxqjlE
+0H2FGLY+Z8Fw3+TE1QuvTuz3gwRI+yzBEyqi/fEGCGrhOVcWaXGgLCtWG+BA4Su8
+HenK97/n3OnXUnBozRPZMH02IaLrOiEGbpaabXKCCabpm5U1oGq437e3SeAeIL7U
+WxuHhHBx0yo9j7ACaCL6mz8xpk8NaRZpPy22MTlrPKwbOK2eYf3Jy5fHa/f6edTs
+KqZewI7t4oe/OqKdjyTgGYkjTE3Xcmo2T/fmcAeEP3HJX267kCzBi5J3McwonWxD
+N8zz9qKSf5YGQy140eEOTjjESwlPz6zfrTW92YdCIr63k9UCDL2HGQTRSxB6g4BQ
+loVzKS9/BKhulGqvSGvEoj6D+qG/PgFlBtJoE71X+vSIxvdbnOVmOi/l+NGNuP1Z
+nwnDtZWp4BKshhSKvqeOI+EyNMQ4FL20S4w8T+LR873jKrbd2MEuAsJiygWh+/ZJ
+haHTEhFxvH/a4i8gb/SGZlFB6oyPJ+XM5kZo4fcp7PnzxhYrIaEpPq+AR/3657hm
+AajXpS5lTCkNJc85QeHHj/0geDsOvfK4XUj2lgaJ0gXpgsoxnSCSq6Xox6ZqAVON
+0ra1KkGBTQH+5DxJ2Gp1UBaucrLYZTfXuJ8fPYeeNQ==
 -----END CERTIFICATE-----
diff --git a/tests/assets/client-certificates/client/self-signed/csr.pem b/tests/assets/client-certificates/client/self-signed/csr.pem
index 4c99e1349..283dd45a6 100644
--- a/tests/assets/client-certificates/client/self-signed/csr.pem
+++ b/tests/assets/client-certificates/client/self-signed/csr.pem
@@ -1,26 +1,26 @@
 -----BEGIN CERTIFICATE REQUEST-----
 MIIEUzCCAjsCAQAwDjEMMAoGA1UEAwwDQm9iMIICIjANBgkqhkiG9w0BAQEFAAOC
-Ag8AMIICCgKCAgEA179eTsqcc1c3AOQHzCZEyYLPta2CCAscUFqcEZ9vWvjW0uzO
-v9TDlB33Unovjch4CElZOBhzTadVsbmnYKpxwyVU89WCuQKvedz4k1vu7S1YryfN
-bmS8PWbnQ4ds9NB7SgJNHZILvx9DXuWeFEyzRIo1984z4HheBzrkf791LqpYKaKz
-iANUo8h8t0dmTX/boOz8cEnQNwtTC0ZX3aD0obG/UAhr/22ZGPo/E659fh4ptyYX
-2LrIUHGy+EuxnJ9Y4cTqa88Ee6K6AkDiT/AoNQNxE4X++jqLuie8j/ZYpI1Oll38
-GwKVOyy1msRLtoGmISNwkMIQDGABrJlxgpP4QQAQ+08v9srzXOlkdxdr7OCP81r+
-ccBXiSQEe7BAkdJ8l98l5dprJ++GJ+SZcV4+/iGR0dKU2IdAG5HiKZIFn6ch9Ux+
-UMqeGaYCpkHrTiietHwcXgtVBlE0jFmB/HspmI/O0abK+grMmueaH7XtTI8YHnw0
-mUpL8+yp7mfA7zFusgFgyiBPXeD/NQgg8vja67k++d1VGoXm2xr+5WPQCSbgQoMk
-kOBMLHWJTefd6F4Z5M+oI0VwYbf6eQW246wJgpCHSPR0Vdijd6MAGRWKUuLfDsA9
-+12iGbKvwJ2enJlStft2V2LZcjBfdIMbigW1aSVNN5w6m6YVrQPry3WPkWcCAwEA
-AaAAMA0GCSqGSIb3DQEBCwUAA4ICAQCb07d2IjUy1PeHCj/2k/z9FrZSo6K3c8y6
-b/u/MZ0AXPKLPDSo7UYpOJ8Z2cBiJ8jQapjTSEL8POUYqcvCmP55R6u68KmvINHo
-+Ly7pP+xPrbA4Q0WmPnz37hQn+I1he0GuEQyjZZqUln9zwp67TsWNKxKtCH+1j8M
-Ltzx6kuHCdPtDUtv291yhVRqvbjiDs+gzdQYNJtAkUbHwHFxu8oZhg8QZGyXYMN8
-TGoQ1LTezFZXJtX69K7WnrDGrjsgB6EMvwkqAFSYNH0LFvI0xo13OOgXr9mrwohA
-76uZtjXL9B15EqrMce6mdUZi46QJuQ2avTi57Lz+fqvsBYdQO89VcFSmqu2nfspN
-QZDrooyjHrlls8MpoBd8fde9oT4uA4/d9SJtuHUnjgGN7Qr7eTruWXL8wVMwFnvL
-igWE4detO9y2gpRLq6uEqzWYMGtN9PXJCGU8C8m9E2EBUKMrT/bpNbboatLcgRrW
-acj0BRVqoVzk1sRq7Sa6ejywqgARvIhTehg6DqdMdcENCPQ7rxDRu5PSDM8/mwIj
-0KYl8d2PlECB4ofRyLcy17BZzjP6hSnkGzcFk0/bChZOSIRnwvKbvfXnB45hhPk8
-XwT/6UNSwC2STP3gtOmLqrWj+OE0gy0AkDMvP3UnQVGMUvgfYg+N4ROCVtlqzxe9
-W65c05Mm1g==
+Ag8AMIICCgKCAgEAzQMXYOZz3ILrbF9qpDng2pw2wJf1UFopehwaYyu7riWJ9+AD
+rhSnCSFBM3ScMBc/8dIR6etWwci8QwJ/MtvIU0yx4llq+53G+19Bc1teC6q/b4QC
+RDIcTGxOZoR+jfYZVjPODEyJ5y5MZIo34ZP4bu+JnpT4W7+uojm3jOoyNPqXMcc7
+0uAhfSKG+JfrwZKteA4T5VKFytVcWgh4v03z8zTYeW3kD4lCsongBz6yu2dn3D6X
+MROnxiPwi+IRQqX1pwnJ0UA3CTeOHEw1jA3koxWIIg44PWaPaCj9Udrhf4ew00XL
+PWVZP8T5rVf8yUfecWQCR7FueJFqoLhPMMFi17rYmGZUvw3/YkXBjay4Q9e+G2WS
+3Xk8u+I1sCuVBJNBRv9DqtMC9D/N9NI8GkLrXwZmk82SXG+cQ0TSkNUHYI/03YKo
+qsn5H8PsG7Tc+Y2Ca6TaCWims7lvOg7U0E6lu2h5NGcdWHFPJ9qfe+xho/yfYYwG
+qEKanGAu1kd5SbIaX6/YiM5/Pp/96MeRNrB9kLzDnZTNuGtdCawVFgbkWmfX2Z6/
+a0d6SvZGDzBxxTVZRB0my01E1FP53MS8YRH98HUjGEwNRVq2e1W+aXldKppgZ85G
+ZD3l2YTeuI0iPJCDUzQiaWzFtWc8s13YQ1HLCOyOXF7QqMyNCiLGb4xQ56kCAwEA
+AaAAMA0GCSqGSIb3DQEBCwUAA4ICAQAn/ZI7IkBUEfhZHefwtF+QHCyxSEKvqwHq
+fSqKVdarBPz8Ik8m3icj8R/DcS3y5jgzx3x8bXQoDpgsAQgeb825NRv2wAQAGoH1
+8vh204lTyjqzrgtK7eQeQDc7fjeigIkxQsAK9zk4BaFUWp0wEC0RLVAgvlQTl7vu
+n1jSSrhK8tvGy62/cIxZfwD0bAMHlW4m1A4fUuSGWQX2KldgA8tnmT6wx0If/nKb
+VB68AMbyMHUeb32v9wEvx2nHlwMjqNFeg7vYyJXOfBdDILUl+OTBoQY1X+jSx5iM
+txTzmA8Hcgx0Fq+BnbQuZCLqFpNWEfenAtQtaAFuJwMiKCf6kgbqkDVShJkmt+vC
+j3dcsVMZDsdMk4qRpiJhaTQOYmsMGCj4uoDpFGjwPoUwlDkjYgHAAsm9uCkshc+m
+WZO7I6Z3Tbi3XskJvAMc3dTWjtc6nApEtr/mn8LcETfOp7RRSfjllj6ijWUrVwUy
+BpzU9C/zLTkhFX0DVDCIV+jEefF8JPfzSKLgXyRbInTz1/6/sKXtswXW0NjzqLMI
+C9ggMBhOiDv9KJn3G/mY4CqIfo9KMzF+++4t+wdXTir8DWNlMUAn1vlBwxZAgKCM
+GonVExBU0VIGCpyTRLkesEHnPMgybP6gLzP3++54x288OS5JwuPPtkDcsBHUjTq8
+HxTJvUul/Q==
 -----END CERTIFICATE REQUEST-----
diff --git a/tests/assets/client-certificates/client/self-signed/key.pem b/tests/assets/client-certificates/client/self-signed/key.pem
index 70d5e3dd0..c3ddd1a91 100644
--- a/tests/assets/client-certificates/client/self-signed/key.pem
+++ b/tests/assets/client-certificates/client/self-signed/key.pem
@@ -1,52 +1,52 @@
 -----BEGIN PRIVATE KEY-----
-MIIJQQIBADANBgkqhkiG9w0BAQEFAASCCSswggknAgEAAoICAQDXv15OypxzVzcA
-5AfMJkTJgs+1rYIICxxQWpwRn29a+NbS7M6/1MOUHfdSei+NyHgISVk4GHNNp1Wx
-uadgqnHDJVTz1YK5Aq953PiTW+7tLVivJ81uZLw9ZudDh2z00HtKAk0dkgu/H0Ne
-5Z4UTLNEijX3zjPgeF4HOuR/v3UuqlgporOIA1SjyHy3R2ZNf9ug7PxwSdA3C1ML
-RlfdoPShsb9QCGv/bZkY+j8Trn1+Him3JhfYushQcbL4S7Gcn1jhxOprzwR7oroC
-QOJP8Cg1A3EThf76Oou6J7yP9likjU6WXfwbApU7LLWaxEu2gaYhI3CQwhAMYAGs
-mXGCk/hBABD7Ty/2yvNc6WR3F2vs4I/zWv5xwFeJJAR7sECR0nyX3yXl2msn74Yn
-5JlxXj7+IZHR0pTYh0AbkeIpkgWfpyH1TH5Qyp4ZpgKmQetOKJ60fBxeC1UGUTSM
-WYH8eymYj87Rpsr6Csya55ofte1MjxgefDSZSkvz7KnuZ8DvMW6yAWDKIE9d4P81
-CCDy+NrruT753VUahebbGv7lY9AJJuBCgySQ4EwsdYlN593oXhnkz6gjRXBht/p5
-BbbjrAmCkIdI9HRV2KN3owAZFYpS4t8OwD37XaIZsq/AnZ6cmVK1+3ZXYtlyMF90
-gxuKBbVpJU03nDqbphWtA+vLdY+RZwIDAQABAoICAETxu6J0LuDQ+xvGwxMjG5JF
-wjitlMMbQdYPzpX3HC+3G3dWA4/b3xAjL1jlAPNPH8SOI/vAHICxO7pKuMk0Tpxs
-/qPZFCgpSogn7CuzEjwq5I88qfJgMKNyke7LhS8KvItfBuOvOx+9Ttsxh323MQZz
-IGHrPDq8XFf1IvYL6deaygesHbEWV2Lre6daIsAbXsUjVlxPykD81nHg7c0+VU6i
-rZ9WwaRjkqwftC6G8UVvQCdt/erdbYv/eZDNJ5oEdfPX6I3BHw6fZs+3ilq/RSoD
-yovRozS1ptc7QY/DynnzSizVJe4/ug6p7/LgTc2pyrwGRj+MNHKv73kHo/V1cbxF
-fBJCpxlfcGcEP27BkENiTKyRQEF1bjStw+UUKygrRXLm3MDtAVX8TrDERta4LAeW
-XvPiJbSOwWk2yYCs62RyKl+T1no7alIvc6SUy8rvKKm+AihjaTsxTeACC1cBc41m
-5HMz1dqdUWcB5jbnPsV+27dNK1/zIC+e0OXtoSXvS+IbQXo/awHJyXv5ClgldbB9
-hESFTYz/uI6ftuTM6coHQfASLgmnq0fOd1gyqO6Jr9ZSvxcPNheGpyzN3I3o5i2j
-LTYJdX3AoI5rQ5d7/GS2qIwWf0q8rxQnq1/34ABWD0umSa9tenCXkl7FIB4drwPB
-4n7n+SL7rhmv0vFKIjepAoIBAQD19MuggpKRHicmNH2EzPOyahttuhnB7Le7j6FC
-afuYUBFNcxww+L34GMRhmQZrGIYmuQ3QV4RjYh2bowEEX+F5R1V90iBtYQL1P73a
-jYtTfaJn0t62EBSC//w2rtaRJPgGhbXbnyid64J0ujRFCelej8FRJdBV342ctRAL
-0RazxQ/KcTRl9pncALxGhnSsBElZlDtZd/dWnWBDZ/fg/C97VV9ZQLcpyGvL516i
-GpB8BQsHiIe9Jt5flZvcKB7z/KItGzPB4WK6dpV8t/FeQiUpZXkQlqO03XaZT4NP
-AEGH3rKIRMpP7TORYFhbYrZwov3kzLaggax2wGPTkfMFNlTjAoIBAQDgjsYfShkz
-6Dl1UTYBrDMy9pakJbC6qmd0KOKX+4XH/Dc1mOzR8NGgoY7xWXFUlozgntKKnJda
-M6GfOt/dxc0Sq7moYzA7Jv4+9hNdU3jX5YrqAbcaSFj6k4yauO2BKCBahQo8qseY
-a3N5f0gp+5ftTMvOTwGw3JRJFJq0/DvKWAYLIaJ0Oo77zGs0vxa1Aqob10MloXt5
-DMwjazWujntTzTJY1vsfsBHa8OEObMwiftqnmn6L4Qprd3AzQkaNlZEsvERyLfFq
-1pu4EsDJJGdVfpZYfo+6vTglLXFBLEUQmh4/018Mw4O4pGgCVMj/wict/gTViQGC
-qSj+IOThsTytAoIBAHu3L3nEU/8EwMJ54q0a/nW+458U3gHqlRyWCZJDhxc9Jwbj
-IMoNRFj39Ef3VgAmrMvrh2RFsUTgRG5V1pwhsmNzmzAXstHx2zALaO73BZ7wcfFx
-Yy8G9ZpTMsU6upj1lICLX0diTmbo4IzgYIxdiPJUsvOjZqDbOvsZJEIdYSL5u5Cj
-0qx7FzdPc2SyGxuvaEnTwuqk6le5/4LIWCnmD+gksDpP0BIHSxmcfsBhRk3rp3mZ
-llVxqKdBtM1PrQojCFxR833RZfzOyzCZwaIc+V5SOUw7yYqfXxmMokrpoQy72ueq
-Wm1LrgWxBaCqDYSop7cftbkUoPB2o3/3SNtVUesCggEAReqOKy3R/QRf53QaoZiw
-9DwsmP0XMndd8J/ONU3d0G9p7SkpCxC05BOJQwH7NEAPqtwoZ3nr8ezDdKVLEGzG
-tfp7ur7vRGuWm5nYW6Viqa3Re5x/GxLNiW8pRv8vC5inwidMEamGraE++eQ0XsXz
-/rF7f0fAGgYDsWFV7eXe49hWQV7+iru0yxdRhcG9WyxyNGrogC3wGLdwU9LMiwXX
-xjbMZzbAR5R1arq3B9u+Dzt57tc+cWTm7qDocT1AZFLeOZSApyBA22foYf6MwdOw
-zMC2JOV68MR7V6/3ZDhZZJrnsi2omXvCZlnh/F/TmTYlJr/BV47pxnnOxpkNSmv5
-nQKCAQBRqrsUVO7NOgR1sVX7YDaekQiJKS6Vq/7y2gR4FoLm/MMzNZQgGo9afmKg
-F2hSv6tuoqc33Wm0FnoSEMaI8ky0qgA5kwXvhfQ6pDf/2zASFBwjwhTyJziDlhum
-iwWe1F7lNaVNpxAXzJBaBTWvHznuM42cGv5bbPBSRuIRniGsyn/zYMrISWgL+h/Q
-fsQ2rfPSqollPw+IUPN0mX+1zg6PFxaR4HM9UrRX7cnRKG20GIDPodsUl8IMg+SO
-M5YG/UqDD10hfeEutvQIvl0oJraBWT34cqUZLVpUwJzf1be7zl9MzHGcym/ni7lX
-dg6m3MAyZ1IXjHlogOdmGvnq07/w
+MIIJQwIBADANBgkqhkiG9w0BAQEFAASCCS0wggkpAgEAAoICAQDNAxdg5nPcguts
+X2qkOeDanDbAl/VQWil6HBpjK7uuJYn34AOuFKcJIUEzdJwwFz/x0hHp61bByLxD
+An8y28hTTLHiWWr7ncb7X0FzW14Lqr9vhAJEMhxMbE5mhH6N9hlWM84MTInnLkxk
+ijfhk/hu74melPhbv66iObeM6jI0+pcxxzvS4CF9Iob4l+vBkq14DhPlUoXK1Vxa
+CHi/TfPzNNh5beQPiUKyieAHPrK7Z2fcPpcxE6fGI/CL4hFCpfWnCcnRQDcJN44c
+TDWMDeSjFYgiDjg9Zo9oKP1R2uF/h7DTRcs9ZVk/xPmtV/zJR95xZAJHsW54kWqg
+uE8wwWLXutiYZlS/Df9iRcGNrLhD174bZZLdeTy74jWwK5UEk0FG/0Oq0wL0P830
+0jwaQutfBmaTzZJcb5xDRNKQ1Qdgj/Tdgqiqyfkfw+wbtNz5jYJrpNoJaKazuW86
+DtTQTqW7aHk0Zx1YcU8n2p977GGj/J9hjAaoQpqcYC7WR3lJshpfr9iIzn8+n/3o
+x5E2sH2QvMOdlM24a10JrBUWBuRaZ9fZnr9rR3pK9kYPMHHFNVlEHSbLTUTUU/nc
+xLxhEf3wdSMYTA1FWrZ7Vb5peV0qmmBnzkZkPeXZhN64jSI8kINTNCJpbMW1Zzyz
+XdhDUcsI7I5cXtCozI0KIsZvjFDnqQIDAQABAoICAAN6aFLBqijNNFEM/95MKJVQ
+5eln0pbDxtUeZbC1yNv8IU56J5nUGh7gqG5m7bDvrgssXxcuwdStEwuYft+2JJyM
+Li7qyTK+YyY34CCExfBQ++k4jkDJsFr4Ee7xk8OVD6o7nATvpf3M9mkUwryyIdqA
++B7fhGSrGHuCWuu6O/KT502GBazu1kadF7jfO/XXZxfEtl/zQdeWfdf9sY2+VPOU
++5C41XARijcE+Y7p6IafKx8MlUxU+ulUygOXiOcucV/dfcXt7tkaTxAKF3T6Nd0x
+8/Ku9tOM2kVAP8b8HYwIOW7mLdvrbKOVNA61sdFY5axbD+JXP2pufiZ+pgJL36FF
+SDQIW5M3aH7CSa1i3i4MP49jWomhTNwseVrXsDuGCKVqgIR5LZwpS4VOHLAILkCh
+cIEDnoMS9YPuQdENIIxKyZGGHaeJ+LRb4w+szvtmu55Kp+N7AubPfoypPrx7a8LN
+8/0/w731DS6nTICYXXzzGoB3cefb3nsBNaH1+edffPTZOYlFZ9ElFjIs/xvWCSy4
+qYwQ1cW4DslIiVD62wm8Df2yr/5J6znfU01RXQ4GWfmDNFBdYsQO/8JEy6UZEvCy
+tFZ1gseD9K69O4XZSEKRKIvv8+1Y/CwD0ppIOYCIycTKn87GXFmsjbuj8tghmHp4
+TUi3EUvrw8mQMi5QBa5BAoIBAQD8JzdNy4ietoT8UUWqBT+ZSURPWeQN1esbncYU
+b9viBIznnjjFFr5JdYa5k3rxM+bTRq47NRt+r0HOvyJWUFJcI6tbgmGtW+rmM2kB
+hq6ekTJleLz+/cjNSjWD14avNORPz/ozZMlcz52NEl31pdniuDbueeNgyh+CkJtH
+BS8s8mMVZ+3NtafZ1ilGn/RP+n21C1J8Kcxd/1srtfcpybzAQiSYul2DlKVPGvqO
+XpLyt42/cyc7a3MyXtms2XhJ62fDK24Qptp6KJNTzqdtY+KP/iOW0SUgxf+JpC87
+W2NJW7tqyyaebn7KO1lGs9y03KzwaLZvy2RaBfjQnxS8uXzpAoIBAQDQI8QHNtr5
+nHYSzLZJMhJkP641wQWo4ODfkWxtEMqTyOXrVw3L8HMdA03Nmf9jnCv5awYYA3j0
+PmSL3PdM36d3VsAyyxMBN4HrH2Z94oTnoKmDfXjB3prhPYgO6aosSvE8rw1N055o
+757p9vAA5w9apBBLNdcm3cjUm2ZKeocL4wnFjOW63CtcFEouE4R7C32rauEu9Bdg
+dAXciBmOrHtihJUQrpMfyfN2fVSLbO4SoFy7ZHq5YKFk4MzNIp/cENwRIqdcLvOz
+o++RSbwptRtkd/HZCFSh/4gEPRLe/k5gGErS9ZqpeSMfV++IdBMqC0Sx3UpyXuue
+FOhIvnLpJlzBAoIBAGjcDh2mBLyr/oXHbocUA6zFUUkGgtZWHZ2wcQ1Sr0hAyDAS
+Fl2v5ZY677oA4OGpydYW0KICpdp7G4zU43ytjnKOytYVVHV5gigVPRfLYJbEnwaf
+vUj1VSo6MCMR4ArAnimqvcvdn/eex1BBUR20yPWF0iI+QhagN5ZeeJSCTWoNqrLe
+M4CWiKUIcMXUAw+3hctiV/0WjMySQuHcnFqecIYre3igF/9+M3jAKW5HWijhuGrj
+gm8tcgyCcVd2YJWs9cuuJel62eRvN0Vk7S+KmE91SmuPsjb84BXnV1UB3jpFkZ0J
+upesL8H+CFRku+Xi13Bqu2OmW6csUJrBbShGovECggEBAKGk9SupJXyvT1+gTn0f
+/vqOHiyvAEc8hkf6t5sobDtDzZPs4tEcpznEBBuF2rqwYdJtlKj3oWsGPa4FaKXy
+GCvtWozX+6V5R1Oj6kQftJnyw1NUEYF28Q+2asEyJTAK77jyNkHX9HGIjwEi/xek
+Wt9JBUJzyOjtW3gKS/HRoKnRpBghKZTqQl5bf5SzIbMxpGKJOeLuPG1zDc5MgJS2
+TYigcOgovCf2/jZqdUtmyKn8kqgSC+GGMzGWCFfT6RTOnypLoHBOIoPD8F0ER7aY
+aXKoWFH2T0wUmLy59brrA1FL7GhTx86QPn+sGmH9y5hecfY0ZwnVv+TgVdmQ1stN
+OMECggEBAOXDX319Dmo0ydAPYyngK4/slOetGaJmz8looU8a2R2+Ko/VMTZDmJhf
+P0vS74g3U7sukRjmYzUY1mPj27CDURvk1ENam9KPOQ59ws/TaHaJ7tobjUXVQ93/
+OREkrlCuqbEqJJzQ01mCWIbmDnGvJwD87rW6YwmI9Rs+kjZxNLj+IW4CqpY36q9A
+HwaUZLXc2q0W1CqLmFYF5HotvSFIAYHWuClEmM2NI9+0VItarBz6AwCnVXwKbJLC
+irXlllX+63uloTDR5W1ymy2hTUrhE1jgh9DR4106QSVDiEWqme/BAWmUoyuN/zms
+v3/WVVAXEcIowL3T4jzJ0RLdf1qE8Bc=
 -----END PRIVATE KEY-----
diff --git a/tests/assets/client-certificates/client/trusted/cert-legacy.pfx b/tests/assets/client-certificates/client/trusted/cert-legacy.pfx
new file mode 100644
index 0000000000000000000000000000000000000000..9f06aa35c82f05be583a0cf8de295a68fdb9ccbf
GIT binary patch
literal 4045
zcmY+GXD}R$w})AEwM9hly<2r7T6C5uQKLjBT6EFET46(2y|>j8ge8dRqD7BhqVvY;
zz4x1U=HC0i_rsYp^Ze$VPiLMvU^u8BfQ<u&gW~al{81WF7o^w(*eEy%h6@LU{KWxa
zINs;~MEEE;UdCUP0>H-l+v5I{V1pU)iT-;72{t~M43|(%MP~8G)#e}oK!^o{<5?eS
zE^b1E6zBh}dJKHXp8t5yQP>tfz@jCWP9~0;T3EKEsr8vUX6wq{a`e0R055^sE6cO!
zJGs^yC6la~u=NcIOF#L{(n!z+N6jvg5cYnT_HL@+(asUxO{SAAyY~24(`rc#eEm^T
z`qu%F_7-YF<!cYqe6O4!w4*7AET2xg7_2e+jbClL{;Gl4J!q;dM8awalU-dTEl03_
z1*7xzTnpxV4>LT^$)%yP&BHMZQR0S~D_>$Ym<5!cTqi7gPHp)MC=`*XcEpkgpFIfk
ze4Vww6k(Ko#)Y>#?TqPB?>K^|R0yPO)6SEZ;%;@sm^*;Kln7%MNCv^!*%}F;0#+v;
zX6@i=mtiWwH5l$x$vM|(H*P>%cxcUg7`mv{YH%_+eZ4}!ineM>3Pj7)L^Dd40)c_q
z7M*EMLJz~}n(#%{Qjb1UeU}-Dw6Kc)vnWl9cNKU6{MohpHubs?8YTd+^M)ESR-nD_
z=k95BFJ-f}&-vjQlP>&;#Jw6u3{hErc()S83Tu5g4zWbTcAx=D`to%)6PskY`yciM
z@fVWkkcn&lA^%UIJQ8H>BUn@K1y^449dOqZ@7!dLg}%xsW<F5LIxCJP{&nn+!ggUL
zwcP4#uThod2j^3)PhOJ4d>A3m(#c%Wm5#amdJxPTk}hO+ihOtJ$eU$>x5@6mug5|2
z&~^}~l=U`!q540)ll&HS&Zwg0Bq~Q5(SgCgcQazJ8M}S;w8XS>vmnZrm%>H&vX%My
z9a!kZy*<c+^?>A)SiGx$O^65z6j~aK==YNDyF>G_HX1X0=pq#E$V=0G=uG_X^KGh<
z2!HDlmQHWA5yq|8=<4=uXxnqYi?K*&Fus4hHSdy(Ey_Fu)Ng@UwAC9lhG^8CsID@J
zH^8vJ^LErq!Tdn2JI=FjnEdO|WikfH;rPJwT-_E(+jmOM!@IeqGYiOD8F?UyL`nX$
zw!Luc@+j%C?%QZLMAH6B)E}k>I=93zc2viluLw=(PUVhes8&2{aNzdtimr_*vcHUb
zd8g<=J9E=T^c?`d1K)^|4K>TTwKpRI;vSx;ZImDCAgG$zD?rkApafZdj1Irrb{+S#
zV|dY_8C6zlI&>hNOabcA;2OdIR3q9;5zo#>9T4;;KF!9iKXus7fZUIA4Fq5N>^!CJ
ztHS2IJIK^hA1x&@?vPRZcFCdF=E3eO!1l32U5T*mK2IjITAncDk}Yu~``xsm89|DC
z#dV9xN`ENv?d03|FQ)O2H-zcDsx)G0y(ve?P&R=GB=f2)=LBmG3Fl}kj-p31Y8wxG
zM2sZhk!QOvMT<36OZqRo*C1Aw#_0KstjDV9;+Y@pXJ;Y)WSow7UT9dv)MT6|{U5@-
znsx$i<gd0T$CV@qytT^!lc$E#NYBU|lc$@i1pXxZ^%FF9_DeyRg7x?L#S&l!AB3bn
zG+!$tI1Ttrm-GV$W<|oiccoJ$C6zZ?H~OkKjylDXUYS0RJ8Z)SRztmOuiZ1Oq}=w>
zWd7j5W6sN)lVQk?_TvWk5ZRKAE)#2JXU3RhuxH7GT5)hsN7b45@VsH_1@s^UUXx&y
zI4zkmIA28CsK)n|fFmm|0diG?W4PVN!WR1ia-dZtOHsX1j&aYs_;dD&KrD)em@jmz
z>hj~6ytOj)cal8b+p`Bu_y7lM*xp4;<M_Uau`X|U>vN-KS7Nhx8v$P@%}o*Hww0I%
za`?*QjcJ@3i1o!Nu5G$Q%Iepm5rsPY7Y?81VmJab42#UEnB$nHPQYt_nms)z+Yt@g
zI*FigUO_d#+i{B1mehww_K{78U^uY<{|Ffc2R7ltf%SiJ&EG=f6aSB%iLe2GL;t_f
z`~O)R=U;0(-(fdc*(0$2wf5g}y=MlEG)sz?^@$Exj>MX@xp8H#=hSRU{#3c6#n-!6
z^Dl70%g)#AiW5`&nF-%uqWMoQT{gij6js|W?0oxZv8VZ|1U)7bXNRPq928EFw4CGS
zNUIv|=z-%Jc#D5_$xEZK>jg0~!a9#~7u)-zXsx9d{%yxl3_fBQF*1=SUJfwYKCo4y
zu&P2&X5l@2b*8bB9H~7ly1Gl#8tKQA9VvnHDSaK}9t}nszI34<D`)EFN=AL=JB+3}
zSD+Bm&$RMtKBBl}!b~zFhw#0nQKrgoHUhTuWaI?=26r?bFG$P<2iMj?KXi+WnIgM0
zUnl&2pYvUv^$BTw)2Znh^n<UFluF-IE8bfmC%Dqjm|rK<ZvI#<F>8u@(zCR_;Lhdr
zlEL4BJU8M-sPO2A<JZxid7uulQn3_wUzB!hP#RyHDPxq<H{PUxM1z!kXi(c;Tj?NH
z+SUCDYOFJ4{~D@2xS&AV-&O*mc+xMvFSEjMvKB5?W11>9!<fBV7<)xnx_V%6LK<v#
z(}bS3x_26onM1^Myw|HR>XDhzmsb4Nt^aZ7iDlv-B1@6F&rVNjn*90$;Iqa_2j!0u
zW@o@V1qnBcE8eBlKy@#XE*^3RL~9dG&!b!9r1mvy&J%c8pZ$;$)E`*u;h(x}{Ydbq
zxT;r$t9s}pL9P7M*^2z2=Q`BApjnBn3ZH=RkUg;op4Xt3H&pHZoN)m-$n-3?6s^m!
zHz#@gOfWnNw2mQSj%s84BfpgCt1O26-0t(67=^dzQsB!IHvK_D(DiK4F6|K%4PFCS
zN|jr)H<(f<4$Xg~r2D=(x68m9=*!Y5#aFO9O1wJ0z<%gtZC)OXhb+KGxmHUxw@x2#
z>?)RpHYGjIezNjor1s<xP7sC*uk~uJ$c<^15m1^L%3rhdtcATp(XvnOj#Nl=Ii{7b
z+7uvmr!yCl;B(V&cTyIvh*m6Hp}|0+XK+`5)soh`Q3u&ua#G0n^`4M57L7fxUE|vC
z@g&kFlu$&cPgW`x$nxz6F0aq1ex9tGcf>EpiFDSI?Pm61VNH_uQ|{5Gp)yFyc;&+P
zBn`)<q#sjR&+?vzn3ESNv(sqloTjYq;N~a!d6(z})Y5A;7|0SwPop1DMk?yoRF>+~
z$zrRCHM9`StP&r=VWR`RA?#*DWwb)KR|n2y7r%N>w@Dj0P?Qo=2ZYbpnp8iTz{_I}
zmWqqIbh?gYY&3iEUDx4Lv(qU?(Yd<thTQjtHPD-}_e(n8=bAV(00}vXaK7K|SLI=m
z{w(_2q=D374!L%KX3GY5>YD4Ljy6#~>CkWi=qs;;X_Xy@Bz7#asPneMMhI?r$5=y!
z&`BP5<r&u7+YYp%nFvy7f6Y2jK2rAKbEdH_Nxp8qUoEFfwDeUquKt>!6>5_Bi~MnE
zVzM^&Y@XaLpKccc-qLcL<_x(Nh$%DKJ?^MhasAa%kYA)}0?Ph<KUpoHeTe7@ji-FU
z;ZUP6^JRbEtX^QfSlVZ2Tf2J+rK8Jh+;O^1eh37rG8C~zd0CG+RgA&8DL}@A{u;^Y
z`zNxqtyO_v$%S*{#O&8Hhp42HS*vZxz$Rr7EdBZzPfcLGBT9IC-2UlRAzH^tU9M7Q
zUj%Tj|KP`lrh<KoDo}WS8UHhEOdGb(iqkaLInzQ7S-w1+-*gT-xhCEW;x<Yc;%?77
z0i>%_KIgS~u{B?5%l56asAQiqB6@(wktV>9R3)SLH5Sa*=_sae(Nw0xoNVGSh^Gp~
zr8=t6bF{?)J6JT0$dM~>Umg7tP{t&PMeUiL5MRbY4(xWVmc#KHePy#wm>nypHrtXI
zBGWZCL!f`jE?fe(&e1H71X2fg)aiU^PIXC9E$Q4FlzDAb%NBw{H|QJ%;934MqF$*g
zE{U=p?!lmAVsj3QRfaU@xBxvhnPRGgKbnd48t-y#%gyX6=RJ-wFK?AdHh}UKfhTI>
zzx}^UHpoEVhc#yF;B>~gtlrV=3n>*@m-w|yds5Igbs_jv&oBzk7*8Mnv=MSS`*cA=
zdad@R{TVI38(mY?JNp2U4v6BhJ^P)qF~&l(qDPR$BmwKqSI(aYZ@jaeBj*MFk-81a
zb>g!!x)c$-(7y>D0_z7x-4TQ)(VI&jyGwe@xfSPBT^2V^6j0`vzN6F_l8Ct|B~g@_
zCX%H-{RALu>@a``4RKr^#Gh>(=6M`YE*R&rryl(fNNfu887fm#Qe1PJjZ!iXBb_gx
zFLK+LS~|*~x5$CcUSR64F`}l6zFRC`szHnT<47Ko?s<0_8Rz?RT_#3Lw^n4F$f(|P
z&P`+fuwsik=4N|F3-?Zzpb8I-Q}>($41>VJn|wj&1K7=&7yGvd;crRve=041Nf*6t
zOc=|>6I+W~eFX0&lMK&w$gN5Un}8QSns}LQF@@g`cwklvbt-XnvokgmN<YUz+m0Z=
z?e$TDcWm)KaftSgT<nENjkWgN@9U}xPhM9)^_pdInI_8-qn@%pDv{DfhXSo`PeaTl
z_xz)hAJD9{zJGSO*}ZQU6*ji&g48q(dZ8uY>O7GPp2sS@qr?7)tZ->WjvY3R?3$G<
za11P@HJ4?<b$}c3OW+vEw&qpW<?|8eb=>yevSA;?)5*-E(5H&bI$oQ~0(!QB?#)6=
zW?~))4qV`M#?1wX9w9%SSPE@-n2`NT{f!k^|KP;5mX4b3pk9j_yI2;pPKFJxeC^#+
zEv|F9+f#GsZm|m03zkvaR1xKbWpGnOZ|u>+g|>csvZs;B8iegAb;-IL9P={wXTY6p
zoQYC+SEZ}Z`u!(|K~UpCw4T~h9hakq>BRm&^(n!X4#tNT*>t|*)$kVfG+9z$%2TC|
ztF+{df6~NOWPa|VPj$YxtGcdXsl4t96tK=dVrDpw9@mOl^oh<{q<NfPMvH(Td`}X!
za<*NnCn8)=9%>rBcb}m)bR!-2=At)8z@=jfi}1u7w8w=h@qm8$0<=L*oo`IkKy+3!
zK4PYFxfLwFYWws2AtX)t8No+}vnDK~s+T{%O|6`NMLZXwzLN)gXb`avU<LA2_D?ex
zolT#J7gt(x{uH=#mznZYC^n!TSmC-gTt&4sLrM>sprclx2><(AmRI@nEQ!ypee@7r
zmHZASkAAMQ$IYsWa)CMi_e%pl7Ny3e;(sEY$)YH*6Nr^elHe>IuiPr+2Nnghfr0pV
v0%SM<dOR##s#DTgjDTmJ?C{n^Veh-gi&9u_(YS;;{8(RjR_a6l{nq{q%=5KZ

literal 0
HcmV?d00001

diff --git a/tests/assets/client-certificates/client/trusted/cert.pem b/tests/assets/client-certificates/client/trusted/cert.pem
index 76d1e1a54..3430d063c 100644
--- a/tests/assets/client-certificates/client/trusted/cert.pem
+++ b/tests/assets/client-certificates/client/trusted/cert.pem
@@ -1,29 +1,29 @@
 -----BEGIN CERTIFICATE-----
 MIIFAzCCAuugAwIBAgIBATANBgkqhkiG9w0BAQsFADA2MRIwEAYDVQQDDAlsb2Nh
-bGhvc3QxIDAeBgNVBAoMF0NsaWVudCBDZXJ0aWZpY2F0ZSBEZW1vMB4XDTI0MDcx
-OTEyNDczN1oXDTI1MDcxOTEyNDczN1owEDEOMAwGA1UEAwwFQWxpY2UwggIiMA0G
-CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCac3+4rNmH4/N1s4HqR2X168tgS/aA
-6sHW5at8mWRnq54Nm11RvnK55jHQYVAdBgJy5M07w0wakp8inxzlY95wqxBimYG6
-3Un/1p7mX9FkB4LNISCc6j/s/Ufv85MXPbn0S5rm9UcQO9cINJb1RP1YgDDLN5cx
-Mz6X4nyofN8H6Lhvh4JDdBw4DfDEFERkVfF+bkZ7YW4XHEChgzm3RxCF0eeGzIXG
-rkkK9AsSdJAhOvTlHPFCQKXTYZhsL5+3Ma4RnWnDWvLTHx6KzoU+twTM2mYhhQuQ
-gQpnmDHxGge8kGeHGtfdgAjtVJTE57xF/shP0JU+tuIV8NNhQ/vEmhL0Wa093/Ev
-pTVp0EUEuDh9ORRH5K5M4bKJyU4XX5noiht6yOn00uaoJcWduUAWsU+cDSvDTMw8
-1opWWm0QIAV3G2yuRSkumHAKqvQLeyeyiKz+OEhyEiZ7EZNExPD0TSpApSTU6aCT
-UAvPYGQ59VjsMHTuJ9r4wKIYaDvfL+t72vg2vTQma5cTOBJfIdxH9blFTjEnToH3
-LX8t0XndQ2RkiRnIze2p2jUShxo/lWCjCw+2Iaw0A0fNUK1BbOrFRPq1u7AnEuMJ
-t7HF50MloItM97R9vofDwgDIzlX/PzlVRcn1WCo8Fr/0EXxPPreX0YDIp1ANQ8fS
-v7bKb2vQIxWuCQIDAQABo0IwQDAdBgNVHQ4EFgQUVJVRJJ2k/Z4r0M1AXe6agyD4
-uCwwHwYDVR0jBBgwFoAUEHtrxWCk96Ehr60E0HBuwLk2i+IwDQYJKoZIhvcNAQEL
-BQADggIBAGEvSkxhxRKmlvKG8wCXop2OaUUAOG16+T96vd+aFYaJNlfGoPvqv4Lw
-qaHztVktnRrJ//fpNWOsdxkE1uPU4uyGjl2KbyH81JvkE6A3OX0P4B01n8lcimY2
-j3oje6KjORUouYVsypD1VcwfWJgsE3U2Txv5srD8BoemVWgWbWjfyim4kk8C5zlf
-tWEazVAaI4MWecqtU4P5gIEomCI7MG9ebxYp5oQhRxeOndOYdUbSzAkZj50gXFA1
-+TNkvuhTFlJF0F7qIFVJSJTmJ+6E5B4ddbkyUYwbOdO+P8mz5N5mSljE+EiIQTxo
-AwbG8cSivMy/jI3h048tCUONAJzcSWCF4k1r9Qr6xbyW2ud2GmKiFCEYJkYTsMWV
-fM/RujTHlGvJ2+bQK5HiNyW0tO9znW9kaoxolu1YBvTh2492v3agK7nALyGGgdo1
-/nN/ikgkQiyaCpZwFeooJv1YFU5aDhR9RjIIJ9UbJ8FdAv8Xd00E3viunLTvqqXK
-RVMokw+tFQTEzjKofKWYArPDjB9LUbN+vQbumKalis3+NlJ3WolYPrCg55tqt1o3
-zXi+xv7120cJFouilRFwrafNFV6F+pRMkMmiWopMnoVJPVXcoqyJRcsmO62uslhg
-BLFgAH4H/14drYrgWIMz0no78RInEz0z507zwLkWk5d9W9pJ/4Rf
+bGhvc3QxIDAeBgNVBAoMF0NsaWVudCBDZXJ0aWZpY2F0ZSBEZW1vMB4XDTI1MDcy
+MTE1NTYxOFoXDTM1MDcxOTE1NTYxOFowEDEOMAwGA1UEAwwFQWxpY2UwggIiMA0G
+CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC4ggn74iAHLgOWOiOvB2CPe+Hr7W6S
+TYJLZOoqPdh7mv7QGm8cYxfD+26p13aEaW4/qn45losWdEPPy2ZiVIF+kcOP0R4A
+qsB0w9UHT4WSzCWtDqs8ywDMJ6tHge0++8S1bTpdutn/m8DPnKtkD9RQUzLFmGDO
++mB08Xu+egTzJvURbHXRJ27E+CXUXLEHbAJd8EKjJiQYXhcj4lzUXOUg+xkpPAGe
+1dgQ6BDkv3xq/81S9NTIT5YriHEm6egi9AFJLZbbZtCpRQm1MDMq7zfD7oL6ECLG
+rJ/aaxLEM49gMdw2SscYHotVxX2OMAKgN/ytB18L/mIQ4pOWp3HJQ+nks9Zu1V8c
+g7Pz5pWwjqoncbyUaBi3vGsitAot3cyLXbN9hH8zQB8QqGyNLvqQnCJOBlYxOPA8
+M8NQGDThWKspcix0LhkmnYsWWt3+KEGEpFRcJCEthm/DAd1GImP7/dg1/btT/zOs
+IIkIoCyBwznuR4M4XoNTbIBsiTnO/6PjOdTrjLVX7vMueTjdbCgK3VeOuwetbZ7a
+Z/hvMJCjJ4wuM3l2ZyfEQlP4gJLJS3Fw2PRsySZJl9JyEzwTqYVosDF5SF8uw0HI
+cFaliZCqBbgYfOiQzjIX/GiHZdor1ZrhAbO/MpSxuxGzxF7Em4n+4p816NnC9S2J
+bHRetkM9P1adHwIDAQABo0IwQDAdBgNVHQ4EFgQUXhGloOgfXb0tY7HZZGil/d11
+bcwwHwYDVR0jBBgwFoAU8doR+Mmgh+1KQdNvybCZ7bsu2J8wDQYJKoZIhvcNAQEL
+BQADggIBADNVu8YodDjB0474ztGSjV8WO0x984WQpGG6VPIt9xnnswNM8aOZVMNC
+AS12BjgviutSBUbL40xYNlytnqP0KtlgZSNpPVTGMAOoGttbgV7w46+hyBgV4hYs
+PsYrxMU1/4hTW/aGnNXpWJ4VwOESknSqUudzfy1mNVaEuPoL97SCvPrlKPU6El1a
+Wmove/QTKsbsjWaahqE59uClQ6CBcWbxpN5CLyIVM4c/UrsoXdwRewgXl19YFRzR
+l6LXBPid4UPQqdE6XIxgsNpoTDwAyxSRMPydlulJD5sSTaXHB7h63DsT9mEydjR3
+jPjhNZL5ADtDes3/UhfpXDbb8MudXdbdsHNswEl5ewAOdRXAuoaJuQ2TOnhz+cO0
+oaq9X3YaWjl8SwdvZrLIHLG3jEAQYEXDR+dEtT6vs7HmReMrYhGGoCEVrjSZAaeO
+9bQoSe0m8xbuSV19e5A+LZv3bcPcVOe91x/wnjVb98KRQcSQXCBE3yT5Oav/OLKZ
+TrdRkKe1yyPMHJiicn3pffdXuG6mIJC8HgYhvJEX/wkWf1BiyRd44dD1cgI1Ttt1
+pQoapJCmjA0XHtr15o4TW6hmnrmOOYTOVCCug8h1bWscBedMgdR5Qm+umbUiuC3N
+N6mxD49Sc40NCeDboX87rDiObhOXAAFsiE9o39z/tPToVa3TsJsA
 -----END CERTIFICATE-----
diff --git a/tests/assets/client-certificates/client/trusted/cert.pfx b/tests/assets/client-certificates/client/trusted/cert.pfx
new file mode 100644
index 0000000000000000000000000000000000000000..391dea7b8a311f90df6379f79fcca7d0bdf5f190
GIT binary patch
literal 4195
zcmai1Ra6v=)@6bia_AaVN@)gAKtUv>o1u{oL4l#A9lB!#kyZu-1VlnQq&o(Y9C8o_
zX+#7Bu6O<a`o72eaMoFS?}u}q_SpxHf?5LsAUF!jNCFXvR*OER0+0d<QBV>v3JQdy
zXs+NW;_ZJWl0p>m!e43z2q5~~CjM0baO-~nF%{eZF7_{^g!6!*Mw1N=MQ=OvIqQf;
zAae12Kp+_roRWm>|E2;V#6)lo5{ON-8o&_*1_*$mfD*Ggm{%nX$3EWpN$~?uIEvT?
z>b9;n8(k(8(AJpfS!_5o>ol3}NtNYGo593tDP<uBUKh~;+0%a+h+<As3GrI;JpaC%
zrNPEwBjUVcwtkj_hm?#LjC1-l>2S^6*>Nk1k7T@TW3i$Zf0M|3|L`8&a)D{=#p!$Y
z!k{*-s-XRjHM@oK1(%a5D@ULzl@;U18aoXlNM{qXja;rz$%u1^=Hu5lN!^+DZs7;E
zIOn7F#%?UE3aZy13Ja#`#C{XH_fY9=1gIent?;!^wdUST(jtSf<<q9Xn1RX1j@8cK
zt@HwrMaV!3Yg|NLQGc>vc0XCi30w<7)Kn=dcVm^u#DU8&z}r!4x}NP-4e#?Q+@E(n
z2eHpy^{mnR%(s=O!*JX94PZ30ZXC<l2XRc*0mIW;$v*)($d6MgfOJpV=<J@b)fQZn
zMPyQQyqK3Z8ySs1R{1e{bs%1svy2lM%>m4rW2`YTiz*oEJ%OgZVdM_=W*lY1pQX0v
zcseI1`B|2S2x)Q6LEX|u;wv1;wqta=Lf!XO1Ok5WYjf0?;ix&KIkpb6epA!sUwZ13
zdX29%>cV`sSp)L{$1(^cENC->yYVUT3mRWV?_ON^)m_HN#a^lBb~tp=l52c@{qy<T
zMLqEx&m~20PbhyXFSZnhm)~_&7`?wBj^{(;jcyMn^bAQonT51?8a%D#aV2TtWKw8X
zWBz3Z`FQ>E>8T7kQ8S-S!Iz!>03ce^0q#C>^9z};XsuV;pWaaaUghEE+FW%}p9eg4
zl(jVmic;LU0uSh$wu6qOiK#l<1dm(M=_#RxH@`Y>i1-;T{YluCD9E5NKdV`$c9mt-
zLyUf;V)Kg@qr88sRFQMc$!Wiaa1cFaC12}zLB`A?jn2$Zw$2T;ttk58YVnbA4~BKP
z<TS46Ctk)oIh+fRBvo~?KFGDun4SozSbA%=x>IwvJ9y;Hx4lnYYl|uVnvF!V2M<Zp
zdavh;+8zv#J5g9)+HtdF%&Pd(^ObkVC!F#3-gtcrEwUkNLUxhzv}0;K=TZ0qpS^bi
zj~!uW@<UZ|AKho7xBYD-z@5{EY^SEY@69RLgr%8=xG%za0`W2I7wQ|mx?^wB0Z^1X
znU<uQmI6PoT;AH_jmBX0IWvrIQxoM@5#wZ1JOUqgMD@T^*Ny98O6BG%r~Ab2ty(iW
zkzg*s;T_ICH^Udh>79>6urEG3n{8ZQ*!F+IguL@tL<e>8fW8T;8XRT3Bt(ToiSQq2
zZOEE;vwl`<NOpRhJmoFdWnA=4s~RJuOT7ZRVfTV)q&__B^|sGzSx7C3HNBuHUAK1a
zgf)dN<FcIlFYtZfz{L+{V_%Li^EIO>eS4Q02xt)6$@GgH4`R*M2@nL2$VGg2QT5{=
z7O}?a3hOPhvy8eQ?J_$c{b4CBKV^R;WGYC%`n0atsEy+~Q(e>QjP`DT;RLM~u0>la
z(VSXWCmkJ2<`VWP3(xr3Sf6cyC7txxf7d*ua9yeI&r7i?<||Kc-Pfp$vbm~Tep{AD
zV(ycft>Y2IksXQeYHEnzEMpSVN3}HEKD%CD)3Pv(6S@7f<C!LVN4(|+i-ngvin4g)
zUP84O6y3Q6)iNMZGu?6Clil+f>Yovs_pk8F2^XDCw%%~^aa>107_#8YiWzwYy9GuX
zmcL*Pi08fC2_R%whR877(|~}qxj;C@c!a+f%{v;3QW~p6y1Doil`-A-P7z1B)d5Ha
z5EZSt>B+SBv<2&Mne}oibB&5+MyyR~0n?PT8Bd}n6%jd|b1^|(grJ$6<HZ_}ijj76
z@)5ijTctgyWGH59`@#JolYm&O!KiVbDmaRq@*m&+?;(I(f>Dq&I0|y|w+=}t{{Kc$
zk^_K$#iqYx{r@ulhFC<-Cm}wnVg_VLA_I}<|1^G|I~T}{ZT~2K-oE2c4YLA&H_!`M
zd8sS>-0<mHZTYHg3)bJ<b0N;a9lF`(&t^6fG5$UFN>{G~-MpNhJ7KN(i)7>+D^upT
zYPcd^A!=(NpA(d5(!2tzIpUB$-~4XXkaSQ(jR=2D%w<1}9=KHKw(}u*ddk4fbgW}a
zqE8$%ppXv+Kb53FdO6nXMp|26#+Vi5Sez%nn%_Ze+0wPiC`J8&YIpkNU7dV#5cGZ4
zd~Vh3>RrNZYgSQ#xSK0duM(w)ozRu}pi@W2z(X1RoM8nzmRX{IjK^Qq^r;PeFLAUs
z4n8bZta7Fq(4_7b;a5PZ;yw^Mf3}kmgQfNYj5pg~*pGp6fs<?UC~jB$ir|F3;MQ`9
zamEBFqZ;8>>e7<sp;nV5u3&82F_>alU%Z;=;uq;t+B&7yBcIm=ALKpAmE8<k60-dB
zq&0h(cE2NGr(|aVY5vox+ws-Fe&GXE`(ybv%!i~P;D{~l7Z{Cj*cvaEbGfJhx<I9?
z>D}*FC})%<v45iqPq)P-9@w$%wSbhX<<mT6P;QC<IdyZ3t{BbCC9P$pFQwe99FyU(
zRLALl^1_xrS8syDl0Oxkrs-_DNh6=|&oq^;N}sLcaFXoeO?15gHfgNkYsp{cps?n>
zTJkh!;<t4UFr90!`>Dk*(|C#W57YH9mN<-b&=bz%%sXe$Tvr@A^~qL$@5gx8euypS
z-DkyZiFuXJ!v2gd3`5}f#N;>(!-)&Mk&J8gs0@pvZVXt{kS2F1;dX07Qp=UBwK5U!
z*6OSglYeAUuI8)HJ2BOXGMI!=f5DU-?la=^Bt=p5_QT_C1xaFy_IRsUT@&o>l=*f8
z1XTdX^fCH=Oe$#R0NG}Y{+6!_%cEDNzV2egzvnykYBgO8yjw%vt$%-An6Sv2R^A*d
zCeFPy^0aQEDNGz(+Q)7fHL>FxPt+YsJk8jhHS}APp&a~OD)|GySc%MuBz}E50A!U`
z$#|UWvp^>YtX2!IxLBs4uzLYT7J8Cu-Z9Sc9t+Q<*?m1+&{w{`044Q|(s%rc*$c>A
zK?ZY16p+~~>~N{jImfWdUpIgIHRCF4W@ovkTwrL+hA*PJTc$L(IB|P_8^|3z+@%h)
zlCYPcrskc|rb8&TIVGiVKxWZT2^dT^&yUwsZ)Qm1rvom8eYf5Gm0c*r)n#WG?kW8~
z#?ZZo6)h?dT%{LDr`k-eow?34q9wE-9A#49gQ|@HLyCT_V-idnPeR7>vPgo}YXjge
z?&`Ts5)mp#`@l^Ku$R!b@a<RSsa>XoTRfjHqw&6x$F#0{@nLA5;cu@=JwNqSd&-3>
zI9<ilN}4~cG_M@|yNK6VFHncQQjr?)xpJ^i_}54F&)lyCrF~R-%XG7)9=j^U((rH8
zdYI)DiU~ees4I(GlZY_hii}g<WzrW&`n<haL(i)=aW9q_5**{}r4d$CBN_gDohrlE
zW^|H&r)8xMqa~vt`#INY&nx#Ebl67mFiA8vS2ixo1mLCdC8*e&P3NnaOh1lMDeVij
z?b58&07uBL7mg2gPIz4;i2||>gU7_1NB3)<i1A0uR_3k61%mb1*$zdN#;9F3=n;d~
z>hUH+ggrt4oN$xZ=y<aX|8dLCn{u9Z()7mbZwYN3Z4>!xZ5`U9Bx1HOPln%3L@ErP
zezb(kiv)j+F=U4~y$waEtW!<(BM(vD7HmwfIE|u`W{>@bdH127NoS6UhJ^SrJUz}^
zCOX^w$~pDWW*#f;pZ6nL*yjYS=|ZI<Cx(pmi%2JQ;L+BP3}CEQb%2-yzB152Y7ARp
z{M%Yv1-y~);LCi%JX=auUZqX-;iz>Rm%NX3aRhEJA~0w<j(i~K3NchZ$B~p>B5&*o
z`%}>RBGw>c)X+-g51+;;S#7nXmq1Gt-Lws!cIqCgGUJ^JHio{mM84g98pS0v#Jn`q
z?`mm>l9}zgYeG;&0+?F71Vp83^B75*tVX6qMa3%`@`B%_W|mRuf2n&X${FmvPI>y%
zCvCDP3u&y@%M0oWe{AqPFd~hvwf(o*Vc?0cz8rQjs(Ox=9;A|*9-!TWSfeYL&Adko
z*;H26+=X?7lSiLziZ&#>cM_Gaeq73UTOh82E~TEjCofmLe3JO_cB}i|7_vhrxK|IW
z;&c=8{`aGnQ}el0PNlajZ)gbx(kd|v8@Sv^?*qR~3ADeKUE-@9+|rr*`<0ovUXqRv
zDPl@jjr;n%YO#-LmX1AB+||{ne@qZ>T>CB)b<B~E*&uD#WuMW`UkEhn<zgC4Bp{~e
zi=VcH>mB*&%x_jA-XDYMB5&;W3MluVO;MaVLR+2ek*}Tr#W$JTW?5469~0!r=X+K+
z<=tlcYByaH@(LA}Cx86xr}+~7;8?0bmPeDVnCSe`y>T=wjIPQ#0I_O4IX<qH+G2s_
zGQCux!o8C)5rhsdRIM8J@M7Zhu6AdjOudqRjV@E9U|g|6>H>D!q5N<l-RDQG7m4bS
z2`d$aw??nkK9N!B-n;Bgt#%nZ`mE{5f_JdzCky2mzPq%tF-G0`1P}R*VhO_#I&s;D
zC(DCN#SQ@R^sX$+@A#6jKDnaH-pM^?{Ze1enkA2Nfmg3G8mfLwHcUtngkqR-vYK*h
zG~CdM(MLlpkDTMS?1=Mngm=~A#CCTm`-P$`z?Y;Wg`HVT`+B4q1w#|WMH}QlZGHmc
zTTYGRGA=Byw_{9MDuv#dY>q^>kKanAH>Z^%zdbcz%b-5rxE23$n4D$YUcrNYSgLac
zbaYZZ>emQ*KXG&sh&faC{t3OA-ogOOTq%^P&{%ZUXqnJDN;B;;On2Wjz^=u4Uz%YC
z)7L2$CpewquqlV#>N;Bl(=&-OKI{!U&3DIC79-LRtX{a4OPtX0a&<poCN=y1(h2$K
z`{Fp$(tc(>sz^NBd&oMBoL&qTZz(LvLuszA;OZ0Af^(^aIv%^c@d$rlmCCohZ9qAJ
zR%$a~3J{jbufd$kT3Bf7y&O(r7a;nYD>qg~JFluNM3@%~1(tGoxbz6!Z}a#?se4~)
z&X!ZPu5OZ(a7nYizY}WN4JsK~Vs8&c>ZpeSUpmT3RdJQS>1elHf8a4L7gXp;|7*dt
zmQ}d6tW?R=2U+Yp;P(bVD{~Y@WS(y(#P_U@7hBZGg_(HyFhea%QH&SP{ZG(?Fp4pO
z8NMNPpRZ#h=yOVHhYmKTvHG=Isc;3j7@X>#w;Tu{CIa6gtIwDvZmp7uG{A8*nC7u^
gS(8*}6{v#btuKpsyio37vPl1#YXpev^1o5<Kh<5@2><{9

literal 0
HcmV?d00001

diff --git a/tests/assets/client-certificates/client/trusted/csr.pem b/tests/assets/client-certificates/client/trusted/csr.pem
index 8ead6da3d..fc930ea7c 100644
--- a/tests/assets/client-certificates/client/trusted/csr.pem
+++ b/tests/assets/client-certificates/client/trusted/csr.pem
@@ -1,26 +1,26 @@
 -----BEGIN CERTIFICATE REQUEST-----
 MIIEVTCCAj0CAQAwEDEOMAwGA1UEAwwFQWxpY2UwggIiMA0GCSqGSIb3DQEBAQUA
-A4ICDwAwggIKAoICAQCac3+4rNmH4/N1s4HqR2X168tgS/aA6sHW5at8mWRnq54N
-m11RvnK55jHQYVAdBgJy5M07w0wakp8inxzlY95wqxBimYG63Un/1p7mX9FkB4LN
-ISCc6j/s/Ufv85MXPbn0S5rm9UcQO9cINJb1RP1YgDDLN5cxMz6X4nyofN8H6Lhv
-h4JDdBw4DfDEFERkVfF+bkZ7YW4XHEChgzm3RxCF0eeGzIXGrkkK9AsSdJAhOvTl
-HPFCQKXTYZhsL5+3Ma4RnWnDWvLTHx6KzoU+twTM2mYhhQuQgQpnmDHxGge8kGeH
-GtfdgAjtVJTE57xF/shP0JU+tuIV8NNhQ/vEmhL0Wa093/EvpTVp0EUEuDh9ORRH
-5K5M4bKJyU4XX5noiht6yOn00uaoJcWduUAWsU+cDSvDTMw81opWWm0QIAV3G2yu
-RSkumHAKqvQLeyeyiKz+OEhyEiZ7EZNExPD0TSpApSTU6aCTUAvPYGQ59VjsMHTu
-J9r4wKIYaDvfL+t72vg2vTQma5cTOBJfIdxH9blFTjEnToH3LX8t0XndQ2RkiRnI
-ze2p2jUShxo/lWCjCw+2Iaw0A0fNUK1BbOrFRPq1u7AnEuMJt7HF50MloItM97R9
-vofDwgDIzlX/PzlVRcn1WCo8Fr/0EXxPPreX0YDIp1ANQ8fSv7bKb2vQIxWuCQID
-AQABoAAwDQYJKoZIhvcNAQELBQADggIBAGgf3EC8WL3RGmuGA+d/4wd1jNfrfU6n
-xjnDwdEEX0TQZGGPjh5xvoCK76yZPkO6+z0IYSepEmWBS27HJKl7nuoOvS7MjQyJ
-C+3Bdk3ToCeQjmNBlRBKsUw5ftTU902oMl5BptHGj1KGjYBLAkPdXb44wXSVKJ8q
-ihFhWlovsva6GDoUorksU3vOwijdlGzTANQHJGFncgrRud9ATavpGS3KVxR73R3A
-aBbu3Qw+QIfu8Qx5eBJp8CbMrpAmjfuq17STvqr5bC10Fnn4NegrnHOQG9JcK02+
-5Bn3+9X/n1mue7aohIdErLEiDMSqMOwFfrJeaH6YM1G4QkWyqGugtmHsWOUf0nlU
-nkH1krvfw9rb6b+03c4A6GSeHnbX5ufFDSf5gaR6Wy7c0jBnoxVbtBLH2zXlrd0k
-iRQG7C6XZzGMS7hb7GL7+bkRy9kWjmDL7z7Fp+EgzKhNmzuWII3E9X9va33HoQ/Q
-UdK3JVToxRQg6XRKOxL9+U/+8i6U8lxObLWkWh2cypZqbz5qJxa+2u5JYO/KEoHZ
-G963UX7XWezR98vZuTc1XHGZtBDMrjjDd7Kmb4/i/xBPeWwseeGtzFy9z2pnEnkL
-uKE4C8wUNpzUUlsn4LneZXObIoErE7FqAAlVFujVe7iaJBmXoUXZR36drbfiaODK
-vwAGyrYHaOlR
+A4ICDwAwggIKAoICAQC4ggn74iAHLgOWOiOvB2CPe+Hr7W6STYJLZOoqPdh7mv7Q
+Gm8cYxfD+26p13aEaW4/qn45losWdEPPy2ZiVIF+kcOP0R4AqsB0w9UHT4WSzCWt
+Dqs8ywDMJ6tHge0++8S1bTpdutn/m8DPnKtkD9RQUzLFmGDO+mB08Xu+egTzJvUR
+bHXRJ27E+CXUXLEHbAJd8EKjJiQYXhcj4lzUXOUg+xkpPAGe1dgQ6BDkv3xq/81S
+9NTIT5YriHEm6egi9AFJLZbbZtCpRQm1MDMq7zfD7oL6ECLGrJ/aaxLEM49gMdw2
+SscYHotVxX2OMAKgN/ytB18L/mIQ4pOWp3HJQ+nks9Zu1V8cg7Pz5pWwjqoncbyU
+aBi3vGsitAot3cyLXbN9hH8zQB8QqGyNLvqQnCJOBlYxOPA8M8NQGDThWKspcix0
+LhkmnYsWWt3+KEGEpFRcJCEthm/DAd1GImP7/dg1/btT/zOsIIkIoCyBwznuR4M4
+XoNTbIBsiTnO/6PjOdTrjLVX7vMueTjdbCgK3VeOuwetbZ7aZ/hvMJCjJ4wuM3l2
+ZyfEQlP4gJLJS3Fw2PRsySZJl9JyEzwTqYVosDF5SF8uw0HIcFaliZCqBbgYfOiQ
+zjIX/GiHZdor1ZrhAbO/MpSxuxGzxF7Em4n+4p816NnC9S2JbHRetkM9P1adHwID
+AQABoAAwDQYJKoZIhvcNAQELBQADggIBACpScaAoLAs9DuTcI5Y4dbHf7LwF4Zxx
+UgPNzE1HB1Pr6NaHRiOWrlCtDEB5UwHrr0oZuRTqSEGg3Pe5Z2QtPG/sdFgfm4BP
+29o6qo0CXiEVBwU7/K0/lL2/0a7uSbD0Tkw9d6Bgik7/Z5rzXZIi2vtUcrOtHskP
+C+Z9w3vH9a+RnUeo52mCnRi4SaiSEnD5jvhmgaI9iF+k5pYBiMrKRj5W/F1QCkf4
+7OuSK97xN0eG/I4Oxgzi/qt51ySCYZbqoh7dIpwi/a4UsK8kdzDDI1M3J7bU07cO
+CJRfr0EETqCQw/gAKoag3tRFNvWQB6Z9G3Ev5jeaCLpcc32NlpN5xH3VW8A0Zb81
+dn5BXkPSxjwJaD0a3cLFkfgrasoe7ZMmHrVpQDw+9USuGCYXMPzNZLEeTFbrRkUn
+sqi30e28E1H69zVWj+OKzCWEH/azVlfaoVbwM+njUJDe5V09KvFtI7aZYmvLxbUX
+4ifoRUVoKedyKnueVmoIG57lF2VzeEhX5YjCngxIg+YuE99HkMQAZSlS6uJcVM92
+tsC/+pYECBk8ukenbxmKXROl3u4p2M1iCSL/8EOVROuyjnuzCXJZOpNptdpX4ZgL
+kHP1erq7/U8ZU8HviUsfMoisagx8dA8uj/4fk0jfNxOJqlZL9eJhpgBfYHqmAz3h
+m+PQVw96eeoK
 -----END CERTIFICATE REQUEST-----
diff --git a/tests/assets/client-certificates/client/trusted/key.pem b/tests/assets/client-certificates/client/trusted/key.pem
index d60201e5a..a11cdc8a7 100644
--- a/tests/assets/client-certificates/client/trusted/key.pem
+++ b/tests/assets/client-certificates/client/trusted/key.pem
@@ -1,52 +1,52 @@
 -----BEGIN PRIVATE KEY-----
-MIIJRAIBADANBgkqhkiG9w0BAQEFAASCCS4wggkqAgEAAoICAQCac3+4rNmH4/N1
-s4HqR2X168tgS/aA6sHW5at8mWRnq54Nm11RvnK55jHQYVAdBgJy5M07w0wakp8i
-nxzlY95wqxBimYG63Un/1p7mX9FkB4LNISCc6j/s/Ufv85MXPbn0S5rm9UcQO9cI
-NJb1RP1YgDDLN5cxMz6X4nyofN8H6Lhvh4JDdBw4DfDEFERkVfF+bkZ7YW4XHECh
-gzm3RxCF0eeGzIXGrkkK9AsSdJAhOvTlHPFCQKXTYZhsL5+3Ma4RnWnDWvLTHx6K
-zoU+twTM2mYhhQuQgQpnmDHxGge8kGeHGtfdgAjtVJTE57xF/shP0JU+tuIV8NNh
-Q/vEmhL0Wa093/EvpTVp0EUEuDh9ORRH5K5M4bKJyU4XX5noiht6yOn00uaoJcWd
-uUAWsU+cDSvDTMw81opWWm0QIAV3G2yuRSkumHAKqvQLeyeyiKz+OEhyEiZ7EZNE
-xPD0TSpApSTU6aCTUAvPYGQ59VjsMHTuJ9r4wKIYaDvfL+t72vg2vTQma5cTOBJf
-IdxH9blFTjEnToH3LX8t0XndQ2RkiRnIze2p2jUShxo/lWCjCw+2Iaw0A0fNUK1B
-bOrFRPq1u7AnEuMJt7HF50MloItM97R9vofDwgDIzlX/PzlVRcn1WCo8Fr/0EXxP
-PreX0YDIp1ANQ8fSv7bKb2vQIxWuCQIDAQABAoICAAyXg/8rYGS6ydt7sgjGn2Jo
-QeFs8ADcoscBXHTBELV/AVi8pOQIMdREFyWU+XIUTljNnInVxzuXXo/1BucQuE7Z
-M3HGcBQq/GB2P+gqQaj1D83neIAyfNm2YIoIgqJvbtyi2VMhBhUlu8c4emIuqLTx
-Zoj61EG3ms/JMD6QR6Keb4LwOkeDjNVpFYr22AiSFSkolmhyrgYGUKKaTzdI/Ojc
-DxMnU3S6OsxAzzJG/IUpCFQxgt3S5XIRT9rqGwxVaYqYGcpKfOeHbvcEFUriouqM
-l6z96s5yJsYBW3j7lUvjPf1+y8CMMq4eqi5PckMGnZAcQj6lrFL7mlAgucLyiL7w
-o30seXvzoEQXlHxi/tnoZMWaBbntA6TV8t0ap7TMADPPSrXhXt+GIQt6tDTdYd8y
-9VxGAQA0s6FhdURVp0zYtTGrsFTLyHZjC0TFxsvOdRrQL3XbsQxPUCH86Z3hQt9d
-drgxPDJJo/4UUYOX7MAyE3H7zW7qSQ8tNSXPHewff0ItpcrUvBxa8cD95DGB3kws
-0Ns1ulGqOLMPZM3/MUYlDk0PEK1ClBqC1B78mkMpJe5qTYBaFg7S540X4E5Nrq5V
-5VK4QTsBGm9Xks4///psGwmstCVZAZDCyMbW3NOFtzOxsVqi027xknl7UEtfwNFf
-c8tp0CaxZhW8/YTXUtnxAoIBAQDSR/Ux4tfDp84Tyf5N8JaxY1iYA1sor4SQnoSE
-r0/J2UXQpZjNpCT/fOjBT19jJCWQUxUf3M6PE0i40VMcJgtQE9alTTz3iCCUokv+
-IcVxrS+7rdvQGPItoIIZDSKGlAJHoIsMnqGAHpks588ptgPC/FEiNX2nae2CrGRS
-jVcPOLA+St6qGEwPyaSKXjERwSQ9bHLIuKbMDs2+YpPOSp9iLKaW11UQYxF3Uxti
-pVRq5bbqlKFOxxp4PaTZRusWpdWJ1kmpmEpZg6PiUQVeOoOy+hCbLq3KW1aaTc3x
-UcYrbA2hW5vP0u4x4QNPayd8MNEsGHBClObOtD64Vz3lsMFdAoIBAQC8CBoP6Tzy
-1uGNmAOc9ipQwAcTAzPnOH+ouKBwB/5ji/RPrwGCOqjbapmriKtYxW2JOqbTzbze
-+WvGwgfoPo16FZocDMrD90lQdFmfcgnHFZgXZe2k8zr3YTvXdkCCRkthrl9tKN94
-IuNL5K4wMIiPy08B7+dMxnKP4E8C8czzcyrXpdfy/gfu7UQGETYswjmLL1vOr1OE
-WaalbJn/5GDzKKLkcx+Xr4zgHzbyCXb/K+LvawGk0MQMTtbRkphNC2yNejNjQd8F
-wmccFK4LG9JqdjVhKiDiYIKe5ocWDcZ28sBuKyFxOthOywP6tnALIjQgXamsLIZj
-GhCG3g3dAfidAoIBAQDQM7EhgKHztl1DmLczgmgiIORiNsh2gzp1Wo6JNW+Bwp/u
-k1e1HLYJRSrL5APlDLAosypyTtUyMnzJiXCJqV2AHvRi3RPlXqIrqHonmFZ/VGOz
-ptPCukBnTsohdbDeoQOU2e9zQklTqngtTyP9/5q/38WRYncUYLxqqrf2SL2Pc6iF
-NOo8biw5YYSJ//MDykFQk+Ueuj1kQ7AQtlf0ZExlDyKurWwq+nwbsmymAl6QLPws
-TZddgaPCs/5Zp28zEGVawZJT2labRMzqUyBGiRdHCXORwukON9uKkki7jCTzb1wb
-jLG8VvPC7TCy3LzOqSMiTtwwAHB671o+eRrvJlB9AoIBAQCb2J85Vtj0cZPLFxbP
-jtytxytV386yM4rjnfskQAviGErrjKLUfKgeDHHH0eQrFJ/gIOPLI3gK23Iv7/w7
-yzTZ3nO4EgYxfJGghH8P/6YJA2Xm5s2cbRkPluDRiaqYD4lFMhDX2gu2eDwqWCTj
-viZCAIHAmkX8xXKIu6LhTubPVUJKMKQXO+P5bWB3IubjHCwzp5IRchHn3aKY87WE
-eZa9k43HiX/C6nb6AAU7gQrHHmnehLN9FqeXh/TXCQkAuppDfOiAuUUPcfyiMqW6
-gVnacZV2rkNJPjKlX27RoaNATZ2e8lKqldpZHD11HKcrIzNPLDKIiPLtytmt3vhg
-mNSlAoIBAQDMN3FoQfV+Tlky5xt87ImsajdIhf7JI35hq6Zb4+vwR7/vofbzoomS
-+fuivH1+1skQIuEn41G4uwZps9NPRm5sWrjOo869DYPn5Nm8qTGqv/GD28OQQClB
-3/vcwrn5limm3pbQg+z+67fFmorSyLHcZ+ky60lWeE9uXCsVjt7eH6B+Rhs9Jafg
-MbWRZ1C3Gezb1J42XVZ8hczn6r+qmWFTbSY4RzNBqd83motWXIgtybJIV4LB4t06
-JkVNCotSicw0vtZk95AfjQksemAq2fFzJfASxtw8IE/WHW4jtvfZ9PPWDt9U83ll
-Y+eu85cike5J4vnz8uG04yt7rXjIrUav
+MIIJQgIBADANBgkqhkiG9w0BAQEFAASCCSwwggkoAgEAAoICAQC4ggn74iAHLgOW
+OiOvB2CPe+Hr7W6STYJLZOoqPdh7mv7QGm8cYxfD+26p13aEaW4/qn45losWdEPP
+y2ZiVIF+kcOP0R4AqsB0w9UHT4WSzCWtDqs8ywDMJ6tHge0++8S1bTpdutn/m8DP
+nKtkD9RQUzLFmGDO+mB08Xu+egTzJvURbHXRJ27E+CXUXLEHbAJd8EKjJiQYXhcj
+4lzUXOUg+xkpPAGe1dgQ6BDkv3xq/81S9NTIT5YriHEm6egi9AFJLZbbZtCpRQm1
+MDMq7zfD7oL6ECLGrJ/aaxLEM49gMdw2SscYHotVxX2OMAKgN/ytB18L/mIQ4pOW
+p3HJQ+nks9Zu1V8cg7Pz5pWwjqoncbyUaBi3vGsitAot3cyLXbN9hH8zQB8QqGyN
+LvqQnCJOBlYxOPA8M8NQGDThWKspcix0LhkmnYsWWt3+KEGEpFRcJCEthm/DAd1G
+ImP7/dg1/btT/zOsIIkIoCyBwznuR4M4XoNTbIBsiTnO/6PjOdTrjLVX7vMueTjd
+bCgK3VeOuwetbZ7aZ/hvMJCjJ4wuM3l2ZyfEQlP4gJLJS3Fw2PRsySZJl9JyEzwT
+qYVosDF5SF8uw0HIcFaliZCqBbgYfOiQzjIX/GiHZdor1ZrhAbO/MpSxuxGzxF7E
+m4n+4p816NnC9S2JbHRetkM9P1adHwIDAQABAoICACBW8qcKoHCBuTE4qY6BLYSY
+wyWWLT5JhZ/vZTfYNTydEzKon3cLS1wXkvMECAr3a9KO8KbpYyGhaU1fqmdrxnLH
+2842ahrV0vvkY09vucrcK3Jk0tDKCC7AeT4EYPAcMwNVzNgm6xTpWOdK36OfPqiB
+nLGTnsxIiGWW+giN3JY96tCOASySy9CMah0JziGt5dBPT27HPaZjv4yTnY+/ZI3e
+VS+sC+CqPL/h3SwrAATFJ1j1/uHJSVoCBUs7zmtp91u7OOjl4Yb5ydTPSPiqi0y1
+XpG0CFRoZ3BiOhzXqLbEpoOBodnxaJy1C+fDNIKerZQqaZdxlAC/pfzPBpuvYqxe
+RRPV85+AXZ5nosSoqjPprKDfDrLfwnEAJIXtZjDQvJ1mA49Tbtx30rzk3u36BU7v
+4JXBTcCiaxhPw4MlPzCYKXXL8B02m8vC/RYZO29YHytERbAAMd4uUfGU0lOKWi6W
+CEHXYTjbqSDuytpuxT9InLVxEC+u+h9CxAi3FpawLmu5ELW5qA5yMHRoyYOCKUDO
+EsjV/qDSo6T1kkYZ0qj4Ya9DeVWgMRekn9TWZmzeYMzDnZtAp1OscmcETFH28xo0
+iuxQiStWEZaGdxD5njF+0GHtlECxMmPx03IH9bCxt6GU1aFCdfvhzqtovze4OCI2
+SJOxeJRAoom/LcCBQgCBAoIBAQDZygQguNUxwkaEpwsUhAstwse9SwY2fisNQTbU
+Lj1rbvCDlOADrthIBsb9jpsUyqow9UbeB+mq13xrFz7BfmQ0Bf2+3P8mV0IxwmvE
+mg8Wbi8pkYoet4yzSc2f8yHCvAsejFFWNU7/7JB0gpeRxXJTjdgoTiLEop5cus8r
+SmBzCphzOMM8iUV/ByOgIAEOU3bo2GuSRbEEJ0kA1bd/l12uT7tApT+0umo/OPRR
+yYEIexuIa7fean7ZHf31GbQdJm9vgoi+ar0mZg9yHSiqlOnghWVheEeNVGH+XgFt
+4qQkbTW8Ie0Am88uT+3fbxIZHbJ4GkPnKwc+klN5p2efxmlfAoIBAQDY4TOoj2zf
+Uvu8E1KboCiGjfHvvm3UhYVVUVqoctHQihSOQSThmKCGv025K4iSvxfC77XfuJv8
+ZC14TT176VvSZVrV4vZDod572/co5WyEGqaVfqwqjBmCWAODT+IgmIZrDfDRLIkC
+4cQObd8DkzzdP8msqp731UlrEZvOkh9XW4rwBmFXeBqgDKDgM7Zge4Clu6lWABxT
+BnGv00OjqRGd6IH1+tDTm0w0qNkXzZ3UDAuwVEHBjMJnPr7t9LEi5e3AluspjoF9
+Ie/KtQQ6D6guYtdRZismg3CGlnGwcf/yjS1YEVTqyybY52M9N3aHDVlPesn1BWO7
+UKQgHbPQq6RBAoIBAQCQv+n6bZ6VEdCYvgVpP1HGulzS/RhGA5lNl/h/EbSUwQlu
+CvbQu9bYGFkNkUiVixWOsJbHX274s3voGW0GYaDryseZoXyb2QcP126VHufEOrtx
+319zhv8m8niORKQ9r4mcZhpxN8En6+0e4uUmZ5rS2cW/FB+bnZGvhCHJXge4rmQg
+wKtSgtID2ZTeCidphCPWInFsqJE8d3fX7DOnw8zp2+hS0QIEdpnDJ3GLImh2YIwu
+IZn1Y8anO33c95Z0gWUzMgj8tii9arv9Vk//ADZpmX+GRtEXp+vxij1c8XOzGjrK
+ram969DJsSoihMn8k3ZYyOw0qq6H8e01QARpdw/1AoIBAE/9Bxt1And/WJ7uFXqW
+YDv4IDIG7uUB9cIYxjH4Xw/lzV0GA788ln/8EINp3e4Zkn7wAAkqQkWdAPQssK+B
+yr7XaOAX3DHngnH2F7s6moJCfgwG8yKiF0pugaUtkj3pYzIaqyXKoiGw+KlFtonQ
+BROo0g3fw8+uF2zoyqkuVWbXuW97Ou2Su2cqIS9vgyUkh7cYdoTkd43bg5SQe5Lh
+6UBvH3eEcP6KeVm2qJLR4BLz+l+nQ7VJ3+1KRArpQ2eWm9B7GPJzv6hSGumNR6jO
+W334MGeyIdoLgjXxSK8F7JsdnIqtob8S/BnlhUFvskRvFPBuXgwDV9wfCtlZexdM
+JsECggEAJy5r3YTLiNFqXiwIyZ+GFQYlyhYAH75tP6yaF5Sr6FaDDaGTQxtMgp+V
+UAOZIOHQAWpjQtgnjJAYLyDgkhVWJqQILBC3V1GHj6Kr+3avyV4cGuqP7wxsS2kt
+vUY9emtg0dil/8l6IL3DzjXhRI8+00FZSvcueQYVgv+fv1zPx3T/RuUp8x4E0lq1
+YmlLjgi1EznRu1YW1IczsGwBQDpghKnf2E0tUn9wUr1Kb8k0uOVdzUZETvJjWYeD
++GwoR5lW/BhSIwE4zeK66RY18n7GOIS7y7Yvn4onr3j3geqIKAEjQrlBkQlPkhfd
+21eLmxOuln98Q3na7ftpAWQdyjcE6Q==
 -----END PRIVATE KEY-----
diff --git a/tests/assets/client-certificates/generate.sh b/tests/assets/client-certificates/generate.sh
new file mode 100755
index 000000000..f835f5f32
--- /dev/null
+++ b/tests/assets/client-certificates/generate.sh
@@ -0,0 +1,88 @@
+#!/bin/bash
+
+# Client Certificate test-certificates
+
+cd "$(dirname "$0")"
+
+## Server
+
+openssl req \
+	-x509 \
+	-newkey rsa:4096 \
+	-keyout server/server_key.pem \
+	-out server/server_cert.pem \
+	-nodes \
+	-days 3650 \
+	-subj "/CN=localhost/O=Client\ Certificate\ Demo" \
+	-addext "subjectAltName=DNS:localhost,DNS:local.playwright"
+
+## Trusted client-certificate (server signed/valid)
+
+mkdir -p client/trusted
+# generate server-signed (valid) certificate
+openssl req \
+	-newkey rsa:4096 \
+	-keyout client/trusted/key.pem \
+	-out client/trusted/csr.pem \
+	-nodes \
+	-days 3650 \
+	-subj "/CN=Alice"
+
+# sign with server_cert.pem
+openssl x509 \
+	-req \
+	-in client/trusted/csr.pem \
+	-CA server/server_cert.pem \
+	-CAkey server/server_key.pem \
+	-out client/trusted/cert.pem \
+	-set_serial 01 \
+	-days 3650
+# create pfx
+openssl pkcs12 -export -out client/trusted/cert.pfx -inkey client/trusted/key.pem -in client/trusted/cert.pem -passout pass:secure
+
+## Trusted certificate for localhost (server signed/valid)
+
+mkdir -p client/localhost
+
+# generate server-signed (valid) certificate
+openssl req \
+	-newkey rsa:4096 \
+	-keyout client/localhost/localhost.key \
+	-out client/localhost/localhost.csr \
+	-nodes \
+	-days 3650 \
+	-subj "/CN=localhost" \
+  -addext "subjectAltName=DNS:localhost,DNS:127.0.0.1"
+
+# put extensions
+echo "subjectAltName=DNS:localhost,DNS:127.0.0.1" > client/localhost/localhost.ext
+
+# sign with server_cert.pem
+openssl x509 \
+	-req \
+	-in client/localhost/localhost.csr \
+	-CA server/server_cert.pem \
+	-CAkey server/server_key.pem \
+	-set_serial 01 \
+	-out client/localhost/localhost.pem \
+	-days 3650 \
+  -extfile client/localhost/localhost.ext
+
+## Self-signed certificate (invalid)
+
+mkdir -p client/self-signed
+openssl req \
+	-newkey rsa:4096 \
+	-keyout client/self-signed/key.pem \
+	-out client/self-signed/csr.pem \
+	-nodes \
+	-days 3650 \
+	-subj "/CN=Bob"
+
+# sign with self-signed/key.pem
+openssl x509 \
+	-req \
+	-in client/self-signed/csr.pem \
+	-signkey client/self-signed/key.pem \
+	-out client/self-signed/cert.pem \
+	-days 3650
diff --git a/tests/assets/client-certificates/server/server_cert.pem b/tests/assets/client-certificates/server/server_cert.pem
index 52d8f5314..18ee3d805 100644
--- a/tests/assets/client-certificates/server/server_cert.pem
+++ b/tests/assets/client-certificates/server/server_cert.pem
@@ -1,32 +1,32 @@
 -----BEGIN CERTIFICATE-----
-MIIFdTCCA12gAwIBAgIUNPWupe2xcu8YYG1ozoqk9viqDJswDQYJKoZIhvcNAQEL
+MIIFdTCCA12gAwIBAgIUFhAlW/DnHoHOFg2CXKBAvwYN4BIwDQYJKoZIhvcNAQEL
 BQAwNjESMBAGA1UEAwwJbG9jYWxob3N0MSAwHgYDVQQKDBdDbGllbnQgQ2VydGlm
-aWNhdGUgRGVtbzAeFw0yNDA3MTkxMjQ3MzNaFw0yNTA3MTkxMjQ3MzNaMDYxEjAQ
+aWNhdGUgRGVtbzAeFw0yNTA3MjExNTU2MThaFw0zNTA3MTkxNTU2MThaMDYxEjAQ
 BgNVBAMMCWxvY2FsaG9zdDEgMB4GA1UECgwXQ2xpZW50IENlcnRpZmljYXRlIERl
-bW8wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC+K5JWhlfvI47ZL/Az
-L0xnOl+cMelr2BqH+7XS8187SbvluhFfFkq/7V7rwgsHI64sn8pgRCOnqKWV6jtb
-651dGzn7Nby6InmyOQzF4VwfSVWQ6BYXgXuryS9Gm0gi8sOL1Ji/jV49n1gzLyIx
-LNhd7NG2DCCedTHJnxyz4xq8MWhI/qI85iWJqcHhxkDb8wtH1Vd6nd/ZRVDbjgTv
-PH3EDK7JqmnYG9+x4Jz0yEhvV7jL3gNu2mIyttvm7oRna9oHgaKFUJt4BCfPbT5U
-3ipvcq29hdD5/5QIDzTWcExTnklolg5xpFext1+3KPSppESxcfBBNoL3h1B8ZcZa
-lEMC/IoFUIDJQj5gmSn4okwMWIxgf+AL0609MKEqQ2FavOsvBmhHcQsqLk4MO/v0
-NGFv1/xGe4tUkX4han6ykf1+sqzupJT5qnUONmvghb2SpIt83o4j4KHVzZwk8JK0
-N6hN7JEjXQwSKCh3b0FFg+kPAe12d6BBcsNzEYmt2C1KNPbXMX84zIkgPN01XMg6
-kdCdjP6DH7CK+brW9qQufOqYpd3eNhJyeBm+oP3PhnhEiMTIO8X2GdSN5Rxozgxl
-VIj/QWhLV64r5AqPr/Vpd1vcsxrg3aS5CASmoWQmTPuhEZptRtrkPkGw7k9NPZ34
-lnRenvKJ9e3DXhXRMqeYUY6wjwIDAQABo3sweTAdBgNVHQ4EFgQUEHtrxWCk96Eh
-r60E0HBuwLk2i+IwHwYDVR0jBBgwFoAUEHtrxWCk96Ehr60E0HBuwLk2i+IwDwYD
+bW8wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDYDbBlM8ILtq2xKLFU
+ZwU4n7+0VHsO0skCfyNwpSZndbArjJUd/ZgFyCy5RK5Cg23KtXSMgkU6QlXOWvIr
+WJ/1wAkH9tuef/JDo9NJ00jBeua7HjdudNAsz6WwXSZC+a6DhA7nVHNwuyqq1SyH
+g5tuSP294EwfbEhXhaDyfXyBa4PaEmyjD2+O1NHSZ1AuUhblcUelKkZbykMvwCb7
+gJVXxlm/SN0K4vOVq80dBknr785562hDFGoXFX9hd2uPCQKbWGdMca+MmRWwNM2B
+CuxVoUl/Ooqmr7AdZ62lhpcqCd+todWC5GzrxwZjcIwt5P7MDvd+Ktmc8ePcZhp3
+L3ddlxXNgfi+c9OnZaz1QVgEn1YlDAmHvQtj9H+v2mmawyyRycjmhIpV/eaXaJvW
+A2wq+O2OERl056IjjzcXHrD6DOk7IjlTwQ87AMU4mNrCzW1LLd428OxQdGv2I4/b
+nq+0snOJOrTk65upybJYMGKUuTRqfEQgv5d/923VUISC69uTq+0zVFxG3pyMJR2D
+O+6xinBkp0Gk+ft9L4aaBAYXyUmi+PRSfdTfUk3yQkYefC55QTDDRK2rb7JiQqzr
+xhJ2vBar0TqXShQKKlMaOWHd+1U2ZjuyzboDDPeACoAmUVY2IHs+P8Dem0fwuKNd
+TF4jZkVQIWWLfTzzghOelmy9mwIDAQABo3sweTAdBgNVHQ4EFgQU8doR+Mmgh+1K
+QdNvybCZ7bsu2J8wHwYDVR0jBBgwFoAU8doR+Mmgh+1KQdNvybCZ7bsu2J8wDwYD
 VR0TAQH/BAUwAwEB/zAmBgNVHREEHzAdgglsb2NhbGhvc3SCEGxvY2FsLnBsYXl3
-cmlnaHQwDQYJKoZIhvcNAQELBQADggIBALP4kOAP21ZusbEH89VkZT3MkGlZuDQP
-LyTYdLzT3EzN//2+lBDmJfpIPLL/K3sNEVSzNppa6tcCXiVNes/xJM7tHRhTOJ31
-HinSsib2r6DZ6SitQJWmD5FoAdkp9qdG8mA/5vOiwiVKKFV2/Z3i+3iUI/ZnEhUq
-uUA1I3TI5LAQzgWLwYu1jSEM1EbH6uQiZ8AmXLVO4GQnVQdbyarWHxIy+zsg+MJN
-fxIG/phDpkt1mI3SkAdpWRWjCKESQhrIcRUtu5eVk0lho6ttHODXF8bM7iWLoRc7
-rpcllI4HXHoXQqQkZHRa7KwTf0YVwwQbXTecZONWXwE9Ej5R5IcZzja5FWCSstsb
-ULNW0JVxGBE7j5aOjxasYAbRexDmlfEdLvnp6bctZuvMvuBxrB+x5HSEZl6bVnbC
-nvtoslylQJM1bwlZdCqJm04JXe1787HDBef2gABv27BjvG/zn89L5ipogZCrGpl6
-P9qs0eSERHuSrm3eHUVgXSQ1nbvOpk7RPFbsbp/npc1NbEDBdAMoXhLP9A+ytxLq
-TF+w08nfCF6yJJ3jTkvABo10UH6zcPnfH3Ys7JYsHRbcloMfn+mc88KrTaCO+VZx
-qjhFcz+zDu/AbtJkDJtxX2X7jNL0pzWS+9H8jFTrd3ta8XrJiSFq2VMxEU6R0IHk
-2Ct10prMWB/3
+cmlnaHQwDQYJKoZIhvcNAQELBQADggIBAH1/6Sp4dW96yvwi9ptgVRYfRSRWfYYy
+2nU6kJ1DPOW7hTPf2wLf6Z2KqiJXn8tECHfM4pnPSgDhtZHDDHAu9l7Diqzk/NIl
+AblRs++4vSKdnCx1uh3EFLjIMmHa/cRUzfuR+oGfri3v7jgTBV6UJJQ0pMqIDk/P
+VEOWWukllru40M8Rwy4F6LmpwIWMtNDxmhtXSbQJ6TZn+isNSoaWgHjQmayrVyXZ
+OcNYuR8M/ECvnufuIOW53+hhwG1X0jEoBdXqqXbTKcGjA+yLHp008AAB5DNQblYm
+FJ4N0v6eYLhOO0u3n0b/ZsqUkZx2h38tlZoAdJNqy+d4TE3WbGRNgNJrTjAOzpPL
+cQ5RNr3dDsUDFPnCoK3LUf9BWerARoDt+bbrM/VqvWH/0uqaU0/vo8IchSyQ9wGv
+SwrWLJU32HQUJ2VQP/m4ADf3X2Ozj+e8bBf7XPPD8KDyL4aR0KuYzrsOnhFlBkHD
+PtNjc7SgiE7AZe1WOEmhBQcr+vI6S8qFTurTntCBkvrFgYBAIIhK2XwFN5sFtByr
+GCB67NQMp37g2qFNYi8EmKQvPLpAcC3Je5PvHFSj2y9Z14FclGoxjU50SlH9/A5I
+iHGcIVjCv9NhNDFAwakF/sTnrpT/FIS7tm9GwoJGWCdYg4pl72WYCW6hJBG+XY7G
+t3jt9TP8623D
 -----END CERTIFICATE-----
diff --git a/tests/assets/client-certificates/server/server_key.pem b/tests/assets/client-certificates/server/server_key.pem
index ff6a3fc11..3a762bde7 100644
--- a/tests/assets/client-certificates/server/server_key.pem
+++ b/tests/assets/client-certificates/server/server_key.pem
@@ -1,52 +1,52 @@
 -----BEGIN PRIVATE KEY-----
-MIIJQQIBADANBgkqhkiG9w0BAQEFAASCCSswggknAgEAAoICAQC+K5JWhlfvI47Z
-L/AzL0xnOl+cMelr2BqH+7XS8187SbvluhFfFkq/7V7rwgsHI64sn8pgRCOnqKWV
-6jtb651dGzn7Nby6InmyOQzF4VwfSVWQ6BYXgXuryS9Gm0gi8sOL1Ji/jV49n1gz
-LyIxLNhd7NG2DCCedTHJnxyz4xq8MWhI/qI85iWJqcHhxkDb8wtH1Vd6nd/ZRVDb
-jgTvPH3EDK7JqmnYG9+x4Jz0yEhvV7jL3gNu2mIyttvm7oRna9oHgaKFUJt4BCfP
-bT5U3ipvcq29hdD5/5QIDzTWcExTnklolg5xpFext1+3KPSppESxcfBBNoL3h1B8
-ZcZalEMC/IoFUIDJQj5gmSn4okwMWIxgf+AL0609MKEqQ2FavOsvBmhHcQsqLk4M
-O/v0NGFv1/xGe4tUkX4han6ykf1+sqzupJT5qnUONmvghb2SpIt83o4j4KHVzZwk
-8JK0N6hN7JEjXQwSKCh3b0FFg+kPAe12d6BBcsNzEYmt2C1KNPbXMX84zIkgPN01
-XMg6kdCdjP6DH7CK+brW9qQufOqYpd3eNhJyeBm+oP3PhnhEiMTIO8X2GdSN5Rxo
-zgxlVIj/QWhLV64r5AqPr/Vpd1vcsxrg3aS5CASmoWQmTPuhEZptRtrkPkGw7k9N
-PZ34lnRenvKJ9e3DXhXRMqeYUY6wjwIDAQABAoICABfDfxpj2EowUdHvDR+AShZe
-M4Njs00AKLSUbjCpq91PRfUbjr8onHemVGW2jkU6nrHB1/q2mRQC3YpBxmAirbvs
-Qo8TNH24ACgWu/NgSXA5bEFa1yPh0M/zKH60uctwNaJcEyhgpIWjy1Q+EBJADduS
-09PhaRQUBgAxa1dJSlZ5ABSbCS/9/HPa7Djn2sQBd4fm73MJlmbipAuDkDdLAlZE
-1XSq4GYaeZYTQNnPy0lql1OWbyxjisDWm90cMhxwXELy3pm1LHBPaKAhgRf+2SOr
-G23i8m3DE778E3i2eLs8POUeVzi5NiIljYboTcaDGfhoigLEKpJ+7L5Ww3YfL85Q
-xk00Y0b+cYNrlJ3vCpflDXJunZ1gJHLDTixJeVMpXnMSi01+bSb8D/PTcbG3fZ0U
-y4f2G0M+gf+m3EMMD96yerPf6jhGlTqY+eMyNVwNVk4BIG+D/8nf13keAF4kVbPJ
-QMidnCNbu8ZiC12HqLyv3YZlseXPIkhpbYEhsj58sbG4Tms+mG/zPlTZjroIEdAX
-nwI1aoG+NAbe+WSH/P4SvIMi1o/fWoXBtb+t7uy1AG/Xbu414WED7iwvxtqJRQj5
-rhrqryWTGQKY1zVJIOxwZP0f5gSIkEITyE+rO6o6pbAZFX7N0aMIvksBkEN5mdoV
-RWzxfSVNGMWooRD5d3TZAoIBAQD1dvgOsLYP8lUfkKglLTqHQe3x75BVDR9zdTIt
-tQh9UIbyovPFdLcXrHHJMBVMPTRGeRNpjCT5BNSNbidrmAxYN7YXuSA4uy3bubNU
-76km5kmL2Ji+5u+qMm9Xycyqn30rLH9hT+9c/MVuPW6CNmETKX9+v9zb1v//RrBS
-2ZNAWjJcBYv/rS/vKsW9yH/DbM21eSeokUqpkejOk1UxVZEcb9vt8VF8p+jO1wv3
-+UgI4Gfkf3sjEL1m/hBvH5Z49RHTFj4npeK6Lko4NLLazU2904jbHxppH51UNH1j
-xp8Is+iNwW2qCOve8kSUUUjxLn4n45D2d+5qOqQTtsMWXHanAoIBAQDGVQ6UZqvo
-djfcULq0Jub1xpBfxIAg7jSY7aZ6H0YlG7KgpVTd2TUEEKgErxtfYufjtLjjWb/d
-lMG7UpkM5B4tFnpRDmvevltCqGsM3qi3AtPnzavgz2TAQy7qd2gJc8glE965LOfb
-l+mGzE4SzeFJ9WS7sUDf4WnX2xjt3OA0VCvcBRNIwCnEvXu81XLKZL6etBx6zdCt
-whWHIiqa4wkjuWEwvbeH4aWsh8gFY3E5mbvDdMFtyGWvTK8OGivl3CkdQxM+MOJD
-3aAEBTr0M7tSMy5IKewASlAWZEVpFFPIyiyMCTI0XcEgA7ewHw/F3c7cstgVktjm
-OYZytZPF0ZvZAoIBAB5+z0aT8ap9gtHPGPS1b8YKDNO33YiTfsrLTpabHRjkfj96
-uypW28BXLjO+g4bbO7ldpWnBfX5qeTWw77jQRQhYs4iy+SvTJVlc8siklbE9fvme
-ySs+aZwNdAPGEGVKNzS77H9cfPJifOy7ORV4SAsnZq2KjJfLWDaQw6snWMHv8r23
-+rKjA4eFGtf/JtBSniPjj2fD1TDH7dJsP3NHnCWaSAqBpowEGEpKMTR3hdmEd6PN
-qrCqjb1T5xrHI9yXJcXBx6sJUueqhJIDCg1g4D2rIB+I97EDunoRo1pX/L4KC+RA
-ma08OoGSO67pglRkYEv4W7QjJj2QV34TgJ0wk5UCggEALINom0wT5z+pN+xyiv50
-NdNUEfpzW3C7I1urUpt0Td3SkJWq34Phj0EBxNNcTGNRclzcZkJ9eojpllZqfWcx
-kqMJ3ulisoJ8zxAnvqK2sSSUVOFnYzSJA1HQ1NTp570xvYihI2R9wV5uDlAKcdP9
-bXEDI9Ebo2PfMpA9Hx3EwFnn4iDNfDWM6lgwzmgFtIE5+zqnbbSF0onN9R9o+oxc
-P8Val+rspzWwznFHJlZ0Uh478xlgVHh2wgpu+7ZKBfQM0kF8ryefkOXMBTr7SVXX
-BBLyn0Wxbzs+kFf+8B+c0mL17pQdzX0BXGMZNhEypBEtXYFSWD02Ky3cDCDOwsZR
-uQKCAQAKQtsUSO80N/kzsWuSxHhuLMTvNZfiE/qK1Mz5Rw1qXxMXfYNFZbU/MqW7
-5DLd4Kn7s3v1UlBn2tbLGLzghnHYRxT9kxF7ZnY6HZv2IrEUjE2I2YTTCQr/Q7Z5
-gRBQb5z+vJbKOYnlSHurTexKmuTjgJ/y/jRQiQABccVj1w5lIm1SPoxpdKzSFyWt
-0NVmff9VetoiWKJYldPBTOmqPUytuBZyX5fJ4pPixwgAns6ZaqJtVNyMZkZ/GoDk
-XP2CvB/HyMiS7vXK5QJYYumk7oyC15H6eDChITNPV3VGH2QqcdEvDLT81W+JZ2mX
-8ynLaTs3oV3BjQya9pAUyzIX5L67
+MIIJQgIBADANBgkqhkiG9w0BAQEFAASCCSwwggkoAgEAAoICAQDYDbBlM8ILtq2x
+KLFUZwU4n7+0VHsO0skCfyNwpSZndbArjJUd/ZgFyCy5RK5Cg23KtXSMgkU6QlXO
+WvIrWJ/1wAkH9tuef/JDo9NJ00jBeua7HjdudNAsz6WwXSZC+a6DhA7nVHNwuyqq
+1SyHg5tuSP294EwfbEhXhaDyfXyBa4PaEmyjD2+O1NHSZ1AuUhblcUelKkZbykMv
+wCb7gJVXxlm/SN0K4vOVq80dBknr785562hDFGoXFX9hd2uPCQKbWGdMca+MmRWw
+NM2BCuxVoUl/Ooqmr7AdZ62lhpcqCd+todWC5GzrxwZjcIwt5P7MDvd+Ktmc8ePc
+Zhp3L3ddlxXNgfi+c9OnZaz1QVgEn1YlDAmHvQtj9H+v2mmawyyRycjmhIpV/eaX
+aJvWA2wq+O2OERl056IjjzcXHrD6DOk7IjlTwQ87AMU4mNrCzW1LLd428OxQdGv2
+I4/bnq+0snOJOrTk65upybJYMGKUuTRqfEQgv5d/923VUISC69uTq+0zVFxG3pyM
+JR2DO+6xinBkp0Gk+ft9L4aaBAYXyUmi+PRSfdTfUk3yQkYefC55QTDDRK2rb7Ji
+QqzrxhJ2vBar0TqXShQKKlMaOWHd+1U2ZjuyzboDDPeACoAmUVY2IHs+P8Dem0fw
+uKNdTF4jZkVQIWWLfTzzghOelmy9mwIDAQABAoICADF+KUt1qN0QEwgDX2QLWYnY
+Jo1D0RDbPorg3xh97KdEsX+4a6x8HGguq/ghAJ5iBzOpj7JkYUFwUsG72cAORE6C
+mE8HwNW1T6UpEUzXJtKTuelhiac3AT1SsA0PuaUcF1svVE6v7OYFKkgKH3JHtsJz
+3BS0HhwQrR3HkdAa6PuoyoKZN+O+tHqOzCYb3qVNzsruwU/XuFhspCl7JjL1CMEb
+whFsup400UIXIhylBSgUPkN1puO++HKjTRPhzHTuxncZsEg1vtZBd1NvNSh7fRo8
+oV6Q5ZQ7qOeDiabihxxtOJ1I9mVOuJjmddMvxBz7WVcbkpyHamRmkSE7DpMA/6G4
+I6MI7pF1jEkPjvZRVfC9irpd+uFtlmCgjTloFUtGIS9wPmEzbtHsAPWvWQAgbv/A
+BDw9SumA/cPEjjhD0jAdPczTxLZk86yr9UZou5WLmuCZJD3zozdZ/7HM5OvhGf7z
+vXqpIwxulU8uOxB7qVh2FTkArP1CxMPNASsaTzSIVmT4+G2NBaakHT3lCS+47XK/
+DJXc97w38cN/4WCxf5vRbeytS+ruDVWU0Ez0mqzYEo0xyWNcyjlWJfmamgI9Vfml
+wdhdYq/CQrrXi5VoYkTKfJl+Bp1HC+rvLjTWLH8tiWty+DHxmkwTedjPulukrBGp
+Uw9zMan3IxXsX8BanP2RAoIBAQDw4QNiFKYnCKhawyqgDrbtWtQjUPWP3DkSPSfE
+iWEkIwvH2tJpmmkvt+bSzXLLWv0tO2oTn88zmtIanptGbijjPZqhHuB1f6Di+h3A
+ZEFye586WlhCqZCw5RDCXw0Wj5ZQREHazO3txSOHvJxtbwW1Sqf6clGJs6Sq/Mk0
+pw9Cl5jtLELPL3dwQrtRjVpfK1WWh14E5XSFjHRXvWGMWdje1EN+Lf5V27a7W7SD
+elYqhn5NOKU237UB7cnXsvTndf8zsyx4BmBNO2BirU2B/MikK/LMR3BbJkp3rhMI
+eLkgKsN8kf7L4ZABcX1iUr0WxDfrPLxUsuvzb1FAgMpLIsSpAoIBAQDlnblRmqDz
+qsZdZJE2E6PQ7ELCz3b4g6ftMVOyYhptFZqDfku7T1MEdedeHr66pfh1BXgDSYwg
+hnGx8tPmaAZ+ZxghczhADLw1mUXiZ36xIlWVRaVatCCUquVent0PPytUlkPvy37Z
+qIXBAmQNIUorZMVJzeN45073KmZFZfAUXqSx8N0ObBh34oVDx7xgVSQvQyEssR8e
+VsvWWxKY6zrkFeFtonb6A5EDS8R9rmCdGqH0FCGQRo0pP4bT2iXxp40KLeJdZdmy
+nHOEHWtif7/hbaR6w7DLzmWbY5VHKzIFfVkoeoOuQPxYs2ds1mz3ywYKbXXNDcwD
+VMk6mtkqKxajAoIBAArgLfXstr/GbUuDylXltC6tTiy2CBBRwiXnqvb9uOwXxP1m
+DOAFv8AOzpYv/oHd/tZe+2AddA6BbAEVri8U5DW2X1fs+/dyJsJ4xoUcQbQ4jqzk
+zV1dKJJEFWihQAcHvqKrIkoNvKRipUMIqgtq2tgfocv2A2ZzPPkXZsJA1LiN/bKf
+r/iIzRy9dpWtCyqG21trizwvW/53o/0eKNxcZiVRciatTvFzdSGqd1EEYgWTgvpb
+l2IN4a9PnDBn/RTCSB5+dYCJ0SlLiAOMjZZT4n8/GLxOcW08Ilqa+nMEeF9Sbvcd
+5GIyMf1OsXmSAMWZYGj3mg088thP61w9NGUGEdkCggEBAMpwSFa98XFi+wiUBcKb
+hi5IXoPKzaVEzeS9PIFlJM9P4K5VxwcZZKPmH1pH2PhOI8NoUurzCOwUHGE7Kb9V
+r4P5+LhlEQ7HK5hFzetSO8yH7NRyVtqlPKRWF2tYvKUYmGc3JCZiTzAu99228ebx
+lqazbY0oTIjnxiL76rb8rLIIz0NijEKO4vOvbrbXfimgZwqUMMdqUXk6JPSTzs2r
+dnxpHhq+xg6e3lb9kfsMpnlcZbT/mqfMy9+19nUJO7LWee6jjZOynEBw1xd/qJFq
++A0T0ZO6vECzc7mQDqh0WOGmJdkeSsJy4QiDA4hddCzzfhvrbZSfuWKmedOFejlH
+S+kCggEAXxTOwID/U/8d6DnLLQzX1d9S5VPiKS+Jminvl6LzmGBojn0K1+nQXLNT
+c+EIURlHNuK3aR6dR/iSXiffjHzVAeu0FOSg3wTONowmyTB8LQamIt5Gx5vR3ptq
+4hhv2SSgagpJfSiBKzt3D1/Ls+GPIiRhEMNh6RTTvEK90neNNE5SLfPHFsBzAVmA
+VdlaM/mpudP5KCB4LQAGSjzEWYZpJuhBdoNd5guxb3044FcLA7quVQcANWKnXZxh
+7iHegXE37s7suS8tVscfNAXKccBBGsigba+knnhRQ0M9hlKZLlAAFD+qMHpkTYxJ
+dvQgA6dBjtYg5cQMHNbnfT3j3WzyQg==
 -----END PRIVATE KEY-----

From 6dd5aa23c2cff964652e534532e93098119ff678 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 22 Jul 2025 16:54:59 +0200
Subject: [PATCH 407/438] chore: update pre-commit / linters (#2925)

---
 .pre-commit-config.yaml                      | 12 ++++++------
 local-requirements.txt                       |  2 +-
 playwright/_impl/_clock.py                   |  2 +-
 playwright/_impl/_set_input_files_helpers.py |  2 +-
 tests/async/test_page.py                     |  3 +--
 tests/async/test_page_add_locator_handler.py |  1 -
 tests/async/test_worker.py                   |  2 +-
 tests/common/test_signals.py                 |  1 -
 tests/sync/test_page_add_locator_handler.py  |  1 -
 9 files changed, 11 insertions(+), 15 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 5c8c8f1db..57fdca816 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -15,20 +15,20 @@ repos:
       - id: check-executables-have-shebangs
       - id: check-merge-conflict
   - repo: https://github.com/psf/black
-    rev: 24.8.0
+    rev: 25.1.0
     hooks:
       - id: black
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.11.2
+    rev: v1.17.0
     hooks:
       - id: mypy
-        additional_dependencies: [types-pyOpenSSL==24.1.0.20240722, types-requests==2.32.0.20240914]
+        additional_dependencies: [types-pyOpenSSL==24.1.0.20240722, types-requests==2.32.4.20250611]
   - repo: https://github.com/pycqa/flake8
-    rev: 7.1.1
+    rev: 7.3.0
     hooks:
       - id: flake8
   - repo: https://github.com/pycqa/isort
-    rev: 5.13.2
+    rev: 6.0.1
     hooks:
       - id: isort
   - repo: local
@@ -39,7 +39,7 @@ repos:
         language: node
         pass_filenames: false
         types: [python]
-        additional_dependencies: ["pyright@1.1.384"]
+        additional_dependencies: ["pyright@1.1.403"]
   - repo: local
     hooks:
       - id: check-license-header
diff --git a/local-requirements.txt b/local-requirements.txt
index e19488956..28f60ba65 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -2,7 +2,7 @@ autobahn==23.1.2
 black==25.1.0
 build==1.2.2.post1
 flake8==7.2.0
-mypy==1.16.0
+mypy==1.17.0
 objgraph==3.6.2
 Pillow==11.2.1
 pixelmatch==0.3.0
diff --git a/playwright/_impl/_clock.py b/playwright/_impl/_clock.py
index 928536019..f6eb7c42d 100644
--- a/playwright/_impl/_clock.py
+++ b/playwright/_impl/_clock.py
@@ -89,7 +89,7 @@ async def set_system_time(
 
 
 def parse_time(
-    time: Union[float, str, datetime.datetime]
+    time: Union[float, str, datetime.datetime],
 ) -> Dict[str, Union[int, str]]:
     if isinstance(time, (float, int)):
         return {"timeNumber": int(time * 1_000)}
diff --git a/playwright/_impl/_set_input_files_helpers.py b/playwright/_impl/_set_input_files_helpers.py
index f868886a3..0f40d5b99 100644
--- a/playwright/_impl/_set_input_files_helpers.py
+++ b/playwright/_impl/_set_input_files_helpers.py
@@ -139,7 +139,7 @@ async def convert_input_files(
 
 
 def resolve_paths_and_directory_for_input_files(
-    items: Sequence[Union[str, Path]]
+    items: Sequence[Union[str, Path]],
 ) -> Tuple[Optional[List[str]], Optional[str]]:
     local_paths: Optional[List[str]] = None
     local_directory: Optional[str] = None
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 03907c4b9..607c86fb3 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -662,7 +662,7 @@ async def load() -> None:
 
 
 async def test_set_content_should_work_with_tricky_content(page: Page) -> None:
-    await page.set_content("<div>hello world</div>" + "\x7F")
+    await page.set_content("<div>hello world</div>" + "\x7f")
     assert await page.eval_on_selector("div", "div => div.textContent") == "hello world"
 
 
@@ -1403,7 +1403,6 @@ async def test_should_not_throw_when_continuing_after_page_is_closed(
     async def handle_route(route: Route) -> None:
         await page.close()
         await route.continue_()
-        nonlocal done
         done.set_result(True)
 
     await page.route("**/*", handle_route)
diff --git a/tests/async/test_page_add_locator_handler.py b/tests/async/test_page_add_locator_handler.py
index 4a5a44323..5f44170f8 100644
--- a/tests/async/test_page_add_locator_handler.py
+++ b/tests/async/test_page_add_locator_handler.py
@@ -30,7 +30,6 @@ async def test_should_work(page: Page, server: Server) -> None:
     original_locator = page.get_by_text("This interstitial covers the button")
 
     async def handler(locator: Locator) -> None:
-        nonlocal original_locator
         assert locator == original_locator
         nonlocal before_count
         nonlocal after_count
diff --git a/tests/async/test_worker.py b/tests/async/test_worker.py
index de1a858e8..bba22fc0d 100644
--- a/tests/async/test_worker.py
+++ b/tests/async/test_worker.py
@@ -199,5 +199,5 @@ 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"
+    assert await worker.evaluate("() => (10000.20).toLocaleString()") == "10\u00a0000,2"
     await context.close()
diff --git a/tests/common/test_signals.py b/tests/common/test_signals.py
index 174eaf6f2..ba600b44d 100644
--- a/tests/common/test_signals.py
+++ b/tests/common/test_signals.py
@@ -50,7 +50,6 @@ async def main() -> None:
         page = await context.new_page()
         notified = False
         try:
-            nonlocal sigint_received
             while not sigint_received:
                 if not notified:
                     wait_queue.put("ready")
diff --git a/tests/sync/test_page_add_locator_handler.py b/tests/sync/test_page_add_locator_handler.py
index b2d037f07..7a2b6a438 100644
--- a/tests/sync/test_page_add_locator_handler.py
+++ b/tests/sync/test_page_add_locator_handler.py
@@ -29,7 +29,6 @@ def test_should_work(page: Page, server: Server) -> None:
     original_locator = page.get_by_text("This interstitial covers the button")
 
     def handler(locator: Locator) -> None:
-        nonlocal original_locator
         assert locator == original_locator
         nonlocal before_count
         nonlocal after_count

From 2b75be585dac7f0ed762a37e48df3b8296527f9e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 28 Jul 2025 23:04:07 +0200
Subject: [PATCH 408/438] build(deps): bump pytest-asyncio from 1.0.0 to 1.1.0
 (#2932)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 28f60ba65..64544740f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -9,7 +9,7 @@ pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==25.1.0
 pytest==8.4.1
-pytest-asyncio==1.0.0
+pytest-asyncio==1.1.0
 pytest-cov==6.2.1
 pytest-repeat==0.9.4
 pytest-rerunfailures==15.1

From a74efb8e1ce5a60480a48f63a8a6d76dd3d55fb7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 1 Aug 2025 14:04:39 +0200
Subject: [PATCH 409/438] build(deps): bump pytest-xdist from 3.7.0 to 3.8.0
 (#2916)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 64544740f..de20c0daa 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -14,7 +14,7 @@ pytest-cov==6.2.1
 pytest-repeat==0.9.4
 pytest-rerunfailures==15.1
 pytest-timeout==2.4.0
-pytest-xdist==3.7.0
+pytest-xdist==3.8.0
 requests==2.32.4
 service_identity==24.2.0
 twisted==25.5.0

From 8ad65d414aee14f5445ad1b7023f92aedc322700 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 5 Aug 2025 09:44:39 +0200
Subject: [PATCH 410/438] build(deps): bump mypy from 1.17.0 to 1.17.1 (#2933)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index de20c0daa..d9f834c3f 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -2,7 +2,7 @@ autobahn==23.1.2
 black==25.1.0
 build==1.2.2.post1
 flake8==7.2.0
-mypy==1.17.0
+mypy==1.17.1
 objgraph==3.6.2
 Pillow==11.2.1
 pixelmatch==0.3.0

From 7dc8b32b9c34c43620e0c7f19cc08b71410aff22 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 5 Aug 2025 10:46:40 +0200
Subject: [PATCH 411/438] test: unflake dialog inline script test (#2934)

---
 tests/sync/test_browsercontext_events.py | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/tests/sync/test_browsercontext_events.py b/tests/sync/test_browsercontext_events.py
index 6e44b76d5..a100fb04a 100644
--- a/tests/sync/test_browsercontext_events.py
+++ b/tests/sync/test_browsercontext_events.py
@@ -172,23 +172,25 @@ def test_dialog_event_should_work_with_inline_script_tag(
 ) -> None:
     def handle_route(request: TestServerRequest) -> None:
         request.setHeader("content-type", "text/html")
-        request.write(b"""<script>window.result = prompt('hey?')</script>""")
+        request.write(b"<script>window.result = prompt('hey?')</script>")
         request.finish()
 
     server.set_route("/popup.html", handle_route)
     page.goto(server.EMPTY_PAGE)
     page.set_content("<a href='popup.html' target=_blank>Click me</a>")
 
-    def handle_dialog(dialog: Dialog) -> None:
-        assert dialog.message == "hey?"
-        assert dialog.page == popup
-        dialog.accept("hello")
+    with (
+        page.context.expect_event("dialog") as dialog_info,
+        page.expect_popup() as popup_info,
+    ):
+        page.click("a")
 
-    page.context.on("dialog", handle_dialog)
+    dialog: Dialog = dialog_info.value
+    popup: Page = popup_info.value
 
-    with page.expect_popup() as popup_info:
-        page.click("a")
-    popup = popup_info.value
+    assert dialog.message == "hey?"
+    assert dialog.page == popup
+    dialog.accept("hello")
     assert popup.evaluate("window.result") == "hello"
 
 

From 3fea01e81a33f1ef31e271bdda78d398f18e87be Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 5 Aug 2025 11:32:51 +0200
Subject: [PATCH 412/438] test: unflake test_context_add_cookies_should_work
 (#2935)

---
 tests/async/test_defaultbrowsercontext.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/async/test_defaultbrowsercontext.py b/tests/async/test_defaultbrowsercontext.py
index 25ef0c3f8..f5d2a606d 100644
--- a/tests/async/test_defaultbrowsercontext.py
+++ b/tests/async/test_defaultbrowsercontext.py
@@ -111,7 +111,7 @@ async def test_context_add_cookies_should_work(
         ]
     )
     assert await page.evaluate("() => document.cookie") == "username=John Doe"
-    assert await page.context.cookies() == [
+    assert _filter_cookies(await page.context.cookies()) == [
         {
             "name": "username",
             "value": "John Doe",
@@ -127,7 +127,7 @@ async def test_context_add_cookies_should_work(
 
 def _filter_cookies(cookies: Sequence[Cookie]) -> List[Cookie]:
     return list(
-        filter(lambda cookie: cookie["domain"] != "copilot.microsoft.com", cookies)
+        filter(lambda cookie: not cookie["domain"].endswith("microsoft.com"), cookies)
     )
 
 

From 8963460fffe065bfeb58a162f6e35fc8e3e65d4d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 5 Aug 2025 13:37:31 +0200
Subject: [PATCH 413/438] build(deps): bump build from 1.2.2.post1 to 1.3.0
 (#2937)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index d9f834c3f..8c214a014 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,6 +1,6 @@
 autobahn==23.1.2
 black==25.1.0
-build==1.2.2.post1
+build==1.3.0
 flake8==7.2.0
 mypy==1.17.1
 objgraph==3.6.2

From 5cc395e9214b5ebb32ca8629d6905e53824978b5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 12 Aug 2025 10:35:18 +0200
Subject: [PATCH 414/438] build(deps): bump actions/checkout from 4 to 5 in the
 actions group (#2940)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/ci.yml             | 10 +++++-----
 .github/workflows/publish.yml        |  2 +-
 .github/workflows/publish_docker.yml |  2 +-
 .github/workflows/test_docker.yml    |  2 +-
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index c18a04bc6..200b2a65a 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -21,7 +21,7 @@ jobs:
     name: Lint
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
@@ -80,7 +80,7 @@ jobs:
           browser: chromium
     runs-on: ${{ matrix.os }}
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
@@ -127,7 +127,7 @@ jobs:
           browser-channel: msedge
     runs-on: ${{ matrix.os }}
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
@@ -163,7 +163,7 @@ jobs:
         os: [ubuntu-22.04, macos-13, windows-2022]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - name: Get conda
@@ -184,7 +184,7 @@ jobs:
       run:
         working-directory: examples/todomvc/
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index b682372fd..c6e71028a 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -25,7 +25,7 @@ jobs:
         # Required for conda-incubator/setup-miniconda@v3
         shell: bash -el {0}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - name: Get conda
diff --git a/.github/workflows/publish_docker.yml b/.github/workflows/publish_docker.yml
index 7d83136bc..7c2b73e13 100644
--- a/.github/workflows/publish_docker.yml
+++ b/.github/workflows/publish_docker.yml
@@ -15,7 +15,7 @@ jobs:
       contents: read    # This is required for actions/checkout to succeed
     environment: Docker
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Azure login
       uses: azure/login@v2
       with:
diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index c1f2be3de..e5252e389 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -30,7 +30,7 @@ jobs:
           - ubuntu-24.04
           - ubuntu-24.04-arm
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Set up Python
       uses: actions/setup-python@v5
       with:

From d33a807492c0a944186bc37dd5d71d57e1c36901 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 12 Aug 2025 10:35:43 +0200
Subject: [PATCH 415/438] build(deps): bump greenlet from 3.2.3 to 3.2.4
 (#2939)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 14dc0500a..75d362fe8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,6 @@
 # This file was autogenerated by uv via the following command:
 #    uv pip compile pyproject.toml -o requirements.txt
-greenlet==3.2.3
+greenlet==3.2.4
     # via playwright (pyproject.toml)
 pyee==13.0.0
     # via playwright (pyproject.toml)

From e49496e7a803b2fd05e5a7e814db4c0af8962743 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 12 Aug 2025 14:03:42 +0200
Subject: [PATCH 416/438] build(deps): bump types-requests from 2.32.4.20250611
 to 2.32.4.20250809 (#2941)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 8c214a014..2f4f0d488 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -19,4 +19,4 @@ requests==2.32.4
 service_identity==24.2.0
 twisted==25.5.0
 types-pyOpenSSL==24.1.0.20240722
-types-requests==2.32.4.20250611
+types-requests==2.32.4.20250809

From 6e9ff7a80f02db4e0ccdb87efadbf543a0c3ceb9 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 12 Aug 2025 15:34:31 +0200
Subject: [PATCH 417/438] test: unflake cr tracing test (#2942)

---
 tests/async/test_chromium_tracing.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/async/test_chromium_tracing.py b/tests/async/test_chromium_tracing.py
index fd065efde..4cd796e0d 100644
--- a/tests/async/test_chromium_tracing.py
+++ b/tests/async/test_chromium_tracing.py
@@ -114,5 +114,6 @@ async def test_should_support_a_buffer_without_a_path(
 ) -> None:
     await browser.start_tracing(page=page, screenshots=True)
     await page.goto(server.PREFIX + "/grid.html")
+    await rafraf(page)
     trace = await browser.stop_tracing()
     assert "screenshot" in trace.decode()

From 1be34f206e1b57cf94cbb295158f75860f744e9c Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 14 Aug 2025 15:25:41 +0200
Subject: [PATCH 418/438] fix: timeout option support with fetch api (#2947)

---
 playwright/_impl/_fetch.py                 | 1 +
 tests/async/test_fetch_global.py           | 9 +++++++++
 tests/async/test_page_request_intercept.py | 2 +-
 tests/sync/test_fetch_global.py            | 9 +++++++++
 tests/sync/test_page_request_intercept.py  | 2 +-
 5 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/playwright/_impl/_fetch.py b/playwright/_impl/_fetch.py
index e4174ea27..50bf4ad4a 100644
--- a/playwright/_impl/_fetch.py
+++ b/playwright/_impl/_fetch.py
@@ -412,6 +412,7 @@ async def _inner_fetch(
             self._timeout_settings.timeout,
             {
                 "url": url,
+                "timeout": timeout,
                 "params": object_to_array(params) if isinstance(params, dict) else None,
                 "encodedParams": params if isinstance(params, str) else None,
                 "method": method,
diff --git a/tests/async/test_fetch_global.py b/tests/async/test_fetch_global.py
index e2a7678c5..1f7593194 100644
--- a/tests/async/test_fetch_global.py
+++ b/tests/async/test_fetch_global.py
@@ -89,6 +89,15 @@ async def test_should_support_global_timeout_option(
         await request.get(server.EMPTY_PAGE)
 
 
+async def test_should_support_timeout_option_in_get_method(
+    playwright: Playwright, server: Server
+) -> None:
+    request = await playwright.request.new_context()
+    server.set_route("/empty.html", lambda req: None)
+    with pytest.raises(Error, match="APIRequestContext.get: Timeout 123ms exceeded."):
+        await request.get(server.EMPTY_PAGE, timeout=123)
+
+
 async def test_should_propagate_extra_http_headers_with_redirects(
     playwright: Playwright, server: Server
 ) -> None:
diff --git a/tests/async/test_page_request_intercept.py b/tests/async/test_page_request_intercept.py
index dc8f7416a..a9859e87b 100644
--- a/tests/async/test_page_request_intercept.py
+++ b/tests/async/test_page_request_intercept.py
@@ -34,7 +34,7 @@ def _handler(request: TestServerRequest) -> None:
     async def handle(route: Route) -> None:
         with pytest.raises(Error) as error:
             await route.fetch(timeout=1000)
-        assert "Timeout 1000ms exceeded" in error.value.message
+        assert "Route.fetch: Timeout 1000ms exceeded." in error.value.message
 
     await page.route("**/*", lambda route: handle(route))
     with pytest.raises(Error) as error:
diff --git a/tests/sync/test_fetch_global.py b/tests/sync/test_fetch_global.py
index bf3970c21..5cb3abc5b 100644
--- a/tests/sync/test_fetch_global.py
+++ b/tests/sync/test_fetch_global.py
@@ -71,6 +71,15 @@ def test_should_support_global_timeout_option(
         request.get(server.EMPTY_PAGE)
 
 
+def test_should_support_timeout_option_in_get_method(
+    playwright: Playwright, server: Server
+) -> None:
+    request = playwright.request.new_context()
+    server.set_route("/empty.html", lambda req: None)
+    with pytest.raises(Error, match="APIRequestContext.get: Timeout 123ms exceeded."):
+        request.get(server.EMPTY_PAGE, timeout=123)
+
+
 def test_should_propagate_extra_http_headers_with_redirects(
     playwright: Playwright, server: Server
 ) -> None:
diff --git a/tests/sync/test_page_request_intercept.py b/tests/sync/test_page_request_intercept.py
index 86cf21b63..1d3dd0f46 100644
--- a/tests/sync/test_page_request_intercept.py
+++ b/tests/sync/test_page_request_intercept.py
@@ -34,7 +34,7 @@ def _handle(request: TestServerRequest) -> None:
     def handle(route: Route) -> None:
         with pytest.raises(Error) as error:
             route.fetch(timeout=1000)
-        assert "Request timed out after 1000ms" in error.value.message
+        assert "Route.fetch: Timeout 1000ms exceeded." in error.value.message
 
     page.route("**/*", lambda route: handle(route))
     with pytest.raises(Error) as error:

From 254aabddf3a68c9385cc9e363d2b61fa4bba777d Mon Sep 17 00:00:00 2001
From: Xianghu Zhao <xianghuzhao@gmail.com>
Date: Tue, 19 Aug 2025 21:17:08 +0800
Subject: [PATCH 419/438] fix: screenshot type inferred from path file
 extension (#2951)

---
 playwright/_impl/_element_handle.py | 12 ++++++++++
 playwright/_impl/_page.py           |  4 +++-
 tests/async/test_screenshot.py      | 34 +++++++++++++++++++++++++++++
 3 files changed, 49 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 88f1a7358..1561e19fc 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import base64
+import mimetypes
 from pathlib import Path
 from typing import (
     TYPE_CHECKING,
@@ -323,6 +324,8 @@ async def screenshot(
     ) -> bytes:
         params = locals_to_params(locals())
         if "path" in params:
+            if "type" not in params:
+                params["type"] = determine_screenshot_type(params["path"])
             del params["path"]
         if "mask" in params:
             params["mask"] = list(
@@ -450,3 +453,12 @@ def convert_select_option_values(
         elements = list(map(lambda e: e._channel, element))
 
     return dict(options=options, elements=elements)
+
+
+def determine_screenshot_type(path: Union[str, Path]) -> Literal["jpeg", "png"]:
+    mime_type, _ = mimetypes.guess_type(path)
+    if mime_type == "image/png":
+        return "png"
+    if mime_type == "image/jpeg":
+        return "jpeg"
+    raise Error(f'Unsupported screenshot mime type for path "{path}": {mime_type}')
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index a0fa4eec2..1019b2f6e 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -51,7 +51,7 @@
 )
 from playwright._impl._console_message import ConsoleMessage
 from playwright._impl._download import Download
-from playwright._impl._element_handle import ElementHandle
+from playwright._impl._element_handle import ElementHandle, determine_screenshot_type
 from playwright._impl._errors import Error, TargetClosedError, is_target_closed_error
 from playwright._impl._event_context_manager import EventContextManagerImpl
 from playwright._impl._file_chooser import FileChooser
@@ -800,6 +800,8 @@ async def screenshot(
     ) -> bytes:
         params = locals_to_params(locals())
         if "path" in params:
+            if "type" not in params:
+                params["type"] = determine_screenshot_type(params["path"])
             del params["path"]
         if "mask" in params:
             params["mask"] = list(
diff --git a/tests/async/test_screenshot.py b/tests/async/test_screenshot.py
index 3cd536f96..36149225f 100644
--- a/tests/async/test_screenshot.py
+++ b/tests/async/test_screenshot.py
@@ -12,13 +12,21 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from pathlib import Path
 from typing import Callable
 
+from PIL import Image
+
 from playwright.async_api import Page
 from tests.server import Server
 from tests.utils import must
 
 
+def assert_image_file_format(path: Path, image_format: str) -> None:
+    with Image.open(path) as img:
+        assert img.format == image_format
+
+
 async def test_should_screenshot_with_mask(
     page: Page, server: Server, assert_to_be_golden: Callable[[bytes, str], None]
 ) -> None:
@@ -43,3 +51,29 @@ async def test_should_screenshot_with_mask(
         ),
         "mask-should-work-with-element-handle.png",
     )
+
+
+async def test_should_infer_screenshot_type_from_path(
+    page: Page, tmp_path: Path
+) -> None:
+    output_png_file = tmp_path / "foo.png"
+    await page.screenshot(path=output_png_file)
+    assert_image_file_format(output_png_file, "PNG")
+
+    output_jpeg_file = tmp_path / "bar.jpeg"
+    await page.screenshot(path=output_jpeg_file)
+    assert_image_file_format(output_jpeg_file, "JPEG")
+
+    output_jpg_file = tmp_path / "bar.jpg"
+    await page.screenshot(path=output_jpg_file)
+    assert_image_file_format(output_jpg_file, "JPEG")
+
+
+async def test_should_screenshot_with_type_argument(page: Page, tmp_path: Path) -> None:
+    output_jpeg_with_png_extension = tmp_path / "foo_jpeg.png"
+    await page.screenshot(path=output_jpeg_with_png_extension, type="jpeg")
+    assert_image_file_format(output_jpeg_with_png_extension, "JPEG")
+
+    output_png_with_jpeg_extension = tmp_path / "bar_png.jpeg"
+    await page.screenshot(path=output_png_with_jpeg_extension, type="png")
+    assert_image_file_format(output_png_with_jpeg_extension, "PNG")

From 3cbe13e58a4a20b4b3aaa1afbdc69747a7c37933 Mon Sep 17 00:00:00 2001
From: Simon Knott <info@simonknott.de>
Date: Thu, 21 Aug 2025 17:08:58 +0200
Subject: [PATCH 420/438] chore: roll to 1.55.0 (#2956)

---
 README.md                                     |   4 +-
 playwright/_impl/_helper.py                   |  26 +++-
 playwright/async_api/_generated.py            |  27 +++-
 playwright/sync_api/_generated.py             |  35 ++++-
 setup.py                                      |   2 +-
 .../content-script.js                         |   0
 .../index.js                                  |   2 +-
 .../manifest.json                             |   4 +-
 .../extension-mv3-with-logging/background.js  |   5 +
 .../extension-mv3-with-logging/content.js     |   1 +
 .../extension-mv3-with-logging/manifest.json  |  17 +++
 tests/async/test_extension.py                 | 125 ++++++++++++++++++
 tests/async/test_launcher.py                  |  38 +-----
 tests/async/test_page_route.py                |  17 +++
 tests/async/test_tracing.py                   |   1 -
 tests/sync/test_extension.py                  | 101 ++++++++++++++
 tests/sync/test_launcher.py                   |  38 +-----
 tests/sync/test_tracing.py                    |   1 -
 18 files changed, 352 insertions(+), 92 deletions(-)
 rename tests/assets/{simple-extension => extension-mv3-simple}/content-script.js (100%)
 rename tests/assets/{simple-extension => extension-mv3-simple}/index.js (63%)
 rename tests/assets/{simple-extension => extension-mv3-simple}/manifest.json (80%)
 create mode 100644 tests/assets/extension-mv3-with-logging/background.js
 create mode 100644 tests/assets/extension-mv3-with-logging/content.js
 create mode 100644 tests/assets/extension-mv3-with-logging/manifest.json
 create mode 100644 tests/async/test_extension.py
 create mode 100644 tests/sync/test_extension.py

diff --git a/README.md b/README.md
index fa9e246a9..cf85c6116 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 -->139.0.7258.5<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->140.0.7339.16<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->26.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->140.0.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->141.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 66e59c65f..8f1ca8594 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -29,6 +29,7 @@
     Optional,
     Pattern,
     Set,
+    Tuple,
     TypedDict,
     TypeVar,
     Union,
@@ -221,14 +222,35 @@ def map_token(original: str, replacement: str) -> str:
             processed_parts.append(new_prefix + new_suffix)
 
     relative_path = "/".join(processed_parts)
-    resolved_url = urljoin(base_url if base_url is not None else "", relative_path)
+    resolved_url, case_insensitive_part = resolve_base_url(base_url, relative_path)
 
     for replacement, original in token_map.items():
-        resolved_url = resolved_url.replace(replacement, original, 1)
+        normalize = case_insensitive_part and replacement in case_insensitive_part
+        resolved_url = resolved_url.replace(
+            replacement, original.lower() if normalize else original, 1
+        )
 
     return ensure_trailing_slash(resolved_url)
 
 
+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)
+        # Schema and domain are case-insensitive.
+        hostname_port = (
+            parsed.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}"
+        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:
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index bedf233de..bdda2b2b0 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -11487,8 +11487,8 @@ async def main():
     async def pause(self) -> None:
         """Page.pause
 
-        Pauses script execution. Playwright will stop executing the script and wait for the user to either press 'Resume'
-        button in the page overlay or to call `playwright.resume()` in the DevTools console.
+        Pauses script execution. Playwright will stop executing the script and wait for the user to either press the
+        'Resume' button in the page overlay or to call `playwright.resume()` in the DevTools console.
 
         User can inspect selectors or perform manual steps while paused. Resume will continue running the original script
         from the place it was paused.
@@ -13921,6 +13921,10 @@ async def new_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
+            Client certificate authentication is only active when at least one client certificate is provided. If you want to
+            reject all client certificates sent by the server, you need to provide a client certificate with an `origin` that
+            does not match any of the domains you plan to visit.
+
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
@@ -14152,6 +14156,10 @@ async def new_page(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
+            Client certificate authentication is only active when at least one client certificate is provided. If you want to
+            reject all client certificates sent by the server, you need to provide a client certificate with an `origin` that
+            does not match any of the domains you plan to visit.
+
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
@@ -14559,6 +14567,13 @@ async def launch_persistent_context(
             **parent** directory of the "Profile Path" seen at `chrome://version`.
 
             Note that browsers do not allow launching multiple instances with the same User Data Directory.
+
+            **NOTE** Chromium/Chrome: Due to recent Chrome policy changes, automating the default Chrome user profile is not
+            supported. Pointing `userDataDir` to Chrome's main "User Data" directory (the profile used for your regular
+            browsing) may result in pages not loading or the browser exiting. Create and use a separate directory (for example,
+            an empty folder) as your automation profile instead. See https://developer.chrome.com/blog/remote-debugging-port
+            for details.
+
         channel : Union[str, None]
             Browser distribution channel.
 
@@ -14733,6 +14748,10 @@ async def launch_persistent_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
+            Client certificate authentication is only active when at least one client certificate is provided. If you want to
+            reject all client certificates sent by the server, you need to provide a client certificate with an `origin` that
+            does not match any of the domains you plan to visit.
+
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
@@ -18801,6 +18820,10 @@ async def new_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
+            Client certificate authentication is only active when at least one client certificate is provided. If you want to
+            reject all client certificates sent by the server, you need to provide a client certificate with an `origin` that
+            does not match any of the domains you plan to visit.
+
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 8f4b60764..83fedfbe9 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -11569,8 +11569,8 @@ def run(playwright: Playwright):
     def pause(self) -> None:
         """Page.pause
 
-        Pauses script execution. Playwright will stop executing the script and wait for the user to either press 'Resume'
-        button in the page overlay or to call `playwright.resume()` in the DevTools console.
+        Pauses script execution. Playwright will stop executing the script and wait for the user to either press the
+        'Resume' button in the page overlay or to call `playwright.resume()` in the DevTools console.
 
         User can inspect selectors or perform manual steps while paused. Resume will continue running the original script
         from the place it was paused.
@@ -12255,7 +12255,7 @@ def add_locator_handler(
 
         ```py
         # Setup the handler.
-        def handler():
+        async def handler():
           await page.get_by_role(\"button\", name=\"No thanks\").click()
         await page.add_locator_handler(page.get_by_text(\"Sign up to the newsletter\"), handler)
 
@@ -12268,7 +12268,7 @@ def handler():
 
         ```py
         # Setup the handler.
-        def handler():
+        async def handler():
           await page.get_by_role(\"button\", name=\"Remind me later\").click()
         await page.add_locator_handler(page.get_by_text(\"Confirm your security details\"), handler)
 
@@ -12283,7 +12283,7 @@ def handler():
 
         ```py
         # Setup the handler.
-        def handler():
+        async def handler():
           await page.evaluate(\"window.removeObstructionsForTestIfNeeded()\")
         await page.add_locator_handler(page.locator(\"body\"), handler, no_wait_after=True)
 
@@ -12296,7 +12296,7 @@ def handler():
         invocations by setting `times`:
 
         ```py
-        def handler(locator):
+        async def handler(locator):
           await locator.click()
         await page.add_locator_handler(page.get_by_label(\"Close\"), handler, times=1)
         ```
@@ -13952,6 +13952,10 @@ def new_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
+            Client certificate authentication is only active when at least one client certificate is provided. If you want to
+            reject all client certificates sent by the server, you need to provide a client certificate with an `origin` that
+            does not match any of the domains you plan to visit.
+
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
@@ -14185,6 +14189,10 @@ def new_page(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
+            Client certificate authentication is only active when at least one client certificate is provided. If you want to
+            reject all client certificates sent by the server, you need to provide a client certificate with an `origin` that
+            does not match any of the domains you plan to visit.
+
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
@@ -14598,6 +14606,13 @@ def launch_persistent_context(
             **parent** directory of the "Profile Path" seen at `chrome://version`.
 
             Note that browsers do not allow launching multiple instances with the same User Data Directory.
+
+            **NOTE** Chromium/Chrome: Due to recent Chrome policy changes, automating the default Chrome user profile is not
+            supported. Pointing `userDataDir` to Chrome's main "User Data" directory (the profile used for your regular
+            browsing) may result in pages not loading or the browser exiting. Create and use a separate directory (for example,
+            an empty folder) as your automation profile instead. See https://developer.chrome.com/blog/remote-debugging-port
+            for details.
+
         channel : Union[str, None]
             Browser distribution channel.
 
@@ -14772,6 +14787,10 @@ def launch_persistent_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
+            Client certificate authentication is only active when at least one client certificate is provided. If you want to
+            reject all client certificates sent by the server, you need to provide a client certificate with an `origin` that
+            does not match any of the domains you plan to visit.
+
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
@@ -18922,6 +18941,10 @@ def new_context(
             `passphrase` property should be provided if the certificate is encrypted. The `origin` property should be provided
             with an exact match to the request origin that the certificate is valid for.
 
+            Client certificate authentication is only active when at least one client certificate is provided. If you want to
+            reject all client certificates sent by the server, you need to provide a client certificate with an `origin` that
+            does not match any of the domains you plan to visit.
+
             **NOTE** When using WebKit on macOS, accessing `localhost` will not pick up client certificates. You can make it
             work by replacing `localhost` with `local.playwright`.
 
diff --git a/setup.py b/setup.py
index 5c2911865..d147f3be7 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.54.1"
+driver_version = "1.55.0"
 
 base_wheel_bundles = [
     {
diff --git a/tests/assets/simple-extension/content-script.js b/tests/assets/extension-mv3-simple/content-script.js
similarity index 100%
rename from tests/assets/simple-extension/content-script.js
rename to tests/assets/extension-mv3-simple/content-script.js
diff --git a/tests/assets/simple-extension/index.js b/tests/assets/extension-mv3-simple/index.js
similarity index 63%
rename from tests/assets/simple-extension/index.js
rename to tests/assets/extension-mv3-simple/index.js
index a0bb3f4ea..1523a8364 100644
--- a/tests/assets/simple-extension/index.js
+++ b/tests/assets/extension-mv3-simple/index.js
@@ -1,2 +1,2 @@
 // Mock script for background extension
-window.MAGIC = 42;
+globalThis.MAGIC = 42;
diff --git a/tests/assets/simple-extension/manifest.json b/tests/assets/extension-mv3-simple/manifest.json
similarity index 80%
rename from tests/assets/simple-extension/manifest.json
rename to tests/assets/extension-mv3-simple/manifest.json
index da2cd082e..39b77fc21 100644
--- a/tests/assets/simple-extension/manifest.json
+++ b/tests/assets/extension-mv3-simple/manifest.json
@@ -2,7 +2,7 @@
   "name": "Simple extension",
   "version": "0.1",
   "background": {
-    "scripts": ["index.js"]
+    "service_worker": "index.js"
   },
   "content_scripts": [{
     "matches": ["<all_urls>"],
@@ -10,5 +10,5 @@
     "js": ["content-script.js"]
   }],
   "permissions": ["background", "activeTab"],
-  "manifest_version": 2
+  "manifest_version": 3
 }
diff --git a/tests/assets/extension-mv3-with-logging/background.js b/tests/assets/extension-mv3-with-logging/background.js
new file mode 100644
index 000000000..3b1a406fb
--- /dev/null
+++ b/tests/assets/extension-mv3-with-logging/background.js
@@ -0,0 +1,5 @@
+console.log("Service worker script loaded");
+
+chrome.runtime.onInstalled.addListener(() => {
+  console.log("Extension installed");
+});
diff --git a/tests/assets/extension-mv3-with-logging/content.js b/tests/assets/extension-mv3-with-logging/content.js
new file mode 100644
index 000000000..e718206c2
--- /dev/null
+++ b/tests/assets/extension-mv3-with-logging/content.js
@@ -0,0 +1 @@
+console.log("Test console log from a third-party execution context");
diff --git a/tests/assets/extension-mv3-with-logging/manifest.json b/tests/assets/extension-mv3-with-logging/manifest.json
new file mode 100644
index 000000000..5ad1fde38
--- /dev/null
+++ b/tests/assets/extension-mv3-with-logging/manifest.json
@@ -0,0 +1,17 @@
+{
+    "manifest_version": 3,
+    "name": "Console Log Extension",
+    "version": "1.0",
+    "background": {
+      "service_worker": "background.js"
+    },
+    "permissions": [
+      "tabs"
+    ],
+    "content_scripts": [
+      {
+        "matches": ["<all_urls>"],
+        "js": ["content.js"]
+      }
+    ]
+  }
diff --git a/tests/async/test_extension.py b/tests/async/test_extension.py
new file mode 100644
index 000000000..853afd8a5
--- /dev/null
+++ b/tests/async/test_extension.py
@@ -0,0 +1,125 @@
+# 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 pathlib import Path
+from typing import Any, AsyncGenerator, Awaitable, Callable, Dict, List, Optional
+
+import pytest
+
+from playwright.async_api import BrowserContext, BrowserType
+
+from ..server import Server
+
+
+@pytest.fixture()
+async def launch_persistent_context(
+    browser_type: BrowserType,
+    browser_channel: Optional[str],
+    tmp_path: Path,
+    launch_arguments: Dict[str, Any],
+    is_headless_shell: bool,
+) -> AsyncGenerator[Callable[..., Awaitable[BrowserContext]], None]:
+    if browser_channel and browser_channel.startswith("chrome"):
+        pytest.skip(
+            "--load-extension is not supported in Chrome anymore. https://groups.google.com/a/chromium.org/g/chromium-extensions/c/1-g8EFx2BBY/m/S0ET5wPjCAAJ"
+        )
+    if is_headless_shell:
+        pytest.skip("Headless Shell has no support for extensions")
+
+    contexts: List[BrowserContext] = []
+
+    async def launch(extension_path: str, **kwargs: Any) -> BrowserContext:
+        context = await browser_type.launch_persistent_context(
+            str(tmp_path),
+            **launch_arguments,
+            **kwargs,
+            args=[
+                f"--disable-extensions-except={extension_path}",
+                f"--load-extension={extension_path}",
+            ],
+        )
+        contexts.append(context)
+        return context
+
+    yield launch
+
+    for context in contexts:
+        await context.close()
+
+
+@pytest.mark.only_browser("chromium")
+async def test_should_give_access_to_the_service_worker(
+    launch_persistent_context: Callable[..., Awaitable[BrowserContext]],
+    assetdir: Path,
+) -> None:
+    extension_path = str(assetdir / "extension-mv3-simple")
+    context = await launch_persistent_context(extension_path)
+    service_workers = context.service_workers
+    service_worker = (
+        service_workers[0]
+        if len(service_workers)
+        else await context.wait_for_event("serviceworker")
+    )
+    assert service_worker
+    assert service_worker in context.service_workers
+    while not await service_worker.evaluate("globalThis.MAGIC") == 42:
+        await context.pages[0].wait_for_timeout(100)
+    await context.close()
+    assert len(context.background_pages) == 0
+
+
+@pytest.mark.only_browser("chromium")
+async def test_should_give_access_to_the_service_worker_when_recording_video(
+    launch_persistent_context: Callable[..., Awaitable[BrowserContext]],
+    tmp_path: Path,
+    assetdir: Path,
+) -> None:
+    extension_path = str(assetdir / "extension-mv3-simple")
+    context = await launch_persistent_context(
+        extension_path, record_video_dir=(tmp_path / "videos")
+    )
+    service_workers = context.service_workers
+    service_worker = (
+        service_workers[0]
+        if len(service_workers)
+        else await context.wait_for_event("serviceworker")
+    )
+    assert service_worker
+    assert service_worker in context.service_workers
+    while not await service_worker.evaluate("globalThis.MAGIC") == 42:
+        await context.pages[0].wait_for_timeout(100)
+    await context.close()
+    assert len(context.background_pages) == 0
+
+
+# https://github.com/microsoft/playwright/issues/32762
+@pytest.mark.only_browser("chromium")
+async def test_should_report_console_messages_from_content_script(
+    launch_persistent_context: Callable[..., Awaitable[BrowserContext]],
+    assetdir: Path,
+    server: Server,
+) -> None:
+    extension_path = str(assetdir / "extension-mv3-with-logging")
+    context = await launch_persistent_context(extension_path)
+    page = await context.new_page()
+    [message, _] = await asyncio.gather(
+        page.context.wait_for_event(
+            "console",
+            lambda e: "Test console log from a third-party execution context" in e.text,
+        ),
+        page.goto(server.EMPTY_PAGE),
+    )
+    assert "Test console log from a third-party execution context" in message.text
+    await context.close()
diff --git a/tests/async/test_launcher.py b/tests/async/test_launcher.py
index 1b974725b..bd5dd82de 100644
--- a/tests/async/test_launcher.py
+++ b/tests/async/test_launcher.py
@@ -15,7 +15,7 @@
 import asyncio
 import os
 from pathlib import Path
-from typing import Dict, Optional
+from typing import Dict
 
 import pytest
 
@@ -107,39 +107,3 @@ async def test_browser_close_should_be_callable_twice(
         browser.close(),
     )
     await browser.close()
-
-
-@pytest.mark.only_browser("chromium")
-async def test_browser_launch_should_return_background_pages(
-    browser_type: BrowserType,
-    tmp_path: Path,
-    browser_channel: Optional[str],
-    assetdir: Path,
-    launch_arguments: Dict,
-) -> None:
-    if browser_channel:
-        pytest.skip()
-
-    extension_path = str(assetdir / "simple-extension")
-    context = await browser_type.launch_persistent_context(
-        str(tmp_path),
-        **{
-            **launch_arguments,
-            "headless": False,
-            "args": [
-                f"--disable-extensions-except={extension_path}",
-                f"--load-extension={extension_path}",
-            ],
-        },
-    )
-    background_page = None
-    if len(context.background_pages):
-        background_page = context.background_pages[0]
-    else:
-        background_page = await context.wait_for_event("backgroundpage")
-    assert background_page
-    assert background_page in context.background_pages
-    assert background_page not in context.pages
-    await context.close()
-    assert len(context.background_pages) == 0
-    assert len(context.pages) == 0
diff --git a/tests/async/test_page_route.py b/tests/async/test_page_route.py
index fecafdfba..b561af0a2 100644
--- a/tests/async/test_page_route.py
+++ b/tests/async/test_page_route.py
@@ -1128,6 +1128,23 @@ def glob_to_regex(pattern: str) -> re.Pattern:
         "http://playwright.dev/foo/", "http://playwright.dev/foo/bar?x=y", "./bar?x=y"
     )
 
+    # Case insensitive matching
+    assert url_matches(
+        None, "https://playwright.dev/fooBAR", "HtTpS://pLaYwRiGhT.dEv/fooBAR"
+    )
+    assert url_matches(
+        "http://ignored",
+        "https://playwright.dev/fooBAR",
+        "HtTpS://pLaYwRiGhT.dEv/fooBAR",
+    )
+    # Path and search query are case-sensitive
+    assert not url_matches(
+        None, "https://playwright.dev/foobar", "https://playwright.dev/fooBAR"
+    )
+    assert not url_matches(
+        None, "https://playwright.dev/foobar?a=b", "https://playwright.dev/foobar?A=B"
+    )
+
     # This is not supported, we treat ? as a query separator.
     assert not url_matches(
         None,
diff --git a/tests/async/test_tracing.py b/tests/async/test_tracing.py
index e902eafbd..cbd282820 100644
--- a/tests/async/test_tracing.py
+++ b/tests/async/test_tracing.py
@@ -385,6 +385,5 @@ async def test_should_show_tracing_group_in_action_list(
                 re.compile(r"inner group 1"),
                 re.compile(r"Click"),
                 re.compile(r"inner group 2"),
-                re.compile(r"Is visible"),
             ]
         )
diff --git a/tests/sync/test_extension.py b/tests/sync/test_extension.py
new file mode 100644
index 000000000..2cb8aee77
--- /dev/null
+++ b/tests/sync/test_extension.py
@@ -0,0 +1,101 @@
+# 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 pathlib import Path
+from typing import Any, Callable, Dict, Generator, List, Optional
+
+import pytest
+
+from playwright.sync_api import BrowserContext, BrowserType
+
+
+@pytest.fixture()
+def launch_persistent_context(
+    browser_type: BrowserType,
+    browser_channel: Optional[str],
+    tmp_path: Path,
+    launch_arguments: Dict[str, Any],
+    is_headless_shell: bool,
+) -> Generator[Callable[..., BrowserContext], None, None]:
+    if browser_channel and browser_channel.startswith("chrome"):
+        pytest.skip(
+            "--load-extension is not supported in Chrome anymore. https://groups.google.com/a/chromium.org/g/chromium-extensions/c/1-g8EFx2BBY/m/S0ET5wPjCAAJ"
+        )
+    if is_headless_shell:
+        pytest.skip("Headless Shell has no support for extensions")
+
+    contexts: List[BrowserContext] = []
+
+    def launch(extension_path: str, **kwargs: Any) -> BrowserContext:
+        context = browser_type.launch_persistent_context(
+            str(tmp_path),
+            **launch_arguments,
+            **kwargs,
+            args=[
+                f"--disable-extensions-except={extension_path}",
+                f"--load-extension={extension_path}",
+            ],
+        )
+        contexts.append(context)
+        return context
+
+    yield launch
+
+    for context in contexts:
+        context.close()
+
+
+@pytest.mark.only_browser("chromium")
+def test_should_give_access_to_the_service_worker(
+    launch_persistent_context: Callable[..., BrowserContext],
+    assetdir: Path,
+) -> None:
+    extension_path = str(assetdir / "extension-mv3-simple")
+    context = launch_persistent_context(extension_path)
+    service_workers = context.service_workers
+    service_worker = (
+        service_workers[0]
+        if len(service_workers)
+        else context.wait_for_event("serviceworker")
+    )
+    assert service_worker
+    assert service_worker in context.service_workers
+    while not service_worker.evaluate("globalThis.MAGIC") == 42:
+        context.pages[0].wait_for_timeout(100)
+    context.close()
+    assert len(context.background_pages) == 0
+
+
+@pytest.mark.only_browser("chromium")
+def test_should_give_access_to_the_service_worker_when_recording_video(
+    launch_persistent_context: Callable[..., BrowserContext],
+    tmp_path: Path,
+    assetdir: Path,
+) -> None:
+    extension_path = str(assetdir / "extension-mv3-simple")
+    context = launch_persistent_context(
+        extension_path, record_video_dir=(tmp_path / "videos")
+    )
+    service_workers = context.service_workers
+    service_worker = (
+        service_workers[0]
+        if len(service_workers)
+        else context.wait_for_event("serviceworker")
+    )
+    assert service_worker
+    assert service_worker in context.service_workers
+    while not service_worker.evaluate("globalThis.MAGIC") == 42:
+        context.pages[0].wait_for_timeout(100)
+    context.close()
+    assert len(context.background_pages) == 0
diff --git a/tests/sync/test_launcher.py b/tests/sync/test_launcher.py
index 52deeb827..2e5ec1573 100644
--- a/tests/sync/test_launcher.py
+++ b/tests/sync/test_launcher.py
@@ -14,7 +14,7 @@
 
 import os
 from pathlib import Path
-from typing import Dict, Optional
+from typing import Dict
 
 import pytest
 
@@ -88,39 +88,3 @@ def test_browser_close_should_be_callable_twice(
     browser = browser_type.launch(**launch_arguments)
     browser.close()
     browser.close()
-
-
-@pytest.mark.only_browser("chromium")
-def test_browser_launch_should_return_background_pages(
-    browser_type: BrowserType,
-    tmp_path: Path,
-    browser_channel: Optional[str],
-    assetdir: Path,
-    launch_arguments: Dict,
-) -> None:
-    if browser_channel:
-        pytest.skip()
-
-    extension_path = str(assetdir / "simple-extension")
-    context = browser_type.launch_persistent_context(
-        str(tmp_path),
-        **{
-            **launch_arguments,
-            "headless": False,
-            "args": [
-                f"--disable-extensions-except={extension_path}",
-                f"--load-extension={extension_path}",
-            ],
-        },
-    )
-    background_page = None
-    if len(context.background_pages):
-        background_page = context.background_pages[0]
-    else:
-        background_page = context.wait_for_event("backgroundpage")
-    assert background_page
-    assert background_page in context.background_pages
-    assert background_page not in context.pages
-    context.close()
-    assert len(context.background_pages) == 0
-    assert len(context.pages) == 0
diff --git a/tests/sync/test_tracing.py b/tests/sync/test_tracing.py
index 8d0eaa191..ce26600e5 100644
--- a/tests/sync/test_tracing.py
+++ b/tests/sync/test_tracing.py
@@ -386,6 +386,5 @@ def test_should_show_tracing_group_in_action_list(
                 re.compile(r"inner group 1"),
                 re.compile(r"Click"),
                 re.compile(r"inner group 2"),
-                re.compile(r"Is visible"),
             ]
         )

From 4a03d717fa82f1daed6d5f1dab505e8cd06aa8f2 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Thu, 28 Aug 2025 11:27:29 +0200
Subject: [PATCH 421/438] chore(roll): roll Playwright to
 1.55.0-beta-1756314050000 (#2960)

---
 ROLLING.md | 10 ++++++----
 setup.py   |  2 +-
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/ROLLING.md b/ROLLING.md
index f5f500a3f..811d7fcb3 100644
--- a/ROLLING.md
+++ b/ROLLING.md
@@ -5,10 +5,12 @@
     * create virtual environment, if don't have one: `python -m venv env`
 * activate venv: `source env/bin/activate`
 * install all deps:
-     - `python -m pip install --upgrade pip`
-     - `pip install -r local-requirements.txt`
-     - `pre-commit install`
-     - `pip install -e .`
+```
+python -m pip install --upgrade pip
+pip install -r local-requirements.txt
+pre-commit install
+pip install -e .
+```
 * change driver version in `setup.py`
 * download new driver: `python -m build --wheel`
 * generate API: `./scripts/update_api.sh`
diff --git a/setup.py b/setup.py
index d147f3be7..543395520 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.55.0"
+driver_version = "1.55.0-beta-1756314050000"
 
 base_wheel_bundles = [
     {

From e93c23a33ab2b3b8c7168031986702ae39473d89 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 2 Sep 2025 17:52:38 +0200
Subject: [PATCH 422/438] build(deps): bump requests from 2.32.4 to 2.32.5
 (#2962)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 2f4f0d488..ac7d4a464 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -15,7 +15,7 @@ pytest-repeat==0.9.4
 pytest-rerunfailures==15.1
 pytest-timeout==2.4.0
 pytest-xdist==3.8.0
-requests==2.32.4
+requests==2.32.5
 service_identity==24.2.0
 twisted==25.5.0
 types-pyOpenSSL==24.1.0.20240722

From 3763d818a09ad2f47f8be9a8e8c2c404ce2a3a2a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 8 Sep 2025 23:16:55 +0200
Subject: [PATCH 423/438] build(deps): bump actions/setup-python from 5 to 6 in
 the actions group (#2969)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/ci.yml             | 8 ++++----
 .github/workflows/publish_docker.yml | 2 +-
 .github/workflows/test_docker.yml    | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 200b2a65a..65ba1f433 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -23,7 +23,7 @@ jobs:
     steps:
     - uses: actions/checkout@v5
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.10"
     - name: Install dependencies & browsers
@@ -82,7 +82,7 @@ jobs:
     steps:
     - uses: actions/checkout@v5
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies & browsers
@@ -129,7 +129,7 @@ jobs:
     steps:
     - uses: actions/checkout@v5
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.10"
     - name: Install dependencies & browsers
@@ -186,7 +186,7 @@ jobs:
     steps:
     - uses: actions/checkout@v5
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.10'
     - name: Install dependencies & browsers
diff --git a/.github/workflows/publish_docker.yml b/.github/workflows/publish_docker.yml
index 7c2b73e13..7494f1abc 100644
--- a/.github/workflows/publish_docker.yml
+++ b/.github/workflows/publish_docker.yml
@@ -25,7 +25,7 @@ jobs:
     - name: Login to ACR via OIDC
       run: az acr login --name playwright
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.10"
     - name: Set up Docker QEMU for arm64 docker builds
diff --git a/.github/workflows/test_docker.yml b/.github/workflows/test_docker.yml
index e5252e389..464eb3b46 100644
--- a/.github/workflows/test_docker.yml
+++ b/.github/workflows/test_docker.yml
@@ -32,7 +32,7 @@ jobs:
     steps:
     - uses: actions/checkout@v5
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.10"
     - name: Install dependencies

From e43199cd3d108073ed90266f082fbc1749e0219a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 9 Sep 2025 10:50:46 +0200
Subject: [PATCH 424/438] build(deps): bump pillow from 11.2.1 to 11.3.0 in the
 pip group (#2908)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index ac7d4a464..1dc49533b 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -4,7 +4,7 @@ build==1.3.0
 flake8==7.2.0
 mypy==1.17.1
 objgraph==3.6.2
-Pillow==11.2.1
+Pillow==11.3.0
 pixelmatch==0.3.0
 pre-commit==3.5.0
 pyOpenSSL==25.1.0

From 8ab311b6a692f5ff311f028bca5851cd5ae0ad3c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 9 Sep 2025 10:51:22 +0200
Subject: [PATCH 425/438] build(deps): bump pytest-cov from 6.2.1 to 6.3.0
 (#2968)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 local-requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/local-requirements.txt b/local-requirements.txt
index 1dc49533b..8a72b5745 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -10,7 +10,7 @@ pre-commit==3.5.0
 pyOpenSSL==25.1.0
 pytest==8.4.1
 pytest-asyncio==1.1.0
-pytest-cov==6.2.1
+pytest-cov==6.3.0
 pytest-repeat==0.9.4
 pytest-rerunfailures==15.1
 pytest-timeout==2.4.0

From 6fa9500cf051f9abb2b21af7725fa7d1e951a8bb Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 9 Sep 2025 11:51:24 +0200
Subject: [PATCH 426/438] chore: fix api generation under Python 3.13 (#2970)

---
 scripts/documentation_provider.py | 3 +++
 scripts/generate_api.py           | 1 +
 2 files changed, 4 insertions(+)

diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 6ea931fac..a842a1aad 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import json
+import pathlib
 import re
 import subprocess
 from sys import stderr
@@ -359,6 +360,8 @@ def serialize_python_type(self, value: Any, direction: str) -> str:
         match = re.match(r"^<class '((?:pathlib\.)?\w+)'>$", str_value)
         if match:
             return match.group(1)
+        if str_value == str(pathlib.Path):
+            return "pathlib.Path"
         match = re.match(
             r"playwright._impl._event_context_manager.EventContextManagerImpl\[playwright._impl.[^.]+.(.*)\]",
             str_value,
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index 01f8f525a..b0e7e2a32 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -57,6 +57,7 @@
 
 def process_type(value: Any, param: bool = False) -> str:
     value = str(value)
+    value = re.sub("pathlib._local.Path", "pathlib.Path", value)
     value = re.sub(r"<class '([^']+)'>", r"\1", value)
     value = re.sub(r"NoneType", "None", value)
     value = re.sub(r"playwright\._impl\._api_structures.([\w]+)", r"\1", value)

From db390c6e826029c0863a1dce5ca2cda44c54fede Mon Sep 17 00:00:00 2001
From: Adam Gastineau <adam@agg.im>
Date: Mon, 6 Oct 2025 06:19:07 -0700
Subject: [PATCH 427/438] chore: roll to 1.56.0 (#2986)

---
 README.md                                |  4 +-
 playwright/_impl/_api_structures.py      |  1 +
 playwright/_impl/_assertions.py          |  4 +-
 playwright/_impl/_browser_context.py     | 12 +----
 playwright/_impl/_glob.py                | 12 +----
 playwright/_impl/_page.py                | 20 +++++++-
 playwright/async_api/_generated.py       | 65 +++++++++++++++++-------
 playwright/sync_api/_generated.py        | 65 +++++++++++++++++-------
 setup.py                                 |  2 +-
 tests/async/test_assertions.py           |  8 +--
 tests/async/test_console.py              |  2 +-
 tests/async/test_page_aria_snapshot.py   | 10 ++++
 tests/async/test_page_event_console.py   | 35 +++++++++++++
 tests/async/test_page_event_pageerror.py | 36 +++++++++++++
 tests/async/test_page_event_request.py   | 62 ++++++++++++++++++++++
 tests/async/test_page_route.py           | 12 +++--
 tests/sync/test_assertions.py            |  8 +--
 tests/sync/test_console.py               |  5 +-
 18 files changed, 286 insertions(+), 77 deletions(-)
 create mode 100644 tests/async/test_page_event_console.py
 create mode 100644 tests/async/test_page_event_pageerror.py
 create mode 100644 tests/async/test_page_event_request.py

diff --git a/README.md b/README.md
index cf85c6116..b54d5a364 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 -->140.0.7339.16<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->141.0.7390.37<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->26.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->141.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->142.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index 0afa0d02e..c0d0ee442 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -218,6 +218,7 @@ class FrameExpectResult(TypedDict):
     matches: bool
     received: Any
     log: List[str]
+    errorMessage: Optional[str]
 
 
 AriaRole = Literal[
diff --git a/playwright/_impl/_assertions.py b/playwright/_impl/_assertions.py
index 3aadbf5fe..aea37d35c 100644
--- a/playwright/_impl/_assertions.py
+++ b/playwright/_impl/_assertions.py
@@ -80,8 +80,10 @@ async def _expect_impl(
                 out_message = (
                     f"{message} '{expected}'" if expected is not None else f"{message}"
                 )
+            error_message = result.get("errorMessage")
+            error_message = f"\n{error_message}" if error_message else ""
             raise AssertionError(
-                f"{out_message}\nActual value: {actual} {format_call_log(result.get('log'))}"
+                f"{out_message}\nActual value: {actual}{error_message} {format_call_log(result.get('log'))}"
             )
 
 
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 391e61ec6..bab7d1bf1 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -88,6 +88,7 @@
 
 class BrowserContext(ChannelOwner):
     Events = SimpleNamespace(
+        # Deprecated in v1.56, never emitted anymore.
         BackgroundPage="backgroundpage",
         Close="close",
         Console="console",
@@ -117,7 +118,6 @@ def __init__(
         self._timeout_settings = TimeoutSettings(None)
         self._owner_page: Optional[Page] = None
         self._options: Dict[str, Any] = initializer["options"]
-        self._background_pages: Set[Page] = set()
         self._service_workers: Set[Worker] = set()
         self._base_url: Optional[str] = self._options.get("baseURL")
         self._videos_dir: Optional[str] = self._options.get("recordVideo")
@@ -149,10 +149,6 @@ def __init__(
                 )
             ),
         )
-        self._channel.on(
-            "backgroundPage",
-            lambda params: self._on_background_page(from_channel(params["page"])),
-        )
 
         self._channel.on(
             "serviceWorker",
@@ -658,10 +654,6 @@ def expect_page(
     ) -> EventContextManagerImpl[Page]:
         return self.expect_event(BrowserContext.Events.Page, predicate, timeout)
 
-    def _on_background_page(self, page: Page) -> None:
-        self._background_pages.add(page)
-        self.emit(BrowserContext.Events.BackgroundPage, page)
-
     def _on_service_worker(self, worker: Worker) -> None:
         worker._context = self
         self._service_workers.add(worker)
@@ -736,7 +728,7 @@ def _on_response(self, response: Response, page: Optional[Page]) -> None:
 
     @property
     def background_pages(self) -> List[Page]:
-        return list(self._background_pages)
+        return []
 
     @property
     def service_workers(self) -> List[Worker]:
diff --git a/playwright/_impl/_glob.py b/playwright/_impl/_glob.py
index 08b7ce466..a0e6dcd4b 100644
--- a/playwright/_impl/_glob.py
+++ b/playwright/_impl/_glob.py
@@ -28,20 +28,12 @@ def glob_to_regex_pattern(glob: str) -> str:
             tokens.append("\\" + char if char in escaped_chars else char)
             i += 1
         elif c == "*":
-            before_deep = 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
-            after_deep = glob[i + 1] if i + 1 < len(glob) else None
-            is_deep = (
-                star_count > 1
-                and (before_deep == "/" or before_deep is None)
-                and (after_deep == "/" or after_deep is None)
-            )
-            if is_deep:
-                tokens.append("((?:[^/]*(?:/|$))*)")
-                i += 1
+            if star_count > 1:
+                tokens.append("(.*)")
             else:
                 tokens.append("([^/]*)")
         else:
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 1019b2f6e..29a583a7c 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -79,6 +79,7 @@
     async_writefile,
     locals_to_params,
     make_dirs_for_file,
+    parse_error,
     serialize_error,
     url_matches,
 )
@@ -344,8 +345,6 @@ def _on_close(self) -> None:
         self._is_closed = True
         if self in self._browser_context._pages:
             self._browser_context._pages.remove(self)
-        if self in self._browser_context._background_pages:
-            self._browser_context._background_pages.remove(self)
         self._dispose_har_routers()
         self.emit(Page.Events.Close, self)
 
@@ -1434,6 +1433,23 @@ async def remove_locator_handler(self, locator: "Locator") -> None:
                     {"uid": uid},
                 )
 
+    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)
+        return [
+            ConsoleMessage(
+                {**event, "page": self._channel}, self._loop, self._dispatcher_fiber
+            )
+            for event in message_dicts
+        ]
+
+    async def page_errors(self) -> List[Error]:
+        error_objects = await self._channel.send("pageErrors", None)
+        return [parse_error(error["error"]) for error in error_objects]
+
 
 class Worker(ChannelOwner):
     Events = SimpleNamespace(Close="close")
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index bdda2b2b0..71f5aff82 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -12254,6 +12254,49 @@ async def remove_locator_handler(self, locator: "Locator") -> None:
             await self._impl_obj.remove_locator_handler(locator=locator._impl_obj)
         )
 
+    async def requests(self) -> typing.List["Request"]:
+        """Page.requests
+
+        Returns up to (currently) 100 last network request from this page. See `page.on('request')` for more details.
+
+        Returned requests should be accessed immediately, otherwise they might be collected to prevent unbounded memory
+        growth as new requests come in. Once collected, retrieving most information about the request is impossible.
+
+        Note that requests reported through the `page.on('request')` request are not collected, so there is a trade off
+        between efficient memory usage with `page.requests()` and the amount of available information reported
+        through `page.on('request')`.
+
+        Returns
+        -------
+        List[Request]
+        """
+
+        return mapping.from_impl_list(await self._impl_obj.requests())
+
+    async def console_messages(self) -> typing.List["ConsoleMessage"]:
+        """Page.console_messages
+
+        Returns up to (currently) 200 last console messages from this page. See `page.on('console')` for more details.
+
+        Returns
+        -------
+        List[ConsoleMessage]
+        """
+
+        return mapping.from_impl_list(await self._impl_obj.console_messages())
+
+    async def page_errors(self) -> 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.
+
+        Returns
+        -------
+        List[Error]
+        """
+
+        return mapping.from_impl_list(await self._impl_obj.page_errors())
+
 
 mapping.register(PageImpl, Page)
 
@@ -12297,13 +12340,7 @@ def on(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        **NOTE** Only works with Chromium browser's persistent context.
-
-        Emitted when new background page is created in the context.
-
-        ```py
-        background_page = await context.wait_for_event(\"backgroundpage\")
-        ```"""
+        This event is not emitted."""
 
     @typing.overload
     def on(
@@ -12477,13 +12514,7 @@ def once(
         f: typing.Callable[["Page"], "typing.Union[typing.Awaitable[None], None]"],
     ) -> None:
         """
-        **NOTE** Only works with Chromium browser's persistent context.
-
-        Emitted when new background page is created in the context.
-
-        ```py
-        background_page = await context.wait_for_event(\"backgroundpage\")
-        ```"""
+        This event is not emitted."""
 
     @typing.overload
     def once(
@@ -12679,9 +12710,7 @@ def browser(self) -> typing.Optional["Browser"]:
     def background_pages(self) -> typing.List["Page"]:
         """BrowserContext.background_pages
 
-        **NOTE** Background pages are only supported on Chromium-based browsers.
-
-        All existing background pages in the context.
+        Returns an empty list.
 
         Returns
         -------
@@ -16617,7 +16646,7 @@ def and_(self, locator: "Locator") -> "Locator":
         The following example finds a button with a specific title.
 
         ```py
-        button = page.get_by_role(\"button\").and_(page.getByTitle(\"Subscribe\"))
+        button = page.get_by_role(\"button\").and_(page.get_by_title(\"Subscribe\"))
         ```
 
         Parameters
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 83fedfbe9..024014c51 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -12342,6 +12342,49 @@ def remove_locator_handler(self, locator: "Locator") -> None:
             self._sync(self._impl_obj.remove_locator_handler(locator=locator._impl_obj))
         )
 
+    def requests(self) -> typing.List["Request"]:
+        """Page.requests
+
+        Returns up to (currently) 100 last network request from this page. See `page.on('request')` for more details.
+
+        Returned requests should be accessed immediately, otherwise they might be collected to prevent unbounded memory
+        growth as new requests come in. Once collected, retrieving most information about the request is impossible.
+
+        Note that requests reported through the `page.on('request')` request are not collected, so there is a trade off
+        between efficient memory usage with `page.requests()` and the amount of available information reported
+        through `page.on('request')`.
+
+        Returns
+        -------
+        List[Request]
+        """
+
+        return mapping.from_impl_list(self._sync(self._impl_obj.requests()))
+
+    def console_messages(self) -> typing.List["ConsoleMessage"]:
+        """Page.console_messages
+
+        Returns up to (currently) 200 last console messages from this page. See `page.on('console')` for more details.
+
+        Returns
+        -------
+        List[ConsoleMessage]
+        """
+
+        return mapping.from_impl_list(self._sync(self._impl_obj.console_messages()))
+
+    def page_errors(self) -> 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.
+
+        Returns
+        -------
+        List[Error]
+        """
+
+        return mapping.from_impl_list(self._sync(self._impl_obj.page_errors()))
+
 
 mapping.register(PageImpl, Page)
 
@@ -12383,13 +12426,7 @@ def on(
         self, event: Literal["backgroundpage"], f: typing.Callable[["Page"], "None"]
     ) -> None:
         """
-        **NOTE** Only works with Chromium browser's persistent context.
-
-        Emitted when new background page is created in the context.
-
-        ```py
-        background_page = context.wait_for_event(\"backgroundpage\")
-        ```"""
+        This event is not emitted."""
 
     @typing.overload
     def on(
@@ -12529,13 +12566,7 @@ def once(
         self, event: Literal["backgroundpage"], f: typing.Callable[["Page"], "None"]
     ) -> None:
         """
-        **NOTE** Only works with Chromium browser's persistent context.
-
-        Emitted when new background page is created in the context.
-
-        ```py
-        background_page = context.wait_for_event(\"backgroundpage\")
-        ```"""
+        This event is not emitted."""
 
     @typing.overload
     def once(
@@ -12701,9 +12732,7 @@ def browser(self) -> typing.Optional["Browser"]:
     def background_pages(self) -> typing.List["Page"]:
         """BrowserContext.background_pages
 
-        **NOTE** Background pages are only supported on Chromium-based browsers.
-
-        All existing background pages in the context.
+        Returns an empty list.
 
         Returns
         -------
@@ -16680,7 +16709,7 @@ def and_(self, locator: "Locator") -> "Locator":
         The following example finds a button with a specific title.
 
         ```py
-        button = page.get_by_role(\"button\").and_(page.getByTitle(\"Subscribe\"))
+        button = page.get_by_role(\"button\").and_(page.get_by_title(\"Subscribe\"))
         ```
 
         Parameters
diff --git a/setup.py b/setup.py
index 543395520..c2a56354b 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.55.0-beta-1756314050000"
+driver_version = "1.56.0-beta-1759412259000"
 
 base_wheel_bundles = [
     {
diff --git a/tests/async/test_assertions.py b/tests/async/test_assertions.py
index 3213e5523..49e3c3e7f 100644
--- a/tests/async/test_assertions.py
+++ b/tests/async/test_assertions.py
@@ -516,7 +516,7 @@ async def test_to_have_values_fails_when_multiple_not_specified(
     )
     locator = page.locator("select")
     await locator.select_option(["B"])
-    with pytest.raises(Error) as excinfo:
+    with pytest.raises(AssertionError) as excinfo:
         await expect(locator).to_have_values(["R", "G"], timeout=500)
     assert "Error: Not a select element with a multiple attribute" in str(excinfo.value)
 
@@ -530,7 +530,7 @@ async def test_to_have_values_fails_when_not_a_select_element(
     """
     )
     locator = page.locator("input")
-    with pytest.raises(Error) as excinfo:
+    with pytest.raises(AssertionError) as excinfo:
         await expect(locator).to_have_values(["R", "G"], timeout=500)
     assert "Error: Not a select element with a multiple attribute" in str(excinfo.value)
 
@@ -564,7 +564,7 @@ async def test_assertions_boolean_checked_with_intermediate_true_and_checked(
     await page.set_content("<input type=checkbox></input>")
     await page.locator("input").evaluate("e => e.indeterminate = true")
     with pytest.raises(
-        Error, match="Can't assert indeterminate and checked at the same time"
+        AssertionError, match="Can't assert indeterminate and checked at the same time"
     ):
         await expect(page.locator("input")).to_be_checked(
             checked=False, indeterminate=True
@@ -658,7 +658,7 @@ async def test_assertions_locator_to_be_editable_throws(
     await page.goto(server.EMPTY_PAGE)
     await page.set_content("<button disabled>Text</button>")
     with pytest.raises(
-        Error,
+        AssertionError,
         match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
     ):
         await expect(page.locator("button")).not_to_be_editable()
diff --git a/tests/async/test_console.py b/tests/async/test_console.py
index b9a4102a8..5952d1caa 100644
--- a/tests/async/test_console.py
+++ b/tests/async/test_console.py
@@ -107,7 +107,7 @@ async def test_console_should_trigger_correct_log(page: Page, server: Server) ->
     async with page.expect_console_message() as message_info:
         await page.evaluate("async url => fetch(url).catch(e => {})", server.EMPTY_PAGE)
     message = await message_info.value
-    assert "Access-Control-Allow-Origin" in message.text
+    assert "Access-Control-Allow-Origin" in message.text or "CORS" in message.text
     assert message.type == "error"
 
 
diff --git a/tests/async/test_page_aria_snapshot.py b/tests/async/test_page_aria_snapshot.py
index 30a9c9661..cef17cdd0 100644
--- a/tests/async/test_page_aria_snapshot.py
+++ b/tests/async/test_page_aria_snapshot.py
@@ -204,3 +204,13 @@ async def test_should_snapshot_with_restored_contain_mode_inside_deep_equal(
               - listitem: 1.1
       """,
     )
+
+
+async def test_match_values_both_against_regex_and_string(page: Page) -> None:
+    await page.set_content('<a href="/auth?r=/">Log in</a>')
+    await expect(page.locator("body")).to_match_aria_snapshot(
+        """
+        - link "Log in":
+          - /url: /auth?r=/
+      """,
+    )
diff --git a/tests/async/test_page_event_console.py b/tests/async/test_page_event_console.py
new file mode 100644
index 000000000..4326e1823
--- /dev/null
+++ b/tests/async/test_page_event_console.py
@@ -0,0 +1,35 @@
+# 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._impl._page import Page
+
+
+async def test_console_messages_should_work(page: Page) -> None:
+    await page.evaluate(
+        """() => {
+            for (let i = 0; i < 301; i++)
+                console.log('message' + i);
+        }"""
+    )
+
+    messages = await page.console_messages()
+    objects = [{"text": m.text, "type": m.type, "page": m.page} for m in messages]
+
+    expected = []
+    for i in range(201, 301):
+        expected.append({"text": f"message{i}", "type": "log", "page": page})
+
+    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"
diff --git a/tests/async/test_page_event_pageerror.py b/tests/async/test_page_event_pageerror.py
new file mode 100644
index 000000000..4914af5d1
--- /dev/null
+++ b/tests/async/test_page_event_pageerror.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.
+
+from playwright.async_api import Page
+
+
+async def test_page_errors_should_work(page: Page) -> None:
+    await page.evaluate(
+        """async () => {
+            for (let i = 0; i < 301; i++)
+                window.setTimeout(() => { throw new Error('error' + i); }, 0);
+            await new Promise(f => window.setTimeout(f, 100));
+        }"""
+    )
+
+    errors = await page.page_errors()
+    messages = [e.message for e in errors]
+
+    expected = []
+    for i in range(201, 301):
+        expected.append(f"error{i}")
+
+    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"
diff --git a/tests/async/test_page_event_request.py b/tests/async/test_page_event_request.py
new file mode 100644
index 000000000..73d6fd785
--- /dev/null
+++ b/tests/async/test_page_event_request.py
@@ -0,0 +1,62 @@
+# 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._impl._network import Request, Route
+from playwright._impl._page import Page
+from tests.server import Server
+
+
+async def test_should_return_last_requests(page: Page, server: Server) -> None:
+    await page.goto(server.PREFIX + "/title.html")
+    for i in range(200):
+
+        def _handle_route(route: Route) -> None:
+            asyncio.ensure_future(
+                route.fulfill(
+                    status=200,
+                    body=f"url:{route.request.url}",
+                )
+            )
+
+        await page.route(f"**/fetch?{i}", _handle_route)
+
+    # #0 is the navigation request, so start with #1.
+    for i in range(1, 100):
+        await page.evaluate("url => fetch(url)", server.PREFIX + f"/fetch?{i}")
+    first_100_requests_with_goto = await page.requests()
+    first_100_requests = first_100_requests_with_goto[1:]
+
+    for i in range(100, 200):
+        await page.evaluate("url => fetch(url)", server.PREFIX + f"/fetch?{i}")
+    last_100_requests = await page.requests()
+
+    all_requests = first_100_requests + last_100_requests
+
+    async def gather_response(request: Request) -> dict:
+        response = await request.response()
+        assert response
+        return {"text": await response.text(), "url": request.url}
+
+    # All 199 requests are fully functional.
+    received = await asyncio.gather(
+        *[gather_response(request) for request in all_requests]
+    )
+
+    expected = []
+    for i in range(1, 200):
+        url = server.PREFIX + f"/fetch?{i}"
+        expected.append({"url": url, "text": f"url:{url}"})
+    assert received == expected
diff --git a/tests/async/test_page_route.py b/tests/async/test_page_route.py
index b561af0a2..db46c330d 100644
--- a/tests/async/test_page_route.py
+++ b/tests/async/test_page_route.py
@@ -529,12 +529,10 @@ def _handle(route: Route) -> None:
 
     await page.route("**/*", _handle)
 
-    response = await page.goto(
+    await page.set_content(
         f"""data:text/html,<link rel="stylesheet" href="{server.PREFIX}/fonts?helvetica|arial"/>"""
     )
-    assert response is None
-    # TODO: https://github.com/microsoft/playwright/issues/12789
-    assert len(requests) >= 1
+    assert len(requests) == 1
     assert (must(await requests[0].response())).status == 404
 
 
@@ -1145,6 +1143,10 @@ def glob_to_regex(pattern: str) -> re.Pattern:
         None, "https://playwright.dev/foobar?a=b", "https://playwright.dev/foobar?A=B"
     )
 
+    assert url_matches(None, "https://localhost:3000/?a=b", "**/?a=b")
+    assert url_matches(None, "https://localhost:3000/?a=b", "**?a=b")
+    assert url_matches(None, "https://localhost:3000/?a=b", "**=b")
+
     # This is not supported, we treat ? as a query separator.
     assert not url_matches(
         None,
@@ -1190,7 +1192,7 @@ def glob_to_regex(pattern: str) -> re.Pattern:
         "custom://example.com/foo/bar?id=123",
         "{custom,another}://example.com/foo/bar?id=123",
     )
-    assert not url_matches(
+    assert url_matches(
         None, "custom://example.com/foo/bar?id=123", "**example.com/foo/bar?id=123"
     )
 
diff --git a/tests/sync/test_assertions.py b/tests/sync/test_assertions.py
index 740e6e750..0199f67df 100644
--- a/tests/sync/test_assertions.py
+++ b/tests/sync/test_assertions.py
@@ -492,7 +492,7 @@ def test_to_have_values_fails_when_multiple_not_specified(
     )
     locator = page.locator("select")
     locator.select_option(["B"])
-    with pytest.raises(Error) as excinfo:
+    with pytest.raises(AssertionError) as excinfo:
         expect(locator).to_have_values(["R", "G"], timeout=500)
     assert "Error: Not a select element with a multiple attribute" in str(excinfo.value)
 
@@ -506,7 +506,7 @@ def test_to_have_values_fails_when_not_a_select_element(
     """
     )
     locator = page.locator("input")
-    with pytest.raises(Error) as excinfo:
+    with pytest.raises(AssertionError) as excinfo:
         expect(locator).to_have_values(["R", "G"], timeout=500)
     assert "Error: Not a select element with a multiple attribute" in str(excinfo.value)
 
@@ -540,7 +540,7 @@ def test_assertions_boolean_checked_with_intermediate_true_and_checked(
     page.set_content("<input type=checkbox></input>")
     page.locator("input").evaluate("e => e.indeterminate = true")
     with pytest.raises(
-        Error, match="Can't assert indeterminate and checked at the same time"
+        AssertionError, match="Can't assert indeterminate and checked at the same time"
     ):
         expect(page.locator("input")).to_be_checked(checked=False, indeterminate=True)
 
@@ -626,7 +626,7 @@ def test_assertions_locator_to_be_editable_throws(page: Page, server: Server) ->
     page.goto(server.EMPTY_PAGE)
     page.set_content("<button disabled>Text</button>")
     with pytest.raises(
-        Error,
+        AssertionError,
         match=r"Element is not an <input>, <textarea>, <select> or \[contenteditable\] and does not have a role allowing \[aria-readonly\]",
     ):
         expect(page.locator("button")).not_to_be_editable()
diff --git a/tests/sync/test_console.py b/tests/sync/test_console.py
index 73cd9f659..8601ebbe5 100644
--- a/tests/sync/test_console.py
+++ b/tests/sync/test_console.py
@@ -109,7 +109,10 @@ def test_console_should_trigger_correct_Log(page: Page, server: Server) -> None:
     page.goto("about:blank")
     with page.expect_console_message() as message:
         page.evaluate("url => fetch(url).catch(e => {})", server.EMPTY_PAGE)
-    assert "Access-Control-Allow-Origin" in message.value.text
+    assert (
+        "Access-Control-Allow-Origin" in message.value.text
+        or "CORS" in message.value.text
+    )
     assert message.value.type == "error"
 
 

From f4ad602401631461f48256ef76f24231992639b0 Mon Sep 17 00:00:00 2001
From: ProgramRipper <programripper@foxmail.com>
Date: Tue, 7 Oct 2025 04:49:31 +0800
Subject: [PATCH 428/438] fix: remove duplicate callback addition (#2984)

---
 playwright/_impl/_connection.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index a837500b1..65bcf48c8 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -367,7 +367,6 @@ def _send_message_to_server(
             getattr(task, "__pw_stack_trace__", traceback.extract_stack(limit=10)),
         )
         callback.no_reply = no_reply
-        self._callbacks[id] = callback
         stack_trace_information = cast(ParsedStackTrace, self._api_zone.get())
         frames = stack_trace_information.get("frames", [])
         location = (
@@ -399,8 +398,8 @@ def _send_message_to_server(
         if self._tracing_count > 0 and frames and object._guid != "localUtils":
             self.local_utils.add_stack_to_tracing_no_reply(id, frames)
 
-        self._transport.send(message)
         self._callbacks[id] = callback
+        self._transport.send(message)
 
         return callback
 

From 4fb9e0701cbfb7a1da0971b073c593ed44ad0f80 Mon Sep 17 00:00:00 2001
From: Adam Gastineau <adam@agg.im>
Date: Mon, 6 Oct 2025 14:28:42 -0700
Subject: [PATCH 429/438] chore: add dupe sync tests for 1.56 roll (#2988)

---
 tests/sync/test_page_aria_snapshot.py   | 10 +++++
 tests/sync/test_page_event_console.py   | 36 +++++++++++++++++
 tests/sync/test_page_event_pageerror.py | 36 +++++++++++++++++
 tests/sync/test_page_event_request.py   | 54 +++++++++++++++++++++++++
 4 files changed, 136 insertions(+)
 create mode 100644 tests/sync/test_page_event_console.py
 create mode 100644 tests/sync/test_page_event_pageerror.py
 create mode 100644 tests/sync/test_page_event_request.py

diff --git a/tests/sync/test_page_aria_snapshot.py b/tests/sync/test_page_aria_snapshot.py
index e892bb371..17d722ae8 100644
--- a/tests/sync/test_page_aria_snapshot.py
+++ b/tests/sync/test_page_aria_snapshot.py
@@ -204,3 +204,13 @@ def test_should_snapshot_with_restored_contain_mode_inside_deep_equal(
               - listitem: 1.1
       """,
     )
+
+
+def test_match_values_both_against_regex_and_string(page: Page) -> None:
+    page.set_content('<a href="/auth?r=/">Log in</a>')
+    expect(page.locator("body")).to_match_aria_snapshot(
+        """
+        - link "Log in":
+          - /url: /auth?r=/
+      """,
+    )
diff --git a/tests/sync/test_page_event_console.py b/tests/sync/test_page_event_console.py
new file mode 100644
index 000000000..0ab19eca7
--- /dev/null
+++ b/tests/sync/test_page_event_console.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.
+
+
+from playwright.sync_api import Page
+
+
+def test_console_messages_should_work(page: Page) -> None:
+    page.evaluate(
+        """() => {
+            for (let i = 0; i < 301; i++)
+                console.log('message' + i);
+        }"""
+    )
+
+    messages = page.console_messages()
+    objects = [{"text": m.text, "type": m.type, "page": m.page} for m in messages]
+
+    expected = []
+    for i in range(201, 301):
+        expected.append({"text": f"message{i}", "type": "log", "page": page})
+
+    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"
diff --git a/tests/sync/test_page_event_pageerror.py b/tests/sync/test_page_event_pageerror.py
new file mode 100644
index 000000000..9295cb1b0
--- /dev/null
+++ b/tests/sync/test_page_event_pageerror.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.
+
+from playwright.sync_api import Page
+
+
+def test_page_errors_should_work(page: Page) -> None:
+    page.evaluate(
+        """async () => {
+            for (let i = 0; i < 301; i++)
+                window.setTimeout(() => { throw new Error('error' + i); }, 0);
+            await new Promise(f => window.setTimeout(f, 100));
+        }"""
+    )
+
+    errors = page.page_errors()
+    messages = [e.message for e in errors]
+
+    expected = []
+    for i in range(201, 301):
+        expected.append(f"error{i}")
+
+    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"
diff --git a/tests/sync/test_page_event_request.py b/tests/sync/test_page_event_request.py
new file mode 100644
index 000000000..77515091f
--- /dev/null
+++ b/tests/sync/test_page_event_request.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 playwright.sync_api import Page, Request, Route
+from tests.server import Server
+
+
+def test_should_return_last_requests(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/title.html")
+    for i in range(200):
+
+        def _handle_route(route: Route) -> None:
+            route.fulfill(
+                status=200,
+                body=f"url:{route.request.url}",
+            )
+
+        page.route(f"**/fetch?{i}", _handle_route)
+
+    # #0 is the navigation request, so start with #1.
+    for i in range(1, 100):
+        page.evaluate("url => fetch(url)", server.PREFIX + f"/fetch?{i}")
+    first_100_requests_with_goto = page.requests()
+    first_100_requests = first_100_requests_with_goto[1:]
+
+    for i in range(100, 200):
+        page.evaluate("url => fetch(url)", server.PREFIX + f"/fetch?{i}")
+    last_100_requests = page.requests()
+
+    all_requests = first_100_requests + last_100_requests
+
+    def gather_response(request: Request) -> dict:
+        response = request.response()
+        assert response
+        return {"text": response.text(), "url": request.url}
+
+    # All 199 requests are fully functional.
+    received = [gather_response(request) for request in all_requests]
+    expected = []
+    for i in range(1, 200):
+        url = server.PREFIX + f"/fetch?{i}"
+        expected.append({"url": url, "text": f"url:{url}"})
+    assert received == expected

From 019df4b0ecbd8f14154b9ddfbc0b33a3a48c5f96 Mon Sep 17 00:00:00 2001
From: Max Schmitt <max@schmitt.mx>
Date: Tue, 7 Oct 2025 08:36:52 -0500
Subject: [PATCH 430/438] fix: prevent ProtocolCallback memory leak during
 tracing (#2977) (#2980)

---
 playwright/_impl/_connection.py     |  8 ++--
 tests/test_reference_count_async.py | 61 +++++++++++++++++++++++++++++
 2 files changed, 66 insertions(+), 3 deletions(-)

diff --git a/playwright/_impl/_connection.py b/playwright/_impl/_connection.py
index 65bcf48c8..bbc42b6e1 100644
--- a/playwright/_impl/_connection.py
+++ b/playwright/_impl/_connection.py
@@ -218,10 +218,12 @@ def remove_listener(self, event: str, f: Any) -> None:
 
 
 class ProtocolCallback:
-    def __init__(self, loop: asyncio.AbstractEventLoop) -> None:
+    def __init__(self, loop: asyncio.AbstractEventLoop, no_reply: bool = False) -> None:
         self.stack_trace: traceback.StackSummary
-        self.no_reply: bool
+        self.no_reply = no_reply
         self.future = loop.create_future()
+        if no_reply:
+            self.future.set_result(None)
         # The outer task can get cancelled by the user, this forwards the cancellation to the inner task.
         current_task = asyncio.current_task()
 
@@ -360,7 +362,7 @@ def _send_message_to_server(
             )
         self._last_id += 1
         id = self._last_id
-        callback = ProtocolCallback(self._loop)
+        callback = ProtocolCallback(self._loop, no_reply=no_reply)
         task = asyncio.current_task(self._loop)
         callback.stack_trace = cast(
             traceback.StackSummary,
diff --git a/tests/test_reference_count_async.py b/tests/test_reference_count_async.py
index 4f4cac102..5eb1c28a1 100644
--- a/tests/test_reference_count_async.py
+++ b/tests/test_reference_count_async.py
@@ -13,6 +13,8 @@
 # limitations under the License.
 
 import gc
+import os
+import tempfile
 from collections import defaultdict
 from typing import Any
 
@@ -71,3 +73,62 @@ def handle_network_response_received(event: Any) -> None:
     assert "Dialog" not in pw_objects
     assert "Request" not in pw_objects
     assert "Route" not in pw_objects
+
+
+@pytest.mark.asyncio
+async def test_tracing_should_not_leak_protocol_callbacks(browser_name: str) -> None:
+    """
+    Regression test for https://github.com/microsoft/playwright-python/issues/2977
+
+    This test ensures that ProtocolCallback objects don't accumulate when tracing is enabled.
+    The memory leak occurred because no_reply callbacks were created with circular references
+    but never cleaned up.
+    """
+
+    def count_protocol_callbacks() -> int:
+        """Count ProtocolCallback objects in memory."""
+        gc.collect()
+        count = 0
+        for obj in gc.get_objects():
+            if (
+                hasattr(obj, "__class__")
+                and obj.__class__.__name__ == "ProtocolCallback"
+            ):
+                count += 1
+        return count
+
+    with tempfile.TemporaryDirectory() as temp_dir:
+        trace_file = os.path.join(temp_dir, "test_trace.zip")
+
+        async with async_playwright() as p:
+            browser = await p[browser_name].launch()
+            context = await browser.new_context()
+
+            # Start tracing to trigger the creation of no_reply callbacks
+            await context.tracing.start(screenshots=True, snapshots=True)
+
+            initial_count = count_protocol_callbacks()
+
+            # Perform operations that would create tracing callbacks
+            for _ in range(3):
+                page = await context.new_page()
+                await page.goto("data:text/html,<h1>Test Page</h1>")
+                await page.wait_for_load_state("networkidle")
+                await page.evaluate(
+                    "document.querySelector('h1').textContent = 'Modified'"
+                )
+                await page.close()
+
+            # Stop tracing
+            await context.tracing.stop(path=trace_file)
+            await browser.close()
+
+    # Force garbage collection and check callback count
+    gc.collect()
+    final_count = count_protocol_callbacks()
+
+    # The key assertion: callback count should not have increased significantly
+    # Allow for a small number of legitimate callbacks but ensure no major leak
+    assert (
+        final_count - initial_count <= 5
+    ), f"ProtocolCallback leak detected: initial={initial_count}, final={final_count}, leaked={final_count - initial_count}"

From f283da50d64ee896d0a148522b6c719b86b721f3 Mon Sep 17 00:00:00 2001
From: Yury Semikhatsky <yurys@chromium.org>
Date: Fri, 24 Oct 2025 16:09:52 -0700
Subject: [PATCH 431/438] devops: update ado owner (#2997)

---
 .azure-pipelines/publish.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.azure-pipelines/publish.yml b/.azure-pipelines/publish.yml
index d0d308342..1a2e0e7a4 100644
--- a/.azure-pipelines/publish.yml
+++ b/.azure-pipelines/publish.yml
@@ -74,8 +74,8 @@ extends:
               # contentsource: 'folder'
               folderlocation: '$(Build.ArtifactStagingDirectory)/esrp-build'
               waitforreleasecompletion: true
-              owners: 'maxschmitt@microsoft.com'
-              approvers: 'maxschmitt@microsoft.com'
+              owners: 'yurys@microsoft.com'
+              approvers: 'yurys@microsoft.com'
               serviceendpointurl: 'https://api.esrp.microsoft.com'
               mainpublisher: 'Playwright'
               domaintenantid: '975f013f-7f24-47e8-a7d3-abc4752bf346'

From 75ceca04b7f4b29c1c026130696568fca68c9e88 Mon Sep 17 00:00:00 2001
From: Yury Semikhatsky <yurys@chromium.org>
Date: Mon, 10 Nov 2025 17:00:40 -0800
Subject: [PATCH 432/438] chore: update driver to 1.56.1 (#3002)

---
 playwright/async_api/_generated.py | 3 ++-
 playwright/sync_api/_generated.py  | 3 ++-
 setup.py                           | 2 +-
 3 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 71f5aff82..4c8304b25 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -12924,6 +12924,8 @@ async def grant_permissions(
             - `'clipboard-write'`
             - `'geolocation'`
             - `'gyroscope'`
+            - `'local-fonts'`
+            - `'local-network-access'`
             - `'magnetometer'`
             - `'microphone'`
             - `'midi-sysex'` (system-exclusive midi)
@@ -12931,7 +12933,6 @@ async def grant_permissions(
             - `'notifications'`
             - `'payment-handler'`
             - `'storage-access'`
-            - `'local-fonts'`
         origin : Union[str, None]
             The [origin] to grant permissions to, e.g. "https://example.com".
         """
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 024014c51..ced1a7d8c 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -12948,6 +12948,8 @@ def grant_permissions(
             - `'clipboard-write'`
             - `'geolocation'`
             - `'gyroscope'`
+            - `'local-fonts'`
+            - `'local-network-access'`
             - `'magnetometer'`
             - `'microphone'`
             - `'midi-sysex'` (system-exclusive midi)
@@ -12955,7 +12957,6 @@ def grant_permissions(
             - `'notifications'`
             - `'payment-handler'`
             - `'storage-access'`
-            - `'local-fonts'`
         origin : Union[str, None]
             The [origin] to grant permissions to, e.g. "https://example.com".
         """
diff --git a/setup.py b/setup.py
index c2a56354b..2046c2220 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.56.0-beta-1759412259000"
+driver_version = "1.56.1"
 
 base_wheel_bundles = [
     {

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 433/438] 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 434/438] 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 435/438] 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 436/438] 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 437/438] 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 438/438] 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)